Legato
Legato

GoFiler Legato Script Reference

 

Legato v 1.5b

Application v 5.24b

  

 

Chapter NineDialog Functions (continued)

COMBOBOX Resource Statement

Overview

The COMBOBOX statement can be used as part of the body of a dialog resource specification. It is a specific method of specifying a combo box. A combo box consists of either a static text box or an edit box combined with a list box.

Syntax/Parameters

Syntax

COMBOBOX id, x, y, width, height, [style], [extended-style]

Parameters

id

The control identifier. This value must be a 16-bit unsigned integer in the range 0 through 65,535 or -1 (same as 0xFFFF or 65535). Except for -1, control identifiers must be unique. Duplicate control values for the same dialog page will result in an error. id is used to access the control within dialog procedures. A value of -1 is typically used for legends and other static controls and cannot be used for controls that require programmatic access.

x

The X coordinate in dialog units of the left side of the control relative to the left side of the dialog box. This value must be a 16-bit unsigned integer in the range 0 through 65,535. Use caution when overlaying controls.

y

The Y coordinate in dialog units of the top side of the control relative to the top of the dialog box. This value must be a 16-bit unsigned integer in the range 0 through 65,535. Use caution when overlaying controls.

width

The width of the control. This value must be a 16-bit unsigned integer in the range 1 through 65,535. The width is in 1/4-character units.

height

The height of the control. This value must be a 16-bit unsigned integer in the range 1 through 65,535. The height is in 1/8-character units.

style

An optional predefined name or literal integer value that specifies the style of the control. By default, the style is CBS_SIMPLE | WS_TABSTOP.

extended-style

An optional extended window style. The style parameter must be specified in order to specify extended-style. For more information, see EXSTYLE.

Remarks

Combo boxes can appear and behave in numerous different ways, dictated by the style parameter. The list box can be displayed at all times or pulled down by the user. If the combo box contains a static text box, the text box always displays the selection (if any) in the list box portion of the combo box. If it uses an edit box, the user can type in the desired selection; the list box highlights the first item (if any) that matches what the user has entered in the edit box. The user can then select the item highlighted in the list box to complete the choice. [In addition, the combo box can be owner-drawn and of fixed or variable height.]