/text/sbasic/shared/01170101.xhp

General Define the properties for the selected control or dialog. The available properties depend on the type of control selected. The following properties therefore are not available for every type of control.

Alignment Specify the alignment option for the selected control.

AutoFill Select "Yes" to enable the AutoFill function for the selected control.

Background color Specify the background color for the current control.

Large change Specify the number of units to scroll when a user clicks in the area between the slider and the arrows on a scrollbar.

Border Specify the border type for the current control.

Button type Select a button type. Button types determine what type of action is initiated.

Character set Select the font to be used for displaying the contents of the current control.

Currency symbol Enter the currency symbol to be used for currency controls.

Date Specify the default date to be shown in the Date control.

Date format Specify the desired format for a date control. A date control interprets the user input depending on this format setting.

Date max. Specify the upper limit for a date control.

Date min. Specify the lower limit for a date control.

Decimal accuracy Specify the number of decimal places displayed for a numerical or currency control.

Default button Select "Yes" to make the current button control the default selection. Pressing Return in the dialog activates the default button.

Delay Specifies the delay in milliseconds between scrollbar trigger events. A trigger event occurs when you click a scrollbar arrow or click the background area in a scrollbar. Repeated trigger events occur if you keep the mouse button pressed when you click a scrollbar arrow or background area in a scrollbar. If you want, you can include valid time units with the number that you enter, for example, 2 s or 500 ms.

Dropdown Select "Yes" to enable the dropdown option for list or combo box controls. A dropdown control field has an arrow button which you can click to open a list of the existing form entries.

Enabled Select "Yes" to enable the control. If the control is disabled, it is grayed out in the dialog.

Edit mask Specify the edit mask for a pattern control. This is a character code that defines the input format for the control. You need to specify a masking character for each input character of the edit mask to restrict the input to the values that are listed in the following table: Character Meaning L A text constant. This character cannot be modified by the user. a The characters a-z can be entered here. If a capital letter is entered, it is automatically converted to a lowercase letter. A The characters A-Z can be entered here. If a lowercase letter is entered, it is automatically converted to a capital letter c The characters a-z and 0-9 can be entered here. If a capital letter is entered, it is automatically converted to a lowercase letter. C The characters a-z and 0-9 can be entered here. If a lowercase letter is entered, it is automatically converted to a capital letter N Only the characters 0-9 can be entered. x All printable characters can be entered. X All printable characters can be entered. If a lowercase letter is used, it is automatically converted to a capital letter.

Editable Specifies whether the nodes of the tree control are editable. The default value is FALSE.

Graphics Specify the source of the graphics for a button or an image control. Click "..." to select a file.

Height Specify the height of the current control or the dialog.

Help text Enter a help text that is displayed as a tip (bubble help) when the mouse rests over the control.

Help URL Specify the help URL that is called when you press F1 while the focus is on a particular control. For example, use the format HID:1234 to call the Help-ID with the number 1234. Set the environment variable HELP_DEBUG to 1 to view the Help-IDs as extended help tips.

Incr./decrement value Specify the increment and decrement interval for spin button controls.

Invokes stop mode editing Specifies what happens when editing is interrupted by selecting another node in the tree, a change in the tree's data, or by some other means. Setting this property to TRUE causes the changes to be automatically saved when editing is interrupted. FALSE means that editing is canceled and changes are lost. The default value is FALSE.

Label Specifies the label of the current control. The label is displayed along with the control. You can create multi-line labels by inserting manual line breaks in the label using Shift+Enter.

Line Count Enter the number of lines to be displayed for a list control. For combo boxes, this setting is only active if the dropdown option is enabled.

Scrollbar Adds the scrollbar type that you specify to a text box.

Small change Specify the number of units to scroll when a user clicks an arrow on a scrollbar.

List entries Specify the entries for a list control. One line takes one list entry. Press Shift+Enter to insert a new line.

Literal mask Specify the initial values to be displayed in a pattern control. This helps the user to identify which values are allowed in a pattern control. The literal mask is restricted by the format specified by the edit mask.

Manual line break Select "Yes" to allow manual line breaks inside multiline controls.

Max. text length Specify the maximum number of characters that the user can enter.

Multiline Input Select "Yes" to allow the input of multiple lines in the control. Press Enter to insert a manual line break in the control.

Multiselection Select "Yes" to allow the selection of multiple entries in list controls.

Name Insert a name for the current control. This name is used to identify the control.

