ItemAutomationPeer, classe
TOC
Réduire la table des matières
Développer la table des matières

ItemAutomationPeer Class

Expose un élément de données appartenant à une collection Items à Microsoft UI Automation.

Héritage

Object
  DependencyObject
    AutomationPeer
      ItemAutomationPeer

Syntaxe


public class ItemAutomationPeer : AutomationPeer,
    IVirtualizedItemProvider

Attributs

[MarshalingBehavior(Agile)]
[Threading(Both)]
[Version(0x06020000)]
[WebHostHidden()]

Membres

ItemAutomationPeerClasse possède ces types de membres :

Constructeurs

ItemAutomationPeerClasse possède ces constructeurs.

ConstructeurDescription
ItemAutomationPeer Initializes a new instance of the ItemAutomationPeer class.

 

Méthodes

The ItemAutomationPeer Classe a les méthodes suivantes. Elle hérite également des méthodes de Object Classe.

MéthodeDescription
ClearValue Clears the local value of a dependency property. (Hérité de DependencyObject)
GetAcceleratorKey Gets the accelerator key combinations for the object that is associated with the UI Automation peer. (Hérité de AutomationPeer)
GetAcceleratorKeyCore Provides the peer's behavior when a Microsoft UI Automation client calls GetAcceleratorKey or an equivalent Microsoft UI Automation client API. (Hérité de AutomationPeer)
GetAccessKey Gets the access key for the element that is associated with the automation peer. (Hérité de AutomationPeer)
GetAccessKeyCore Provides the peer's behavior when a Microsoft UI Automation client calls GetAccessKey or an equivalent Microsoft UI Automation client API. (Hérité de AutomationPeer)
GetAnimationBaseValue Returns any base value established for a dependency property, which would apply in cases where an animation is not active. (Hérité de DependencyObject)
GetAutomationControlType Gets the control type for the element that is associated with the UI Automation peer. (Hérité de AutomationPeer)
GetAutomationControlTypeCore Provides the peer's behavior when a Microsoft UI Automation client calls GetAutomationControlType or an equivalent Microsoft UI Automation client API. (Hérité de AutomationPeer)
GetAutomationId Gets the AutomationId of the element that is associated with the automation peer. (Hérité de AutomationPeer)
GetAutomationIdCore Provides the peer's behavior when a Microsoft UI Automation client calls GetAutomationId or an equivalent Microsoft UI Automation client API. (Hérité de AutomationPeer)
GetBoundingRectangle Gets the Rect object that represents the screen coordinates of the element that is associated with the automation peer. (Hérité de AutomationPeer)
GetBoundingRectangleCore Provides the peer's behavior when a Microsoft UI Automation client calls GetBoundingRectangle or an equivalent Microsoft UI Automation client API. (Hérité de AutomationPeer)
GetChildren Gets the collection of child elements that are represented in the UI Automation tree as immediate child elements of the automation peer. (Hérité de AutomationPeer)
GetChildrenCore Provides the peer's behavior when a Microsoft UI Automation client calls GetChildren or an equivalent Microsoft UI Automation client API. (Hérité de AutomationPeer)
GetClassName Gets a name that is used with AutomationControlType, to differentiate the control that is represented by this AutomationPeer. (Hérité de AutomationPeer)
GetClassNameCore Provides the peer's behavior when a Microsoft UI Automation client calls GetClassName or an equivalent Microsoft UI Automation client API. (Hérité de AutomationPeer)
GetClickablePoint Gets a point on the element that is associated with the automation peer that responds to a mouse click. (Hérité de AutomationPeer)
GetClickablePointCore Provides the peer's behavior when a Microsoft UI Automation client calls GetClickablePoint or an equivalent Microsoft UI Automation client API. (Hérité de AutomationPeer)
GetControlledPeers Provides the peer's behavior when a Microsoft UI Automation client calls GetControlledPeers or an equivalent Microsoft UI Automation client API such as getting a property value as identified by UIA_ControllerForPropertyId. (Hérité de AutomationPeer)
GetControlledPeersCore Gets a list of the controlled peers for the current automation peer. (Hérité de AutomationPeer)
GetHelpText Gets text that describes the functionality of the control that is associated with the automation peer. (Hérité de AutomationPeer)
GetHelpTextCore Provides the peer's behavior when a Microsoft UI Automation client calls GetHelpText or an equivalent Microsoft UI Automation client API. (Hérité de AutomationPeer)
GetItemStatus Gets text that conveys the visual status of the element that is associated with this automation peer. (Hérité de AutomationPeer)
GetItemStatusCore Provides the peer's behavior when a Microsoft UI Automation client calls GetItemStatus or an equivalent Microsoft UI Automation client API. (Hérité de AutomationPeer)
GetItemType Gets a string that describes what kind of item an element represents. (Hérité de AutomationPeer)
GetItemTypeCore Provides the peer's behavior when a Microsoft UI Automation client calls GetItemType or an equivalent Microsoft UI Automation client API. (Hérité de AutomationPeer)
GetLabeledBy Gets the AutomationPeer for the UIElement that is targeted to the element. (Hérité de AutomationPeer)
GetLabeledByCore Provides the peer's behavior when a Microsoft UI Automation client calls GetLabeledBy or an equivalent Microsoft UI Automation client API. (Hérité de AutomationPeer)
GetLiveSetting Gets the live setting notification behavior information for the object that is associated with the UI Automation peer. (Hérité de AutomationPeer)
GetLiveSettingCore Provides the peer's behavior when a Microsoft UI Automation client calls GetLiveSetting or an equivalent Microsoft UI Automation client API. (Hérité de AutomationPeer)
GetLocalizedControlType Gets a localized string that represents the AutomationControlType value for the control that is associated with this automation peer. (Hérité de AutomationPeer)
GetLocalizedControlTypeCore Provides the peer's behavior when a Microsoft UI Automation client calls GetLocalizedControlType or an equivalent Microsoft UI Automation client API. (Hérité de AutomationPeer)
GetName Gets text that describes the element that is associated with this automation peer. The Microsoft UI Automation Name value is the primary identifier used by most assistive technology when they represent your app's UI by interacting with the Microsoft UI Automation framework. (Hérité de AutomationPeer)
GetNameCore Provides the peer's behavior when a Microsoft UI Automation client calls GetName or an equivalent Microsoft UI Automation client API. (Hérité de AutomationPeer)
GetOrientation Gets a value that indicates the explicit control orientation, if any. (Hérité de AutomationPeer)
GetOrientationCore Provides the peer's behavior when a Microsoft UI Automation client calls GetOrientation or an equivalent Microsoft UI Automation client API. (Hérité de AutomationPeer)
GetParent Gets the AutomationPeer that is the parent of this AutomationPeer. (Hérité de AutomationPeer)
GetPattern Gets the control pattern that is associated with the specified PatternInterface. (Hérité de AutomationPeer)
GetPatternCore Provides the peer's behavior when a Microsoft UI Automation client calls GetPattern or an equivalent Microsoft UI Automation client API. (Hérité de AutomationPeer)
GetPeerFromPoint Gets an AutomationPeer from the specified point. (Hérité de AutomationPeer)
GetPeerFromPointCore Provides the peer's behavior when a Microsoft UI Automation client calls GetPeerFromPoint or an equivalent Microsoft UI Automation client API. (Hérité de AutomationPeer)
GetValue Returns the current effective value of a dependency property from a DependencyObject. (Hérité de DependencyObject)
HasKeyboardFocus Gets a value that indicates whether the element that is associated with this automation peer currently has keyboard focus. (Hérité de AutomationPeer)
HasKeyboardFocusCore Provides the peer's behavior when a Microsoft UI Automation client calls HasKeyboardFocus or an equivalent Microsoft UI Automation client API. (Hérité de AutomationPeer)
InvalidatePeer Triggers recalculation of the main properties of the AutomationPeer and raises the PropertyChanged notification to the automation client if the properties have changed. (Hérité de AutomationPeer)
IsContentElement Gets a value that indicates whether the element that is associated with this automation peer contains data that is presented to the user. (Hérité de AutomationPeer)
IsContentElementCore Provides the peer's behavior when a Microsoft UI Automation client calls IsContentElement or an equivalent Microsoft UI Automation client API. (Hérité de AutomationPeer)
IsControlElement Gets a value that indicates whether the element is understood by the user as interactive or as contributing to the logical structure of the control in the GUI. (Hérité de AutomationPeer)
IsControlElementCore Provides the peer's behavior when a Microsoft UI Automation client calls IsControlElement or an equivalent Microsoft UI Automation client API. (Hérité de AutomationPeer)
IsEnabled Gets a value that indicates whether the element associated with this automation peer supports interaction. (Hérité de AutomationPeer)
IsEnabledCore Provides the peer's behavior when a Microsoft UI Automation client calls IsEnabled or an equivalent Microsoft UI Automation client API. (Hérité de AutomationPeer)
IsKeyboardFocusable Gets a value that indicates whether the element can accept keyboard focus. (Hérité de AutomationPeer)
IsKeyboardFocusableCore Provides the peer's behavior when a Microsoft UI Automation client calls IsKeyboardFocusable or an equivalent Microsoft UI Automation client API. (Hérité de AutomationPeer)
IsOffscreen Gets a value that indicates whether an element is off the screen. (Hérité de AutomationPeer)
IsOffscreenCore Provides the peer's behavior when a Microsoft UI Automation client calls IsOffscreen or an equivalent Microsoft UI Automation client API. (Hérité de AutomationPeer)
IsPassword Gets a value that indicates whether the element contains sensitive content. (Hérité de AutomationPeer)
IsPasswordCore Provides the peer's behavior when a Microsoft UI Automation client calls IsPassword or an equivalent Microsoft UI Automation client API. (Hérité de AutomationPeer)
IsRequiredForForm Gets a value that indicates whether the element that is associated with this peer must be completed on a form. (Hérité de AutomationPeer)
IsRequiredForFormCore Provides the peer's behavior when a Microsoft UI Automation client calls IsRequiredForForm or an equivalent Microsoft UI Automation client API. (Hérité de AutomationPeer)
PeerFromProvider Gets an AutomationPeer for the specified IRawElementProviderSimple proxy. (Hérité de AutomationPeer)
ProviderFromPeer Gets the IRawElementProviderSimple proxy for the specified AutomationPeer. (Hérité de AutomationPeer)
RaiseAutomationEvent Raises an automation event. (Hérité de AutomationPeer)
RaisePropertyChangedEvent Raises an event to notify the automation client of a changed property value. (Hérité de AutomationPeer)
ReadLocalValue Returns the local value of a dependency property, if a local value is set. (Hérité de DependencyObject)
Realize Makes the virtual item fully accessible as a Microsoft UI Automation element.
SetFocus Sets the keyboard focus on the element that is associated with this automation peer. (Hérité de AutomationPeer)
SetFocusCore Provides the peer's behavior when a Microsoft UI Automation client calls SetFocus or an equivalent Microsoft UI Automation client API. (Hérité de AutomationPeer)
SetValue Sets the local value of a dependency property on a DependencyObject. (Hérité de DependencyObject)
ShowContextMenu Shows the available context menu for the owner element. (Hérité de AutomationPeer)
ShowContextMenuCore Provides the peer's behavior when a Microsoft UI Automation client calls ShowContextMenu or an equivalent Microsoft UI Automation client API. (Hérité de AutomationPeer)

 

