大网数据广告活动
安装更新与部署

CheckBox Control (Windows Installer)

· 52CE 我爱测

This CheckBox_control is a two-state check box.

This CheckBox_control is a two-state check box. To associate an integer or string property with this control, enter the property name into the Property column of the Control table. The selected state of the box sets the property either to the value specified in the Value column of the CheckBox table or to the initial value of the property specified in the Property table. If the property has no initial value, the checked state sets it to 1. The unselected state sets the property to null.

CheckBox controls can only be used to publish AddLocal ControlEvent, AddSource ControlEvent, Remove ControlEvent, DoAction ControlEvent, or SetProperty ControlEvent controls.

Control Attributes

You can use the following attributes with this control. To change the value of an attribute using an event, subscribe the control to a ControlEvent in the EventMapping table and list the attribute's identifier in the Attribute column. Enter the identifier of the ControlEvent in the Event column.

Attribute identifier Hexadecimal bit Description
IndirectPropertyName This is the name of an indirect property associated with the control. If the Indirect attribute bit is set, the control displays or changes the value of the property having this name. If the Indirect attribute bit is set, this name is also the value of the property listed in the Property column of the Control table.
Position Position of control in the dialog box. Enter the control's width, height, and coordinates of the control's left corner into the Width, Height, X, and Y columns of the Control table. Use installer units for length and distance.
PropertyName This is the name of the property associated with this control. If the Indirect attribute bit is not set, the control displays or changes the value of the property having this name. This attribute is specified in the Property column of the Control table.
PropertyValue Current value of the property displayed or changed by this control. If the Indirect attribute bit is not set, this is the value of PropertyName. If the Indirect attribute bit is set, this is the value of IndirectPropertyName. If the attribute changes, the control reflects the new value.
Text This control attribute can specify the text displayed by the control, an image stored in the Binary table, or an image set at run time. To specify text, enter the text string into the Text column of the Control table. To set the font and font style of a text string, prefix the string of displayed characters with {\style} or {&style}. Where style is an identifier listed in the TextStyle column of the TextStyle table. If neither of these are present, but the DefaultUIFont property is defined as a valid text style, that font will be used. To specify an icon or bitmap image stored in the Binary table, enter the primary key of the image's record from the Name column of the Binary table into the Text column of the Control table record for the control.
Visible 0x00000000 0x00000001 Hidden control. Visible control. Include this bit in the bit word of the Attributes column in the Control table to make the control visible or hidden upon its creation. You can also hide or show a control by using the ControlCondition table.
Enabled 0x00000000 0x00000002 Control in a disabled state. Control in an enabled state. Include this bit in the Attributes column of the Control table to enable the control on creation. You can also enable or disable a control by using the ControlCondition table.
Sunken 0x00000000 0x00000004 Displays the default visual style. Displays the control with a sunken, 3-D, look. Include these bits in the bit word in the Attributes column of the Control table.
Indirect 0x00000000 0x00000008 The control displays or changes the value of the property in the Property column of the Control table. The control displays or changes the value of the property that has the Identifier listed in the Property column of the Control table. Determines if the property associated with this control is referenced indirectly.
Integer 0x00000000 0x00000010 Property associated with the control is a string value. Property associated with the control is an integer value. Include this bit in the bit word of the Attributes column of the Control table to set this attribute on creation of the control.
RTLRO 0x00000000 0x00000020 Text in the control is displayed in left-to-right reading order. Text in the control is displayed in right-to-left reading order.
RightAligned 0x00000000 0x00000040 Text in the control is aligned to the left. Text in the control is aligned to the right.
PushLike 0x00000000 0x00020000 Control is drawn with its usual appearance. Control has the BS_PUSHLIKE style, and is drawn to appear as a push button. Include this bit in the bit word of the Attributes column of the Control table to set this attribute on creation of the control.

Remarks

This control can be created from the BUTTON class by using the CreateWindowEx function. It has the BS_CHECKBOX, WS_TABSTOP, WS_GROUP, WS_CHILD, and BS_MULTILINE styles.

Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.

资料来源与适用范围

资料来源
Microsoft Learn / Windows Win32 documentation
适用范围
Windows Win32 API · Source date 05/31/2018
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0 (documentation), MIT (code samples)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。