Anexo III: Ejemplos de tareas de Geografía de España

The size of the input field, the maximum number of characters and lines, and the colour, font and orientation of the input are defined on this page.

The Edit control Controls

Fig. 38: Edit control - Input page

z Input orientation: This group of radio buttons controls the positioning of the

caret in an empty input field.

z right-justified: The caret is located at the right end of the input field. Each

character that is input appears to the right of the caret initially. Entering a new character shifts the previous ones to the left.

z left-justified: At the beginning, the caret is located at the left end of the

input field. Each character that is input appears to the right of the caret and shifts the caret further to the right.

z centered: At the beginning, the caret is located at the center of the input

field. Each character that is input appears to the right of the caret and shifts the caret slightly to the right. All previous characters are shifted slightly to the left so that the character that has just been input is always placed at the center of the input field.

z Input limits — max. chars: The maximum number of characters is defined in

this input field. This figure must be geared to the selected font size. If not all characters will fit into the input field at the selected font size, there is a beep and the maximum number of characters cannot be reached.

Controls The Edit control

The maximum number of characters is entered in the variable (Name-of- Input-Variable)_MAXCHARS_L when the Internet page is loaded. This means the check function (see "The Check() function" on page 424) can draw upon this value in order to output detailed error messages if the conversion of umlauts causes the maximum number of characters to be exceeded.

z Input limits — max. lines: The maximum number of lines is defined in this

input field. This figure must be geared to the selected font size. If not all lines will fit into the input field at the selected font size, confirmation causes the input field to be exited before the maximum number of lines is reached.

z Input range: The size and position of the input field are defined in the

following input fields:

z X pos: The X position of the input range is specified in pixels in this input

field. The origin is the top left corner of the Edit control. The distance from the left edge is specified here.

z Y pos: The Y position of the input range is specified in pixels in this input

field. The origin is the top left corner of the Edit control. The distance from the top edge is specified here.

z Width: The width of the input range is entered in pixels here.

z Height: The height of the input range is entered in pixels here.

z default check box: If this check box is activated, the size and position of

the input field are read from the following parameters at runtime: InputAlignX corresponding to X pos

(see "InputAlignX" on page 662 in the Parameters chapter) InputAlignY corresponding to Y pos

(see "InputAlignY" on page 662 in the Parameters chapter) InputWidth corresponding to Width

(see "InputWidth" on page 663 in the Parameters chapter) InputHeight corresponding to Height

(see "InputHeight" on page 663 in the Parameters chapter)

z Don’t display preliminary input: Any content of the input variable will not be

displayed, when this checkbox is checked. The input variable, the unfor- matted input variable, the input status variable, the variable for the maximum numbers of input characters and the error counter variable will be reset, too. Another way not to show the content of an input variable is to initialize the input variable and unformatted input variable in the application with a null string and leave this property unchecked.

The Edit control Controls

z Font colour for active: Three fields define the colour setting for the font.

z default check box: If this check box is activated, the font colour is read

from the InputColour parameter at runtime (see "InputColour" on page 662 in the Parameters chapter). The Standard colour dialog button and the input field for the colour cannot be selected if this check box is activated. The value to be stored in InputColour can be ascertained by calling the standard colour dialog here once and selecting a colour. The colour is then output as a numeric value in the input field for the colour for active and can be read there.

z Input field for colour: A numeric value can be input here to define a

colour. However it is better to use the standard colour dialog to select a colour. The value for the selected colour is then entered here automati- cally.

Selecting the Font button causes the text colour defined there to be entered in this field. Any font colour that had been defined beforehand in the standard colour dialog is overwritten by this one. It is better to select the font first and then the colour if a special colour outside the 16 basic colours is required.

z ... button (standard colour dialog): Pressing this button opens the

standard colour dialog (Fig. 29: "Standard colour dialog"). See page 103. Refer to the Windows NT Online Help for a description of the options in this dialog. This dialog can also be called when selecting colours for the Windows NT Desktop.

z Font colour for inactive: The same three fields are used to define the font

colour for a inactive (disabled) input field as for an active one. If the default check box is activated, the colour is read from the InputColourDisabled parameter at runtime (see "InputColourDisabled" on page 662 in the Param- eters chapter).