Order Specify the order in which the controls receive the focus when the Tab key is pressed in the dialog. On entering a dialog, the control with the lowest order (0) receives the focus. Pressing the Tab key the successively focusses the other controls as specified by their order number. Initially, the controls receive numbers in the order they are added to the dialog. You can change the order numbers for controls. $[officename] Basic updates the order numbers automatically to avoid duplicate numbers. Controls that cannot be focused are also assigned a value but these controls are skipped when using the Tab key.

Orientation Specify the orientation for a scrollbar control.

Page (step) Specify the number of the dialog page to which the current control is assigned or the page number of the dialog you want to edit. If a dialog has only one page set its Page (Step) value to 0. Select Page (Step) = 0 to make a control visible on every dialog page. To switch between dialog pages at run time, you need to create a macro that changes the value of Page (Step).

Password characters Enter a character to be displayed instead of the characters that are typed. This can be used for entering passwords in text controls.

PositionXSpecify the distance of the current control from the left side of the dialog.

PositionY Specify the distance of the current control from the top of the dialog.

Prefix symbol Select "Yes" to display the currency symbol prefix in currency controls when a number was entered.

Print Select "Yes" to include the current control in a document's printout.

Progress value Specify a progress value for a progress bar control.

Progress value max. Specify the maximum value of a progress bar control.

Progress value min. Specify the minimum value of a progress bar control.

Read-only Select "Yes" to prevent the user from editing the value of the current control. The control is enabled and can be focussed but not modified.

RepeatUFI: see spec spinbutton_form_control.sxw Repeats trigger events when you keep the mouse button pressed on a control such as a spin button.

Root displayedsee http://specs.openoffice.org/appwide/dialog_ide/New_Tree_Control_in_IDE.odt Specifies if the root node of the tree control is displayed. If Root displayed is set to FALSE, the root node of a model is no longer a valid node for the tree control and can't be used with any method of XTreeControl. The default value is TRUE.

Row height Specifies the height of each row of a tree control, in pixels. If the specified value is less than or equal to zero, the row height is the maximum height of all rows. The default value is 0.

Scale Scales the image to fit the control size.

Scrollbar Adds the scrollbar type that you specify to a text box.

Scroll value Specify the initial value of a scrollbar control. This determines the position of the scrollbar slider.

Scroll value max. Specify the maximum value of a scrollbar control.

Scroll value min. Specify the minimum value of a scrollbar control.

Show handles Specifies whether the handles of the nodes should be displayed. The handles are dotted lines that visualize the hierarchy of the tree control. The default value is TRUE.

Show root handles Specifies whether the handles of the nodes should also be displayed at root level. The default value is TRUE.

SelectionUFI: udk.features "New property and help ID for property browser in Basic IDE" Specifies the sequence of the selected items, where "0" corresponds to the first item. To select more than one item, Multiselection must be enabled. Click the ... button to open the Selection dialog. Click the item or items that you want to select. To select more than one item, ensure that the Multiselection option is selected.

Selection typesee http://specs.openoffice.org/appwide/dialog_ide/New_Tree_Control_in_IDE.odt Specifies the selection mode that is enabled for this tree control.

Spin Button Select "Yes" to add spin buttons to a numerical, currency, date, or time control to allow increasing and decreasing the input value using arrow buttons.

State Select the selection state of the current control.

Strict format Select "Yes" to only allow valid characters to be entered in a numerical, currency, date, or time control.

Tabstop Select the focus behavior of the current control when using the Tab key. Default Only input controls receive the focus when using the Tab key. Controls without input like caption controls are omitted. No When using the tab key focusing skips the control. Yes The control can be selected with the Tab key.

Thousands Separator Select "Yes" to display thousands separator characters in numerical and currency controls.

Time Format Select the format to be used for time controls.

Time max. Specify the maximum time value for a time control.

Time min. Specify the minimum time value for a time control.

Title Specify the title of the dialog. Click the border of the dialog to select the dialog. Titles are only used for labeling a dialog and can only contain one line. Please note that if you work with macros, controls are only called through their Name property.

Tristate Select "Yes" to allow a check box to have three states (checked, unchecked, and grayed out) instead of two (checked and unchecked).

Value Specify the value for the current control.

Value max. Specify the maximum value for the current control.

Value min. Specify the minimum value for the current control.

Visible size Specify the length of the slider of a scrollbar control.

Width Specify the width of the current control or dialog.