AutomationProperties Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Prend en charge l’obtention ou la définition de valeurs de niveau instance des propriétés d’automatisation. Ces valeurs de propriété sont définies en tant que propriétés jointes (généralement en XAML) et complètent ou remplacent les valeurs de propriété Automation de l’AutomationPeer d’un contrôle.
public ref class AutomationProperties sealed/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 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(Windows.Foundation.UniversalApiContract), 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- Héritage
- Attributs
Configuration requise pour Windows
| Famille d’appareils |
Windows 10 (introduit dans 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduit dans v1.0)
|
Exemples
Conseil
Ouvrez l’application WinUI 3 Gallery et consultez les principes d’accessibilité suivants en action :
L’application Galerie WinUI 3 inclut des exemples interactifs de la plupart des contrôles, fonctionnalités et fonctionnalités WinUI 3. Obtenir l’application à partir du Microsoft Store ou obtenir le code source sur GitHub
Remarques
AutomationProperties est la classe de service hôte pour plusieurs propriétés jointes XAML. L’objectif de ces propriétés jointes est de permettre la définition de différentes valeurs par instance pertinentes pour la façon dont un élément d’interface utilisateur est signalé à l’infrastructure d’accessibilité Microsoft UI Automation. Cela est utile dans les cas où la conception de classe de l’élément d’interface utilisateur ne transfère pas déjà d’autres valeurs de propriété liées à l’interface utilisateur dans le cadre de son comportement d’intégration microsoft UI Automation ou d’implémentation d’homologue, ou lorsque la valeur transférée n’est pas la valeur que vous souhaitez signaler à Microsoft UI Automation.
Pour prendre en charge l’accès du processeur XAML aux propriétés jointes, ainsi que pour exposer des opérations get et set équivalentes au code, chaque propriété jointe XAML a une paire de méthodes d’accesseur Get et Set , qui sont également membres d’AutomationProperties. Par exemple, les méthodes GetName et SetName prennent en charge et fournissent la prise en charge du code uniquement équivalente pour la création de rapports de valeurs nom automation à Microsoft UI Automation, au lieu d’utiliser la propriété Jointe Name pour la définir en XAML. Vous pouvez également utiliser le système de propriétés de dépendance pour obtenir ou définir la valeur de la propriété jointe, ce qui signale également la valeur sous-jacente à Microsoft UI Automation. Appelez GetValue ou SetValue, en passant les arguments de l’identificateur de propriété de dépendance à définir et une référence à l’objet cible sur lequel obtenir ou définir la valeur.
Nom de la propriété
Parmi les différentes propriétés jointes, la plus importante est probablement Name. Cela est dû au fait que c’est la propriété Name qui est la plus fréquemment consultée et signalée par la technologie d’assistance lorsque les utilisateurs interagissent avec une application dans un scénario d’accessibilité. Le nom sert d’identificateur lisible par l’utilisateur pour l’élément d’interface utilisateur.
Divers éléments d’interface utilisateur ont un transfert d’homologue qui peut fournir une valeur Name par défaut basée sur d’autres propriétés d’élément. Par exemple, le transfert d’homologue pour la classe Button transfère l’évaluation ToString du contenu button et utilise cette chaîne comme nom par défaut. Pour remplacer cette valeur par défaut, ou pour fournir une valeur Name pour tout cas d’élément d’interface utilisateur où microsoft UI Automation Name n’est pas disponible, définissez la propriété Name jointe sur cet élément en XAML. Pour plus d’informations sur l’importance d’un nom microsoft UI Automation, consultez Informations de base sur l’accessibilité. Pour plus d’informations sur la façon de tester si un élément a déjà un nom fourni par l’homologue qui est utile, consultez Tests d’accessibilité.
Pour des raisons de localisation, vous devez éviter les valeurs de chaîne codées en dur pour le Nom en XAML. Si vous définissez la directive x:Uid sur l’élément, vous pouvez utiliser les ressources RESW pour cibler la propriété et fournir différentes valeurs pour la localisation. Pour les propriétés jointes, le formulaire d’identificateur de ressource nécessite une qualification complète de la propriété jointe dans le formulaire XAML, y compris son espace de noms et un préfixe using:. Par exemple, pour cibler la valeur de propriété jointe AutomationProperties.Name sur une ressource dont la valeur de directive x:Uid est « sendButton », la valeur de nom de l’élément de données dans les ressources RESW est sendButton.[using:Windows.UI.Xaml.Automation]AutomationProperties.Name
Consultez Propriétés jointes pour obtenir une liste complète (pour plus d’informations sur chaque propriété jointe, voir le champ Identificateur de chaque propriété).
Historique des versions
| Version de Windows | Version du SDK | Valeur ajoutée |
|---|---|---|
| 1511 | 10586 | GetLandmarkType |
| 1511 | 10586 | GetLocalizedLandmarkType |
| 1511 | 10586 | SetLandmarkType |
| 1511 | 10586 | SetLocalizedLandmarkType |
| 1607 | 14393 | GetDescribedBy |
| 1607 | 14393 | GetFlowsFrom |
| 1607 | 14393 | GetFlowsTo |
| 1607 | 14393 | GetFullDescription |
| 1607 | 14393 | GetIsDataValidForForm |
| 1607 | 14393 | GetIsPeripheral |
| 1607 | 14393 | GetLocalizedControlType |
| 1607 | 14393 | SetFullDescription |
| 1607 | 14393 | SetIsDataValidForForm |
| 1607 | 14393 | SetIsPeripheral |
| 1607 | 14393 | SetLocalizedControlType |
| 1703 | 15063 | GetCulture |
| 1703 | 15063 | SetCulture |
| 1803 | 17134 | GetHeadingLevel |
| 1803 | 17134 | SetHeadingLevel |
| 1809 | 17763 | GetIsDialog |
| 1809 | 17763 | SetIsDialog |
Propriétés
Propriétés attachées
| AcceleratorKey |
Obtient ou définit une chaîne contenant les combinaisons de touche d’accélérateur (également appelée touche de raccourci) pour l’élément automation. |
| AccessibilityView |
Obtient ou définit le mode d’arborescence Microsoft UI Automation pour un élément. |
| AccessKey |
Obtient ou définit une chaîne contenant le caractère de clé d’accès pour l’élément automation. |
| Annotations |
Obtient une liste d’objets d’annotation dans un document, tels que le commentaire, l’en-tête, le pied de page, etc. |
| AutomationControlType |
Obtient ou définit le type de contrôle pour Microsoft UI Automation. |
| AutomationId |
Obtient ou définit la chaîne qui identifie de manière unique l’élément à Microsoft UI Automation. |
| ControlledPeers |
Obtient une collection d’éléments Automation qui peuvent être manipulés par l’élément Automation spécifié. |
| Culture |
Obtient ou définit l’identificateur de paramètres régionaux pour l’élément automation (par exemple, 0x0409 pour « en-US » ou anglais (États-Unis)). |
| DescribedBy |
Obtient un tableau d’éléments qui fournissent plus d’informations sur l’élément automation. |
| FlowsFrom |
Obtient un tableau d’éléments d’automatisation qui suggère l’ordre de lecture avant l’élément Automation actuel. |
| FlowsTo |
Obtient un tableau d’éléments d’automatisation qui suggère l’ordre de lecture après l’élément Automation actuel. |
| FullDescription |
Obtient ou définit une chaîne localisée contenant du texte de description étendu pour un élément. |
| HeadingLevel |
Obtient ou définit le niveau de titre d’un élément UI Automation. |
| HelpText |
Obtient ou définit une chaîne de texte d’aide associée à l’élément automation. |
| IsDataValidForForm |
Obtient ou définit une valeur qui indique si les données sont valides pour le formulaire. |
| IsDialog |
Obtient ou définit une valeur qui indique si l’élément automation est une fenêtre de dialogue. |
| IsPeripheral |
Obtient ou définit une valeur qui indique si l’élément Automation représente l’interface utilisateur périphérique. |
| IsRequiredForForm |
Obtient ou définit une valeur qui indique si l’élément doit être renseigné dans un formulaire. |
| ItemStatus |
Obtient ou définit une description du status d’un élément dans un élément. |
| ItemType |
Obtient ou définit une description du type de l'élément spécifié. |
| LabeledBy |
Obtient ou définit l’élément automation qui contient l’étiquette de texte de cet élément. |
| LandmarkType |
Obtient ou définit un identificateur de type de repère associé à un élément. |
| Level |
Obtient ou définit un entier de base 1 qui décrit l’emplacement d’un élément à l’intérieur de structures hiérarchiques hiérarchiques ou rompues. |
| LiveSetting |
Obtient ou définit la valeur du paramètre actif pour l’élément spécifié, qui est pris en charge par un élément Automation qui représente une région dynamique. |
| LocalizedControlType |
Obtient ou définit une chaîne de texte localisée qui décrit le type de contrôle que l’élément automation représente. |
| LocalizedLandmarkType |
Obtient ou définit une chaîne de texte localisée qui décrit le type de point de repère que l’élément automation représente. |
| Name |
Obtient ou définit le nom UI Automation de l’élément. |
| PositionInSet |
Obtient ou définit un entier de base 1 qui décrit l’emplacement ordinal de l’élément dans un ensemble d’éléments considérés comme frères. |
| SizeOfSet |
Obtient ou définit le nombre d’éléments d’un ensemble d’éléments considérés comme frères. |