Forms: General Tab

Conteníu

# General Tab

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.

P'aportar a esta orde...

#### Dende'l menú contestual:

Choose Control Properties - General tab.

#### Dende la interfaz con llingüetes:

Choose Forms - Control Properties - General tab.

#### Dende les barres de ferramientes:

Control Properties

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).

## Acciones sobre un rexistru

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.

## Activar al faer clic

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

## Activáu

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

## Aición

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:

Aición | Descripción
--- | ---
Nengún | Nun hai aición.
Unviar formulariu | 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. Al esportar a un ficheru PDF, indique la URL nel cuadru de testu correspondiente de les propiedaes de datos del formulariu.
Reafitar formulariu | Resets the settings in other control fields to the predefined defaults: Default Status, Default Selection, Default Value.
Abrir documentu / páxina web | Abre la URL establecida en URL. Pue usar Marcu pa especificar el marcu de destín.
Primer rexistru | Mueve'l formulariu actual al primer rexistru.
Rexistru anterior | Mueve'l formulariu actual al rexistru anterior.
Rexistru siguiente | Mueve'l formulariu actual al rexistru siguiente.
Últimu rexistru | Mueve'l formulariu actual al últimu rexistru.
Guardar rexistru | Guarda'l rexistru actual, si ye necesariu.
Desfacer datos inxertaos | Invierte los cambeos del rexistru actual.
Nuevu rexistru | Mueve'l formulariu actual a la filera d'inxertamientu.
Desaniciar rexistru | Desanicia'l rexistru actual.
Anovar formulariu | Recarga la versión del formulariu actual que se guardó más apocayá.

## Alliniación / Alliniación de gráficos

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

1. Title of Label fields,

2. Content of text fields,

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

4. Graphics or text that are used in buttons.

   La opción Alliniación pa los botones denominar Alliniación de gráficos.

## Alternar

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".

## Altor

Define l'altor del control.

## Anchor

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

## Anchor

Define l'anchor del control.

## Anclaxe

Define onde s'anclará'l control.

## Anubrir esbilla

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

## Asitiar símbolu delantre

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.

## Autorrellenar

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

## Ayuda 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.

## Barra de desplazamientu

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

## Barra de navegación

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

## Berbesu

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.

## Botón predetermináu

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.

Esta propiedá namái débese asignar a un solu botón nel documentu.

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.

## Botón xiratoriu

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

## Cambéu grande

Especifique'l valor que se va amestar o va quitar cuando l'usuariu faiga clic nel iconu de flecha de la barra de desplazamientu.

## Cambéu pequeñu

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

## Campu d'etiqueta

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.

Nos botones d'opción namái s'almite como campu d'etiqueta'l testu del marcu del grupu que creares. Esti testu rixe pa tolos botones d'opción del mesmu grupu.

Si calca'l botón ... asitiáu xuntu al campu de testu, amuésase'l diálogu Seleición riolo d'etiqueta. Escueya un campu de control na llista de tolos campos de control.

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

## Caráuteres pa contraseñes

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).

## Color de fondu

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.

## Color de símbolu

Especifica'l color de los símbolos nos controles, por exemplu, les fleches d'una barra de desplazamientu.

## Color del borde

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

## Decimales

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

## Desplazamientu de rueda del mur

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.

## División de pallabres

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.

## Entraes de llista

Please note the tips referring to the keyboard controls.

La entrada de llista predeterminada predefinida escribir nel cuadru combináu Seleición predeterminada.

Tenga en cuenta que les entraes de la llista escrites equí namái s'incorporen al formulariu si, na llingüeta Datos, escuéyese la opción "Llista de valores" como Tipu del conteníu de llista.

Si nun quier que les entraes de llista s'han escrites na base de datos o tresmitíes al recipiente del formulariu Web, sinón más bien de que los valores asignaos nun seyan visibles nel formulariu, pue asignar les entraes de llista a otros valores nuna llista de valores. La llista de valor determinar na llingüeta Datu. Baxu Tipu de conteníos de llista, escueya'l botón "Llista de valor". De siguío, introduza los valores baxu Conteníos de llista que s'asignaron a la correspondiente llista d'entraes visibles del formatu. Pa l'asignación correcta, l'orde na llista de valor ye relevante.

Nos documentos HTML, una entrada de la llista ingresada na llingüeta Xeneral correspuende a etiquetar HTML <option>; una entrada de la llista de valores ingresada na llingüeta Datos dientro de Conteníu de la llista correspuende a la etiqueta <option value=...>.

## Escala

Resizes the image to fit the size of the control.

## Espaciu ente ringleres

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.

## Estenderexable

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.

Los campos combinaos inxertaos como columnes nun control de tabla siempres son estenderexables de forma predeterminada.

## Estilu

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

## Estáu predetermináu

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

Pa un botón de tipu reestablecer, pue definir l'estáu del control si'l botón de reestablecer ye activáu pol usuariu.

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

## Estáu triple

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.

## Fecha máx.

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

## Fecha mín.

Determines the earliest date that a user can enter.

## Fecha predeterminada

Establez la fecha predeterminada.

## Formatu

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

## Formatu d'hora

You can define the desired format for the time display.

## Formatu de fecha

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

De forma automática dase formatu a tolos campos de formatu (fecha, hora, moneda, numbéricu) nel formatu que s'escoyera xusto depués de dexar la caxella, ensin importar de qué mou escriba la entrada.

## Formatu estriutu

