控件模式属性标识符
本主题介绍用于标识与特定 Microsoft UI 自动化控件模式关联的属性的命名常量。
| 常量/值 | 说明 |
|---|---|
|
标识 Annotation 控件模式的 AnnotationTypeId 属性。 支持从Windows 8开始。 此属性指示批注的类型。 有关可能值的列表，请参阅 批注类型标识符。 变体类型： VT_I4 默认值：0 |
|
标识 Annotation 控件模式的 AnnotationTypeName 属性。 支持从Windows 8开始。 此属性是包含批注类型名称的本地化字符串。 名称可以对应于注释类型标识符之一 (例如注释 AnnotationType_Comment) ，但不需要。 变体类型： VT_BSTR 默认值：空字符串 |
|
标识 Annotation 控件模式的 Author 属性。 支持从Windows 8开始。 此属性是包含批注作者姓名的字符串。 变体类型： VT_BSTR 默认值：空字符串 |
|
标识 Annotation 控件模式的 DateTime 属性。 支持从Windows 8开始。 此属性是包含批注创建日期和时间的字符串。 变体类型： VT_BSTR 默认值：空字符串 |
|
标识“注释”控件模式的 Target 属性。 支持从Windows 8开始。 此属性是正在批注的元素的 IUIAutomationElement 接口。 变体类型： VT_UNKNOWN 默认值： NULL |
|
标识 Dock 控件模式的 DockPosition 属性。 此属性指示自动化元素在停靠容器中的停靠位置，并表示为 DockPosition 枚举类型的值。 变体类型： VT_I4 默认值： DockPosition_None |
|
标识拖动控件模式的 DropEffect 属性。 支持从Windows 8开始。 此属性指示在拖放操作过程中删除元素时会发生什么情况。 变体类型： VT_BSTR 默认值：空字符串 |
|
标识拖动控件模式的 DropEffects 属性。 支持从Windows 8开始。 此属性是字符串的集合，用于枚举在拖放操作过程中删除元素时可能发生的影响。 变体类型： VT_BSTR | VT_ARRAY 默认值：空数组 |
|
标识拖动控件模式的 IsGrabbed 属性。 支持从Windows 8开始。 此属性指示是否拖动元素。 变体类型： VT_BOOL 默认值： FALSE |
|
标识 Drag 控件模式的 GrabbedItems 属性。 支持从Windows 8开始。 此属性是作为拖动操作的一部分进行拖动的元素的集合。 变体类型： VT_UNKNOWN | VT_ARRAY 默认值：空数组 |
|
标识 DropTarget 控件模式的 DropTargetEffect 属性。 支持从Windows 8开始。 此属性指示正在拖动的元素的当前拖放效果。 变体类型： VT_BSTR 默认值：空字符串 |
|
标识 DropTarget 控件模式的 DropTargetEffects 属性。 支持从Windows 8开始。 此属性指示在放置目标上放置元素时可能发生的放置效果。 变体类型： VT_BSTR | VT_ARRAY 默认值：空数组 |
|
标识 ExpandCollapse 控件模式的 ExpandCollapseState 属性。 此属性指示自动化元素的当前状态（展开或折叠），并表示为 ExpandCollapseState 枚举类型的值。 变体类型： VT_I4 默认值： ExpandCollapseState_LeafNode |
|
标识 Grid 控件模式的 ColumnCount 属性。 此属性指示网格中的列总数。 变量类型： VT_I4 默认值：0 |
|
标识 GridItem 控件模式的 Column 属性。 此属性指示包含单元格或项的列的序号。 变量类型： VT_I4 默认值：0 |
|
标识 GridItem 控件模式的 ColumnSpan 属性。 此属性指示单元格或项跨越的列数。 Variant 类型：VT_I4 默认值：1 |
|
标识 GridItem 控件模式的 ContainingGrid 属性。 此属性是包含单元格或项的自动化元素的 IUIAutomationElement 接口指针。 容器元素 (IGridProvider) 实现 Grid 控件模式。 变量类型： VT_UNKNOWN 默认值： NULL |
|
标识 GridItem 控件模式的 Row 属性。 此属性是包含单元格或项的行的序号。 变量类型： VT_I4 默认值：0 |
|
标识 GridItem 控件模式的 RowSpan 属性。 此属性指示单元格或项跨越的行数。 变量类型： VT_I4 默认值：1 |
|
标识 Grid 控件模式的 RowCount 属性。 此属性指示网格中的总行数。 变量类型： VT_I4 默认值：0 |
|
标识 LegacyIAccessible 控件模式的 ChildId 属性。 此属性是 Microsoft Active Accessibility (MSAA) 自动化元素的子标识符。 变量类型： VT_I4 默认值：0 |
|
标识 LegacyIAccessible 控件模式的 DefaultAction 属性。 此属性是自动化元素 (accDefaultAction) MSAA 默认操作。 变量类型： VT_BSTR 默认值：空字符串 |
|
标识 LegacyIAccessible 控件模式的 Description 属性。 此属性是自动化元素 (accDescription) MSAA 说明。 变量类型： VT_BSTR 默认值：空字符串 |
|
标识 LegacyIAccessible 控件模式的帮助属性。 此属性是自动化元素 (accHelp) MSAA 帮助字符串。 变量类型： VT_BSTR 默认值：空字符串 |
|
标识 LegacyIAccessible 控件模式的 KeyboardShortcut 属性。 此属性是自动化元素的 msAA 键盘快捷方式字符串 (accKeyboardShortcut) 。 变量类型： VT_BSTR 默认值：空字符串 |
|
标识 LegacyIAccessible 控件模式的 Name 属性。 此属性是自动化元素的 accName) (MSAA 名称字符串。 变量类型： VT_BSTR 默认值：空字符串 |
|
标识 LegacyIAccessible 控件模式的 Role属性。 此属性是自动化元素的 accRole) (MSAA 角色标识符。 变量类型： VT_I4 默认值：0 |
|
标识 LegacyIAccessible 控件模式的 Selection 属性。 此属性是自动化元素表示的控件中 (accSelection) 选定项的 MSAA 列表。 变体类型： VT_UNKNOWN | VT_ARRAY 默认值：空数组 |
|
标识 LegacyIAccessible 控件模式的 State 属性。 此属性是自动化元素 (accState) MSAA 状态。 变量类型： VT_I4 默认值：0 |
|
标识 LegacyIAccessible 控件模式的 Value 属性。 此属性是自动化元素的 accValue) (MSAA 值。 变量类型： VT_BSTR 默认值：空字符串 |
|
标识 MultipleView 控件模式的 CurrentView 属性。 此属性指示自动化元素的当前视图状态。 变体类型： VT_I4 默认值：0 |
|
标识 MultipleView 控件模式的 SupportedViews 属性。 此属性是自动化元素支持的视图状态的标识符列表。 变体类型： VT_I4 | VT_ARRAY 默认值：空数组 |
|
标识 RangeValue 控件模式的 IsReadOnly 属性。 此属性指示自动化元素的值是否为只读。 变体类型： VT_BOOL 默认值： TRUE |
|
标识 RangeValue 控件模式的 LargeChange 属性。 此属性是向 Value 属性添加或从中减去的自动化元素唯一的大型更改值。 变体类型： VT_R8 默认值：0 |
|
标识 RangeValue 控件模式的 Maximum 属性。 此属性是自动化元素支持的最大范围值。 变体类型： VT_R8 默认值：0 |
|
标识 RangeValue 控件模式的 Minimum 属性。 此属性是自动化元素支持的最小范围值。 变体类型： VT_R8 默认值：0 |
|
标识 RangeValue 控件模式的 SmallChange 属性。 此属性是自动化元素特有的小变化值，它添加到 Value 属性或从 Value 属性中减去。 变体类型： VT_R8 默认值：0 |
|
标识 RangeValue 控件模式的 Value 属性。 此属性是自动化元素的当前值。 变体类型： VT_R8 默认值：0 |
|
标识 Scroll 控件模式的 HorizontallyScrollable 属性。 此属性指示自动化元素是否可以水平滚动。 变体类型： VT_BOOL 默认值： FALSE |
|
标识 Scroll 控件模式的 HorizontalScrollPercent 属性。 此属性是当前水平滚动位置，表示为自动化元素中总内容区域的百分比。 变体类型： VT_R8 默认值：0 |
|
标识 Scroll 控件模式的 HorizontalViewSize 属性。 此属性是可查看区域的水平大小，表示为 元素中总内容区域的百分比。 变体类型： VT_R8 默认值：100 |
|
标识 Scroll 控件模式的 VerticallyScrollable 属性。 此属性指示自动化元素是否可以垂直滚动。 变体类型： VT_BOOL 默认值： FALSE |
|
标识 Scroll 控件模式的 VerticalScrollPercent 属性。 此属性是当前垂直滚动位置，表示为自动化元素中总内容区域的百分比。 变体类型： VT_R8 默认值：0 |
|
标识 Scroll 控件模式的 VerticalViewSize 属性。 此属性是可查看区域的垂直大小，表示为 元素中总内容区域的百分比。 变体类型： VT_R8 默认值：100 |
|
标识 Selection 控件模式的 CanSelectMultiple 属性。 此属性指示自动化元素是否允许同时选择多个子元素。 变体类型： VT_BOOL 默认值： FALSE |
|
标识 Selection 控件模式的 IsSelectionRequired 属性。 此属性指示自动化元素是否需要至少选择一个子项。 变体类型： VT_BOOL 默认值： FALSE |
|
标识 Selection 控件模式的 Selection 属性。 此属性是所选子元素的集合，表示为 IUIAutomationElementArray 指针。 变体类型： VT_UNKNOWN | VT_ARRAY 默认值：空数组 |
|
标识 SelectionItem 控件模式的 IsSelected 属性。 此属性指示是否选择了自动化元素。 变体类型： VT_BOOL 默认值： FALSE |
|
标识 SelectionItem 控件模式的 SelectionContainer 属性。 此属性是包含当前元素的自动化元素的 IUIAutomationElement 接口指针。 变量类型： VT_UNKNOWN 默认值： NULL |
|
标识 SpreadsheetItem 控件模式的 Formula 属性。 此属性是包含电子表格单元格的公式的字符串。 从 Windows 8 开始支持。 变量类型： VT_BSTR 默认值：空字符串 |
|
标识 SpreadsheetItem 控件模式的 AnnotationObjects 属性。 此属性是表示与电子表格单元格关联的批注的UI 自动化元素的集合。 集合表示为 IUIAutomationElementArray 接口。 从 Windows 8 开始支持。 变体类型： VT_UNKNOWN | VT_ARRAY 默认值：空数组 |
|
标识 SpreadsheetItem 控件模式的 AnnotationTypes 属性。 从 Windows 8 开始支持。 此属性是批注类型标识符的数组，用于与电子表格单元格关联的每种类型的批注。 有关可能值的列表，请参阅 批注类型标识符。 变量类型： VT_I4 | VT_ARRAY 默认值：空数组 |
|
标识 Styles 控件模式的 ExtendedProperties 属性。 此属性包含本地化的格式化字符串，该字符串包含其他属性，这些属性未包含在 Styles 控件模式中，但提供有关可能对用户有用的文档内容的信息。 字符串的格式如下：“prop1=value;prop2=value2”。 从 Windows 8 开始支持。 变量类型： VT_BSTR 默认值：空字符串 |
|
标识 Styles 控件模式的 FillColor 属性。 此属性指定用于填充元素的颜色。 此属性表示为 COLORREF，这是用于指定 RGB 或 RGBA 颜色的 32 位值。 从 Windows 8 开始支持。 变量类型： VT_I4 默认值：0 |
|
标识 Styles 控件模式的 FillPatternColor 属性。 此属性指定用于填充元素的图案的颜色。 此属性表示为 COLORREF，这是用于指定 RGB 或 RGBA 颜色的 32 位值。 从 Windows 8 开始支持。 变量类型： VT_I4 默认值：0 |
|
标识 Styles 控件模式的 FillPatternStyle 属性。 此属性是一个本地化字符串，其中包含用于填充元素的图案的样式，例如“垂直条带”。 从 Windows 8 开始支持。 变量类型： VT_BSTR 默认值：空字符串 |
|
标识 Styles 控件模式的 Shape 属性。 此属性是指示元素形状的本地化字符串。 从 Windows 8 开始支持。 变量类型： VT_BSTR 默认值：空字符串 |
|
标识 Styles 控件模式的 StyleId 属性。 此属性标识元素的视觉样式。 有关可能值的列表，请参阅 样式标识符。 从 Windows 8 开始支持。 变量类型： VT_I4 默认值：0 |
|
标识 Styles 控件模式的 StyleName 属性。 此属性是元素的视觉样式的名称。 从 Windows 8 开始支持。 变量类型： VT_BSTR 默认值：空字符串 |
|
标识 Table 控件模式的 ColumnHeaders 属性。 此属性是表中所有列标题的自动化元素的集合，表示为 IUIAutomationElementArray 接口指针。 变体类型： VT_UNKNOWN | VT_ARRAY 默认值：空数组 |
|
标识 TableItem 控件模式的 ColumnHeaderItems 属性。 此属性是表项或单元格中所有列标题的自动化元素集合，表示为 IUIAutomationElementArray 接口指针。 变体类型： VT_UNKNOWN | VT_ARRAY 默认值：空数组 |
|
标识 Table 控件模式的 RowHeaders 属性。 此属性是表中所有行标题的自动化元素集合，表示为 IUIAutomationElementArray 接口指针。 变体类型： VT_UNKNOWN | VT_ARRAY 默认值：空数组 |
|
标识 Table 控件模式的 RowOrColumnMajor 属性。 此属性指示表的主要遍历方向，并表示为 RowOrColumnMajor 枚举类型的值。 变量类型： VT_I4 默认值： RowOrColumnMajor_Indeterminate |
|
标识 TableItem 控件模式的 RowHeaderItems 属性。 此属性是表项或单元格中所有行标题的自动化元素集合，表示为 IUIAutomationElementArray 接口指针。 变体类型： VT_UNKNOWN | VT_ARRAY 默认值：空数组 |
|
标识 Toggle 控件模式的 ToggleState 属性。 此属性指示自动化元素的切换状态，并表示为 ToggleState 枚举类型中的值。 变量类型： VT_I4 默认值： ToggleState_Indeterminate |
|
标识转换控件模式的 CanMove 属性。 此属性指示是否可以移动自动化元素。 变体类型： VT_BOOL 默认值： FALSE |
|
标识转换控件模式的 CanResize 属性。 此属性指示是否可以调整自动化元素的大小。 变体类型： VT_BOOL 默认值： FALSE |
|
标识转换控件模式的 CanRotate 属性。 此属性指示是否可以旋转自动化元素。 变体类型： VT_BOOL 默认值： FALSE |
|
标识 Transform 控件模式的 CanZoom 属性。 此属性指示控件是否支持缩放其视区。 从 Windows 8 开始支持。 变体类型： VT_BOOL 默认值： FALSE |
|
标识 Transform 控件模式的 ZoomLevel 属性。 从 Windows 8 开始支持。 此属性指示控件视区当前缩放级别。 变量类型： VT_R8 默认值：1 |
|
标识 Transform 控件模式的 ZoomMaximum 属性。 从 Windows 8 开始支持。 此属性指示控件的视区支持的最大缩放级别。 变量类型： VT_R8 默认值：1 |
|
标识 Transform 控件模式的 ZoomMinimum 属性。 从 Windows 8 开始支持。 此属性指示控件的视区支持的最低缩放级别。 变量类型： VT_R8 默认值：1 |
|
标识 Value 控件模式的 IsReadOnly 属性。 此属性指示自动化元素的值是否为只读。 变体类型： VT_BOOL 默认值： TRUE |
|
标识 Value 控件模式的 Value 属性。 此属性指示自动化元素的值。 变量类型： VT_BSTR 默认值：空字符串 |
|
标识 Window 控件模式的 CanMaximize 属性。 此属性指示窗口是否可以最大化。 变体类型： VT_BOOL 默认值： FALSE |
|
标识 Window 控件模式的 CanMinimize 属性。 此属性指示是否可以最小化窗口。 变体类型： VT_BOOL 默认值： FALSE |
|
标识 Window 控件模式的 IsModal 属性。 此属性指示窗口是否为模式窗口。 变体类型： VT_BOOL 默认值： FALSE |
|
标识 Window 控件模式的 IsTopmost 属性。 此属性指示窗口是否为 z 顺序中最顶层的元素。 变体类型： VT_BOOL 默认值： FALSE |
|
标识 Window 控件模式的 WindowInteractionState 属性。 此属性指示用于用户交互的窗口状态，并表示为 WindowInteractionState 枚举类型的值。 变体类型： VT_I4 默认值： WindowInteractionState_Running |
|
标识 Window 控件模式的 WindowVisualState 属性。 此属性指示窗口的视觉状态，并表示为 WindowVisualState 枚举类型的值。 变体类型： VT_I4 默认值： WindowVisualState_Normal |
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows XP [桌面应用 |UWP 应用] |
| 最低受支持的服务器 |
Windows Server 2003 [桌面应用 |UWP 应用] |
| 标头 |
|
另请参阅
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