AutomationProperties Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona compatibilidad para obtener o establecer valores de nivel de instancia de las propiedades de automatización. Estos valores de propiedad se establecen como propiedades adjuntas (normalmente en XAML) y complementan o invalidan los valores de propiedad de automatización de los AutomationPeer de un control.
public ref class AutomationProperties sealed/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AutomationProperties final[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class AutomationPropertiesPublic NotInheritable Class AutomationProperties- Herencia
- Atributos
Comentarios
Propiedades adjuntas xaml
AutomationProperties es la clase de servicio host para varias propiedades adjuntas XAML . El propósito de estas propiedades adjuntas es habilitar la configuración de varios valores por instancia que son pertinentes para la forma en que se notifica un elemento de interfaz de usuario al marco de accesibilidad de Automatización de la interfaz de usuario de Microsoft. Esto es útil en los casos en los que el diseño de clase del elemento de interfaz de usuario aún no reenvía otros valores de propiedad relacionados con la interfaz de usuario como parte de su comportamiento de integración de Automatización de la interfaz de usuario de Microsoft o del mismo nivel, o donde el valor que se reenvía no es el valor que desea informar a Microsoft UI Automation.
Para admitir el acceso del procesador XAML a las propiedades adjuntas y también para exponer operaciones equivalentes de obtención y establecimiento en código, cada propiedad adjunta XAML tiene un par de Obtener y Establecer métodos de descriptor de acceso, que también son miembros de AutomationProperties. Por ejemplo, los métodos GetName y SetName admiten y proporcionan la compatibilidad equivalente de solo código para la automatización de informes valores de Name a Microsoft UI Automation, en lugar de usar la propiedad adjunta Name para establecerla en XAML. Como alternativa, puede usar el sistema de propiedades de dependencia para obtener o establecer el valor de la propiedad adjunta, y esto también informa del valor subyacente a Automatización de la interfaz de usuario de Microsoft. Llame a GetValue o SetValue, pasando los argumentos del identificador de propiedad de dependencia que se va a establecer y una referencia al objeto de destino en el que se va a obtener o establecer el valor.
Propiedad Name
De las distintas propiedades adjuntas, probablemente la más importante sea Nombre. Esto se debe a que es la propiedad Name a la que se accede con más frecuencia y se notifica mediante tecnología de asistencia cuando los usuarios interactúan con una aplicación en un escenario de accesibilidad. El Nombre actúa como identificador legible para el elemento de la interfaz de usuario.
Varios elementos de interfaz de usuario tienen reenvío del mismo nivel que puede proporcionar un valor predeterminado Nombre en función de otras propiedades de elemento. Por ejemplo, el reenvío del mismo nivel de la clase button button
Por motivos de localización, debes evitar valores de cadena codificados de forma rígida para el Nombre en XAML. Si establece directiva x:Uid en el elemento , puede usar recursos RESW para dirigirse a la propiedad y proporcionar valores diferentes para la localización. Para las propiedades adjuntas, el formulario de identificador de recursos requiere una calificación completa de la propiedad adjunta en formato XAML, incluido su espacio de nombres y un uso: prefijo. Por ejemplo, para tener como destino el valor de la propiedad adjunta AutomationProperties.Name en un recurso que tiene directiva x:Uid valor de "sendButton", el nombre de valor del elemento de datos en los recursos de RESW es sendButton.[using:Windows.UI.Xaml.Automation]AutomationProperties.Name
Propiedades adjuntas
Nota
Para obtener más información sobre cada propiedad adjunta, consulta la página del campo identificador de de la propiedad.
| Propiedad adjunta | Descripción |
|---|---|
| AcceleratorKey | Obtiene o establece la tecla de aceleración del elemento especificado.
|
| AccessibilityView | Obtiene o establece el modo de vista de árbol de Automatización de la interfaz de usuario de Microsoft para un elemento.
|
| AccessKey | Obtiene o establece la clave de acceso del elemento especificado.
|
| AutomationId | Obtiene o establece la cadena que identifica de forma única el elemento a Automatización de la interfaz de usuario de Microsoft.
|
| Cultura | Obtiene o establece el identificador de configuración regional del elemento de automatización (por ejemplo, 0x0409 para "en-US" o inglés (Estados Unidos)).
|
| FullDescription | Obtiene o establece una cadena localizada que contiene texto de descripción extendido para un elemento.
|
| HeadingLevel | Obtiene o establece el nivel de título de un elemento de Automatización de la interfaz de usuario.
|
| HelpText | Obtiene o establece el texto de ayuda del elemento.
|
| IsDataValidForForm | Obtiene o establece un valor que indica si los datos son válidos para el formulario.
|
| IsDialog | Obtiene o establece un valor que indica si el elemento de automatización es una ventana de diálogo.
|
| IsPeripheral | Obtiene o establece un valor que indica si el elemento de automatización representa la interfaz de usuario periférica.
|
| IsRequiredForForm | Obtiene o establece un valor que indica si es necesario rellenar el elemento en un formulario.
|
| ItemStatus | Obtiene o establece una descripción del estado de un elemento de un elemento.
|
| ItemType | Obtiene o establece una descripción del tipo del elemento especificado.
|
| LabeledBy | Obtiene o establece el elemento que contiene la etiqueta de texto del elemento.
|
| LandmarkType | Obtiene o establece un identificador de tipo de punto de referencia asociado a un elemento .
|
| Nivel | Obtiene o establece un entero basado en 1 que describe la ubicación de un elemento dentro de estructuras jerárquicas o jerárquicas rotas.
|
| LiveSetting | Obtiene o establece el valor de configuración activo del elemento especificado.
|
| LocalizedControlType | Obtiene o establece una cadena de texto localizada que describe el tipo de control que representa el elemento de automatización.
|
| LocalizedLandmarkType | Obtiene o establece una cadena de texto localizada que describe el tipo de punto de referencia que representa el elemento de automatización.
|
| Nombre | Obtiene o establece el nombre de automatización de la interfaz de usuario del elemento.
|
| PositionInSet | Obtiene o establece un entero basado en 1 que describe la ubicación ordinal del elemento dentro de un conjunto de elementos que se consideran relacionados.
|
| SizeOfSet | Obtiene o establece el número de elementos de un conjunto de elementos que se consideran relacionados.
|
Propiedades
| AcceleratorKeyProperty |
Identifica la AutomationProperties.AcceleratorKey propiedad adjunta, que es una cadena que contiene las combinaciones de teclas de aceleración (también denominada tecla de método abreviado) para el elemento de automatización. |
| AccessibilityViewProperty |
Identifica la propiedad adjunta AutomationProperties.AccessibilityView. Establezca esta propiedad adjunta en elementos individuales para cambiar su visibilidad de elementos a modos específicos solicitados por un cliente de Automatización de la interfaz de usuario. |
| AccessKeyProperty |
Identifica la propiedad adjunta AutomationProperties.AccessKey, que es una cadena que contiene el carácter de clave de acceso para el elemento de automatización. |
| AnnotationsProperty |
Identifica una propiedad de dependencia que se usa para una lista de objetos de anotación de un documento, como comentario, encabezado, pie de página, etc. |
| AutomationControlTypeProperty |
Identifica la AutomationProperties propiedad adjunta, que es un Microsoft.UI.Xaml.Automation.Peers.AutomationControlType. |
| AutomationIdProperty |
Identifica la propiedad adjunta AutomationProperties.AutomationId, que es una cadena que contiene el identificador (ID) de automatización de la interfaz de usuario para el elemento de automatización. |
| ControlledPeersProperty |
Identifica la propiedad adjunta ControlledPeers, que se usa para una colección de elementos de automatización que el elemento de automatización especificado puede manipular. |
| CultureProperty |
Obtiene el identificador de la propiedad adjunta de referencia cultural que contiene un identificador de configuración regional para el elemento de automatización (por ejemplo, 0x0409 para "en-US" o inglés (Estados Unidos)). |
| DescribedByProperty |
Obtiene el identificador de la propiedad adjunta descrita, que es una matriz de elementos que proporcionan más información sobre el elemento de automatización. |
| FlowsFromProperty |
Obtiene el identificador de la FlowsFrom propiedad adjunta, que es una matriz de elementos de automatización que sugiere el orden de lectura antes del elemento de automatización actual. |
| FlowsToProperty |
Obtiene el identificador de la FlowsTo propiedad adjunta, que es una matriz de elementos de automatización que sugiere el orden de lectura después del elemento de automatización actual. |
| FullDescriptionProperty |
Obtiene el identificador de la propiedad adjunta de descripción completa, que expone una cadena localizada que contiene texto de descripción extendido para un elemento. |
| HeadingLevelProperty |
Obtiene el identificador de la propiedad adjunta HeadingLevel , que indica el nivel de encabezado de un elemento de automatización de la interfaz de usuario. |
| HelpTextProperty |
Identifica la propiedad adjunta AutomationProperties.HelpText, que es una cadena de texto de ayuda asociada al elemento automation. |
| IsDataValidForFormProperty |
Identifica la propiedad de dependencia booleana que indica si los datos son válidos para el formulario. |
| IsDialogProperty |
Identifica la AutomationProperties.IsDialog propiedad adjunta, que es un valor booleano que indica si el elemento de automatización es una ventana de diálogo. |
| IsPeripheralProperty |
Identifica la propiedad de dependencia booleana que indica si el elemento de automatización representa la interfaz de usuario periférica. |
| IsRequiredForFormProperty |
Identifica la AutomationProperties.IsRequiredForForm propiedad adjunta, que es un valor booleano que indica si es necesario rellenar el elemento de automatización en un formulario. |
| ItemStatusProperty |
Identifica la propiedad adjunta ItemStatus, que describe el estado de un elemento de elemento de automatización. |
| ItemTypeProperty |
Identifica la propiedad adjunta AutomationProperties.ItemType, que es una cadena de texto que describe el tipo del elemento de automatización. |
| LabeledByProperty |
Identifica la propiedad adjunta AutomationProperties.LabeledBy, que es un elemento de automatización que contiene la etiqueta de texto de este elemento. |
| LandmarkTypeProperty |
Obtiene el identificador de la propiedad adjunta del tipo de punto de referencia, que es un identificador de tipo de punto de referencia asociado a un elemento. |
| LevelProperty |
Obtiene el identificador de la propiedad adjunta level de |
| LiveSettingProperty |
Identifica la propiedad adjunta AutomationProperties.LiveSetting, que es compatible con un elemento de automatización que representa una región activa. |
| LocalizedControlTypeProperty |
Identifica la propiedad de dependencia del tipo de control localizado, que es una cadena de texto que describe el tipo de control que representa el elemento de automatización. |
| LocalizedLandmarkTypeProperty |
Obtiene el identificador de la propiedad adjunta de tipo de punto de referencia localizado, que es una cadena de texto localizada que describe el tipo de punto de referencia que representa el elemento de automatización. |
| NameProperty |
Identifica la propiedad adjunta AutomationProperties.Name, que es una cadena que contiene el nombre del elemento de automatización. |
| PositionInSetProperty |
Obtiene el identificador de la PositionInSet propiedad adjunta, que es un entero basado en 1 asociado a un elemento de automatización. |
| SizeOfSetProperty |
Obtiene el identificador de la propiedad adjunta. |
Propiedades adjuntas
| AcceleratorKey |
Obtiene o establece una cadena que contiene las combinaciones de teclas de aceleración (también denominada tecla de método abreviado) para el elemento de automatización. |
| AccessibilityView |
Obtiene o establece el modo de vista de árbol de Automatización de la interfaz de usuario de Microsoft para un elemento. |
| AccessKey |
Obtiene o establece una cadena que contiene el carácter de clave de acceso para el elemento de automatización. |
| Annotations |
Obtiene una lista de objetos de anotación en un documento, como comentario, encabezado, pie de página, etc. |
| AutomationControlType |
Identifica el tipo de elemento de interfaz de usuario (UI) que se expone al cliente de Automatización de la interfaz de usuario de Microsoft. |
| AutomationId |
Obtiene o establece la cadena que identifica de forma única el elemento a Automatización de la interfaz de usuario de Microsoft. |
| ControlledPeers |
Obtiene una colección de elementos de automatización que el elemento de automatización especificado puede manipular. |
| Culture |
Obtiene o establece el identificador de configuración regional del elemento de automatización (por ejemplo, 0x0409 para "en-US" o inglés (Estados Unidos)). |
| DescribedBy |
Obtiene una matriz de elementos que proporcionan más información sobre el elemento de automatización. |
| FlowsFrom |
Obtiene una matriz de elementos de automatización que sugiere el orden de lectura antes del elemento de automatización actual. |
| FlowsTo |
Obtiene una matriz de elementos de automatización que sugiere el orden de lectura después del elemento de automatización actual. |
| FullDescription |
Obtiene o establece una cadena localizada que contiene texto de descripción extendido para un elemento. |
| HeadingLevel |
Obtiene o establece el nivel de título de un elemento de Automatización de la interfaz de usuario. |
| HelpText |
Obtiene o establece una cadena de texto de ayuda asociada al elemento de automatización. |
| IsDataValidForForm |
Obtiene o establece un valor que indica si los datos son válidos para el formulario. |
| IsDialog |
Obtiene o establece un valor que indica si el elemento de automatización es una ventana de diálogo. |
| IsPeripheral |
Obtiene o establece un valor que indica si el elemento de automatización representa la interfaz de usuario periférica. |
| IsRequiredForForm |
Obtiene o establece un valor que indica si es necesario rellenar el elemento en un formulario. |
| ItemStatus |
Obtiene o establece una descripción del estado de un elemento de un elemento. |
| ItemType |
Obtiene o establece una descripción del tipo del elemento especificado. |
| LabeledBy |
Obtiene o establece el elemento de automatización que contiene la etiqueta de texto de este elemento. |
| LandmarkType |
Obtiene o establece un identificador de tipo de punto de referencia asociado a un elemento . |
| Level |
Obtiene o establece un entero basado en 1 que describe la ubicación de un elemento dentro de estructuras jerárquicas o jerárquicas rotas. |
| LiveSetting |
Obtiene o establece el valor de configuración activo del elemento especificado, que es compatible con un elemento de automatización que representa una región activa. |
| LocalizedControlType |
Obtiene o establece una cadena de texto localizada que describe el tipo de control que representa el elemento de automatización. |
| LocalizedLandmarkType |
Obtiene o establece una cadena de texto localizada que describe el tipo de punto de referencia que representa el elemento de automatización. |
| Name |
Obtiene o establece el nombre de automatización de la interfaz de usuario del elemento. |
| PositionInSet |
Obtiene o establece un entero basado en 1 que describe la ubicación ordinal del elemento dentro de un conjunto de elementos que se consideran relacionados. |
| SizeOfSet |
Obtiene o establece el número de elementos de un conjunto de elementos que se consideran relacionados. |