Compartilhar via

AutomationProperties Classe

  • Referência

Definição

Namespace:
Microsoft.UI.Xaml.Automation
Editar

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
Object Platform::Object IInspectable AutomationProperties
Atributos
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Comentários

Propriedades anexadas ao 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 em 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 da Automação da Interface do Usuário da Microsoft ou comportamento de implementação de par ou em que 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 Get e Set accessor, que também são membros do AutomationProperties. Por exemplo, os métodos GetName e SetName dão suporte e fornecem o suporte de somente código equivalente para relatar valores de de nome de automação de automação à 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 à 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 é Name. Isso ocorre porque é a propriedade Name que é mais acessada 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 par que pode fornecer um valor de name padrão com base em outras propriedades de elemento. Por exemplo, o encaminhamento de pares para a classe botão encaminhará a avaliação ToString do conteúdo do botão e usará essa cadeia de caracteres como o nome de 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 de Automação de Interface do Usuário da Microsoft disponível, defina o nome propriedade anexada nesse elemento em XAML. Para obter mais informações sobre por que uma de nome de 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 de nome fornecido por par que seja útil, consulte de teste de acessibilidade.

Por motivos de localização, você deve evitar valores de cadeia de caracteres codificados para a de Nome do no XAML. Se você definir 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 do identificador de recurso requer a qualificação completa da propriedade anexada no formulário XAML, incluindo seu namespace e um prefixo using: Por exemplo, para direcionar o valor da propriedade anexada AutomationProperties.Name em um recurso que tenha de diretiva x:Uid valor de "sendButton", o nome valor do item de dados nos recursos RESW é

Propriedades anexadas

Nota

Para obter mais informações sobre cada propriedade anexada, consulte a página do campo identificador de da propriedade.

Propriedade anexada Descrição
AcceleratorKey Obtém ou define a chave de acelerador 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 para o 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)).O valor da propriedade de cultura para o elemento especificado.
FullDescription Obtém ou define uma cadeia de caracteres localizada contendo texto de descrição estendida para um elemento.
HeadingLevel Obtém ou define o nível de título para um elemento de Automação de 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 deve 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 do elemento especificado.
LabeledBy Obtém ou define o elemento que contém o rótulo de texto do elemento.
LandmarkType Obtém ou define um de 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 do 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 que são 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 de 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 propriedade anexada AutomationProperties, que é uma Microsoft.UI.Xaml.Automation.Peers.AutomationControlType.
AutomationIdProperty

Identifica a propriedade anexada AutomationProperties.AutomationId, que é uma cadeia de caracteres que contém o identificador de Automação da Interface do Usuário (ID) 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 da propriedade descrita pela anexação, 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 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 o 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 do tipo de ponto de referência, que é um o 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 o AutomationProperties.LiveSetting propriedade anexada, que tem suporte de 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 a propriedade anexada AutomationProperties.Name, 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 contendo texto de descrição estendida para um elemento.
HeadingLevel

Obtém ou define o nível de título para um elemento de Automação de 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 deve 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 do 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 de 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 do elemento especificado, que tem suporte por 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 DependencyObjectespecificado.
GetAccessibilityView(DependencyObject)

Obtém o valor da propriedade anexada AutomationProperties.AccessibilityView para oDependencyObject especificado.
GetAccessKey(DependencyObject)

Obtém o valor da propriedade anexada AutomationProperties.AccessKey para oDependencyObject especificado.
GetAnnotations(DependencyObject)

Obtém o valor da propriedade AutomationProperties.Annotations para oDependencyObject 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 oDependencyObject especificado.
GetControlledPeers(DependencyObject)

Um método de 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 oDependencyObject 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 doDependencyObject especificado.
GetHeadingLevel(DependencyObject)

Obtém o valor da propriedade AutomationProperties.HeadingLevel para oDependencyObject especificado.
GetHelpText(DependencyObject)

Obtém o valor da propriedade anexada AutomationProperties.HelpText para oDependencyObject 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 do DependencyObjectespecificado.
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 oDependencyObject especificado.
GetItemStatus(DependencyObject)

Obtém o valor da propriedade anexada AutomationProperties.ItemStatus para oDependencyObject especificado.
GetItemType(DependencyObject)

Obtém o valor da propriedade anexada AutomationProperties.ItemType para oDependencyObject especificado.
GetLabeledBy(DependencyObject)

Obtém o valor da propriedade anexada AutomationProperties.LabeledBy para oDependencyObject especificado.
GetLandmarkType(DependencyObject)

Obtém o valor da propriedade anexada do tipo de ponto de referência para oDependencyObject especificado.
GetLevel(DependencyObject)

Obtém o valor da propriedade para o especificado.
GetLiveSetting(DependencyObject)

Obtém o valor da propriedade anexada AutomationProperties.LiveSetting para oDependencyObject 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 oDependencyObject especificado.
GetName(DependencyObject)

Obtém o valor da propriedade anexada AutomationProperties.Name para o DependencyObjectespecificado.
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 oDependencyObject especificado.
SetAccessibilityView(DependencyObject, AccessibilityView)

Define o valor da propriedade anexada AutomationProperties.AccessibilityView para oDependencyObject especificado.
SetAccessKey(DependencyObject, String)

Define o valor da propriedade anexada AutomationProperties.AccessKey para oDependencyObject 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 oDependencyObject especificado.
SetCulture(DependencyObject, Int32)

Define o valor da propriedade anexada CultureProperty para oDependencyObject especificado.
SetFullDescription(DependencyObject, String)

Define uma cadeia de caracteres localizada que descreve a aparência visual ou o conteúdo doDependencyObject especificado.
SetHeadingLevel(DependencyObject, AutomationHeadingLevel)

Define o valor da propriedade AutomationProperties.HeadingLevel para oDependencyObject especificado.
SetHelpText(DependencyObject, String)

Define o valor da propriedade anexada AutomationProperties.HelpText para oDependencyObject 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 oDependencyObject especificado.
SetItemStatus(DependencyObject, String)

Define o valor da propriedade anexada AutomationProperties.ItemStatus para oDependencyObject especificado.
SetItemType(DependencyObject, String)

Define o valor da propriedade anexada AutomationProperties.ItemType para oDependencyObject especificado.
SetLabeledBy(DependencyObject, UIElement)

Define o valor da propriedade anexada AutomationProperties.LabeledBy para oDependencyObject especificado.
SetLandmarkType(DependencyObject, AutomationLandmarkType)

Define o valor da propriedade anexada do tipo de ponto de referência para oDependencyObject especificado.
SetLevel(DependencyObject, Int32)

Define o valor da propriedade anexada AutomationProperties.Level para oDependencyObject especificado.
SetLiveSetting(DependencyObject, AutomationLiveSetting)

Define o valor da propriedade anexada AutomationProperties.LiveSetting para oDependencyObject 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 oDependencyObject especificado.
SetName(DependencyObject, String)

Define o valor da propriedade anexada AutomationProperties.Name para oDependencyObject especificado.
SetPositionInSet(DependencyObject, Int32)

Define o valor da propriedade anexada AutomationProperties.PositionInSet para oDependencyObject especificado.
SetSizeOfSet(DependencyObject, Int32)

Define o valor da propriedade anexada AutomationProperties.SizeOfSet para oDependencyObject especificado.

Aplica-se a

Confira também