Propriétés

Le ItemAutomationPeerClasse a les propriétés suivantes.

PropriétéType d'accèsDescription

Dispatcher

En lecture seuleGets the CoreDispatcher that this object is associated with. (Hérité de DependencyObject)

EventsSource

Lecture/écritureGets or sets an AutomationPeer that is reported to the automation client as the source for all the events that come from this AutomationPeer. See Remarks. (Hérité de AutomationPeer)

Item

En lecture seuleGets the data item in the Items collection that is associated with this ItemAutomationPeer.

ItemsControlAutomationPeer

En lecture seuleGets the ItemsControlAutomationPeer that is associated with the ItemsControl that holds the Items collection.

 

Remarques

ItemAutomationPeer est générée à partir de la logique de contrôle d'éléments et de ItemsControlAutomationPeer, et non d'une classe de contrôle associée.

Outre l'API d'implémentation homologue classique, ItemAutomationPeer a une propriété ItemsControlAutomationPeer pour référencer son homologue de conteneur. L'homologue de conteneur fournit potentiellement la logique pour les méthodes AutomationPeer comme il est appelé sur ItemAutomationPeer. Il existe également une propriété Item dont l'objectif est semblable à celui de la propriété Owner sur d'autres homologues (elle fournit une référence à l'objet auquel cet homologue fournit l'exposition Automation). Ces deux valeurs doivent être placées dans le constructeur ItemAutomationPeer.

