bJRNV‖General

7aXp6‖This General tab enables you to define the general properties of a form control. These properties differ, depending on the control type. Not all of the following properties are available for every control.

To access this command...

TrUBh‖Open context menu of a selected form element - choose Control Properties - General tab.

XDaSr‖Open Form Design toolbar, click Control icon - General tab.


note

kNGCv‖If you export the current form document to HTML format, the default control values are exported, not the current control values. Default values are determined - depending on the type of control - by the properties' Default value (for example, in text fields), Default status (for check boxes and option fields), and Default selection (for list boxes).


2FgA8‖Incr./decrement value

PUUDt‖Determines intervals to add or subtract with each activation of the spin button control.

49HyB‖Width

kKEdB‖ Sets the column width in the table control field in the units that are specified in the LibreOfficeDev module options. If you want, you can enter a value followed by a valid measurement unit, for example, 2 cm.

5GFLT‖PositionY

bp5K9‖Defines the Y position of the control, relative to the anchor.

5MiV4‖Mouse wheel scroll

JFAAg‖Sets whether the value changes when the user scrolls a mouse wheel. Never: No change of the value. When focused: (default) The value changes when the control has the focus and the wheel is pointing at the control and gets scrolled. Always: The value changes when the wheel is pointing at the control and gets scrolled, no matter which control has the focus.

5a4Jg‖Acting on a record

ZjCTy‖Specifies to show or hide the action items in a selected Navigation bar control. Action items are the following: Save record, Undo, New record, Delete record, Refresh.

75FBj‖Help URL

TyrDc‖Specifies a batch label in URL spelling which refers to a help document and which can be called with the help of the control field. The help for the control field help can be opened if the focus is positioned on the control field and the user presses F1.

7mr2p‖Take Focus on Click

UmGen‖If you set this option to "Yes", the Push button receives the focus when you click the button.

8XexW‖List entries

EBEQY‖ Please note the tips referring to the keyboard controls.

ELF5e‖The predefined default list entry is entered into the Default selection combo box.

note

DMKt9‖Note that the list entries entered here are only incorporated into the form if, on the Data tab under List Content Type, the option "Value List" is selected.


j7Ywy‖If you do not want the list entries to be written to the database or transmitted to the recipient of the Web form, but rather assigned values that are not visible in the form, you can assign the list entries to other values in a value list. The value list is determined on the Data tab. Under Type of List Contents, select the option "Value List". Then enter the values under List Contents that are to be assigned to the corresponding visible list entries of the form. For the correct assignment, the order in the value list is relevant.

note

tJXYS‖For HTML documents, a list entry entered on the General tab corresponds to the HTML tag <OPTION>; an entry of the value list entered on the Data tab under List Contents corresponds to the <OPTION VALUE=...> tag.


8ikFf‖Filtering/Sorting

BFG9f‖Specifies to show or hide the filtering and sorting items in a selected Navigation bar control. Filtering and sorting items are the following: Sort ascending, Sort descending, Sort, Automatic filter, Standard filter, Apply filter, Reset filter/sort.

8oY9x‖Icon Size

drgLn‖Specifies whether the icons in a selected Navigation bar should be small or large.

9Msbo‖Hide selection

Laj9U‖Specifies whether a text selection on a control remains selected when the focus is no longer on a control. If you set Hide selection to "No", the selected text remains selected when the focus is no longer on the control that contains the text.

AVGrt‖Default time

pB56r‖Sets the default time.

CBCwM‖Date format

qQ2pa‖ With date fields you can determine the format for the date readout.

note

aeF95‖All format fields (date, time, currency, numeric) are formatted automatically in the selected format as soon as you leave them regardless of how you entered the input.


CDKXG‖Delay

7FDsh‖Specifies the delay in milliseconds between repeating events. A repeating event occurs when you click an arrow button or the background of a scrollbar, or one of the record navigation buttons of a Navigation bar, and you keep the mouse button pressed for some time. You can enter a value followed by a valid time unit, for example, 2 s or 500 ms.

CpDt4‖Multiselection

LBGGC‖ Allows you to select more than one item in a list box.

CpEpp‖Default date

CZ4jn‖Sets the default date.

DMFbh‖AutoFill

TiV2A‖ The AutoFill function displays a list of previous entries after you start to type an entry.

DQAD8‖Graphics

kDzEL‖An image button has a "Graphics" property. The "Graphics" property specifies the graphic's path and file name that you want to have displayed on the button. If you select the graphic file with the ... button, the path and file name will be automatically included in the text box.

EGBFF‖Font