La función de formatu estrictu ta disponible pa los campos de control qu'aceuten conteníu con formatu (data, hora, etc.). Si s'activa esta función (Sí), solo s'aceuten los caráuteres permitíos. Por exemplu, nun campu de data, solo van aceutase númberos y allindiadores de data; van ignorase les lletres introducíes col tecláu.

## Hora máx.

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

## Hora mín.

Determines the minimum time that a user can enter.

## Hora predeterminada

Establez la hora predeterminada.

## Imaxe

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.

## Imprentable

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

## Intervalu

Establez l'intervalu p'aumentar o menguar con cada activación del control del botón de seleición.

## Les llinies de testu acaben con

Pa los campos de testu, escueya'l códigu de fin de llinia que se va utilizar cuando escriba testu nuna columna de base de datos.

## Llargor máx. del testu

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).

## Marcador de rexistru

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

## Marcu

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.

Al calcar nel campu va poder escoyer una opción de la llista qu'especifique en qué marcu se debe cargar el documentu siguiente. Les posibilidaes son:

Entrada | Significáu
--- | ---
_blank | L'elementu siguiente inxertar nun frame nuevu y baleru.
_parent | El documentu siguiente inxertar nun frame d'un nivel cimeru. Si esti nivel cimeru nun esiste, el documentu inxertar nel mesmu frame.
_self | El documentu siguiente inxertar nel mesmu frame.
_top | El documentu siguiente inxertar nuna Top-Window (ventana cimera), eso ye, nel frame asitiáu na parte más alta de la xerarquía. Si'l frame de partida ye yá una ventana cimera, el documentu inxertar nel mesmu frame.

The "Frame" property is relevant for HTML forms, but not for database forms.

## Mázcara d'entrada

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:

Caráuter | Significáu
--- | ---
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 | Puen introducise tolos caráuteres imprentables.
X | All printable characters can be entered. If a lowercase letter is entered, it is automatically converted to a capital letter.

Defina, por exemplu, pa la mázcara de caráuteres "__.__.2000", la mázcara d'entrada "NNLNNLLLLL" que l'usuariu pueda introducir 4 cifres na indicación de la fecha.

## Mázcara de caráuteres

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.

El llargor de la mázcara de caráuteres tien de correspondese siempres col llargor de la mázcara d'entrada. De nun ser asina, la mázcara de caráuteres córtase o se rellena con espacios en blancu hasta algamar el llargor de la mázcara d'entrada.

## Namái de llectura

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.

## Navegación

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.

## Nome

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.

Si trabaya con macros, asegúrese de que los nomes de los campos de control son inequívocos.

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.

## Númberu de llinies

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.

## Orde de tabulación

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.

Tamién pues definir los índices de distintos controles nel diálogu Secuencia d'activación.

## Orientación

Establez la orientación horizontal o vertical de la barra de desplazamientu o'l botón de seleición.

## Peñerar y ordenar

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

## Posición

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.

## PosiciónX

Define la posición X del control, respeuto a l'ancla.

## PosiciónY

Define la posición Y del control, respeuto a l'ancla.

## Repitir

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

## Retrasu

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.

## Seleición múltiple

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

## Seleición predeterminada

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.

Nel diálogu Seleición predeterminada, escueya les entraes que deseye marcar como escoyíes al abrir el formulariu que contenga'l cuadru de llista.

## Separador de mil

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

## Símbolu de moneda

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

## Tabstop

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

Non | When using the Tab key, focusing skips the control.
Sí | The control can be selected with the Tab key.

## Tamañu del iconu

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

## Tamañu visible

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.

## Testu d'ayuda

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.

## Testu d'ayuda

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.

## Testu predetermináu

Establez el testu predetermináu pa un cuadru de testu o un cuadru combináu.

## Tipu lletra

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.

## Triba de testu

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.

Si escueye'l tipu de testu "Múltiples llinies con formatu", esti control nun pue enllazase con un campu de base de datos.

Esti control denominar "Entrada de múltiples llinies" pa les columnes de testu que tean dientro d'un control de la tabla.

## Títulu

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.

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

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.

Si mueve'l mur sobre'l botón en mou Usuariu, la direición URL va amosase como una suxerencia emerxente, en casu de que nun s'ingresó nengún testu d'ayuda.

## Valor

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.

## Valor de desplazamientu mín.

Especifica'l valor mínimu d'un control de barra de desplazamientu.

## Valor diferencial

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.

## Valor máx.

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

## Valor máximu

Specify the maximum value of a scrollbar control.

## Valor mín.

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

## Valor predetermináu

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.

## Valor predetermináu de desplazamientu

Sets the default value for the scrollbar.

## Visible

Define si'l control va siguir tando visible en mou en vivu. En mou de diseñu, el control siempres ta visible.

Ten en cuenta que si esta propiedá se define como «Sí» (opción predeterminada), esto nun significa necesariamente que'l control vaya a apaecer na pantalla. Aplíquense restricciones adicionales al calcular la visibilidá efeutiva d'un control. Por exemplu, un control asitiáu nuna seición oculta en Writer nunca va ser visible, hasta que se faiga visible siquier la mesma seición.

Si la propiedá defínese en «Non», el control siempres va tar ocultu nel mou en direuto.

Les versiones más antigües de OpenOffice.org hasta 3.1 van inorar esta propiedá ensin xenerar alvertencies al lleer documentos que faigan usu de la mesma.

Temes rellacionaos

Data Tab

Events Tab

Please support us!