z DF (Direct Format) Checkbox: If the input shall be formatted directly during

input, please check this box. The Button Direct format will be activated then. Direct format may be used for amount input or date input, to show the separator characters directly during, while the customer does not have to type it in, e.g.

z Direct format button: By pressing this button the property page Direct

Format is activated, to configure the type of each character of the input

field. In this property page, the table at the top shows one column for each input character. To change the settings for a special character, its

Controls The Edit control

column has to be activated with the mouse. With the properties under the table, the highlighted character will be configured. The lines in the table have the following meanings:

1. Pre-allocation character or RealTime, which means, character is shown, when page is loaded.

2. Character is writeable or not, which means Edit or No Edit. 3. Visible At input or Always.

4. Permitted characters (All, Numeric, Alpha or self-defined charac- terset).

5. Character transformation (None, Uppercase, Lowercase). 6. Pre-allocation selected from the Pre-allocation Listbox, from the

Special Listbox or None.

Fig. 39: Edit control - Direct format

z Writeable: In this radiobuttons it is specified, if the character may be

overridden, or if the caret passes this character. Normally these buttons are disabled, which means, the character is writeable. If any predefined

Pre-allocation from the drop-down list is set, this field is activated. Now

there is the option to switch this character to not writeable, which means, during input the character may not be overridden. The caret jumps automatically to the next writeable character.

The Edit control Controls

z Yes: The character may be overridden.

z No: During input the caret jumps automatically to the next writeable

character.

z Visible: These radiobuttons specify, if a Pre-allocated character shall be

visible, when the page is loaded or if it should be shown, when the character beneath this character has been typed in. So these

radiobuttons are disabled. They will be enabled, when a Pre-allocation is specified.

z At input: This radiobutton means, that the pre-allocated character

shall be displayed, when the character beneath this character has been typed in.

z Always: The pre-allocated character is shown, when the page is

loaded.

z Character transformation: It may be specified here, if Alpha characters

are directly set to Uppercase or Lowercase.

z None: No transformation is done. Character stays as it is.

z Uppercase: Alpha characters are set to Uppercase, directly after

typing the character in.

z Lowercase: Alpha characters are set to Lowercase, directly after

typing the character in.

z Pre-allocation: This field contains an edit field to specify any sign, which

should be displayed at the current character position and a listbox with predefined signs. If an item from the listbox is selected, the input field is disabled. It is only possible to enter a sign in the edit field, if None in the listbox is selected. The following items may be choosen from the listbox:

– None

– Date separator

– Time separator

– Decimal symbol

– Digit grouping symbol

Controls The Edit control

All these symbols are chosen from the actual language specific settings in the HTML-Generator (see also section ’Formatting settings’ on page 288).

z Permitted characters: In this combobox it can be chosen, if all Alpha

characters, Numeric characters or All characters may be edited. This

field is only active, if no Pre-allocation is set. Additionally every possible permitted character at this position can be entered in this combobox directly.

z Special: In this Listbox Amount Entry DDC may be selected. This format

must be set at the position of the decimal sign. Amount entry for DDC means, that first the entered numerical values are displayed from the right to the left. If the separator sign is pressed the next numerical values are treated as post separator digits. They are displayed from the left to the right. All other properties are disabled when Amount Entry DDC is chosen.

z Clear all button: This button resets the complete table, which means the

direct format for the complete input string.

z Font button: The font size for the input is defined by opening the standard

font dialog. This is only available if the default check box has not been activated (see Fig. 30: "Standard font dialog"). Refer to the Windows NT Online Help for a description of the options in this dialog. This dialog is used, for instance, in the Notepad editor to define the font.

z default check box: If the default check box is activated, the Font button

cannot be selected. In this case, the font and the font settings are read from the following parameters at runtime:

InputFont corresponding to Font

(see "InputFont" on page 661 in the Parameters chapter) InputSize corresponding to Size

(see "InputSize" on page 662 in the Parameters chapter) InputBold corresponding to Bold

(see "InputBold" on page 663 in the Parameters chapter) InputItalic corresponding to Italic

(see "InputItalic" on page 663 in the Parameters chapter) InputStrikeout corresponding to Strikeout

(see "InputStrikeout" on page 664 in the Parameters chapter) InputUnderline corresponding to Underline

The Edit control Controls