ZrPbi‖ For control fields which have visible text or titles, select the display font that you want to use. To open the Font dialog, click the ... button. The selected font is used in control fields names and to display data in table control fields.

EaFAK‖Small change

E2zWA‖Specify the value to add or subtract when the user clicks the Arrow icon on the scrollbar.

FBxHS‖Formatting

qXkGL‖Specifies the format code for the control. Click the ... button to select the format code.

FEeCy‖Scroll value max.

2QDng‖Specify the maximum value of a scrollbar control.

FQ2oR‖Action

jBDUe‖ You can use navigation actions to design your own database navigation buttons.

mbZXx‖The following table describes the actions that you can assign to a button:

C7u7G‖Action

V74cs‖Description

sGEcA‖None

HAzhT‖No action occurs.

gWUK4‖Submit form

b5eNF‖Sends the data that is entered in other control fields of the current form to the address that is specified in Form Properties under URL.

ftvDz‖Enter the URL into the form's data property "URL" text box when you export to a PDF file.

57uLY‖Reset form

6xQdb‖Resets the settings in other control fields to the predefined defaults: Default Status, Default Selection, Default Value.

D5GrH‖Open document / web page

YMJSL‖Opens the URL that is specified under URL.

UTy42‖First record

34GwQ‖Moves the current form to the first record.

u7etb‖Previous record

A356m‖Moves the current form to the previous record.

w7Wmy‖Next record

pToMx‖Moves the current form to the next record.

23Xpn‖Last record

3DAQp‖Moves the current form to the last record.

8xueP‖Save record

8XkBs‖Saves the current record, if necessary.

ed9VQ‖Undo data entry

uUDd5‖Reverses the changes in the current record.

q8zAf‖New record

FAxaD‖Moves the current form to the insert row.

UaEeA‖Delete record

YUcQ7‖Deletes the current record.

bNC7E‖Refresh form

uqZBH‖Reloads the most recently saved version of the current form.


FbjBr‖Enabled

ag5GD‖If a control field has the property "Enabled" (Yes), the form user can use the control field. Otherwise (No), it is disabled and greyed out.

FjoMi‖Default status

CR6ZA‖Specifies whether an option or a check box is selected by default.

ZfKGq‖For a reset type button, you can define the status of the control if the reset button is activated by the user.

9XWcE‖For grouped option fields, the status of the group corresponding to the default setting is defined by the "Default Status" property.

FnSGh‖Visible size

TRP7n‖Specifies the size of scrollbar thumb in "value units". A value of ("Scroll value max." minus "Scroll value min." ) / 2 would result in a thumb which occupies half of the background area.

bAKD9‖If set to 0, then the thumb's width will equal its height.

G25Gx‖Default scroll value

jyGFB‖Sets the default value for the scrollbar.

GUvSA‖Strict format

tegwy‖You can have a format check with control fields that accept formatted contents (date, time, and so on). If the strict format function is activated (Yes), only the allowed characters are accepted. For example, in a date field, only numbers or date delimiters are accepted; all alphabet entries typed with your keyboard are ignored.

GeweC‖Text lines end with

u95W9‖For text fields, select the line end code to be used when writing text into a database column.

GgFDL‖Navigation

Dhu48‖Specifies to show or hide the navigation items in a selected Navigation bar control. Navigation items are the following: First record, Previous record, Next record, Last record.

GtGBH‖Prefix symbol

44gDj‖Determines if the currency symbol is displayed before or after the number when using currency fields. The default setting is currency symbols are not prefixed.

Gwrav‖Time min

RYEo4‖ Determines the minimum time that a user can enter.

HWKMj‖Navigation bar

SV979‖Specifies whether to display the Navigation bar on the lower border of the table control.

JTJFz‖Toggle

7vvK2‖Specifies if a Push button behaves as a Toggle Button. If you set Toggle to "Yes", you can switch between the "selected" and "not selected" control states when you click the button or press the Spacebar while the control has the focus. A button in the "selected" state appears "pressed in".

KaYwC‖Large change

xxwcp‖Specify the value to add or subtract when the user clicks next to the slider on the scrollbar.

MCzAE‖Scrollbar

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

R2hCy‖Help text

4dShE‖Provides the option of entering a help text that will be displayed as a tip on the control. The tip shows the text in user mode when the mouse is moved over the control.

J8vXr‖For URL type buttons, the help text appears as the extended tip instead of the URL address entered under URL.

RaCDi‖Default text

Pu7Cr‖Sets the default text for a text box or a combo box.

