From bc08ccfcaab7ce88b2d705e9caaed00c767925aa Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Sophia=20Schr=C3=B6der?= Date: Sat, 9 Jun 2018 22:19:40 +0200 Subject: [PATCH] Cleanups and improvements in /shared/02/011701*.xhp files Change-Id: I543d70dbf830119432af0db179ac8489e8717c52 Reviewed-on: https://gerrit.libreoffice.org/55538 Tested-by: Jenkins Reviewed-by: Olivier Hallot --- source/text/shared/02/01170100.xhp | 141 ++-- source/text/shared/02/01170101.xhp | 1213 ++++++++++++++-------------- source/text/shared/02/01170102.xhp | 1172 +++++++++++++-------------- source/text/shared/02/01170103.xhp | 73 +- 4 files changed, 1279 insertions(+), 1320 deletions(-) diff --git a/source/text/shared/02/01170100.xhp b/source/text/shared/02/01170100.xhp index c08b3886ea..e0cc455589 100644 --- a/source/text/shared/02/01170100.xhp +++ b/source/text/shared/02/01170100.xhp @@ -1,6 +1,5 @@ - - + - - + - -Control Properties -/text/shared/02/01170100.xhp - - -Sun Microsystems, Inc. - + + Control Properties + /text/shared/02/01170100.xhp + + + Sun Microsystems, Inc. +
@@ -38,76 +36,73 @@ Control Properties -Opens a dialog for editing the properties of a selected control. - + Opens a dialog for editing the properties of a selected control.
-You can only call the Properties dialog when in the Design mode with a control selected. - +You can only call the Properties dialog when in the Design mode with a control selected.
If you enter data in the Properties dialog, note that multiline input is possible for certain drop-down combo boxes. This concerns all fields in which an SQL statement can be entered, as well as the properties of text boxes or label fields. You can open these fields and enter text in the opened list. The following shortcut keys are valid: - - -Keys - - -Effects - - - - -OptionAlt+Down Arrow - - -Opens the combo box - - - - -OptionAlt+Up Arrow - - -Closes the combo box - - - - -Shift+Enter - - -Inserts a new line. - - - - -Up Arrow - - -Places the cursor into the previous line. - - - - -Down Arrow - - -Places the cursor into the next line. - - - - -Enter - - -Completes the input in the field and places the cursor into the next field. - - + + + Keys + + + Effect + + + + + OptionAlt+Down Arrow: + + + Opens the combo box. + + + + + OptionAlt+Up Arrow: + + + Closes the combo box. + + + + + Shift+Enter + + + Inserts a new line. + + + + + Up Arrow + + + Places the cursor into the previous line. + + + + + Down Arrow + + + Places the cursor into the next line. + + + + + Enter + + + Completes the input in the field and places the cursor into the next field. + +
- -As with list boxes or combo boxes, you can open or close the list with a mouse click at the arrow on the right end of the field. However, the input here can be entered either in the opened list or in the top text field. An exception is the properties that expect a list representation, for example, the property List Entries, which can be set for the control fields List Box and Combo Box. Here, you can only edit the entries when the field is opened. +As with list boxes or combo boxes, you can open or close the list with a mouse click at the arrow on the right end of the field. However, the input here can be entered either in the opened list or in the top text field. An exception is the properties that expect a list representation, for example, the property "List Entries", which can be set for the control fields List Box and Combo Box. Here, you can only edit the entries when the field is opened.
diff --git a/source/text/shared/02/01170101.xhp b/source/text/shared/02/01170101.xhp index 5f0150580a..bdcc091f9e 100644 --- a/source/text/shared/02/01170101.xhp +++ b/source/text/shared/02/01170101.xhp @@ -1,6 +1,5 @@ - - - - General - /text/shared/02/01170101.xhp - - - -
- GeneralUFI: had to remove all internal links to this file because all the targets vanished and no time to reinsert them all -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. -
-
- -
- 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). + + General + /text/shared/02/01170101.xhp + + + +
+GeneralUFI: had to remove all internal links to this file because all the targets vanished and no time to reinsert them all + 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. +
+
+ +
+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).
Enabled - If a control field has the property "Enabled" (Yes), the form user will be able to use the control field. If the property is disabled, it will not be enabled (No) and will be displayed in a gray color. -
-
+ If a control field has the property "Enabled" (Yes), the form user will be able to use the control field. If the property is disabled, it will not be enabled (No) and will be displayed in a gray color. +
+
Line count - Specifies how many lines should be displayed in the dropdown list. This setting is only active if you chose "Yes" in the "Dropdown" option. 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. -
-
+ Specifies how many lines should be displayed in the dropdown list. This setting is only active if you chose "Yes" in the Dropdown option. 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. +
+
ActionUFI: renamed from Button type to Action, see dba.features: Form navigation functionality for command buttons - The Action property determines the action that occurs when you activate a button. You can use navigation actions to design your own database navigation buttons. - The following table describes the actions that you can assign to a button. - - - - Action - - - Description - - - - - None - - - No action occurs. - - - - - Submit form - - - 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. - Enter the URL into the form's data property "URL" text box when you export to a PDF file.UFI: see #i36574# - - - - - Reset form - - - Resets the settings in other control fields to the predefined defaults (Default Status, Default Selection, Default Value). - - - - - Open document / web page - - - Opens the URL that is specified under URL. You can use Frame to specify the target frame. - - - - - First record - - - Moves the current form to the first record. - - - - - Previous record - - - Moves the current form to the previous record. - - - - - Next record - - - Moves the current form to the next record. - - - - - Last record - - - Moves the current form to the last record. - - - - - Save record - - - Saves the current record, if necessary. - - - - - Undo data entry - - - Reverses the changes in the current record. - - - - - New record - - - Moves the current form to the insert row. - - - - - Delete record - - - Deletes the current record. - - - - - Refresh form - - - Reloads the most recently saved version of the current form. - - -
- -
-
+ The "Action" property determines the action that occurs when you activate a button. You can use navigation actions to design your own database navigation buttons. +The following table describes the actions that you can assign to a button: + + + + Action + + + Description + + + + + None + + + No action occurs. + + + + + Submit form + + + 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. + Enter the URL into the form's data property "URL" text box when you export to a PDF file.UFI: see #i36574# + + + + + Reset form + + + Resets the settings in other control fields to the predefined defaults: Default Status, Default Selection, Default Value. + + + + + Open document / web page + + + Opens the URL that is specified under URL. You can use Frame to specify the target frame. + + + + + First record + + + Moves the current form to the first record. + + + + + Previous record + + + Moves the current form to the previous record. + + + + + Next record + + + Moves the current form to the next record. + + + + + Last record + + + Moves the current form to the last record. + + + + + Save record + + + Saves the current record, if necessary. + + + + + Undo data entry + + + Reverses the changes in the current record. + + + + + New record + + + Moves the current form to the insert row. + + + + + Delete record + + + Deletes the current record. + + + + + Refresh form + + + Reloads the most recently saved version of the current form. + + +
+
+
Dropdown - Specifies whether the combo box should dropdown (Yes) or not (No). 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. - Combo boxes that were inserted as columns in a table control are always dropdown as the default. -
-
+ Specifies whether the combo box should dropdown (Yes) or not (No). 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. + Combo boxes that were inserted as columns in a table control are always dropdown as the default. +
+
Alignment / Graphics alignment - Specifies the alignment option for text or graphics that are used on a control. The alignment options are left-aligned, right-aligned, and centered. These options are available for the following elements: - - - Title of Label fields - - - Content of text fields - - - Content of table fields in the columns of a table control - - - Graphics or text that are used in buttons - The Alignment option for buttons is called Graphics alignment. - - -
-
+Specifies the alignment option for text or graphics that are used on a control. The alignment options are left-aligned, right-aligned, and centered. These options are available for the following elements: + + + Title of Label fields, + + + Content of text fields, + + + Content of table fields in the columns of a table control, + + + Graphics or text that are used in buttons. + The Alignment option for buttons is called Graphics alignment. + + +
+
AutoFill - Assigns the AutoFill function to a combo box. The AutoFill function displays a list of previous entries after you start to type an entry.UFI: changed AutoComplete to AutoFill (got changed by error in the UI, so we stay with it now, according to FS) -
-
+ Assigns the AutoFill function to a combo box. The AutoFill function displays a list of previous entries after you start to type an entry.UFI: changed AutoComplete to AutoFill (got changed by error in the UI, so we stay with it now, according to FS) +
+
Label field - 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. - 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. - 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. - 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. -Check the No assignment box to remove the link between a control and the assigned label field. -
-
+ 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. + 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. + 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. + 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. + Check the No assignment box to remove the link between a control and the assigned label field. +
+
Width - Sets the column width in the table control field. Sets the column width in the table control field in the units that are specified in the %PRODUCTNAME module options. If you want, you can enter a value followed by a valid measurement unit, for example, 2 cm. -
-
+ Sets the column width in the table control field. Sets the column width in the table control field in the units that are specified in the %PRODUCTNAME module options. If you want, you can enter a value followed by a valid measurement unit, for example, 2 cm. +
+
RepeatUFI: see spec spinbutton_form_control.sxw - Specifies if the action of a control such as a spin button repeats when you click the control and hold the mouse button down. -
-
+ Specifies if the action of a control such as a spin button repeats when you click the control and hold the mouse button down. +
+
Delay - 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. -
-
+ 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. +
+
Record marker - Specifies whether the first column is displayed with row labels, in which the current record is marked by an arrow. -
-
+ Specifies whether the first column is displayed with row labels, in which the current record is marked by an arrow. +
+
Date format - Here, you can determine the format you want for the date readout. With date fields you can determine the format for the date readout. - 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. - -
-
+ Here you can determine the format you want for the date readout. With date fields you can determine the format for the date readout. + 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. +
+
Spin Button - The "Yes" option transforms the control field into a spin button, where corresponding arrow buttons are added. Numerical fields, currency fields, date and time fields can be introduced as spin buttons in the form. -
-
+ The "Yes" option transforms the control field into a spin button, where corresponding arrow buttons are added. Numerical fields, currency fields, date and time fields can be introduced as spin buttons in the form. +
+
Tristate - 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. - The Tristate property is only defined for database forms, not for HTML forms. -
-
+ 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. + The "Tristate" property is only defined for database forms, not for HTML forms. +
+
Printable - Specifies whether you want the control field to appear in a document's printout. -
-
+ Specifies whether you want the control field to appear in a document's printout. +
+
PositionX - Defines the X position of the control, relative to the anchor. -
-
+ Defines the X position of the control, relative to the anchor. +
+
PositionY - Defines the Y position of the control, relative to the anchor. -
-
+ Defines the Y position of the control, relative to the anchor. +
+
Anchor - Defines where the control will be anchored. -
-
+ Defines where the control will be anchored. +
+
Width - Defines the width of the control. -
-
+ Defines the width of the control. +
+
Height - Defines the height of the control. -
-
+ Defines the height of the control. +
+
Edit mask - 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. - 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. You can enter the following characters to define the edit mask: - - - - Character - - - Meaning - - - - - L - - - A text constant. This position cannot be edited. The character is displayed at the corresponding position of the Literal Mask. - - - - - a - - - The characters a-z and A-Z can be entered. Capital characters are not converted to lowercase characters. - - - - - A - - - The characters A-Z can be entered. If a lowercase letter is entered, it is automatically converted to a capital letter - - - - - c - - - The characters a-z, A-Z, and 0-9 can be entered. Capital characters are not converted to lowercase characters. - - - - - C - - - 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 - - - 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. - - -
- - 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. -
-
+ 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. + 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. You can enter the following characters to define the edit mask: + + + + Character + + + Meaning + + + + + L + + + A text constant. This position cannot be edited. The character is displayed at the corresponding position of the Literal Mask. + + + + + a + + + The characters a-z and A-Z can be entered. Capital characters are not converted to lowercase characters. + + + + + A + + + The characters A-Z can be entered. If a lowercase letter is entered, it is automatically converted to a capital letter. + + + + + c + + + The characters a-z, A-Z, and 0-9 can be entered. Capital characters are not converted to lowercase characters. + + + + + C + + + 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 + + + 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 entered, it is automatically converted to a capital letter. + + +
+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. +
+
Strict format - 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. -
-
+ 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. +
+
Frame - Specifies the target frame to display the document that is opened by the "Open document / web page" action. You can also specify the target frame to display a URL that you open when you click a button that has been assigned the Open document or web page action). -
- If you click the field, you can select an option from the list that specifies into which frame the next document should be loaded. The following possibilities exist: - - - - Entry - - - Meaning - - - - - _blank - - - The next document is created in a new empty frame. - - - - - _parent - - - The next document is created in a parent frame. If no parent exists, the document is created in the same frame. - - - - - _self - - - The next document is created in the same frame. - - - - - _top - - - The next document is created in a top-level window, that is, in the highest frame of the hierarchy; if the current frame is already a top window, the document is created in the current frame. - - -
- -
- The Frame property is relevant for HTML forms, but not for database forms. -
-
+ Specifies the target frame to display the document that is opened by the "Open document / web page" action. You can also specify the target frame to display a URL that you open when you click a button that has been assigned to the "Open document or web page" action. +
+If you click the field, you can select an option from the list that specifies into which frame the next document should be loaded. The following possibilities exist: + + + + Entry + + + Meaning + + + + + _blank + + + The next document is created in a new empty frame. + + + + + _parent + + + The next document is created in a parent frame. If no parent exists, the document is created in the same frame. + + + + + _self + + + The next document is created in the same frame. + + + + + _top + + + The next document is created in a top-level window, that is, in the highest frame of the hierarchy; if the current frame is already a top window, the document is created in the current frame. + + +
+
+ The "Frame" property is relevant for HTML forms, but not for database forms. +
+
Graphics - 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. -
-
+ 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. +
+
Help text - 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. - For URL type buttons, the help text appears as the extended tip instead of the URL address entered under URL. -
-
+ 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. + For URL type buttons, the help text appears as the extended tip instead of the URL address entered under URL. +
+
Help URL - 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. -
-
+ 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. +
+
Background color - Sets the background color of the control field. 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. -
-
+ Sets the background color of the control field. 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. +
+
Scrollbar - Adds the scrollbar type that you specify to a text box. Adds the scrollbar type that you specify to a text box. -
-
+ Adds the scrollbar type that you specify to a text box. Adds the scrollbar type that you specify to a text box. +
+
Incr./decrement value - Determines intervals to add or subtract with each activation of the spin button control. -
-
+ Determines intervals to add or subtract with each activation of the spin button control. +
+
Value step - Determines spin button intervals. 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. -
-
+ Determines spin button intervals. 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. +
+
List entries - Defines the list entries visible in the document. Open this list and type your text. Use Shift+Enter for a new line. With list and combo boxes, you can define the list entries that will be visible in the document. Open the List entries field and type your text. Please note the tips referring to the keyboard controls. - The predefined default list entry is entered into the Default selection combo box. - 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. - 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. - 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. -
-
+ Defines the list entries visible in the document. Open this list and type your text. Use Shift+Enter for a new line. With list and combo boxes, you can define the list entries that will be visible in the document. Open the List entries field and type your text. Please note the tips referring to the keyboard controls. + The predefined default list entry is entered into the Default selection combo box. + 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. + 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. + 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. +
+
Date max - Determines a date which can not be exceeded by another value introduced by the user. Determines a date which can not be exceeded by another value introduced by the user. -
-
+ Determines a date which can not be exceeded by another value introduced by the user. Determines a date which can not be exceeded by another value introduced by the user. +
+
Max text length - Defines the maximum number of characters that the user can enter. 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. - 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). -
-
+ Defines the maximum number of characters that the user can enter. 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. + 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). +
+
Value max - Defines a value for the control field which can not be exceeded by another value introduced by the user. For numerical and currency fields, you can determine the maximum value that the user can enter. -
-
+ Defines a value for the control field which can not be exceeded by another value introduced by the user. For numerical and currency fields, you can determine the maximum value that the user can enter. +
+
Time max - Determines a time which can not be exceeded by another value introduced by the user. Determines a time which can not be exceeded by another value introduced by the user. -
-
+ Determines a time which can not be exceeded by another value introduced by the user. Determines a time which can not be exceeded by another value introduced by the user. +
+
Multiselection - Allows you to select more than one item in a list box. Allows you to select more than one item in a list box. -
-
-rich text control - controls;rich text control + Allows you to select more than one item in a list box. Allows you to select more than one item in a list box. +
+
+ +rich text control +controls; rich text control Text typeUFI: now renamed to Text Type, see #i24386#UFI: see dba spec prop_browser_enhancements.sxw - 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. - If you select the text type "Multi-line with formatting", you cannot bind this control to a database field. - This control is named "Multiline input" for a text column inside a table control. -
-
+ 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. + If you select the text type "Multi-line with formatting", you cannot bind this control to a database field. + This control is named "Multiline input" for a text column inside a table control. +
+
Word breakUFI: see dba spec form_controls_interop_1.sxw - 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 the Enter key. -
-
+ 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. +
+
ToggleUFI: see dba spec form_controls_interop_1.sxw - 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". -
-
+ 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". +
+
Take Focus on ClickUFI: see dba spec form_controls_interop_1.sxw - If you set this option to "Yes", the Push Button receives the focus when you click the button. -
-
+ If you set this option to "Yes", the Push button receives the focus when you click the button. +
+
Hide selectionUFI: see dba spec form_controls_interop_1.sxw - Specifies whether a text selection on a control remains selected when a 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. -
-
+ Specifies whether a text selection on a control remains selected when a 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. +
+
StyleUFI: see dba spec form_controls_interop_1.sxw - Specifies whether Check boxes and Option buttons are displayed in a 3D look (default) or a flat look. -
-
+ Specifies whether Check boxes and Option buttons are displayed in a 3D look (default) or a flat look. +
+
Border colorUFI: see dba spec form_controls_interop_1.sxw - Specifies the border color for controls that have the Border property set to "flat". -
-
+ Specifies the border color for controls that have the "Border" property set to "flat". +
+
Symbol color - Specifies the color for symbols on controls, for example the arrows on a scrollbar. -
-
+ Specifies the color for symbols on controls, for example the arrows on a scrollbar. +
+
Date min - Determines the earliest date that a user can enter. Determines the earliest date that a user can enter. -
-
+ Determines the earliest date that a user can enter. Determines the earliest date that a user can enter. +
+
Value min - You can determine here a value for the control field to prevent the user from entering a smaller value. For numerical and currency fields you can determine a minimum value to prevent the user from entering a smaller value. -
-
+ You can determine here a value for the control field to prevent the user from entering a smaller value. For numerical and currency fields you can determine a minimum value to prevent the user from entering a smaller value. +
+
Time min - Determines the minimum time that a user can enter. Determines the minimum time that a user can enter. -
-
+ Determines the minimum time that a user can enter. Determines the minimum time that a user can enter. +
+
Decimal accuracy - Determines the number of digits displayed to the right of the decimal point. With numerical and currency fields you can determine the number of digits displayed to the right of the decimal point. -
-
+ Determines the number of digits displayed to the right of the decimal point. With numerical and currency fields you can determine the number of digits displayed to the right of the decimal point. +
+
Name - On the Properties tab page, this option specifies the name for the control field. On the Form Properties tab page, this option specifies the name for the form. 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. - If you work with macros, make sure that the names of the controls are unique. -controls; grouping - groups;of controls - forms; grouping controls + On the Properties tab page, this option specifies the name for the control field. On the Form Properties tab page, this option specifies the name for the form. 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. +If you work with macros, make sure that the names of the controls are unique. + +controls; grouping +groups; of controls +forms; grouping controls mw changed "grouping;" to "groups;" -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. -
-
+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. +
+
Navigation bar - Specifies whether to display the navigation bar on the lower border of the table control. Specifies whether to display the navigation bar on the lower border of table controls. -
-
+ Specifies whether to display the Navigation bar on the lower border of the table control. Specifies whether to display the Navigation bar on the lower border of table controls. +
+
Read-only - Determines if the control is read-only (Yes) or if it can be edited (No). 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. -
-
+ Determines if the control is read-only ("Yes") or if it can be edited ("No"). 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. +
+
Border - Determines if the field's border should be displayed "Without frame", with a "3-D look" or "Flat". 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. -
-
+ Determines if the field's border should be displayed "Without frame", with a "3-D look" or "Flat". 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. +
+
Tab order - 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. - 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. - 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. - You can also easily define the indices of the different controls in the Tab Order dialog. -
-
+ 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". + 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. + 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. + You can also easily define the indices of the different controls in the Tab Order dialog. +
+
Mouse wheel scroll - 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. -
-
+ 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. +
+
Default status - Specifies whether an option or a check box is selected by default. - For a reset type button, you can define the status of the control if the reset button is activated by the user. - For grouped option fields, the status of the group corresponding to the default setting is defined by the Default Status property.UFI: what does this mean? Cannot understand that sentence. -
-
+ Specifies whether an option or a check box is selected by default. + For a reset type button, you can define the status of the control if the reset button is activated by the user. + For grouped option fields, the status of the group corresponding to the default setting is defined by the "Default Status" property.UFI: what does this mean? Cannot understand that sentence. +
+
Default selection - Specifies the list box entry to mark as the default entry. Specifies the list box entry to mark as the default entry. - 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. - For a List box that contains a value list, you can click the ... button to open the Default selection dialog. - 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. -
-
+ Specifies the list box entry to mark as the default entry. Specifies the list box entry to mark as the default entry. + 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. + For a List box that contains a value list, you can click the ... button to open the Default selection dialog. + 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. +
+
Default value - Sets the default value for the control field. For example, the default value will be entered when a form is opened. - For a Reset type button, the Default value entry defines the status of the control if the reset button is activated by the user. -
-
+ Sets the default value for the control field. For example, the default value will be entered when a form is opened. + For a Reset type button, the Default value entry defines the status of the control if the reset button is activated by the user. +
+
Default scroll value - Sets the default value for the scrollbar. -
-
+ Sets the default value for the scrollbar. +
+
Scroll value max. - Specify the maximum value of a scrollbar control. -
-
+ Specify the maximum value of a scrollbar control. +
+
Scroll value min. - Specify the minimum value of a scrollbar control. -
-
+ Specify the minimum value of a scrollbar control. +
+
Small change - Specify the value to add or subtract when the user clicks the arrow icon on the scrollbar. -
-
+ Specify the value to add or subtract when the user clicks the Arrow icon on the scrollbar. +
+
Large change - Specify the value to add or subtract when the user clicks next to the slider on the scrollbar. -
-
+ Specify the value to add or subtract when the user clicks next to the slider on the scrollbar. +
+
Default time - Sets the default time. -
-
+ Sets the default time. +
+
Default date - Sets the default date. -
-
+ Sets the default date. +
+
Default text - Sets the default text for a text box or a combo box. -
-
+ Sets the default text for a text box or a combo box. +
+
Default button - The Default button property specifies that the corresponding button will be operated when you press the Return key. 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. - This property should be assigned only to a single button within the document. - 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. -
-
+ The "Default button" property specifies that the corresponding button will be operated when you press the Return key. 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. + This property should be assigned only to a single button within the document. + 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. +
+
Prefix symbol - 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. -
-
+ 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. +
+
Tabstop - The Tabstop property determines if a control field can be selected with the tab key. The following options are available:UFI: Default entry row deleted from table - - - - No - - - When using the tab key, focusing skips the control. - - - - - Yes - - - The control can be selected with the Tab key. - - -
- -
-
+ The "Tabstop" property determines if a control field can be selected with the Tab key. The following options are available:UFI: Default entry row deleted from table + + + + No + + + When using the Tab key, focusing skips the control. + + + + + Yes + + + The control can be selected with the Tab key. + + +
+
+
Thousands separator - Inserts a thousands separator. With numerical and currency fields you can determine whether thousands separators are used. -
-
+ Inserts a thousands separator. With numerical and currency fields you can determine whether thousands separators are used. +
+
Label - The Label property sets the label of the control field that is displayed in the form. 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. - 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. -multi-line titles in forms - names; multi-line titles - controls; multi-line titles + The "Label" property sets the label of the control field that is displayed in the form. 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. + 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. + +multi-line titles in forms +names; multi-line titles +controls; multi-line titles -To create a multi-line title, open the combo box using the arrow button. You can enter a line break by pressing Shift+Command -Ctrl+Enter. - 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. -
-
+To create a multi-line title, open the combo box using the Arrow button. You can enter a line break by pressing Shift+CommandCtrl+Enter. +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. +
+
URL - Specifies the URL address that opens when you click an "Open document / web page" button. 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. - 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. -
-
+ Specifies the URL address that opens when you click an Open document / web page button. 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. + 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. +
+
Currency symbol - You can enter a character or a string for the currency symbol. In a currency field, you can pre-define the currency symbol by entering the character or string in the Currency symbol property. -
-
+ You can enter a character or a string for the currency symbol. In a currency field, you can predefine the currency symbol by entering the character or string in the "Currency symbol" property. +
+
Value - You can enter the data that is inherited by the hidden control. 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. -
-
+ You can enter the data that is inherited by the hidden control. 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. +
+
Password characters - If the text box is used as a password input, enter the ASCII-code of the display character. This character is displayed instead of the characters typed by the user for the password. 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. - The characters and their ASCII codes can be seen in the Special Characters dialog (Insert - Special Character). -
-
+ If the text box is used as a password input, enter the ASCII code of the display character. This character is displayed instead of the characters typed by the user for the password. 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. +The characters and their ASCII codes can be seen in the Special Characters dialog (Insert - Special Character). +
+
Literal mask - Defines the literal mask. The literal mask contains the initial values and is always visible after downloading a form. 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. - 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. -
-
+ Defines the literal mask. The literal mask contains the initial values and is always visible after downloading a form. 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. +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. +
+
FontUFI: dba.features "Character set property renamed to Font" - Select the font for the text that is in the control field. 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. -
-
+ Select the font for the text that is in the control field. 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. +
+
Row height - Specifies the row height of a table control field. 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. -
-
+ Specifies the row height of a table control field. 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. +
+
Text lines end with - For text fields, select the line end code to be used when writing text into a database column.UFI: spec dba-features: "form text fields: New property Text lines end with" -
-
+ For text fields, select the line end code to be used when writing text into a database column.UFI: spec dba-features: "form text fields: New property Text lines end with" +
+
Time format - You can define the desired format for the time display. You can define the desired format for the time display. -
-
+ You can define the desired format for the time display. You can define the desired format for the time display. +
+
Help text - Specifies additional information or a descriptive text for the control field. 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. -
-
+ Specifies additional information or a descriptive text for the control field. 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. +
+
Formatting - Specifies the format code for the control. Click the ... button to select the format code. -
-
+ Specifies the format code for the control. Click the ... button to select the format code. +
+
Scale - Resizes the image to fit the size of the control. -
-
+ Resizes the image to fit the size of the control. +
+
Acting on a record - 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. -
-
+ 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. +
+
Positioning - 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. -
-
+ 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. +
+
Navigation - 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. -
-
+ 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. +
+
-Filtering / Sorting - 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, Default filter, Apply filter, Reset filter/sort. -
-
+Filtering/Sorting + 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, Default filter, Apply filter, Reset filter/sort. +
+
Icon Size - Specifies whether the icons in a selected Navigation Bar should be small or large. -
-
+ Specifies whether the icons in a selected Navigation bar should be small or large. +
+
Visible - Defines whether the control will be visible in live mode. In design mode, the control is always visible. - 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. - If the property is set to "No", then the control will always be hidden in live mode. - Older OpenOffice.org versions up to 3.1 will silently ignore this property when reading documents which make use of it. -
-
+ Defines whether the control will be visible in live mode. In design mode, the control is always visible. + 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. + If the property is set to "No", then the control will always be hidden in live mode. + Older OpenOffice.org versions up to 3.1 will silently ignore this property when reading documents which make use of it. +
+
Visible size - 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. - If set to 0, then the thumb's width will equal its height. -
-
+ 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. + If set to 0, then the thumb's width will equal its height. +
+
Orientation - Specifies the horizontal or vertical orientation for a scrollbar or spin button. -
+ Specifies the horizontal or vertical orientation for a scrollbar or spin button. + diff --git a/source/text/shared/02/01170102.xhp b/source/text/shared/02/01170102.xhp index b61695a467..65664d9f0e 100644 --- a/source/text/shared/02/01170102.xhp +++ b/source/text/shared/02/01170102.xhp @@ -1,6 +1,5 @@ - - - + - -Data -/text/shared/02/01170102.xhp - + + Data + /text/shared/02/01170102.xhp +
@@ -37,687 +35,659 @@ controls;assigning data sources MW made "cells..." a two level entry, changed "linked cells;" to "links;" and "list contents" to "lists;" Data -The Data tab page allows you to assign a data source to the selected control. +The Data tab page allows you to assign a data source to the selected control.
- +
-For forms with database links, the associated database is defined in the Form Properties. You will find the functions for this on the Data tab page. -The possible settings of the Data tab page of a control depend on the respective control. You will only see the options that are available for the current control and context. The following fields are available: +For forms with database links, the associated database is defined in the Form Properties. You will find the functions for this on the Data tab page. +The possible settings of the Data tab page of a control depend on the respective control. You will only see the options that are available for the current control and context.
The following fields are available:
Reference value (off) -Check boxes and radio buttons in spreadsheets can be bound to cells in the current document. If the control is enabled, the value you enter in Reference value (on) is copied to the cell. If the control is disabled, the value from Reference value (off) is copied to the cell. + Check boxes and radio buttons in spreadsheets can be bound to cells in the current document. If the control is enabled, the value you enter in Reference value (on) is copied to the cell. If the control is disabled, the value from Reference value (off) is copied to the cell.
Reference value (on)UFI: moved section from 01170101, changed name -You can enter a reference value for the web form, which will be remitted to a server when sending the form. With database forms, the value entered is written in the database field, assigned to the control field. You can assign a reference value to option buttons and check boxes. The reference value will be remitted to a server when sending the web form. With database forms the value entered here will be written in the database assigned to the control field. - -Reference values for web forms - -Reference values are useful if you design a web form and the information on the status of the control is to be transmitted to a server. If the control is clicked by the user, the corresponding reference value is sent to the server. -For example, if you have two control fields for the options "feminine" and "masculine", and assign a reference value of 1 to the field "feminine" and the value 2 to the "masculine" field, the value 1 is transmitted to the server if a user clicks the "feminine" field and value 2 is sent if the "masculine" field is clicked. - -Reference values for database forms - -For database forms, you can also characterize the status of an option or a check box by a reference value, storing it in the database. If you have a set of three options, for example "in progress", "completed", and "resubmission", with the respective reference values, "ToDo", "OK", and "RS", these reference values appear in the database if the respective option is clicked. + You can enter a reference value for the web form, which will be remitted to a server when sending the form. With database forms, the value entered is written in the database field, assigned to the control field. You can assign a reference value to option buttons and check boxes. The reference value will be remitted to a server when sending the web form. With database forms the value entered here will be written in the database assigned to the control field. + Reference values for web forms + Reference values are useful if you design a web form and the information on the status of the control is to be transmitted to a server. If the control is clicked by the user, the corresponding reference value is sent to the server. + For example, if you have two control fields for the options "feminine" and "masculine", and assign a reference value of 1 to the field "feminine" and the value 2 to the "masculine" field, the value 1 is transmitted to the server if a user clicks the "feminine" field and value 2 is sent if the "masculine" field is clicked. + Reference values for database forms + For database forms, you can also characterize the status of an option or a check box by a reference value, storing it in the database. If you have a set of three options, for example "in progress", "completed", and "resubmission", with the respective reference values, "ToDo", "OK", and "RS", these reference values appear in the database if the respective option is clicked.
Data field -Specifies the field of the data source table to which the control refers. With database forms, you can link controls with the data fields. -You have several possibilities: + Specifies the field of the data source table to which the control refers. With database forms, you can link controls with the data fields. + You have several possibilities: - -First case: There is only one table in the form. -Under Data field, specify the field of the data source table whose contents you want to be displayed. - - -Second case: The control belongs to a subform that is created by an SQL query. -Under Data field, specify the field of the SQL statement whose contents you want to be displayed. - + + First case: There is only one table in the form. + Under Data field, specify the field of the data source table whose contents you want to be displayed. + + + Second case: The control belongs to a subform that is created by an SQL query. + Under Data field, specify the field of the SQL statement whose contents you want to be displayed. + - -Third case: Combo Boxes -For combo boxes, the field of the data source table in which the values entered or selected by the user should be stored is specified under Data field. The values displayed in the list of the combo box are based on an SQL statement, which is entered under List content. - - -Fourth case: List Boxes -The data source table does not contain the data to be displayed, but rather a table linked to the data source table through a common data field. -If you want a list box to display data from a table that is linked to the current data source table, under Data field specify the field of the data source table to which the content of the list box refers. Or you can specify the database field that controls the display of the data in the form. This data field provides the link to the other table if both tables can be linked through a common data field. It is usually a data field in which unique identification numbers are stored. The data field whose contents are displayed in the form is specified by an SQL statement under List content. - + + Third case: Combo Boxes + For combo boxes, the field of the data source table in which the values entered or selected by the user should be stored is specified under Data field. The values displayed in the list of the combo box are based on an SQL statement, which is entered under List content. + + + Fourth case: List Boxes + The data source table does not contain the data to be displayed, but rather a table linked to the data source table through a common data field. + If you want a list box to display data from a table that is linked to the current data source table, under Data field specify the field of the data source table to which the content of the list box refers. Or you can specify the database field that controls the display of the data in the form. This data field provides the link to the other table if both tables can be linked through a common data field. It is usually a data field in which unique identification numbers are stored. The data field whose contents are displayed in the form is specified by an SQL statement under List content. + List boxes work with references. They can either be implemented with linked tables by SQL statements (fourth case) or through value lists: - -References through linked tables (SQL statements) - +References through linked tables (SQL statements) If you want a list box to display data from a database table that is linked by a common data field to the table on which the form is based, the link field of the form table is specified under Data field. The link is created with an SQL Select, which, if you selected "SQL" or "Native SQL", is specified under Type of list contents in the field List content. As an example, a table "Orders" is linked to the current form control, and in the database a table "Customers" is linked to the "Orders" table. You can use an SQL statement as follows: SELECT CustomerName, CustomerNo FROM Customers, where "CustomerName" is the data field from the linked table "Customers", and "CustomerNo" is the field of the table "Customers" that is linked to a field of the form table "Orders" specified under Data field. - -References Using Value Lists - +References Using Value Lists For list boxes, you can use value lists. Value lists are lists that define reference values. In this way, the control in the form does not directly display the content of a database field, but rather values assigned in the value list. If you work with reference values of a value list, the contents of the data field that you specified under Data Field in the form are not visible, but rather the assigned values. If you chose "Valuelist" on the Data tab under Type of list contents and assigned a reference value to the visible list entries in the form under List entries (entered in the General tab), then the reference values are compared with the data content of the given data field. If a reference value corresponds to the content of a data field, the associated list entries are displayed in the form.
Bound field -Use an index to specify the table field or table SQL query to link to the field that is provided under Data field. Valid values for this property are 1, 2, 3, and so on.UFI: issue #i32749# -If you delete the contents of the Bound field cell in the property browser, the first field of the result set is used to display and to exchange data.UFI: issue #i32749# -This property for list boxes defines which data field of a linked table is displayed in the form. -If a list box in the form is to display contents of a table linked to the form table, then define in the Type of list contents field if the display is determined by an SQL command or the (linked) table is accessed. With the Bound field property, you use an index to specify to which data field of the query or of the table the list field is linked. -The property Bound field is only for forms that are used to access more than one table. If the form is based on only one table, the field to be displayed in the form is specified directly under Data field. However, if you want the list box to display data from a table that is linked to the current table over a common data field, the linked data field is defined by the property Bound field. -If you selected "SQL" under Type of list contents, the SQL command determines the index to be specified. Example: If you specify an SQL command such as "SELECT Field1, Field2 FROM tablename" under List content, refer to the following table: + Use an index to specify the table field or table SQL query to link to the field that is provided under Data field. Valid values for this property are 1, 2, 3, and so on.UFI: issue #i32749# + If you delete the contents of the Bound field cell in the property browser, the first field of the result set is used to display and to exchange data.UFI: issue #i32749# + This property for list boxes defines which data field of a linked table is displayed in the form. + If a list box in the form is to display contents of a table linked to the form table, then define in the Type of list contents field if the display is determined by an SQL command or the (linked) table is accessed. With the Bound field property, you use an index to specify to which data field of the query or of the table the list field is linked. + The property Bound field is only for forms that are used to access more than one table. If the form is based on only one table, the field to be displayed in the form is specified directly under Data field. However, if you want the list box to display data from a table that is linked to the current table over a common data field, the linked data field is defined by the property Bound field. + If you selected "SQL" under Type of list contents, the SQL command determines the index to be specified. Example: If you specify an SQL command such as "SELECT Field1, Field2 FROM tablename" under List content, refer to the following table: - - -Bound field - - -Link - - - - --1since LibreOffice 4.1 - - -The index of the selected entry in the list is linked to the field specified under Data field. - - - - -{empty} or 0 - - -The database field "Field1" is linked to the field specified under Data field. - - - - -1 - - -The database field "Field2" is linked to the field specified under Data field. - - + + + Bound field + + + Link + + + + + -1since LibreOffice 4.1 + + + The index of the selected entry in the list is linked to the field specified under Data field. + + + + + {empty} or 0 + + + The database field "Field1" is linked to the field specified under Data field. + + + + + 1 + + + The database field "Field2" is linked to the field specified under Data field. + +
- If you selected "Table" under Type of list contents, the table structure defines the index to be specified. Example: If a database table is selected under List content, refer to the following table: - - -Bound field - - -Link - - - - --1since LibreOffice 4.1 - - -The index of the selected entry in the list is linked to the field specified under Data field. - - - - -{empty} or 0 - - -The 1st column of the table is linked to the field specified under Data field. - - - - -1 - - -The 2nd column of the table is linked to the field specified under Data field. - - - - -2 - - -The 3rd column of the table is linked to the field specified under Data field. - - + + + Bound field + + + Link + + + + + -1since LibreOffice 4.1 + + + The index of the selected entry in the list is linked to the field specified under Data field. + + + + + {empty} or 0 + + + The 1st column of the table is linked to the field specified under Data field. + + + + + 1 + + + The 2nd column of the table is linked to the field specified under Data field. + + + + + 2 + + + The 3rd column of the table is linked to the field specified under Data field. + +
-
Type of list contents -Determines the data to fill the lists in list and combo boxes. Determines the data to fill the lists in list and combo boxes. -With the "Valuelist" option, all entries entered in the List entries field of the General tab appear in the control. For database forms, you can use reference values (see the References Using Value Lists section). -If the content of the control is read from a database, you can determine the type of the data source with the other options. For example, you can choose between tables and queries. + Determines the data to fill the lists in list and combo boxes. Determines the data to fill the lists in list and combo boxes. + With the "Valuelist" option, all entries entered in the List entries field of the General tab appear in the control. For database forms, you can use reference values (see the References Using Value Lists section). + If the content of the control is read from a database, you can determine the type of the data source with the other options. For example, you can choose between tables and queries.
List content -With database forms, specifies the data source for the list content of the form-element. This field can be used to define a value list for documents without a database connection. -In the case of database forms, the data source determines the entries of the list or combo box. Depending on the selected type, you have a choice between different data sources under List content, provided that these objects exist in your database. All available database objects of the type selected under Type of list contents are offered here. If you have selected the "Value List" option as the type, you can use references for database forms. If the display of the control is controlled by an SQL command, the SQL statement is entered here. -Examples of SQL statements: -For list boxes, an SQL statement may have the following form: -SELECT field1, field2 FROM table, -Here "table" is the table whose data is displayed in the list of the control (list table). "field1" is the data field that defines the visible entries in the form; its content is displayed in the list box. "field2" is the field of the list table that is linked to the form table (value table) through the field specified under Data field if Bound field = 1 was selected. -For combo boxes, an SQL statement may take the following form: -SELECT DISTINCT field FROM table, -Here "field" is a data field from the list table "table" whose content is displayed in the list of the combo box. - -Value lists for HTML documents - -For HTML forms, you can enter a value list under List content. Select the option "Valuelist" under Type of list contents. The values entered here will not be visible in the form, and are used to assign values to the visible entries. The entries made under List content correspond to the HTML tag <OPTION VALUE=...>. -In the data transfer of a selected entry from a list box or a combo box, both the list of the values displayed in the form, which was entered on the General tab under List entries, and the value list entered on the Data tab under List content, are taken into consideration: If a (non-empty) text is at the selected position in the value list (<OPTION VALUE=...>), it will be transmitted. Otherwise, the text displayed in the (<OPTION>) control is sent. -If the value list is to contain an empty string, enter the value "$$$empty$$$" under List content at the corresponding position (note uppercase/lowercase). $[officename] interprets this input as an empty string and assigns it to the respective list entry. -The following table shows the connections between HTML, JavaScript, and the $[officename] field List content using an example list box named "ListBox1". In this case, "Item" designates a list entry visible in the form: + With database forms, specifies the data source for the list content of the form-element. This field can be used to define a value list for documents without a database connection. + In the case of database forms, the data source determines the entries of the list or combo box. Depending on the selected type, you have a choice between different data sources under List content, provided that these objects exist in your database. All available database objects of the type selected under Type of list contents are offered here. If you have selected the "Value List" option as the type, you can use references for database forms. If the display of the control is controlled by an SQL command, the SQL statement is entered here. + Examples of SQL statements: + For list boxes, an SQL statement may have the following form: + SELECT field1, field2 FROM table, + Here "table" is the table whose data is displayed in the list of the control (list table). "field1" is the data field that defines the visible entries in the form; its content is displayed in the list box. "field2" is the field of the list table that is linked to the form table (value table) through the field specified under Data field if Bound field = 1 was selected. + For combo boxes, an SQL statement may take the following form: + SELECT DISTINCT field FROM table, + Here "field" is a data field from the list table "table" whose content is displayed in the list of the combo box. + Value lists for HTML documents + For HTML forms, you can enter a value list under List content. Select the option "Valuelist" under Type of list contents. The values entered here will not be visible in the form, and are used to assign values to the visible entries. The entries made under List content correspond to the HTML tag <OPTION VALUE=...>. + In the data transfer of a selected entry from a list box or a combo box, both the list of the values displayed in the form, which was entered on the General tab under List entries, and the value list entered on the Data tab under List content, are taken into consideration: If a (non-empty) text is at the selected position in the value list (<OPTION VALUE=...>), it will be transmitted. Otherwise, the text displayed in the (<OPTION>) control is sent. + If the value list is to contain an empty string, enter the value "$$$empty$$$" under List content at the corresponding position (note uppercase/lowercase). $[officename] interprets this input as an empty string and assigns it to the respective list entry. + The following table shows the connections between HTML, JavaScript, and the $[officename] field List content using an example list box named "ListBox1". In this case, "Item" designates a list entry visible in the form: - - - -HTML Tag - - - - -JavaScript - - - - -Entry in value list of the control (List content) - - - - -Transmitted data - - - - - -<OPTION>Item - - -Not possible - - -"" - - -the visible list entry ("ListBox1=Item") - - - - -<OPTION VALUE="Value">Item - - -ListBox1.options[0].value="Value" - - -"Value" - - -The value assigned to the list entry ("ListBox1=Value") - - - - -<OPTION VALUE="">Item - - -ListBox1.options[0].value="" - - -"$$$empty$$$" - - -An empty string ("ListBox1=") - - + + + HTML Tag + + + JavaScript + + + Entry in value list of the control (List content) + + + Transmitted data + + + + + <OPTION>Item + + + Not possible + + + "" + + + the visible list entry ("ListBox1=Item") + + + + + <OPTION VALUE="Value">Item + + + ListBox1.options[0].value="Value" + + + "Value" + + + The value assigned to the list entry ("ListBox1=Value") + + + + + <OPTION VALUE="">Item + + + ListBox1.options[0].value="" + + + "$$$empty$$$" + + + An empty string ("ListBox1=") + +
-
Empty string is NULL -Defines how an empty string input should be handled. If set to Yes, an input string of length zero will be treated as a value NULL. If set to No, any input will be treated as-is without any conversion. -An empty string is a string of length zero (""). Normally, a value NULL is not the same as an empty string. In general, a term NULL is used to denote an undefined value, an unknown value, or "no value has been entered yet." -Database systems vary and they might handle a value NULL differently. Refer to documentations of the database that you are using. + Defines how an empty string input should be handled. If set to "Yes", an input string of length zero will be treated as a value NULL. If set to "No", any input will be treated as-is without any conversion. + An empty string is a string of length zero (""). Normally, a value NULL is not the same as an empty string. In general, a term NULL is used to denote an undefined value, an unknown value, or "no value has been entered yet." + Database systems vary and they might handle a value NULL differently. Refer to documentations of the database that you are using.
Filter proposal -While designing your form, you can set the "Filter proposal" property for each text box in the Data tab of the corresponding Properties dialog. In subsequent searches in the filter mode, you can select from all information contained in these fields. The field content can then be selected using the AutoComplete function. Note, however, that this function requires a greater amount of memory space and time, especially when used in large databases and should therefore be used sparingly. - + While designing your form, you can set the "Filter proposal" property for each text box in the Data tab of the corresponding Properties dialog. In subsequent searches in the filter mode, you can select from all information contained in these fields. The field content can then be selected using the AutoComplete function. Note, however, that this function requires a greater amount of memory space and time, especially when used in large databases and should therefore be used sparingly.
Linked cell -Specifies the reference to a linked cell on a spreadsheet. The live state or contents of the control are linked to the cell contents. The following tables list the controls and their corresponding link type: + Specifies the reference to a linked cell on a spreadsheet. The live state or contents of the control are linked to the cell contents. The following tables list the controls and their corresponding link type: Check box with linked cell - - -Action - - -Result - - - - -Select the check box - - -TRUE is entered into the linked cell - - - - -Deselect the check box - - -FALSE is entered into the linked cell - - - - -Tri-state check box is set to "undetermined" state - - -#NV is entered into the linked cell - - - - -Enter a number or a formula that returns a number in the linked cell - - -If entered value is TRUE or not 0: Check box is selected
If entered value is FALSE or 0: Check box is deselected - - - - -Clear the linked cell, or enter text, or enter a formula that returns text or an error - - -Check box is set to "undetermined" state if it is a tri-state check box, else check box is deselected. - - - - -Select the box. The Reference value box contains text.UFI: sc.features "eforms2 option buttons check boxes now also exchanging text" - - -The text from the Reference value box is copied to the cell. - - - - -Deselect the box. The Reference value box contains text. - - -An empty string is copied to the cell. - - - - -The Reference value box contains text. Enter the same text into the cell. - - -The check box is selected. - - - - -The Reference value box contains text. Enter another text into the cell. - - -The check box is deselected. - - + + + Action + + + Result + + + + + Select the check box: + + + TRUE is entered into the linked cell. + + + + + Deselect the check box: + + + FALSE is entered into the linked cell. + + + + + Tri-state check box is set to "undetermined" state: + + + #NV is entered into the linked cell. + + + + + Enter a number or a formula that returns a number in the linked cell: + + + If entered value is TRUE or not 0: Check box is selected.
If entered value is FALSE or 0: Check box is deselected. + + + + + Clear the linked cell, or enter text, or enter a formula that returns text or an error: + + + Check box is set to "undetermined" state if it is a tri-state check box, else check box is deselected. + + + + + Select the box. The Reference value box contains text:UFI: sc.features "eforms2 option buttons check boxes now also exchanging text" + + + The text from the Reference value box is copied to the cell. + + + + + Deselect the box. The Reference value box contains text: + + + An empty string is copied to the cell. + + + + + The Reference value box contains text. Enter the same text into the cell: + + + The check box is selected. + + + + + The Reference value box contains text. Enter another text into the cell: + + + The check box is deselected. + +
- Option button (radio button) with linked cell - - -Action - - -Result - - - - -Select the option button - - -TRUE is entered into the linked cell - - - - -Option button is deselected by selecting another option button - - -FALSE is entered into the linked cell - - - - -Enter a number or a formula that returns a number in the linked cell - - -If entered value is TRUE or not 0: Option button is selected
If entered value is FALSE or 0: Option button is deselected - - - - -Clear the linked cell, or enter text, or enter a formula that returns text or an error - - -Option button is deselected - - - - -Click the option button. The Reference value box contains text. - - -The text from the Reference value box is copied to the cell. - - - - -Click another option button of the same group. The Reference value box contains text. - - -An empty string is copied to the cell. - - - - -The Reference value box contains text. Enter the same text into the cell. - - -The option button is selected. - - - - -The Reference value box contains text. Enter another text into the cell. - - -The option button is cleared. - - + + + Action + + + Result + + + + + Select the option button: + + + TRUE is entered into the linked cell. + + + + + Option button is deselected by selecting another option button: + + + FALSE is entered into the linked cell. + + + + + Enter a number or a formula that returns a number in the linked cell: + + + If entered value is TRUE or not 0: Option button is selected.
If entered value is FALSE or 0: Option button is deselected. + + + + + Clear the linked cell, or enter text, or enter a formula that returns text or an error: + + + Option button is deselected. + + + + + Click the option button. The Reference value box contains text: + + + The text from the Reference value box is copied to the cell. + + + + + Click another option button of the same group. The Reference value box contains text: + + + An empty string is copied to the cell. + + + + + The Reference value box contains text. Enter the same text into the cell: + + + The option button is selected. + + + + + The Reference value box contains text. Enter another text into the cell: + + + The option button is cleared. + +
- Text box with linked cell - - -Action - - -Result - - - - -Enter text into the text box - - -Text is copied into the linked cell - - - - -Clear the text box - - -Linked cell is cleared - - - - -Enter text or a number in the linked cell - - -Text or number is copied into the text box - - - - -Enter a formula into the linked cell - - -Formula result is copied into the text box - - - - -Clear the linked cell - - -Text box is cleared - - + + + Action + + + Result + + + + + Enter text into the text box: + + + Text is copied into the linked cell. + + + + + Clear the text box: + + + Linked cell is cleared. + + + + + Enter text or a number in the linked cell: + + + Text or number is copied into the text box. + + + + + Enter a formula into the linked cell: + + + Formula result is copied into the text box. + + + + + Clear the linked cell: + + + Text box is cleared. + +
- Numerical field and formatted field with linked cell - - -Action - - -Result - - - - -Enter a number into the field - - -Number is copied into the linked cell - - - - -Clear the field - - -Value 0 is set in the linked cell - - - - -Enter a number or a formula that returns a number in the linked cell - - -Number is copied into the field - - - - -Clear the linked cell, or enter text, or enter a formula that returns text or an error - - -Value 0 is set in the field - - + + + Action + + + Result + + + + + Enter a number into the field: + + + Number is copied into the linked cell. + + + + + Clear the field: + + + Value 0 is set in the linked cell. + + + + + Enter a number or a formula that returns a number in the linked cell: + + + Number is copied into the field. + + + + + Clear the linked cell, or enter text, or enter a formula that returns text or an error: + + + Value 0 is set in the field. + +
- List box with linked cell -List boxes support two different linking modes, see the property "Contents of the linked cell". + List boxes support two different linking modes, see the property "Contents of the linked cell". - -Linked contents: Synchronize the text contents of the selected list box entry with the cell contents. - - -Linked selection position: The position of the single selected item in the list box is synchronized with the numerical value in the cell. - + + Linked contents: Synchronize the text contents of the selected list box entry with the cell contents. + + + Linked selection position: The position of the single selected item in the list box is synchronized with the numerical value in the cell. + - - -Action - - -Result - - - - -Select a single list item - - -Contents are linked: Text of the item is copied into the linked cell. -Selection is linked: Position of the selected item is copied into the linked cell. For example, if the third item is selected, the number 3 will be copied. - - - - -Select several list items - - -#NV is entered into the linked cell - - - - -Deselect all list items - - -Contents are linked: Linked cell is cleared -Selection is linked: Value 0 is entered in the linked cell - - - - -Enter text or a number into the linked cell - - -Contents are linked: Find and select an equal list item -Selection is linked: The list item at the specified position (starting with 1 for the first item) is selected. If not found, all items are deselected. - - - - -Enter a formula into the linked cell - - -Find and select a list item that matches the formula result and link mode - - - - -Clear the linked cell - - -Deselect all items in the list box - - - - -Change the contents of the list source range - - -List box items are updated according to the change. The selection is preserved. This may cause an update to the linked cell. - - + + + Action + + + Result + + + + + Select a single list item: + + + Contents are linked: Text of the item is copied into the linked cell. + Selection is linked: Position of the selected item is copied into the linked cell.
For example, if the third item is selected, the number 3 will be copied. + + + + + Select several list items: + + + #NV is entered into the linked cell. + + + + + Deselect all list items: + + + Contents are linked: Linked cell is cleared. + Selection is linked: Value 0 is entered in the linked cell. + + + + + Enter text or a number into the linked cell: + + + Contents are linked: Find and select an equal list item. + Selection is linked: The list item at the specified position (starting with 1 for the first item) is selected. If not found, all items are deselected. + + + + + Enter a formula into the linked cell: + + + Find and select a list item that matches the formula result and link mode. + + + + + Clear the linked cell: + + + Deselect all items in the list box. + + + + + Change the contents of the list source range: + + + List box items are updated according to the change. The selection is preserved. This may cause an update to the linked cell. + +
- Combo box with linked cell - - -Action - - -Result - - - - -Enter text into the edit field of the combo box, or select an entry from the drop-down list - - -Text is copied into the linked cell - - - - -Clear the edit field of the combo box - - -Linked cell is cleared - - - - -Enter text or a number into the linked cell - - -Text or number is copied into the edit field of the combo box - - - - -Enter a formula into the linked cell - - -Formula result is copied into the edit field of the combo box - - - - -Clear the linked cell - - -Edit field of the combo box is cleared - - - - -Change the contents of the list source range - - -Drop-down list items are updated according to the change. The edit field of the combo box and the linked cell are not changed. - - + + + Action + + + Result + + + + + Enter text into the edit field of the combo box, or select an entry from the drop-down list: + + + Text is copied into the linked cell. + + + + + Clear the edit field of the combo box: + + + Linked cell is cleared. + + + + + Enter text or a number into the linked cell: + + + Text or number is copied into the edit field of the combo box. + + + + + Enter a formula into the linked cell: + + + Formula result is copied into the edit field of the combo box. + + + + + Clear the linked cell: + + + Edit field of the combo box is cleared. + + + + + Change the contents of the list source range: + + + Drop-down list items are updated according to the change. The edit field of the combo box and the linked cell are not changed. + +
-
Contents of the linked cell -Select the mode of linking a list box with a linked cell on a spreadsheet. + Select the mode of linking a list box with a linked cell on a spreadsheet. - -Linked contents: Synchronize the text contents of the selected list box entry with the cell contents. Select "The selected entry" - - -Linked selection position: The position of the single selected item in the list box is synchronized with the numerical value in the cell. Select "Position of the selected entry" - + + Linked contents: Synchronize the text contents of the selected list box entry with the cell contents. Select "The selected entry". + + + Linked selection position: The position of the single selected item in the list box is synchronized with the numerical value in the cell. Select "Position of the selected entry". +
Source cell rangeUFI: in the spec, this is "Source range of the list". Named it as seen in 680m38 -Enter a cell range that contains the entries for a list box or combo box on a spreadsheet. If you enter a multi-column range, only the contents of the leftmost column are used to fill the control. + Enter a cell range that contains the entries for a list box or combo box on a spreadsheet. If you enter a multi-column range, only the contents of the leftmost column are used to fill the control.
diff --git a/source/text/shared/02/01170103.xhp b/source/text/shared/02/01170103.xhp index 4c987a9633..85817c01dc 100644 --- a/source/text/shared/02/01170103.xhp +++ b/source/text/shared/02/01170103.xhp @@ -1,6 +1,5 @@ - - - - Events - /text/shared/02/01170103.xhp - - - -
-controls; events - events; controls - macros; assigning to events in forms + + Events + /text/shared/02/01170103.xhp + + + +
+ +controls; events +events; controls +macros; assigning to events in forms Events - On the Events tab page you can link macros to events that occur in a form's control fields. -
- When the event occurs, the linked macro will be called. To assign a macro to an event, press the ... button. The Assign Action dialog opens. -
- -
- Depending on the control, different events are available. Only the available events for the selected control and context are listed on the Events tab page. The following events are defined: + On the Events tab page you can link macros to events that occur in a form's control fields. +
+When the event occurs, the linked macro will be called. To assign a macro to an event, press the ... button. The Assign Action dialog opens. +
+ +
+Depending on the control, different events are available. Only the available events for the selected control and context are listed on the Events tab page.
The following events are defined: Approve actionrenamed from Before commencing, issue 97356 - This event takes place before an action is triggered by clicking the control. For example, clicking a "Submit" button initiates a send action; however, the actual "send" process is started only when the When initiating event occurs. The Approve action event allows you to kill the process. If the linked method sends back FALSE, When initiating will not be executed. + This event takes place before an action is triggered by clicking the control. For example, clicking a "Submit" button initiates a send action; however, the actual "send" process is started only when the When initiating event occurs. The Approve action event allows you to kill the process. If the linked method sends back FALSE, When initiating will not be executed. Execute actionrenamed from When initiated, issue 97356 - The Execute action event occurs when an action is started. For example, if you have a "Submit" button in your form, the send process represents the action to be initiated. + The Execute action event occurs when an action is started. For example, if you have a "Submit" button in your form, the send process represents the action to be initiated. Changed - The Changed event takes place when the control loses the focus and the content of the control has changed since it lost the focus. + The Changed event takes place when the control loses the focus and the content of the control has changed since it lost the focus. Text modified - The Text modified event takes place if you enter or modify a text in an input field. + The Text modified event takes place if you enter or modify a text in an input field. Item status changed - The Item status changed event takes place if the status of the control field has changed. The Item status changed event takes place if the status of the control field has changed. + The Item status changed event takes place if the status of the control field has changed. The Item status changed event takes place if the status of the control field has changed. When receiving focus - The When receiving focus event takes place if a control field receives the focus. + The When receiving focus event takes place if a control field receives the focus. When losing focus - The When losing focus event takes place if a control field loses the focus. + The When losing focus event takes place if a control field loses the focus. Key pressed - The Key pressed event occurs when the user presses any key while the control has the focus. This event may be linked to a macro for checking entries. + The Key pressed event occurs when the user presses any key while the control has the focus. This event may be linked to a macro for checking entries. Key released - The Key released event occurs when the user releases any key while the control has the focus. + The Key released event occurs when the user releases any key while the control has the focus. Mouse inside - The Mouse inside event takes place if the mouse is inside the control field. + The Mouse inside event takes place if the mouse is inside the control field. Mouse moved while key pressed - The Mouse moved while key pressed event takes place when the mouse is dragged while a key is pressed. An example is when, during drag-and-drop, an additional key determines the mode (move or copy). + The Mouse moved while key pressed event takes place when the mouse is dragged while a key is pressed. An example is when, during drag-and-drop, an additional key determines the mode (move or copy). Mouse moved - The Mouse moved event occurs if the mouse moves over the control. + The Mouse moved event occurs if the mouse moves over the control. Mouse button pressed - The Mouse button pressed event occurs if the mouse button is pressed while the mouse pointer is on the control. - Note that this event is also used for notifying requests for a popup context menu on the control. + The Mouse button pressed event occurs if the mouse button is pressed while the mouse pointer is on the control. + Note that this event is also used for notifying requests for a popup context menu on the control. Mouse button released - The Mouse button released event occurs if the mouse button is released while the mouse pointer is on the control. + The Mouse button released event occurs if the mouse button is released while the mouse pointer is on the control. Mouse outside - The Mouse outside event takes place when the mouse is outside the control field. - - + The Mouse outside event takes place when the mouse is outside the control field. + +