Xbasic

UI_GET_CHECK2P Function

Syntax

Selections as P = ui_get_check2P(C title ,C selected ,C choices [,C headingText [,L hasSelectAllLink [,L hasUnselectAllLink [,L hasWildcardSelectLink [,N width [,N height [,C scrollingMode [,L resizeable [,C xbInitialize [,* opsIn ]]]]]]]]]])

Arguments

Selections

A pointer variable with two properties.

Property
Description
.LastButton

C, The name of the last button clicked.

.Selected

C, A CR-LF delimited list of the user's selections.

title

Character

selected

A CR-LF list of the default selections.

choices

A CR-LF delimited list of choices to display.

headingText

Optional. Default = "". The dialog title.

hasSelectAllLink

Optional. Default = .T. . When the value it .T., the Select_All button appears.

hasUnselectAllLink

Optional. Default = .T. . When the value it .T., the Un-Select_All button appears.

hasWildcardSelectLink

Optional. Default = .T. . When the value it .T., the Wildcard Select button appears.

width

Optional. Default = 80. The width of the dialog in characters.

height

Optional. Default = 25. The height of the dialog in lines.

scrollingMode

Character

resizeable

Logical

xbInitialize

Character

opsIn

*

Description

Display a multi-column list of choices, allowing a user to select entries by checking entries. Returns .lastbutton, .selected, .selected_in_selection_order

Discussion

The UI_GET_CHECK2P() function displays a list of check boxes. If necessary, the display will be multi-column.

Example

This example displays a single column of check boxes.

ui_get_check2p("Multi-column list of choices", "blue", choices, "Heading text", .t., .t., .t., 25, 7)
images/FU_UI_GET_CHECK2.gif

This example displays a single column of check boxes.

ui_get_check2p("Multi-column list of choices", defaults, choices, "Heading text", .t., .t., .t., 50, 6)
images/FU_UI_GET_CHECK2b.gif

Limitations

Desktop applications only.

See Also