
[-defdefine TermForForm 'legend'-]
[-defdefine TermForForm_InitialLettersUppercase 'Legend'-]
[-defdefine TermUsedForMap "map"-]
[-defdefine TermUsedForMap_FirstLetterUppercase "Map"-]
[-defdefine	EditFormDialogBoxScreenCapImg "<img src='WCFORM_EditFormDialogBox_ScreenCap.png'/>"-]
[-defdefine	EditFormDialogBox_Text_SymbolsIntroduction
        "<para>
            The text can include <termtext>symbolic fields</termtext>, placeholders
            for text that is automatically inserted. For example, the field
            {FlightTrackName} is automatically replaced with the name of the flight
            track currently being printed.
        </para>
        <para>
            Symbolic fields can also represent graphical elements, such as
            a north arrow. Of particular interest is the {FlightDiagram}
            symbol, which represents the flight diagram being annotated
            by the &TermForForm;. Each &TermForForm; should contain exactly
            one text cell that has the {FlightDiagram} symbol as part
            of its text.
        </para>"
-]
<section id='WCFORM_EditingForms_id'>
    <title>
        Editing &TermForForm_InitialLettersUppercase;s
    </title>
    <section>
        <title>
            Legend Concepts
        </title>
        <para>
            An &app_name; legend is an area that surrounds a &TermUsedForMap;
            when it is printed. The legend displays information about the
            &TermUsedForMap;, such as descriptive text, a graphical scale,
            and a north arrow. The legend may also include a border around
            the &TermUsedForMap;.
        </para>
        <para>
            &app_name;'s legends are based upon a concept of <termtext>cells</termtext>.
            Cells are rectangular areas of the paper that can contain text,
            graphical features such as scales and north arrows, and other
            cells. In addition, there is a cell that contains the &TermUsedForMap;
            itself. Each cell has a variety of properties, such as a background
            color, a margin, and a border.
        </para>
        <para>
            The printable area of the paper (i.e., the paper minus any margins)
            is the <termtext>outermost cell</termtext>. You build a legend
            by adding cells to this outermost cell, and setting their properties.
            Recall that cells can contains other cells. The legend consists
            of a hierarchy of cells, with the outermost cell as the hierarchy
            root.
        </para>
        <para>
            There are three types of cells:
        </para>
        <unorderedlist>
            <listitem>
                <para>
                    <italic>Text Cells</italic> - These cells contain text, and possibly,
                    graphical elements such as a north arrow and the &TermUsedForMap;
                    itself.
                </para>
                <para>
                    <italic>Horizontal Organizer Cells</italic> - These cells contain
                    a horizontal row of other cells.
                </para>
                <para>
                    <italic>Vertical Organizer Cells</italic> - These cells contain
                    a vertical column of other cells.
                </para>
            </listitem>
        </unorderedlist>
    </section>
    <section id='WCFORM_EditingFormDialogBox_id'>
        <title>
            Edit &TermForForm_InitialLettersUppercase; Dialog Box
        </title>
        <para>
            Use the Edit &TermForForm_InitialLettersUppercase; dialog box
            to inspect and edit an &app_name; &TermForForm;.
        </para>
        <exhibit>
            &EditFormDialogBoxScreenCapImg;
        </exhibit>
        <para>
            The left side of the Edit &TermForForm_InitialLettersUppercase;
            dialog box displays a preview of what the current legend will
            look like when printed. This is know as the <italic>&TermForForm;
            preview</italic>.
        </para>
        <para>
            The right side of the Edit &TermForForm_InitialLettersUppercase;
            dialog box displays a hierarchical list of the cells in the legend.
            This is known as the <termtext>cell list</termtext>.
        </para>
        <para>
            At any given time, one cell is selected. This <termtext>selected
            cell</termtext> is the one that you are currently working with.
            The selected cell is highlighted in both the &TermForForm; preview
            and the cell list.
        </para>
    </section>
    <section>
        <title>
            Working with the &TermForForm_InitialLettersUppercase; Preview
        </title>
        <para>
            Press the Zoom In button <img
            src='intres:WCF_ZoomInToolbarButtonBitmap'/> to magnify the &TermForForm;
            preview for close study. Press the Zoom Out button <img
            src='intres:WCF_ZoomOutToolbarButtonBitmap'/> to reduce the magnification
            level.
        </para>
        <para>
            Press the Change Sample Paper Size button <img
            src='intres:WCPAPERxWCF_Paper_ToolbarButtonBitmap'/> to select
            the size and orientation of the hypothetical piece of paper used
            to display the &TermForForm; preview.
        </para>
        <para>
            Press the Print Sample Legend button <img
            src='intres:WCF_PrintToolbarButtonBitmap'/> to print the &TermForForm;
            preview.
        </para>
        <para>
            Click on a cell in the &TermForForm; preview to select it. Double-click
            on a cell to displays the cell's Edit &TermForForm_InitialLettersUppercase;
            Cell dialog box, which allows you to inspect and change the cell's
            properties. See <iref
            target='WCFORM_EditDialogBox_CellPropertiesDialogBox_id'/>.
        </para>
    </section>
    <section>
        <title>
            Working with the Cell List
        </title>
        <para>
            The cell list displays a hierarchical list of the cells in the
            &TermForForm; being edited. The selected cell is always highlighted.
            To change the selected cell, either use the arrow keys, or click
            on the cell to be selected.
        </para>
        <para>
            To edit the properties of the selected cell, you can:
        </para>
        <unorderedlist>
            <listitem>
                <para>
                    Press the Edit Cell button <img
                    src='intres:WCF_PropertiesToolbarButtonBitmap'/>
                </para>
            </listitem>
            <listitem>
                <para>
                    Press <keytext>Alt + E</keytext>
                </para>
            </listitem>
            <listitem>
                <para>
                    Double-click on the cell in the cell list
                </para>
            </listitem>
        </unorderedlist>
        <para>
            The cell's Edit &TermForForm_InitialLettersUppercase; Cell dialog
            box, which allows you to inspect and change the cell's properties,
            is displayed. See <iref
            target='WCFORM_EditDialogBox_CellPropertiesDialogBox_id'/>.
        </para>
        <para>
            Use either the keyboard or the Move buttons to move the selected
            cell.
        </para>
        <table>
            <tableheader>
                <tablecolumnheader horzjust='center'>
                    Key
                </tablecolumnheader>
                <tablecolumnheader horzjust='center'>
                    Button
                </tablecolumnheader>
                <tablecolumnheader horzjust='left'>
                    Action
                </tablecolumnheader>
            </tableheader>
            <tablerow>
                <tablecell>
                    <keytext>Alt +</keytext> &uparrowkey;
                </tablecell>
                <tablecell>
                    <img src='intres:WCF_MoveUpToolbarButtonBitmap'/>
                </tablecell>
                <tablecell>
                    Move selected cell up in the cell list.
                </tablecell>
            </tablerow>
            <tablerow>
                <tablecell>
                    <keytext>Alt +</keytext> &downarrowkey;
                </tablecell>
                <tablecell>
                    <img src='intres:WCF_MoveDownToolbarButtonBitmap'/>
                </tablecell>
                <tablecell>
                    Move selected cell down in the cell list.
                </tablecell>
            </tablerow>
            <tablerow>
                <tablecell>
                    <keytext>Alt +</keytext> &leftarrowkey;
                </tablecell>
                <tablecell>
                    <img src='intres:WCF_MoveLeftToolbarButtonBitmap'/>
                </tablecell>
                <tablecell>
                    Move selected cell in one level towards the root of the cell list.
                </tablecell>
            </tablerow>
            <tablerow>
                <tablecell>
                    <keytext>Alt +</keytext> &rightarrowkey;
                </tablecell>
                <tablecell>
                    <img src='intres:WCF_MoveRightToolbarButtonBitmap'/>
                </tablecell>
                <tablecell>
                    Move selected cell out one level away from the root of the cell
                    list.
                </tablecell>
            </tablerow>
        </table>
        <para>
            Use either the keyboard or the Add buttons to add a new cell as
            the child of the selected cell.
        </para>
        <table>
            <tableheader>
                <tablecolumnheader horzjust='center'>
                    Key
                </tablecolumnheader>
                <tablecolumnheader horzjust='center'>
                    Button
                </tablecolumnheader>
                <tablecolumnheader horzjust='left'>
                    Action
                </tablecolumnheader>
            </tableheader>
            <tablerow>
                <tablecell>
                    <keytext>Alt + T</keytext>;
                </tablecell>
                <tablecell>
                    <img
                    src='intres:WCFORMxWCF_AddFormElement_Content_ToolbarButton'/>
                </tablecell>
                <tablecell>
                    Add a new text cell
                </tablecell>
            </tablerow>
            <tablerow>
                <tablecell>
                    <keytext>Alt + H</keytext>
                </tablecell>
                <tablecell>
                    <img
                    src='intres:WCFORMxWCF_AddFormElement_HorizontalBox_ToolbarButton'/>
                </tablecell>
                <tablecell>
                    Add a new horizontal organizer cell
                </tablecell>
            </tablerow>
            <tablerow>
                <tablecell>
                    <keytext>Alt + V</keytext>
                </tablecell>
                <tablecell>
                    <img
                    src='intres:WCFORMxWCF_AddFormElement_VerticalBox_ToolbarButton'/>
                </tablecell>
                <tablecell>
                    Add a new vertical organizer cell
                </tablecell>
            </tablerow>
        </table>
        <para>
            Delete the selected cell by either pressing the Delete button
            <img src='intres:WCF_DeleteCrossToolbarButtonBitmap'/>, or by
            pressing the <keytext>Delete</keytext> key.
        </para>
    </section>
    <section id='WCFORM_EditDialogBox_CellPropertiesDialogBox_id'>
        <title>
            Edit &TermForForm_InitialLettersUppercase; Cell Dialog Box
        </title>
        <para>
            The Edit &TermForForm_InitialLettersUppercase; Cell dialog box
            allows you to inspect and change the properties of the selected
            cell.
        </para>
        <exhibit>
            <img src='WCFORM_EditCellDialogBox_ScreenCap.png'/>
        </exhibit>
        <para>
            The Edit &TermForForm_InitialLettersUppercase; Cell dialog box
            is a Multiple Page dialog box. See <iref
            target='WCF_MultiplePageDialogBoxes_id'/> for more information.
        </para>
    </section>
    <section
    id='WCFORM_EditDialogBox_CellPropertiesDialogBox_Text_id'>
        <title>
            Text Page
        </title>
        <para>
            The Text page of the <link
            target='#WCFORM_EditDialogBox_CellPropertiesDialogBox_id'>Edit
            &TermForForm_InitialLettersUppercase; Cell dialog box</link> allows
            you to change the text of a text cell.
        </para>
        <exhibit>
            <img src='WCFORM_EditCellDialogBox_Text_ScreenCap.png'/>
        </exhibit>
        <para>
            Type the desired text in the box provided. The text can have as
            many lines as desired: press the <keytext>Enter</keytext> key
            to insert a new line.
        </para>
        &EditFormDialogBox_Text_SymbolsIntroduction;
        <para>
            Press the Insert Symbolic Field button <img
            src='WCF_SymbolicFieldsTextControl_InsertFieldButton_ScreenCap.png'/>,
            located to the right of the text box, to display a list of fields
            from which you can choose. See <iref
            target='WCF_SymbolicFieldsTextControl_id'/> for more information.
        </para>
    </section>
    <section
    id='WCFORM_EditDialogBox_CellPropertiesDialogBox_Size_id'>
        <title>
            Size Page
        </title>
        <para>
            The Size page of the <link
            target='#WCFORM_EditDialogBox_CellPropertiesDialogBox_id'>Edit
            &TermForForm_InitialLettersUppercase; Cell dialog box</link> allows
            you to specify the horizontal and vertical size of a cell.
        </para>
        <exhibit>
            <img src='WCFORM_EditCellDialogBox_Size_ScreenCap.png'/>
        </exhibit>
        <para>
            You can specify both the cell's width (i.e., horizontal size)
            and height (i.e., vertical size). Since the width and height are
            specified in an analogous manner, only the width is described
            in detail.
        </para>
        <para>
            Select the method used to specify the cell's width. You have four
            choices.
        </para>
        <unorderedlist>
            <listitem>
                <para>
                    <italic>Determine cell width automatically</italic> - &app_name;
                    will automatically calculate an appropriate width for the cell.
                    For text cells, the width is computed from the text being displayed.
                    For organizer cells, the width is computed from the widths' of
                    the cell's child cells.
                </para>
            </listitem>
            <listitem>
                <para>
                    <italic>Cell should be</italic> - Type the width of the cell,
                    in centimeters. Choose <italic>Exactly</italic> from the drop-down
                    list to force the cell to be exactly the width you supplied. Choose
                    <italic>At least</italic> to allow the cell to be wider: &app_name;
                    will assign the cell a larger width if there is room for it.
                </para>
            </listitem>
            <listitem>
                <para>
                    <italic>Cell should be</italic> - Choose how the cell uses its
                    contents (either its text or child cells) to determine its own
                    width. Choose <italic>Exactly</italic> to restrict the cell to
                    the smallest width that will accommodate its contents. Choose
                    <italic>At least</italic> to allow the cell to be wider: &app_name;
                    will assign the cell a larger width if there is room for it.
                </para>
            </listitem>
            <listitem>
                <para>
                    <italic>As large as possible</italic> - The cell will be as wide
                    as possible: it will fill the horizontal space available for it.
                </para>
            </listitem>
        </unorderedlist>
    </section>
    <section
    id='WCFORM_EditDialogBox_CellPropertiesDialogBox_Style_id'>
        <title>
            Style Page
        </title>
        <para>
            The Style page of the <link
            target='#WCFORM_EditDialogBox_CellPropertiesDialogBox_id'>Edit
            &TermForForm_InitialLettersUppercase; Cell dialog box</link> allows
            you to specify the visual appearance of a cell: its color, font,
            and justification.
        </para>
        <exhibit>
            <img src='WCFORM_EditCellDialogBox_Style_ScreenCap.png'/>
        </exhibit>
        <para>
            <italic>Background color</italic> - Select the background color
            of the cell. See <iref target='WCF_ColorControl_id'/> for information
            on selecting colors.
        </para>
        <para>
            Note that for some organizer cells, the background color will
            not be visible, as the entire cell will be filled with other cells
            that have their own background colors. Typically, you will set
            the background colors of all text cells, and all organizer cells
            that have non-zero margins.
        </para>
        <para>
            <italic>Text Color</italic> - Select the color of the cell's text.
            This is relevant only for text cells.
        </para>
        <para>
            <italic>Text Font</italic> - Select the font used to display the
            cell's text. This is relevant only for text cells. See <iref
            target='WCF_FontControl_id'/> for information on selecting fonts.
        </para>
        <para>
            <italic>Horizontal Justification</italic> - Select how the cell's
            contents (either its text or its child cells) are horizontally
            justified. You have three choices: <italic>Left</italic>, <italic>Center</italic>,
            and <italic>Right</italic>.
        </para>
        <para>
            <italic>Vertical Justification</italic> - Select how the cell's
            contents (either its text or its child cells) are vertically justified.
            You have three choices: <italic>Top</italic>, <italic>Center</italic>,
            and <italic>Bottom</italic>.
        </para>
    </section>
    <section
    id='WCFORM_EditDialogBox_CellPropertiesDialogBox_Margins_id'>
        <title>
            Margins Page
        </title>
        <para>
            The Margins page of the <link
            target='#WCFORM_EditDialogBox_CellPropertiesDialogBox_id'>Edit
            &TermForForm_InitialLettersUppercase; Cell dialog box</link> allows
            you to specify a cell's margins. The margins are white space around
            the edge of the cell, similar to the margins on a piece of paper.
        </para>
        <exhibit>
            <img src='WCFORM_EditCellDialogBox_Margins_ScreenCap.png'/>
        </exhibit>
        <para>
            Choose the method used to specify the margins. You have three
            choices: specifying a single margin for all four sides of the
            cell, specifying different margins for the left-right and top-bottom
            sides of the cell, and specifying the margins for all four sides
            individually.
        </para>
        <para>
            Type the desired margin or margins, and select the units used
            to specify the margins.
        </para>
    </section>
    <section
    id='WCFORM_EditDialogBox_CellPropertiesDialogBox_Borders_id'>
        <title>
            Borders Page
        </title>
        <para>
            The Borders page of the <link
            target='#WCFORM_EditDialogBox_CellPropertiesDialogBox_id'>Edit
            &TermForForm_InitialLettersUppercase; Cell dialog box</link> allows
            you to specify a cell's borders. The borders are optional lines
            that can be drawn around some or all of the four edges of the
            cell, just outside of the margins.
        </para>
        <exhibit>
            <img src='WCFORM_EditCellDialogBox_Borders_ScreenCap.png'/>
        </exhibit>
        <para>
            Choose the method used to specify the borders. You have four choices:
            displaying no borders, specifying a single border style for all
            four sides of the cell, specifying different border styles for
            the left-right and top-bottom sides of the cell, and specifying
            the border styles for all four sides individually.
        </para>
        <para>
            Select the desired color(s) of the line(s) used to draw the borders.
            See <iref target='WCF_ColorControl_id'/> for information on selecting
            colors.
        </para>
        <para>
            Type the desired width(s) of the line(s) used to draw the borders,
            in millimeters. If a width of zero is specified, then the border
            is not drawn.
        </para>
    </section>
</section>