Rmc37‖Dropdown

vsFj2‖ A control field with the dropdown property has an additional arrow button which opens the list of the existing form entries per mouse click. Under Line count, you can specify how many lines (or rows) should be displayed in the dropdown state. Combination fields can have the dropdown property.

Jhjcy‖Combo boxes that were inserted as columns in a table control are always dropdown as the default.

Rr2Dv‖Record marker

xWjjz‖Specifies whether the first column is displayed with row labels, in which the current record is marked by an arrow.

TADLv‖Repeat

cWS7E‖Specifies if the action of a control such as a spin button repeats when you click the control and hold the mouse button down.

TMrYf‖Value

cSNbG‖ In a hidden control, under Value, you can enter the data which is inherited by the hidden control. This data will be transferred when sending the form.

Vmytb‖Background color

N7AFb‖ A background color is available for most control fields. If you click on Background color, a list will open which enables you to select among various colors. The "Standard" option adopts the system setting. If the desired color is not listed, click the ... button to define a color in the Color dialog.

W24yw‖Tab order

zDMXA‖The "Tab order" property determines the order in which the controls are focused in the form when you press the Tab key. In a form that contains more than one control, the focus moves to the next control when you press the Tab key. You can specify the order in which the focus changes with an index under "Tab order".

note

PcEAx‖The "Tab order" property is not available to Hidden Controls. If you want, you can also set this property for image buttons and image controls, so that you can select these controls with the Tab key.


j4nyL‖When creating a form, an index is automatically assigned to the control fields that are added to this form; every control field added is assigned an index increased by 1. If you change the index of a control, the indices of the other controls are updated automatically. Elements that cannot be focused ("Tabstop = No") are also assigned a value. However, these controls are skipped when using the Tab key.

bTZRR‖You can also easily define the indices of the different controls in the Tab Order dialog.

WgKUY‖Literal mask

o8cDJ‖ With masked fields you can specify a literal mask. A literal mask contains the initial values of a form, and is always visible after downloading a form. Using a character code for the Edit mask, you can determine the entries that the user can type into the masked field.

note

MGsXr‖The length of the literal mask should always correspond to the length of the edit mask. If this is not the case, the edit mask is either cut off or filled with blanks up to the length of the edit mask.


WhdNX‖Scroll value min.

KkkV7‖Specify the minimum value of a scrollbar control.

WmA5A‖Width

6FoM4‖Defines the width of the control.

YjMsq‖PositionX

VKkSV‖Defines the X position of the control, relative to the anchor.

YvfaQ‖Tabstop

Cannw‖The "Tabstop" property determines if a control field can be selected with the Tab key. The following options are available:

GSRYx‖No

6gQsE‖When using the Tab key, focusing skips the control.

vGMU7‖Yes

RCwr9‖The control can be selected with the Tab key.


fa4YG‖

aENQR‖Text type

Q5xQ3‖Allows you to use line breaks and formatting in a control field, such as a text box or label. To manually enter a line break, press the Enter key. Select "Multi-line with formatting" to enter formatted text.

warning

UAsCt‖If you select the text type "Multi-line with formatting", you cannot bind this control to a database field.


note

JjJPM‖This control is named "Multiline input" for a text column inside a table control.


ao2mE‖Value min

2dgC6‖ For numerical and currency fields you can determine a minimum value to prevent the user from entering a smaller value.

bYzrC‖Time format

2jDsb‖You can define the desired format for the time display.

bm2rA‖Positioning

iMMMF‖Specifies to show or hide the positioning items in a selected Navigation bar control. Positioning items are the following: Record label, Record position, Record count label, Record count.

bpPFF‖Value max

NTXd5‖ For numerical and currency fields, you can determine the maximum value that the user can enter.

c2jpL‖Border

U942j‖ With control fields that have a frame, you can determine the border display on the form using the "Border" property. You can select among the "Without frame", "3-D look" or "Flat" options.

c7NuT‖Row height

Ca5UC‖ In table controls, enter a value for the row height. If you want, you can enter a value followed by valid measurement unit, for example, 2 cm.

cQY2E‖Default button

t8Dmt‖The "Default button" property specifies that the corresponding button will be operated when you press the Return key. If you open the dialog or form and do not carry out any further action, the button with this property is the default button.

note

4qXNR‖This property should be assigned only to a single button within the document.


dFCEw‖When using Web page forms, you might come across this property in search masks. These are edit masks that contain a text field and a Submit type button. The search term is entered in the text field and the search is started by activating the button. If the button is defined as the default button, however, simply hit Enter after entering the search term in order to start the search.

