List Box Property Page |
Use the List Box property page to configure the appearance of the list box control and the presentation of the options.
By using this property page, you can configure an input box to accept a user-entered value. You can also configure the list box to display database records in multiple columns so that print operators can choose the records to be printed.
Type
Single Column: Specifies that the control appears as a box on the form and displays the options in a single-column list.
Multiple Columns: Specifies that the control appears as a box on the form and displays the options in a multiple-column list.
Simple Cards: Specifies that the control appears as multiple cards on the form, and each card displays one or more fields of data for a single option.
Custom Cards: Specifies the same functionality as the simple cards type but with support for additional layout customizations.
|
When you select the Multiple Columns, Simple Cards, or Custom Cards type, the Columns property page becomes available in the left navigation pane of the List Box Properties dialog. |
The properties that are available to configure vary depending on the list box type that you select.
Properties
Add text input box on top: Inserts a text input box above the predefined list of options. Print operators can use this box to enter a value that does not appear in the list box control.
Width: Specifies the horizontal dimension of the list box control in the specified unit of measurement.
Height: Specifies how many rows of records are displayed in the control. By default, this is the number of items in the List Items property page. When this value is set to a number that is less than the number of items in the List Items property page, a scroll bar is provided in the control at print time so that the print operator can view the additional list items.
Alignment: Specifies the alignment of the list items in the list box control. To use the alignment that is specified by the Reading Order setting, select Auto.
Reading Order: Specifies the reading order for the reply box. To use the reading order that is configured on the Form property page, select Auto.
|
You can set the reading order for the control's label on the Text Label property page. |
Size
Width: Specifies the horizontal dimension of the control in the specified unit of measurement.
Height: Specifies the vertical dimension of the control in the specified unit of measurement.
Features
Search Control: Specifies that the search control input box is displayed. This feature makes it possible for users to filter the displayed record set by entering a keyword (or partial spelling of a keyword) into the input box.
Always Show: Specifies that the search control is always available on the control, with no option for users to hide it.
Show by Default: Specifies that the search control is available on the control by default, but users can hide it at print time by using the control's context menu.
Hide by Default: Specifies that the search control is hidden by default, but users can show it at print time by using the control's context menu.
Always Hide: Specifies that the search control is always hidden, with no option for users to show it.
Filter Row: Specifies whether the filter row is displayed. The filter row provides an input box for each column in the record set into which the user can enter values that are then used to filter the record set.
Always Show: Specifies that the filter row is always displayed, with no option for users to hide it.
Show by Default: Specifies that the filter row is displayed by default, but users can hide it at print time by using the control's context menu.
Hide by Default: Specifies that the filter row is hidden by default, but users can show it at print time by using the control's context menu.
Always Hide: Specifies that the filter row is always hidden, with no option for users to show it.
Show column headers: Specifies that column headers are displayed on the control. When this option is not selected, column headers are not displayed.
Lock column order: Specifies that users cannot rearrange the column order of the returned record set. When this option is not selected, users can drag columns to change column order. Available when Show column headers is selected.
Lock column widths: Specifies that users cannot resize the column widths of the returned record set. Available when Show column headers is selected.
Group By: Specifies a column heading to group the records by. At print time, the user can expand groups to access the records that they contain. Click to select the Locked check box to prevent the setting from being changed.
Sort By: Specifies a column heading to sort the records by at print time. Click to select the Locked check box to prevent the setting from being changed.
Row Highlighting: Specifies the row highlighting that is displayed on the control.
None: Specifies that there is no row highlighting.
Even Rows: Specifies that only the even rows are highlighted.
Odd Rows: Specifies that only the odd rows are highlighted.
Both: Specifies that the even and odd rows are both highlighted, but in contrasting shades.
Record numbers: Specifies that record numbers are displayed on the left side of the control.
Record navigator: Specifies that a record navigator is displayed at the bottom of the control so that users can browse the record set.
Size
Width: Specifies the horizontal dimension of the control in the specified unit of measurement.
Height: Specifies the vertical dimension of the control in the specified unit of measurement.
Features
Search Control: Specifies that the search control input box is displayed. This feature makes it possible for users to filter the displayed record set by entering a keyword (or partial spelling of a keyword) into the input box.
Always Show: Specifies that the search control is always available on the control, with no option for users to hide it.
Show by Default: Specifies that the search control is available on the control by default, but users can hide it at print time by using the control's context menu.
Hide by Default: Specifies that the search control is hidden by default, but users can show it at print time by using the control's context menu.
Always Hide: Specifies that the search control is always hidden, with no option for users to show it.
Allow changing field visibility: Specifies that the sorting and filtering settings can be changed. When this option is not selected, the current sorting and filtering settings are locked.
Allow sorting: Specifies that the fields can be sorted. Available when Allow changing field visibility is selected.
Allow filtering: Specifies that the fields can be filtered. Available when Allow changing field visibility is selected.
Auto fit cards to width: Specifies that the cards are automatically sized to fit the data entry form.
Cards Across: Specifies the number of cards that appear in a row on the form. Available when Auto fit cards to width is selected.
Caption Format: Specifies the database field values that are the source of the text that appears in the header panel of the card. Click to display a list of available values, and then click the values that you want to use.
Record navigator: Specifies that a record navigator is displayed at the bottom of the control so that users can browse the record set.
Size
Width: Specifies the horizontal dimension of the control in the specified unit of measurement.
Height: Specifies the vertical dimension of the control in the specified unit of measurement.
Features
View: Specifies how the cards are displayed on the form. Click to select the Lock check box to prevent the setting from being changed. The following views are available:
Single Record: Specifies that only one card appears at a time.
Single Column: Specifies that cards appear in one column.
Single Row: Specifies that cards appear in one row.
Multiple Columns: Specifies that cards appear in more than one column.
Multiple Rows: Specifies that cards appear in more than one row.
Carousel: Specifies that cards appear in a carousel format, where scrolling causes one card to move into the background and optionally become smaller and more transparent while the next card moves into the foreground.
View Settings: Opens the View Settings dialog, which you can use to configure the settings for the selected view type. Depending on the view type, one or more of the following options are available:
Stretch card to height: Specifies that the card is resized to fit the height of the form.
Stretch card to width: Specifies that the card is resized to fit the width of the form.
Maximum Columns: Specifies the maximum number of columns to be displayed.
Maximum Rows: Specifies the maximum number of rows to be displayed.
Pitch Angle: Specifies the angle at which cards in a carousel are pitched up or down. Valid values are from 0 to 180.
Radius: Specifies the size of the imaginary circle around which cards in a carousel rotate.
Roll Angle: Specifies the angle at which cards in a carousel are rolled around the center point of the form. Valid values are from 0 to 360.
Transparency: Specifies the transparency (as a percentage) of the background cards in a carousel. The range is from 0 (transparent) to 100 (opaque).
Fade: Specifies the degree (as a percentage) to which the cards in a carousel fade in or out when they are moving toward or away from the foreground.
Scale: Specifies the size (as a percentage) of the background cards in a carousel.
Card Count: Specifies the maximum number of cards in a carousel that are displayed at one time.
Search Control: Specifies that the search control input box is displayed. This feature makes it possible for users to filter the displayed record set by entering a keyword (or partial spelling of a keyword) into the input box.
Always Show: Specifies that the search control is always available on the control, with no option for users to hide it.
Show by Default: Specifies that the search control is available on the control by default, but users can hide it at print time by using the control's context menu.
Hide by Default: Specifies that the search control is hidden by default, but users can show it at print time by using the control's context menu.
Always Hide: Specifies that the search control is always hidden, with no option for users to show it.
Show header panel: Specifies that the header panel is displayed on each card.
Allow sorting: Specifies that the records can be sorted.
Allow filtering: Specifies that the records can be filtered.
Caption Format: Specifies the database field values that are the source of the text that appears in the header of the card. Click to display a list of values from which you can select the values that you want to use.
Record navigator: Specifies that a record navigator is displayed at the bottom of the control so that users can browse the record set.
Allow customizing card template: Specifies that the icon appears on the data entry form at print time. The print operator can click this icon to open the LayoutView Customization dialog, which the print operator can use to customize the template card and view layout.
Customize Card Layout: Opens the LayoutView Customization dialog, which you can use to customize the template card and view layout.
This property page is available for the following controls: