  |
GoFiler Legato Script Reference
Legato v 1.5d Application v 5.25a
|
| Table of Contents | < < Previous | Next >> |
Chapter Nine — Dialog Functions (continued)
Overview
The CONTROL statement can be used as part of the body of a dialog resource specification. It is a generic method of specifying class, position, and style information for a control that allows for user-defined attributes. Any type of control can be specified with this statement.
Syntax/Parameters
Syntax
CONTROL text, id, class, style, x, y, width, height, [extended-style]
Parameters
text
The text that is to be displayed with the control (the control’s caption). The text is positioned within the control or adjacent to the control.
This parameter must contain zero or more characters enclosed in double quotation marks ("). Strings are automatically converted to Unicode in the resulting resource file. By default, the characters listed between the double quotation marks are ANSI characters, and escape sequences are interpreted as byte escape sequences. If a double quotation mark is required in the text, you must include the double quotation mark twice. An ampersand (&) character in the text indicates that the following character is used as a mnemonic character for the control. When the control is displayed, the ampersand is not shown but the mnemonic character is underlined. The user can choose the control by pressing the key corresponding to the underlined mnemonic character. To use the ampersand as a character in a string, insert two ampersands (&&).
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. This id is used to access the control within dialog procedures. An id of -1 is typically used for legends and other static controls and cannot be used for controls that require programmatic access.
class
A predefined class name that defines the class. This can be any one of the control classes; for a list of the control classes, see the first list following this description. The string must be enclosed in double quotation marks (").
style
A predefined name or integer value that specifies the style of the control. The exact meaning of style depends on the class value. Styles for specific classes are typically mixed with window control styles such as WS_TABSTOP or WS_CHILD.
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.
extended-style
An optional predefined name or literal integer value that specifies the style of the control. For more information, see EXSTYLE.
Remarks
The CONTROL entry of a resource dialog allows universal specification of controls. Each CONTROL statement defines one control on a dialog page. While CONTROL can be mixed with other styles of control specifications, they all compile to the same basic window class, position, and style.
| Table of Contents | < < Previous | Next >> |
© 2012-2024 Novaworks, LLC. All rights reserved worldwide. Unauthorized use, duplication or transmission prohibited by law. Portions of the software are protected by US Patents 10,095,672, 10,706,221 and 11,210,456. GoFiler™ and Legato™ are trademarks of Novaworks, LLC. EDGAR® is a federally registered trademark of the U.S. Securities and Exchange Commission. Novaworks is not affiliated with or approved by the U.S. Securities and Exchange Commission. All other trademarks are property of their respective owners. Use of the features specified in this language are subject to terms, conditions and limitations of the Software License Agreement.