Linguaggio

AutomationPeer Classe

Definizione

Spazio dei nomi:
Microsoft.UI.Xaml.Automation.Peers
Modifica

Fornisce una classe di base che espone il peer di automazione per una classe proprietaria associata a Automazione interfaccia utente Microsoft.

public ref class AutomationPeer : DependencyObject
/// [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 AutomationPeer : DependencyObject
[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 class AutomationPeer : DependencyObject
Public Class AutomationPeer
Inherits DependencyObject
Ereditarietà
Object Platform::Object IInspectable DependencyObject AutomationPeer
Derivato
Attributi
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Commenti

AutomationPeer è la classe che fornisce quasi tutte le API che alla fine inoltrano le informazioni Microsoft Automazione interfaccia utente per un'app XAML a un client Microsoft Automazione interfaccia utente. I client Microsoft Automazione interfaccia utente tipici non chiamano direttamente i metodi AutomationPeer. Questi client sono spesso assistive technology che usano altri modelli di programmazione e operano come servizi e probabilmente non chiamano metodi Windows Runtime. Tuttavia, il supporto generale Microsoft Automazione interfaccia utente nel Windows Runtime inoltra tutte queste informazioni usando il lato provider del framework di Microsoft Automazione interfaccia utente. Tutti i client da Microsoft Automazione interfaccia utente possono interagire con gli alberi di automazione rappresentativi di un'app XAML.

Generazione di eventi di automazione

La classe AutomationPeer è rilevante per Windows Runtime autori di controlli perché in fase di esecuzione sarà disponibile un'istanza peer, dopo che il runtime richiama il metodo OnCreateAutomationPeer. Usando questo peer, è possibile generare eventi di automazione chiamando RaiseAutomationEvent e RaisePropertyChangedEvent. Questa operazione viene eseguita ogni volta che viene modificata una proprietà correlata nel proprietario del peer (classe) o quando si attiva un evento per il supporto corretto dell'automazione.

La progettazione del supporto per l'automazione non mantiene un handle per il peer come parte di come implementare OnCreateAutomationPeer, perché non esistono garanzie di quando il peer viene effettivamente creato. È invece possibile verificare la presenza di listener di eventi di automazione in fase di esecuzione all'interno delle definizioni della classe di controllo just-in-time, usando codice simile al seguente:

if (AutomationPeer.ListenerExists(AutomationEvents.PropertyChanged))
{
    MyAutomationPeer peer = 
        FrameworkElementAutomationPeer.FromElement(myCtrl) as MyAutomationPeer;

    if (peer != null)
    {
        peer.RaisePropertyChangedEvent(
            RangeValuePatternIdentifiers.ValueProperty,
            (double)oldValue,
            (double)newValue);
    }
}

Classi derivate di AutomationPeer

AutomationPeer si trova nella gerarchia per tutti i peer esistenti per i controlli Windows Runtime e le classi dell'interfaccia utente correlate.

Le classi che derivano direttamente da AutomationPeer sono:

FrameworkElementAutomationPeer. Per un elenco dei peer che derivano da FrameworkElementAutomationPeer , vedere la sezione Osservazioni di FrameworkElementAutomationPeer.

Metodi di base

I metodi "Core" sono le implementazioni standard che eseguono l'azione predefinita di un metodo Microsoft Automazione interfaccia utente chiamabile client. È possibile eseguire l'override di uno dei metodi "Core" per restituire valori alternativi in un peer di automazione personalizzato. Ad esempio, GetAcceleratorKeyCore viene richiamato ogni volta che viene chiamato GetAcceleratorKey, viene richiamato ogni volta che viene chiamato GetAccessKeyKey e così via.

L'implementazione di base per AutomationPeer restituisce null. I peer che rappresentano gli elementi possono rinviare il risultato al contenitore.

Costruttori

Nome Descrizione
AutomationPeer()

Fornisce il comportamento di inizializzazione della classe base per le classi derivate di AutomationPeer .

Proprietà

Nome Descrizione
Dispatcher

Restituisce null sempre in un'app di SDK per app di Windows. Usare invece DispatcherQueue .

(Ereditato da DependencyObject)
DispatcherQueue

Ottiene l'oggetto DispatcherQueue a cui è associato questo oggetto. Rappresenta DispatcherQueue una funzionalità che può accedere al nel thread dell'interfaccia DependencyObject utente anche se il codice viene avviato da un thread non dell'interfaccia utente.

(Ereditato da DependencyObject)
EventsSource

Ottiene o imposta un oggetto AutomationPeer segnalato al client di automazione come origine per tutti gli eventi provenienti da automationPeer. Vedere la sezione Osservazioni.

Metodi

Nome Descrizione
ClearValue(DependencyProperty)

Cancella il valore locale di una proprietà di dipendenza.

(Ereditato da DependencyObject)
GenerateRawElementProviderRuntimeId()

Genera un identificatore di runtime per l'elemento associato al peer di automazione.
GetAcceleratorKey()

Ottiene le combinazioni di tasti di scelta rapida per l'oggetto associato al peer di automazione interfaccia utente.
GetAcceleratorKeyCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama GetAcceleratorKey o un'API client di Automazione interfaccia utente Microsoft equivalente.
GetAccessKey()

Ottiene la chiave di accesso per l'elemento associato al peer di automazione.
GetAccessKeyCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama GetAccessKey o un'API client di Automazione interfaccia utente Microsoft equivalente.
GetAnimationBaseValue(DependencyProperty)

Restituisce qualsiasi valore di base stabilito per una proprietà di dipendenza, che si applica nei casi in cui un'animazione non è attiva.

(Ereditato da DependencyObject)
GetAnnotations()

Ottiene un riferimento all'elenco di annotazioni di automazione interfaccia utente per il peer di automazione corrente.
GetAnnotationsCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama GetAnnotations o un'API client di Automazione interfaccia utente Microsoft equivalente.
GetAutomationControlType()

Ottiene il tipo di controllo per l'elemento associato al peer di automazione interfaccia utente.
GetAutomationControlTypeCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama GetAutomationControlType o un'API client di Automazione interfaccia utente Microsoft equivalente.
GetAutomationId()

Ottiene l'oggetto AutomationId dell'elemento associato al peer di automazione.
GetAutomationIdCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama GetAutomationId o un'API client di Automazione interfaccia utente Microsoft equivalente.
GetBoundingRectangle()

Ottiene l'oggetto Rect che rappresenta le coordinate dello schermo dell'elemento associato al peer di automazione.
GetBoundingRectangleCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama GetBoundingRectangle o un'API client di Automazione interfaccia utente Microsoft equivalente.
GetChildren()

Ottiene la raccolta di elementi figlio rappresentati nell'albero di automazione interfaccia utente come elementi figlio immediati del peer di automazione.
GetChildrenCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama GetChildren o un'API client di Automazione interfaccia utente Microsoft equivalente.
GetClassName()

Ottiene un nome utilizzato con AutomationControlType, per distinguere il controllo rappresentato da automationPeer.
GetClassNameCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama GetClassName o un'API client di Automazione interfaccia utente Microsoft equivalente.
GetClickablePoint()

Ottiene un punto sull'elemento associato al peer di automazione che risponde a un clic del mouse.
GetClickablePointCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama GetClickablePoint o un'API client di Automazione interfaccia utente Microsoft equivalente.
GetControlledPeers()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama GetControlPeers o un'API client di Automazione interfaccia utente Microsoft equivalente, ad esempio ottenere un valore di proprietà identificato da UIA_ControllerForPropertyId.
GetControlledPeersCore()

Ottiene un elenco dei peer controllati per il peer di automazione corrente.
GetCulture()

Chiama GetCultureCore per ottenere il valore delle impostazioni cultura per l'elemento associato al peer di automazione.
GetCultureCore()

Ottiene il valore delle impostazioni cultura per l'elemento associato al peer di automazione.
GetDescribedByCore()

Ottiene una raccolta di elementi che forniscono altre informazioni sull'elemento di automazione.
GetElementFromPoint(Point)

Ottiene un elemento dal punto specificato.
GetElementFromPointCore(Point)

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama GetElementFromPoint o un'API client di Automazione interfaccia utente Microsoft equivalente.
GetFlowsFromCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama AutomationProperties.GetFlowsFrom o un'API client di Automazione interfaccia utente Microsoft equivalente.
GetFlowsToCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama AutomationProperties.GetFlowsTo o un'API client di Automazione interfaccia utente Microsoft equivalente.
GetFocusedElement()

Ottiene l'elemento che ha attualmente lo stato attivo.
GetFocusedElementCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama GetFocusedElement o un'API client di Automazione interfaccia utente Microsoft equivalente.
GetFullDescription()

Ottiene una stringa localizzata che descrive l'aspetto visivo effettivo o il contenuto di un elemento, ad esempio un'immagine o un controllo immagine.
GetFullDescriptionCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama GetFullDescription o un'API client di Automazione interfaccia utente Microsoft equivalente.
GetHeadingLevel()

Ottiene il livello di intestazione dell'elemento di automazione interfaccia utente associato a questo peer di automazione.
GetHeadingLevelCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama GetHeadingLevel o un'API client di Automazione interfaccia utente Microsoft equivalente.
GetHelpText()

Ottiene il testo che descrive la funzionalità del controllo associato al peer di automazione.
GetHelpTextCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama GetHelpText o un'API client di Automazione interfaccia utente Microsoft equivalente.
GetItemStatus()

Ottiene il testo che indica lo stato visivo dell'elemento associato a questo peer di automazione.
GetItemStatusCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama GetItemStatus o un'API client di Automazione interfaccia utente Microsoft equivalente.
GetItemType()

Ottiene una stringa che descrive il tipo di elemento rappresentato da un elemento.
GetItemTypeCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama GetItemType o un'API client di Automazione interfaccia utente Microsoft equivalente.
GetLabeledBy()

Ottiene AutomationPeer per UIElement destinato all'elemento .
GetLabeledByCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama GetLabeledBy o un'API client di Automazione interfaccia utente Microsoft equivalente.
GetLandmarkType()

Ottiene il tipo di punto di riferimento per questo peer di automazione.
GetLandmarkTypeCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama GetLandmarkType o un'API client di Automazione interfaccia utente Microsoft equivalente.
GetLevel()

Restituisce l'intero in base 1 per il livello (gerarchia) dell'elemento associato al peer di automazione.
GetLevelCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama GetLevel o un'API client di Automazione interfaccia utente Microsoft equivalente.
GetLiveSetting()

Ottiene le informazioni sul comportamento di notifica dell'impostazione dinamica per l'oggetto associato al peer di automazione interfaccia utente.
GetLiveSettingCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama GetLiveSetting o un'API client di Automazione interfaccia utente Microsoft equivalente.
GetLocalizedControlType()

Ottiene una stringa localizzata che rappresenta il valore AutomationControlType per il controllo associato a questo peer di automazione.
GetLocalizedControlTypeCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama GetLocalizedControlType o un'API client di Automazione interfaccia utente Microsoft equivalente.
GetLocalizedLandmarkType()

Ottiene una stringa localizzata che rappresenta il valore AutomationLandmarkType per l'elemento associato a questo peer di automazione.
GetLocalizedLandmarkTypeCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama GetLocalizedLandmarkType o un'API client di Automazione interfaccia utente Microsoft equivalente.
GetName()

Ottiene il testo che descrive l'elemento associato a questo peer di automazione. Il valore microsoft Automazione interfaccia utente Name è l'identificatore principale usato dalla maggior parte della tecnologia di assistive technology quando rappresentano l'interfaccia utente dell'app interagendo con il framework di automazione interfaccia utente Microsoft.
GetNameCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama GetName o un'API client di Automazione interfaccia utente Microsoft equivalente.
GetOrientation()

Ottiene un valore che indica l'orientamento esplicito del controllo, se presente.
GetOrientationCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama GetOrientation o un'API client di Automazione interfaccia utente Microsoft equivalente.
GetParent()

Ottiene AutomationPeer che è l'elemento padre di questo AutomationPeer.
GetPattern(PatternInterface)

Ottiene il pattern di controllo associato all'oggetto PatternInterface specificato.
GetPatternCore(PatternInterface)

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama GetPattern o un'API client di Automazione interfaccia utente Microsoft equivalente.
GetPeerFromPoint(Point)

Ottiene un oggetto AutomationPeer dal punto specificato.
GetPeerFromPointCore(Point)

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama GetPeerFromPoint o un'API client di Automazione interfaccia utente Microsoft equivalente.
GetPositionInSet()

Restituisce l'intero in base 1 per la posizione ordinale nel set per l'elemento associato al peer di automazione.
GetPositionInSetCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama GetPositionInSet o un'API client di Automazione interfaccia utente Microsoft equivalente.
GetSizeOfSet()

Restituisce l'intero in base 1 per le dimensioni del set in cui si trova l'elemento associato al peer di automazione.
GetSizeOfSetCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama GetSizeOfSet o un'API client di Automazione interfaccia utente Microsoft equivalente.
GetValue(DependencyProperty)

Restituisce il valore effettivo corrente di una proprietà di dipendenza da dependencyObject.

(Ereditato da DependencyObject)
HasKeyboardFocus()

Ottiene un valore che indica se l'elemento associato a questo peer di automazione ha attualmente lo stato attivo della tastiera.
HasKeyboardFocusCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama HasKeyboardFocus o un'API client di Automazione interfaccia utente Microsoft equivalente.
InvalidatePeer()

Attiva il ricalcolo delle proprietà principali di AutomationPeer e genera la notifica PropertyChanged al client di automazione se le proprietà sono state modificate.
IsContentElement()

Ottiene un valore che indica se l'elemento associato a questo peer di automazione contiene dati presentati all'utente.
IsContentElementCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama IsContentElement o un'API client di Automazione interfaccia utente Microsoft equivalente.
IsControlElement()

Ottiene un valore che indica se l'elemento viene compreso dall'utente come interattivo o che contribuisce alla struttura logica del controllo nell'interfaccia utente grafica.
IsControlElementCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama IsControlElement o un'API client di Automazione interfaccia utente Microsoft equivalente.
IsDataValidForForm()

Ottiene un valore booleano che indica se il valore immesso o selezionato è valido per la regola del modulo associata all'elemento di automazione.
IsDataValidForFormCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft accede a IsDataValidForForm o a un'API client di Automazione interfaccia utente Microsoft equivalente.
IsDialog()

Ottiene un valore che indica se l'elemento associato a questo peer di automazione è una finestra di dialogo.
IsDialogCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama IsDialog o un'API client di Automazione interfaccia utente Microsoft equivalente.
IsEnabled()

Ottiene un valore che indica se l'elemento associato a questo peer di automazione supporta l'interazione.
IsEnabledCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama IsEnabled o un'API client di Automazione interfaccia utente Microsoft equivalente.
IsKeyboardFocusable()

Ottiene un valore che indica se l'elemento può accettare lo stato attivo della tastiera.
IsKeyboardFocusableCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama IsKeyboardFocusable o un'API client di Automazione interfaccia utente Microsoft equivalente.
IsOffscreen()

Ottiene un valore che indica se un elemento è fuori dallo schermo.
IsOffscreenCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama IsOffscreen o un'API client di Automazione interfaccia utente Microsoft equivalente.
IsPassword()

Ottiene un valore che indica se l'elemento contiene contenuto sensibile.
IsPasswordCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama IsPassword o un'API client di Automazione interfaccia utente Microsoft equivalente.
IsPeripheral()

Ottiene un valore booleano che indica se l'elemento di automazione rappresenta l'interfaccia utente periferica.
IsPeripheralCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft accede a IsPeripheral o a un'API client di Automazione interfaccia utente Microsoft equivalente.
IsRequiredForForm()

Ottiene un valore che indica se l'elemento associato a questo peer deve essere completato in un modulo.
IsRequiredForFormCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama IsRequiredForForm o un'API client di Automazione interfaccia utente Microsoft equivalente.
ListenerExists(AutomationEvents)

Ottiene un valore che indica se Microsoft Automazione interfaccia utente segnala che un client è in ascolto dell'evento specificato.
Navigate(AutomationNavigationDirection)

Ottiene l'elemento nella direzione specificata all'interno dell'albero di automazione interfaccia utente.
NavigateCore(AutomationNavigationDirection)

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama Navigate o un'API client di Automazione interfaccia utente Microsoft equivalente.
PeerFromProvider(IRawElementProviderSimple)

Ottiene un oggetto AutomationPeer per il proxy IRawElementProviderSimple specificato.
ProviderFromPeer(AutomationPeer)

Ottiene il proxy IRawElementProviderSimple per l'oggetto AutomationPeer specificato.
RaiseAutomationEvent(AutomationEvents)

Genera un evento di automazione.
RaiseNotificationEvent(AutomationNotificationKind, AutomationNotificationProcessing, String, String)

Avvia un evento di notifica.
RaisePropertyChangedEvent(AutomationProperty, Object, Object)

Genera un evento per notificare al client di automazione un valore di proprietà modificato.
RaiseStructureChangedEvent(AutomationStructureChangeType, AutomationPeer)

Genera un evento per notificare al core di Automazione interfaccia utente Microsoft che la struttura ad albero è stata modificata.
RaiseTextEditTextChangedEvent(AutomationTextEditChangeType, IVectorView<String>)

Genera un evento per notificare al core di Automazione interfaccia utente Microsoft che un controllo di testo ha modificato testo a livello di codice.
ReadLocalValue(DependencyProperty)

Restituisce il valore locale di una proprietà di dipendenza, se è impostato un valore locale.

(Ereditato da DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

Registra una funzione di notifica per l'ascolto delle modifiche a una dipendenza specifica in questa istanza dependencyObject .

(Ereditato da DependencyObject)
SetFocus()

Imposta lo stato attivo della tastiera sull'elemento associato a questo peer di automazione.
SetFocusCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama SetFocus o un'API client di Automazione interfaccia utente Microsoft equivalente.
SetParent(AutomationPeer)

Imposta AutomationPeer che è l'elemento padre di automationPeer.
SetValue(DependencyProperty, Object)

Imposta il valore locale di una proprietà di dipendenza in un Oggetto DependencyObject.

(Ereditato da DependencyObject)
ShowContextMenu()

Mostra il menu di scelta rapida disponibile per l'elemento proprietario.
ShowContextMenuCore()

Fornisce il comportamento del peer quando un client di Automazione interfaccia utente Microsoft chiama ShowContextMenu o un'API client di Automazione interfaccia utente Microsoft equivalente.
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

Annulla una notifica di modifica registrata in precedenza chiamando RegisterPropertyChangedCallback.

(Ereditato da DependencyObject)

Si applica a

Vedi anche