ItemAutomationPeer implémente la méthode Realize pour prendre en charge le modèle de contrôle IVirtualizedItemProvider. Les clients peuvent appeler l'accès du modèle équivalent de leur infrastructure à Realize pour obtenir un résultat non virtualisé. Cela génère plus d'informations sur l'élément d'une arborescence d'automation.

Par défaut, implémentation d'homologue et substitutions dans ItemDatAutomationPeer

ItemAutomationPeer a des substitutions de méthodes Core telles que les méthodes AutomationPeer associées fournissent des informations spécifiques aux homologues à un client UI Automation.

  • GetPattern signale que l'homologue prend en charge PatternInterface.VirtualizedItem (IVirtualizedItemProvider). De plus, il existe la logique "GetContainerPeer" qui stocke des informations sur les modèles pris en charge du conteneur d'élément.

  • GetClassName utilise la logique "GetContainerPeer" pour obtenir des informations sur les noms des classes. S'il n'existe aucun homologue de conteneur, l'appel à GetClassName lève ElementNotAvailableException.
  • GetName utilise la logique "GetContainerPeer" mais si aucun homologue de conteneur n'existe, une logique ToString() de base est utilisée pour tenter de générer un nom Automation par défaut à partir du contenu de l'élément.
  • GetAutomationControlType utilise la logique "GetContainerPeer" pour obtenir des informations sur les différents types de contrôle. S'il n'existe aucun homologue de conteneur, retourne AutomationControlType.ListItem.
  • La logique "GetContainerPeer" est utilisée pour transférer la plupart des autres méthodes AutomationPeer des implémentations des homologues de conteneur, si cela est possible. Par exemple, IsControlElement peut vérifier un homologue de conteneur en premier. Certaines de ces méthodes AutomationPeer lèveront ElementNotAvailableException s'il n'existe aucun homologue de conteneur disponible.

Il s'agit de l'une des seules classes homologues de la prise en charge Windows Runtime de l'UI Automation qui n'utilise pas FrameworkElementAutomationPeer comme classe de base.

Conditions requises

Client minimal pris en charge

Windows 8 [Applications Windows Store uniquement]

Serveur minimal pris en charge

Windows Server 2012 [Applications Windows Store uniquement]

Espace de noms

Windows.UI.Xaml.Automation.Peers
Windows::UI::Xaml::Automation::Peers [C++]

Métadonnées

Windows.winmd

Voir aussi

AutomationPeer
IVirtualizedItemProvider

 

 

Afficher:
© 2016 Microsoft