AutomationProperties Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece suporte para obter ou definir valores no nível da instância das propriedades de automação. Esses valores de propriedade são definidos como propriedades anexadas (normalmente em XAML) e complementam ou substituem valores de propriedade de automação do AutomationPeer de um controle.
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 AutomationProperties
Public NotInheritable Class AutomationProperties
- Herança
- Atributos
Comentários
Propriedades anexadas de XAML
AutomationProperties é a classe de serviço de host para várias propriedades anexadas XAML. A finalidade dessas propriedades anexadas é habilitar a configuração de vários valores por instância pertinentes à forma como um elemento de interface do usuário é relatado à estrutura de acessibilidade da Automação da Interface do Usuário da Microsoft. Isso é útil nos casos em que o design de classe do elemento de interface do usuário ainda não encaminha outros valores de propriedade relacionados à interface do usuário como parte de sua integração de Automação da Interface do Usuário da Microsoft ou comportamento de implementação de par, ou onde o valor que está sendo encaminhado não é o valor que você deseja relatar à Automação da Interface do Usuário da Microsoft.
Para dar suporte ao acesso do processador XAML às propriedades anexadas e também para expor operações de obtenção e definição equivalentes ao código, cada propriedade anexada XAML tem um par de métodos de acessador Get e Set , que também são membros de AutomationProperties. Por exemplo, os métodos GetName e SetName dão suporte e fornecem o suporte somente de código equivalente para relatar valores de nome de automação para a Automação da Interface do Usuário da Microsoft, em vez de usar a propriedade anexada Name para defini-la em XAML. Como alternativa, você pode usar o sistema de propriedades de dependência para obter ou definir o valor da propriedade anexada, e isso também relata o valor subjacente para a Automação da Interface do Usuário da Microsoft. Chame GetValue ou SetValue, passando os argumentos do identificador de propriedade de dependência para definir e uma referência ao objeto de destino no qual obter ou definir o valor.
Propriedade Name
Das várias propriedades anexadas, provavelmente a mais importante é Nome. Isso ocorre porque é a propriedade Name que é acessada com mais frequência e relatada pela tecnologia adaptativa quando os usuários interagem com um aplicativo em um cenário de acessibilidade. O Nome serve como o identificador legível para o elemento de interface do usuário.
Vários elementos de interface do usuário têm encaminhamento de pares que podem fornecer um valor name padrão com base em outras propriedades de elemento. Por exemplo, o encaminhamento de pares para a classe Button encaminhará a avaliação ToString do conteúdo do Botão e usará essa cadeia de caracteres como o Nome padrão. Para substituir esse padrão ou fornecer um valor Name para qualquer caso de elemento de interface do usuário em que não haja nenhum Nome de Automação da Interface do Usuário da Microsoft disponível, defina a propriedade anexada Name nesse elemento em XAML. Para obter mais informações sobre por que um Nome de Automação da Interface do Usuário da Microsoft é importante, consulte Informações básicas de acessibilidade. Para obter mais informações sobre como testar se um elemento já tem um Nome fornecido por pares que é útil, consulte Teste de acessibilidade.
Por motivos de localização, você deve evitar valores de cadeia de caracteres embutidos em código para o Nome em XAML. Se você definir a diretiva x:Uid no elemento , poderá usar recursos RESW para direcionar a propriedade e fornecer valores diferentes para localização. Para propriedades anexadas, o formulário de identificador de recurso requer a qualificação completa da propriedade anexada no formato XAML, incluindo seu namespace e um prefixo using: . Por exemplo, para direcionar o valor da propriedade anexada AutomationProperties.Name em um recurso que tem o valor da diretiva x:Uid de "sendButton", o valor do nome do item de dados nos recursos RESW é sendButton.[using:Windows.UI.Xaml.Automation]AutomationProperties.Name
Propriedades anexadas
Observação
Para obter mais informações sobre cada propriedade anexada, consulte a página do campo Identificador da propriedade.
Propriedade anexada | Descrição |
---|---|
Acceleratorkey | Obtém ou define a tecla de aceleração para o elemento especificado.
|
AccessibilityView | Obtém ou define o modo de exibição de árvore da Automação da Interface do Usuário da Microsoft para um elemento.
|
AccessKey | Obtém ou define a chave de acesso do elemento especificado.
|
AutomationId | Obtém ou define a cadeia de caracteres que identifica exclusivamente o elemento para a Automação da Interface do Usuário da Microsoft.
|
Cultura | Obtém ou define o identificador de localidade para o elemento de automação (por exemplo, 0x0409 para "en-US" ou inglês (Estados Unidos)).
|
FullDescription | Obtém ou define uma cadeia de caracteres localizada que contém texto de descrição estendido para um elemento.
|
HeadingLevel | Obtém ou define o nível de título para um elemento de Automação da Interface do Usuário.
|
HelpText | Obtém ou define o texto de ajuda para o elemento .
|
IsDataValidForForm | Obtém ou define um valor que indica se os dados são válidos para o formulário.
|
IsDialog | Obtém ou define um valor que indica se o elemento de automação é uma janela de diálogo.
|
IsPeripheral | Obtém ou define um valor que indica se o elemento de automação representa a interface do usuário periférica.
|
Isrequiredforform | Obtém ou define um valor que indica se o elemento é necessário para ser preenchido em um formulário.
|
Itemstatus | Obtém ou define uma descrição do status de um item em um elemento .
|
ItemType | Obtém ou define uma descrição do tipo de elemento especificado.
|
LabeledBy | Obtém ou define o elemento que contém o rótulo de texto para o elemento .
|
LandmarkType | Obtém ou define um Identificador de Tipo de Ponto de Referência associado a um elemento .
|
Nível | Obtém ou define um inteiro baseado em 1 que descreve o local de um elemento dentro de estruturas hierárquicas ou hierárquicas quebradas.
|
LiveSetting | Obtém ou define o valor de configuração dinâmica para o elemento especificado.
|
Localizedcontroltype | Obtém ou define uma cadeia de caracteres de texto localizada que descreve o tipo de controle que o elemento de automação representa.
|
LocalizedLandmarkType | Obtém ou define uma cadeia de caracteres de texto localizada que descreve o tipo de ponto de referência que o elemento de automação representa.
|
Nome | Obtém ou define o nome da Automação da Interface do Usuário do elemento .
|
PositionInSet | Obtém ou define um inteiro baseado em 1 que descreve o local ordinal do elemento dentro de um conjunto de elementos considerados irmãos.
|
SizeOfSet | Obtém ou define o número de elementos em um conjunto de elementos considerados irmãos.
|
Propriedades
AcceleratorKeyProperty |
Identifica a propriedade anexada AutomationProperties.AcceleratorKey , que é uma cadeia de caracteres que contém as combinações de tecla de acelerador (também chamada de tecla de atalho) para o elemento de automação. |
AccessibilityViewProperty |
Identifica a propriedade anexada AutomationProperties.AccessibilityView . Defina essa propriedade anexada em elementos individuais para alterar a visibilidade do elemento para modos específicos solicitados por um cliente de Automação da Interface do Usuário. |
AccessKeyProperty |
Identifica a propriedade anexada AutomationProperties.AccessKey , que é uma cadeia de caracteres que contém o caractere de chave de acesso para o elemento de automação. |
AnnotationsProperty |
Identifica uma propriedade de dependência usada para uma lista de objetos de anotação em um documento, como comentário, cabeçalho, rodapé e assim por diante. |
AutomationControlTypeProperty |
Identifica a AutomationProperties propriedade anexada, que é um Microsoft.UI.Xaml.Automation.Peers.AutomationControlType. |
AutomationIdProperty |
Identifica a propriedade anexada AutomationProperties.AutomationId , que é uma cadeia de caracteres que contém o ID (identificador de Automação da Interface do Usuário) para o elemento de automação. |
ControlledPeersProperty |
Identifica a propriedade anexada ControlledPeers, que é usada para uma coleção de elementos de automação que podem ser manipulados pelo elemento de automação especificado. |
CultureProperty |
Obtém o identificador da propriedade anexada à cultura que contém um identificador de localidade para o elemento de automação (por exemplo, 0x0409 para "en-US" ou inglês (Estados Unidos)). |
DescribedByProperty |
Obtém o identificador do descrito pela propriedade anexada, que é uma matriz de elementos que fornecem mais informações sobre o elemento de automação. |
FlowsFromProperty |
Obtém o identificador da propriedade anexada FlowsFrom , que é uma matriz de elementos de automação que sugere a ordem de leitura antes do elemento de automação atual. |
FlowsToProperty |
Obtém o identificador da propriedade anexada FlowsTo , que é uma matriz de elementos de automação que sugere a ordem de leitura após o elemento de automação atual. |
FullDescriptionProperty |
Obtém o identificador da propriedade anexada de descrição completa, que expõe uma cadeia de caracteres localizada contendo texto de descrição estendida para um elemento. |
HeadingLevelProperty |
Obtém o identificador da propriedade anexada HeadingLevel , que indica o nível de título para um elemento de Automação da Interface do Usuário. |
HelpTextProperty |
Identifica a propriedade anexada AutomationProperties.HelpText , que é uma cadeia de caracteres de texto de ajuda associada ao elemento de automação. |
IsDataValidForFormProperty |
Identifica a propriedade de dependência booliana que indica se os dados são válidos para o formulário. |
IsDialogProperty |
Identifica a propriedade anexada AutomationProperties.IsDialog , que é um valor booliano que indica se o elemento de automação é uma janela de diálogo. |
IsPeripheralProperty |
Identifica a propriedade de dependência booliana que indica se o elemento de automação representa a interface do usuário periférica. |
IsRequiredForFormProperty |
Identifica a propriedade anexada AutomationProperties.IsRequiredForForm , que é um valor booliano que indica se o elemento de automação deve ser preenchido em um formulário. |
ItemStatusProperty |
Identifica a propriedade anexada ItemStatus, que descreve a status de um item de elemento de automação. |
ItemTypeProperty |
Identifica a propriedade anexada AutomationProperties.ItemType , que é uma cadeia de texto que descreve o tipo do elemento de automação. |
LabeledByProperty |
Identifica a propriedade anexada AutomationProperties.LabeledBy , que é um elemento de automação que contém o rótulo de texto para esse elemento. |
LandmarkTypeProperty |
Obtém o identificador da propriedade anexada de tipo de ponto de referência, que é um Identificador de Tipo de Ponto de Referência associado a um elemento . |
LevelProperty |
Obtém o identificador da propriedade anexada Level , que é um inteiro baseado em 1 associado a um elemento de automação. |
LiveSettingProperty |
Identifica a propriedade anexada AutomationProperties.LiveSetting , que é compatível com um elemento de automação que representa uma região dinâmica. |
LocalizedControlTypeProperty |
Identifica a propriedade de dependência do tipo de controle localizado, que é uma cadeia de caracteres de texto que descreve o tipo de controle que o elemento de automação representa. |
LocalizedLandmarkTypeProperty |
Obtém o identificador da propriedade anexada do tipo de ponto de referência localizado, que é uma cadeia de caracteres de texto localizada que descreve o tipo de ponto de referência que o elemento de automação representa. |
NameProperty |
Identifica o AutomationProperties.Name propriedade anexada, que é uma cadeia de caracteres que contém o nome do elemento de automação. |
PositionInSetProperty |
Obtém o identificador da propriedade anexada PositionInSet , que é um inteiro baseado em 1 associado a um elemento de automação. |
SizeOfSetProperty |
Obtém o identificador da propriedade anexada. |
Propriedades Anexadas
AcceleratorKey |
Obtém ou define uma cadeia de caracteres que contém as combinações de tecla de acelerador (também chamada de tecla de atalho) para o elemento de automação. |
AccessibilityView |
Obtém ou define o modo de exibição de árvore da Automação da Interface do Usuário da Microsoft para um elemento . |
AccessKey |
Obtém ou define uma cadeia de caracteres que contém o caractere de chave de acesso para o elemento de automação. |
Annotations |
Obtém uma lista de objetos de anotação em um documento, como comentário, cabeçalho, rodapé e assim por diante. |
AutomationControlType |
Identifica o tipo de elemento de interface do usuário exposto ao cliente de Automação da Interface do Usuário da Microsoft. |
AutomationId |
Obtém ou define a cadeia de caracteres que identifica exclusivamente o elemento para a Automação da Interface do Usuário da Microsoft. |
ControlledPeers |
Obtém uma coleção de elementos de automação que podem ser manipulados pelo elemento de automação especificado. |
Culture |
Obtém ou define o identificador de localidade para o elemento de automação (por exemplo, 0x0409 para "en-US" ou inglês (Estados Unidos)). |
DescribedBy |
Obtém uma matriz de elementos que fornecem mais informações sobre o elemento de automação. |
FlowsFrom |
Obtém uma matriz de elementos de automação que sugere a ordem de leitura antes do elemento de automação atual. |
FlowsTo |
Obtém uma matriz de elementos de automação que sugere a ordem de leitura após o elemento de automação atual. |
FullDescription |
Obtém ou define uma cadeia de caracteres localizada que contém texto de descrição estendido para um elemento. |
HeadingLevel |
Obtém ou define o nível de título para um elemento de Automação da Interface do Usuário. |
HelpText |
Obtém ou define uma cadeia de caracteres de texto de ajuda associada ao elemento de automação. |
IsDataValidForForm |
Obtém ou define um valor que indica se os dados são válidos para o formulário. |
IsDialog |
Obtém ou define um valor que indica se o elemento de automação é uma janela de diálogo. |
IsPeripheral |
Obtém ou define um valor que indica se o elemento de automação representa a interface do usuário periférica. |
IsRequiredForForm |
Obtém ou define um valor que indica se o elemento é necessário para ser preenchido em um formulário. |
ItemStatus |
Obtém ou define uma descrição do status de um item em um elemento . |
ItemType |
Obtém ou define uma descrição do tipo de elemento especificado. |
LabeledBy |
Obtém ou define o elemento de automação que contém o rótulo de texto para esse elemento. |
LandmarkType |
Obtém ou define um Identificador de Tipo de Ponto de Referência associado a um elemento . |
Level |
Obtém ou define um inteiro baseado em 1 que descreve o local de um elemento dentro de estruturas hierárquicas ou hierárquicas quebradas. |
LiveSetting |
Obtém ou define o valor de configuração dinâmica para o elemento especificado, que é compatível com um elemento de automação que representa uma região dinâmica. |
LocalizedControlType |
Obtém ou define uma cadeia de caracteres de texto localizada que descreve o tipo de controle que o elemento de automação representa. |
LocalizedLandmarkType |
Obtém ou define uma cadeia de caracteres de texto localizada que descreve o tipo de ponto de referência que o elemento de automação representa. |
Name |
Obtém ou define o nome da Automação da Interface do Usuário do elemento . |
PositionInSet |
Obtém ou define um inteiro baseado em 1 que descreve o local ordinal do elemento dentro de um conjunto de elementos considerados irmãos. |
SizeOfSet |
Obtém ou define o número de elementos em um conjunto de elementos que são considerados irmãos. |
Métodos
GetAcceleratorKey(DependencyObject) |
Obtém o valor da propriedade anexada AutomationProperties.AcceleratorKey para o DependencyObject especificado. |
GetAccessibilityView(DependencyObject) |
Obtém o valor da propriedade anexada AutomationProperties.AccessibilityView para o DependencyObject especificado. |
GetAccessKey(DependencyObject) |
Obtém o valor da propriedade anexada AutomationProperties.AccessKey para o DependencyObject especificado. |
GetAnnotations(DependencyObject) |
Obtém o valor da propriedade AutomationProperties.Annotations para o DependencyObject especificado. |
GetAutomationControlType(UIElement) |
Obtém o Microsoft.UI.Xaml.Automation.Peers.AutomationControlType para o elemento de interface do usuário especificado. |
GetAutomationId(DependencyObject) |
Obtém o valor da propriedade anexada AutomationProperties.AutomationId para o DependencyObject especificado. |
GetControlledPeers(DependencyObject) |
Um método utilitário estático que recupera a lista de pares controlados de um proprietário de destino. |
GetCulture(DependencyObject) |
Obtém o valor da propriedade anexada CultureProperty para o DependencyObject especificado. |
GetDescribedBy(DependencyObject) |
Obtém uma coleção de elementos que fornecem mais informações sobre o elemento de automação especificado. |
GetFlowsFrom(DependencyObject) |
Obtém uma lista de elementos de automação que sugerem a ordem de leitura antes do elemento de automação especificado. |
GetFlowsTo(DependencyObject) |
Obtém uma lista de elementos de automação que sugerem a ordem de leitura após o elemento de automação especificado. |
GetFullDescription(DependencyObject) |
Obtém uma cadeia de caracteres localizada que descreve a aparência visual ou o conteúdo do DependencyObject especificado. |
GetHeadingLevel(DependencyObject) |
Obtém o valor da propriedade AutomationProperties.HeadingLevel para o DependencyObject especificado. |
GetHelpText(DependencyObject) |
Obtém o valor da propriedade anexada AutomationProperties.HelpText para o DependencyObject especificado. |
GetIsDataValidForForm(DependencyObject) |
Obtém um valor booliano que indica se o valor inserido ou selecionado é válido para a regra de formulário associada ao elemento especificado. |
GetIsDialog(DependencyObject) |
Obtém o valor da propriedade anexada AutomationProperties.IsDialog para o DependencyObject especificado. |
GetIsPeripheral(DependencyObject) |
Obtém um valor booliano que indica se o elemento especificado representa a interface do usuário periférica. |
GetIsRequiredForForm(DependencyObject) |
Obtém o valor da propriedade anexada AutomationProperties.IsRequiredForForm para o DependencyObject especificado. |
GetItemStatus(DependencyObject) |
Obtém o valor da propriedade anexada AutomationProperties.ItemStatus para o DependencyObject especificado. |
GetItemType(DependencyObject) |
Obtém o valor da propriedade anexada AutomationProperties.ItemType para o DependencyObject especificado. |
GetLabeledBy(DependencyObject) |
Obtém o valor da propriedade anexada AutomationProperties.LabeledBy para o DependencyObject especificado. |
GetLandmarkType(DependencyObject) |
Obtém o valor da propriedade anexada do tipo de ponto de referência do DependencyObject especificado. |
GetLevel(DependencyObject) |
Obtém o valor da propriedade para o especificado. |
GetLiveSetting(DependencyObject) |
Obtém o valor da propriedade anexada AutomationProperties.LiveSetting para o DependencyObject especificado. |
GetLocalizedControlType(DependencyObject) |
Obtém uma cadeia de caracteres localizada que indica o tipo do controle especificado. |
GetLocalizedLandmarkType(DependencyObject) |
Obtém o valor da propriedade anexada do tipo de ponto de referência localizado para o DependencyObject especificado. |
GetName(DependencyObject) |
Obtém o valor da propriedade anexada AutomationProperties.Name para o DependencyObject especificado. |
GetPositionInSet(DependencyObject) |
Obtém o valor da propriedade para o especificado. |
GetSizeOfSet(DependencyObject) |
Obtém o valor da propriedade para o especificado. |
SetAcceleratorKey(DependencyObject, String) |
Define o valor da propriedade anexada AutomationProperties.AcceleratorKey para o DependencyObject especificado. |
SetAccessibilityView(DependencyObject, AccessibilityView) |
Define o valor da propriedade anexada AutomationProperties.AccessibilityView para o DependencyObject especificado. |
SetAccessKey(DependencyObject, String) |
Define o valor da propriedade anexada AutomationProperties.AccessKey para o DependencyObject especificado. |
SetAutomationControlType(UIElement, AutomationControlType) |
Define o Microsoft.UI.Xaml.Automation.Peers.AutomationControlType para o elemento de interface do usuário especificado. |
SetAutomationId(DependencyObject, String) |
Define o valor da propriedade anexada AutomationProperties.AutomationId para o DependencyObject especificado. |
SetCulture(DependencyObject, Int32) |
Define o valor da propriedade anexada CultureProperty para o DependencyObject especificado. |
SetFullDescription(DependencyObject, String) |
Define uma cadeia de caracteres localizada que descreve a aparência visual ou o conteúdo do DependencyObject especificado. |
SetHeadingLevel(DependencyObject, AutomationHeadingLevel) |
Define o valor da propriedade AutomationProperties.HeadingLevel para o DependencyObject especificado. |
SetHelpText(DependencyObject, String) |
Define o valor da propriedade anexada AutomationProperties.HelpText para o DependencyObject especificado. |
SetIsDataValidForForm(DependencyObject, Boolean) |
Define um valor booliano que indica se o valor inserido ou selecionado é válido para a regra de formulário associada ao elemento especificado. |
SetIsDialog(DependencyObject, Boolean) |
Define um valor booliano que indica se o elemento especificado deve ser identificado como uma janela de diálogo. |
SetIsPeripheral(DependencyObject, Boolean) |
Define um valor booliano que indica se o elemento especificado representa a interface do usuário periférica. |
SetIsRequiredForForm(DependencyObject, Boolean) |
Define o valor da propriedade anexada AutomationProperties.IsRequiredForForm para o DependencyObject especificado. |
SetItemStatus(DependencyObject, String) |
Define o valor da propriedade anexada AutomationProperties.ItemStatus para o DependencyObject especificado. |
SetItemType(DependencyObject, String) |
Define o valor da propriedade anexada AutomationProperties.ItemType para o DependencyObject especificado. |
SetLabeledBy(DependencyObject, UIElement) |
Define o valor da propriedade anexada AutomationProperties.LabeledBy para o DependencyObject especificado. |
SetLandmarkType(DependencyObject, AutomationLandmarkType) |
Define o valor da propriedade anexada do tipo de ponto de referência para o DependencyObject especificado. |
SetLevel(DependencyObject, Int32) |
Define o valor da propriedade anexada AutomationProperties.Level para o DependencyObject especificado. |
SetLiveSetting(DependencyObject, AutomationLiveSetting) |
Define o valor da propriedade anexada AutomationProperties.LiveSetting para o DependencyObject especificado. |
SetLocalizedControlType(DependencyObject, String) |
Define uma cadeia de caracteres localizada que indica o tipo do controle especificado. |
SetLocalizedLandmarkType(DependencyObject, String) |
Define o valor da propriedade anexada do tipo de ponto de referência localizado para o DependencyObject especificado. |
SetName(DependencyObject, String) |
Define o valor do AutomationProperties.Name propriedade anexada para o DependencyObject especificado. |
SetPositionInSet(DependencyObject, Int32) |
Define o valor da propriedade anexada AutomationProperties.PositionInSet para o DependencyObject especificado. |
SetSizeOfSet(DependencyObject, Int32) |
Define o valor da propriedade anexada AutomationProperties.SizeOfSet para o DependencyObject especificado. |
Aplica-se a
Confira também
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de