cxAEF‖Read-only

MJEuK‖ The "Read-only" property can be assigned to all controls in which the user can enter text. If you assign the read-only property to an image field which uses graphics from a database, the user will not be able to insert new graphics into the database.

eoKqZ‖Spin Button

CWgEx‖ Numerical fields, currency fields, date and time fields can be introduced as spin buttons in the form.

fDQ78‖Border color

eGv4b‖Specifies the border color for controls that have the "Border" property set to "flat".

fP6QW‖Label field

jYExC‖Specifies the source for the label of the control. The text of the label field will be used instead of the name of a database field. For example, in the Filter Navigator, Search dialog, and as a column name in the table view.

VU4uz‖To define one character of the label as a mnemonic, so that the user can access this control by pressing the character on the keyboard, insert a tilde (~) character in front of the character in the label.

GvEcp‖Only the text of a group frame can be used as the label field when using radio buttons. This text applies to all of the radio buttons of the same group.

tyTGF‖If you click on the ... button next to the text field, you will see the Label Field Selection dialog. Select a label from the list.

NQB8A‖Check the No assignment box to remove the link between a control and the assigned label field.

gNubd‖Height

fvJvH‖Defines the height of the control.

hrGjz‖Decimal accuracy

LwCoA‖ With numerical and currency fields you can determine the number of digits displayed to the right of the decimal point.

hxJVk‖Default value

EKBJP‖Sets the default value for the control field. For example, the default value will be entered when a form is opened.

gfCP8‖For a Reset type button, the Default value entry defines the status of the control if the reset button is activated by the user.

ipubB‖Tristate

R3bCQ‖Specifies whether a check box can also represent ZERO values of a linked database apart from the TRUE and FALSE values. This function is only available if the database accepts three states: TRUE, FALSE and ZERO.

note

7r799‖The "Tristate" property is only defined for database forms, not for HTML forms.


irNhJ‖Password characters

HLnwV‖ If the user enters a password, you can determine the characters that will be displayed instead of the characters typed by the user. Under Password character, enter the ASCII code of the desired character. You can use the values from 0 to 255.

tip

P56Dk‖The characters and their ASCII codes can be seen in the Special Characters dialog (Insert - Special Character).


ixrih‖Time max

7jAmQ‖ Determines a time which can not be exceeded by another value introduced by the user.

jBMd3‖Printable

FE6DC‖Specifies whether you want the control field to appear in a document's printout.

jNMGe‖Date max

ECbFj‖ Determines a date which can not be exceeded by another value introduced by the user.

kgFJg‖Edit mask

FwMNe‖Defines the edit mask. By specifying a character code you can determine what the user can enter in the control field. By specifying the character code in pattern fields, you can determine what the user can enter in the pattern field.

CihFD‖The length of the edit mask determines the number of the possible input positions. If the user enters characters that do not correspond to the edit mask, the input is rejected when the user leaves the field.

gGatc‖You can enter the following characters to define the edit mask:

9Z25D‖Character

kGk9w‖Meaning

L

KVYC5‖A text constant. This position cannot be edited. The character is displayed at the corresponding position of the Literal Mask.

a

X2Fet‖The characters a-z and A-Z can be entered. Capital characters are not converted to lowercase characters.

A

MBwus‖The characters A-Z can be entered. If a lowercase letter is entered, it is automatically converted to a capital letter.

c

REnSG‖The characters a-z, A-Z, and 0-9 can be entered. Capital characters are not converted to lowercase characters.

C

7wrCS‖The characters A-Z and 0-9 can be entered. If a lowercase letter is entered, it is automatically converted to a capital letter.

N

RFpdy‖Only the characters 0-9 can be entered.

x

yDGGq‖All printable characters can be entered.

X

ELnXb‖All printable characters can be entered. If a lowercase letter is entered, it is automatically converted to a capital letter.


EPpP8‖For the literal mask "__.__.2000", for example, define the "NNLNNLLLLL" edit mask so that the user can only enter four digits when entering a date.

kgZFR‖Visible

d4LsE‖Defines whether the control will be visible in live mode. In design mode, the control is always visible.

cnW2X‖Note that if this property is set to "Yes" (the default), this does not necessarily mean the control will really appear on the screen. Additional constraints are applied when calculating a control's effective visibility. For instance, a control placed in a hidden section in Writer will never be visible at all, until at least the section itself becomes visible.

DGqCx‖If the property is set to "No", then the control will always be hidden in live mode.

vXBkb‖Older OpenOffice.org versions up to 3.1 will silently ignore this property when reading documents which make use of it.

m2Ef9‖Name

iTT9E‖ Each control field and each form has a "Name" property through which it can be identified. The name will appear in the Form Navigator and, using the name, the control field can be referred to from a macro. The default settings already specify a name which is constructed from using the field's label and number.

note

MCCG9‖If you work with macros, make sure that the names of the controls are unique.


3utaZ‖

GBtsm‖The name is also used to group different controls that belong together functionally, such as radio buttons. To do so, give the same name to all members of the group: controls with identical names form a group. Grouped controls can be represented visually by using a Group Box.

p4FqD‖Anchor

iCxXo‖Defines where the control will be anchored.

pEceD‖Style

5EFi4‖Specifies whether Check boxes and Option buttons are displayed in a 3D look (default) or a flat look.

pyhET‖Alignment / Graphics alignment

ieJgt‖ The alignment options are left-aligned, right-aligned, and centered. These options are available for the following elements:

  1. 6UGxE‖Title of Label fields,

  2. ZeUGz‖Content of text fields,

  3. nn8WE‖Content of table fields in the columns of a table control,

  4. G9RZn‖Graphics or text that are used in buttons.

    note

    TD5C4‖The Alignment option for buttons is called Graphics alignment.


qUkQm‖Symbol color

CaKVw‖Specifies the color for symbols on controls, for example the arrows on a scrollbar.

rBmAR‖Orientation

xedS5‖Specifies the horizontal or vertical orientation for a scrollbar or spin button.

tYDLf‖Line count

EvPKm‖ For combo boxes with the "Dropdown" property, you can specify how many lines should be displayed in the dropdown list. With control fields which do not have the Dropdown option, the line's display will be specified by the size of the control field and the font size.

trt9n‖Date min

WKnRH‖ Determines the earliest date that a user can enter.

ueTAm‖URL

Liomr‖ Enter the URL address for a Open document or web page button type in the URL box. The address opens when you click the button.

RGFV3‖If you move the mouse over the button in User mode, the URL appears as the extended tip, provided that no other Help text was entered.

vhduq‖Default selection

pcEku‖Specifies the list box entry to mark as the default entry.

RAEyY‖For a Reset type button, the Default selection entry defines the status of the list box if the reset button is activated by the user.

cCCEt‖For a List box that contains a value list, you can click the ... button to open the Default selection dialog.

7JzPY‖In the Default selection dialog, select the entries that you want to mark as selected when you open the form that contains the list box.

wS8qb‖Label

SJbPM‖The "Label" property sets the label of the control field that is displayed in the form. This property determines the visible label or the column header of the data field in table control forms.

wxACC‖When you create a new control, the description predefined in the "Name" property is used as the default for labeling the control. The label consists of the control field name and an integer numbering the control (for example, CommandButton1). With the "Title" property, you can assign another description to the control so that the label reflects the function of the control. Change this entry in order to assign an expressive label to the control that is visible to the user.

yAFjM‖

hGZx9‖To create a multi-line title, open the combo box using the Arrow button. You can enter a line break by pressing Shift++Enter.

note

D9jDp‖The "Title" property is only used for labeling a form element in the interface visible to the user. If you work with macros, note that at runtime, a control is always addressed through the "Name" property.


wTGr8‖Max text length

f3g43‖ For text and combo boxes, you can define the maximum number of characters that the user can enter. If this control field property is uncertain, the default setting will be zero.

TUFDf‖If the control is linked to a database and the text length is to be accepted from the field definition of the database, you must not enter the text length here. The settings are only accepted from the database if the control property was not defined ("Not Defined" state).

wgmCA‖Value step

qRFCY‖ You can preset the value intervals for numerical and currency spin buttons. Use the up and down arrows of the spin button to increase or decrease the value.

wzQaF‖Help text

AJEQZ‖ In each control field you can specify additional information or a descriptive text for the control field. This property helps the programmer to save additional information that can be used in the program code. This field can be used, for example, for variables or other evaluation parameters.

xMsFS‖Thousands separator

R5ApE‖ With numerical and currency fields you can determine whether thousands separators are used.

y6Tc9‖Currency symbol

wFk7Q‖ In a currency field, you can predefine the currency symbol by entering the character or string in the "Currency symbol" property.

z4BNm‖Word break

GEFfK‖Displays text on more than one line. Allows you to use line breaks in a text box, so that you can enter more than one line of text. To manually enter a line break, press Enter.

zPXcv‖Scale

ryF5J‖Resizes the image to fit the size of the control.