Condividi tramite


UIElement Classe

Definizione

UIElement è una classe di base per la maggior parte degli oggetti dell'interfaccia utente di Windows Runtime con aspetto visivo e può elaborare l'input di base come parte dell'interfaccia utente dell'app.

public ref class UIElement : DependencyObject, IAnimationObject, IVisualElement, IVisualElement2
/// [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 UIElement : DependencyObject, IAnimationObject, IVisualElement, IVisualElement2
[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 UIElement : DependencyObject, IAnimationObject, IVisualElement, IVisualElement2
Public Class UIElement
Inherits DependencyObject
Implements IAnimationObject, IVisualElement, IVisualElement2
Ereditarietà
Object Platform::Object IInspectable DependencyObject UIElement
Derivato
Attributi
Implementazioni

Commenti

UIElement è un elemento di base: è una classe che molte altre classi di Windows Runtime ereditano da per supportare il modello di elemento dell'interfaccia utente XAML. Le proprietà, i metodi e gli eventi che UIElement definiscono vengono ereditati da centinaia di altre classi di Windows Runtime.

UIElement non espone un costruttore pubblico. In genere, non si derivano classi da UIElement o FrameworkElement direttamente. Le classi di base usate più in genere per le classi personalizzate derivate sono le seguenti:

La classe UIElement viene usata come parametro di tipo di molte proprietà e metodi nell'API di Windows Runtime. Ad esempio, la proprietà child di Border accetta un singolo , che rappresenta l'elemento intorno al quale viene disegnato il Border . È possibile fornire qualsiasi elemento derivato da UIElementper tale proprietà, inclusi i controlli personalizzati definiti dall'utente.

La classe UIElementCollection fornisce una raccolta fortemente tipizzata di elementi . viene utilizzato come tipo per le proprietà di oggetti che contengono diversi elementi figlio, ad esempio per la proprietà Children di qualsiasi classe Panel .

API e funzionalità di UIElement

UIElement estende DependencyObject, che è un altro elemento di base e aggiunge il supporto per varie aree di funzionalità di Windows Runtime.

Input ed eventi per rispondere all'interazione dell'utente

Gran parte del comportamento di input per gli elementi visibili in un'interfaccia utente è definita nella classe UIElement. Sono inclusi gli eventi per le interazioni tramite tastiera, mouse, tocco, trascinamento della selezione e stato attivo. Per altre informazioni, vedere Gestire l'input del puntatore, Interazioni tramite tastierae Interazioni utente personalizzate.

API prominente di UIElement che supportano l'input e l'interazione dell'utente:

Movimenti e manipolazioni

Movimenti e manipolazioni sono anche un modo per gestire l'input e l'interazione dell'utente. L'API viene elencata separatamente qui perché questi eventi rappresentano il modo in cui il sistema interagisce con le azioni di input a livello di dispositivo e le interpreta come interazione dell'utente. Le manipolazioni sono un modo per gestire interazioni dinamiche multitocco, ad esempio avvicinamento delle dita e allungamento. Insieme, i movimenti e le manipolazioni forniscono i modelli di tocco per l'interazione tramite tocco con l'app UWP. Per altre info, vedi Interazioni utente personalizzate e Progettazione interazione tramite tocco.

API prominente di UIElement che supportano movimenti e manipolazioni:

Aspetto di base

Le proprietà visibility e Opacity vengono spesso usate per regolare l'aspetto di un elemento nell'interfaccia utente, in particolare negli stili, nei modelli e negli stati di visualizzazione. Le proprietàClip , RenderTransforme Transizioni sono utili per produrre interazioni e look diversi per gli elementi dell'interfaccia utente.

Layout di base

La classe UIElement fornisce un punto di partenza per le caratteristiche di layout con proprietà quali DesiredSize e i metodi Arrange e Measure. FrameworkElement aggiunge altre funzionalità di layout. Per altre info, vedi Definire layout con XAML e FrameworkElement.

Eventi indirizzati

La maggior parte degli eventi di input di UIElement sono eventi indirizzati. Un evento indirizzato abilita un sistema di notifica di gestione degli eventi predefinito, in modo che un oggetto padre possa gestire gli eventi di input dagli oggetti figlio nell'albero degli oggetti se l'evento rimane non gestito. Questo comportamento dell'evento di input è utile per il raggruppamento dell'area di input e per la composizione dei controlli. Per altre info, vedere Eventi e panoramica degli eventi indirizzati.

API prominente di UIElement che supportano eventi indirizzati: AddHandler, RemoveHandler, *proprietà evento.

Supporto di altre piattaforme

Proprietà di dipendenza UIElement

Molte delle proprietà di lettura/scrittura della classe di elementi di base UIElement sono proprietà di dipendenza. Le proprietà di dipendenza supportano alcune delle funzionalità di base del modello di programmazione per un'app che usa C++ o C#, ad esempio stili e modelli, data binding, riferimenti alle risorse XAML e logica modificata proprietà. Per altre informazioni sulle proprietà di dipendenza e sulle funzionalità supportate, vedere panoramica delle proprietà di dipendenza .

Classi derivate UIElement

L'unica classe Windows Runtime che deriva direttamente da UIElement è FrameworkElement. Per un elenco delle classi che derivano da FrameworkElement, vedere la sezione "FrameworkElement classi derivate" dell'argomento di riferimento FrameworkElement.

Proprietà

AccessKey

Ottiene o imposta il tasto di scelta (mnemonico) per questo elemento.

AccessKeyProperty

Identifica per la proprietà di dipendenza AccessKey .

AccessKeyScopeOwner

Ottiene o imposta un elemento di origine che fornisce l'ambito della chiave di accesso per questo elemento, anche se non si trova nella struttura ad albero visuale dell'elemento di origine.

AccessKeyScopeOwnerProperty

Identifica per la proprietà di dipendenza AccessKeyScopeOwner.

ActualOffset

Ottiene la posizione di questo uiElement, rispetto al relativo elemento padre, calcolata durante il passaggio di disposizione del processo di layout.

ActualSize

Ottiene le dimensioni calcolate da questo UIElement durante il passaggio di disposizione del processo di layout.

AllowDrop

Ottiene o imposta un valore che determina se questa UIElement può essere una destinazione di rilascio ai fini delle operazioni di trascinamento della selezione.

AllowDropProperty

Identifica la proprietà di dipendenza AllowDrop.

BringIntoViewRequestedEvent

Ottiene l'identificatore per l'evento indirizzato BringIntoViewRequested.

CacheMode

Ottiene o imposta un valore che indica che il contenuto sottoposto a rendering deve essere memorizzato nella cache come bitmap composita quando possibile.

CacheModeProperty

Identifica la proprietà di dipendenza CacheMode.

CanBeScrollAnchor

Ottiene o imposta un valore che indica se l'UIElement può essere un candidato per l'ancoraggio dello scorrimento.

CanBeScrollAnchorProperty

Identifica il CanBeScrollAnchor proprietà di dipendenza.

CanDrag

Ottiene o imposta un valore che indica se l'elemento può essere trascinato come dati in un'operazione di trascinamento della selezione.

CanDragProperty

Identifica la proprietà di dipendenza CanDrag.

CenterPoint

Ottiene o imposta il punto centrale dell'elemento, ovvero il punto su cui si verifica la rotazione o la scalabilità. Influisce sulla posizione di rendering dell'elemento.

CharacterReceivedEvent

Ottiene l'identificatore per l'evento indirizzato CharacterReceived.

Clip

Ottiene o imposta la RectangleGeometry utilizzata per definire la struttura del contenuto di un UIElement.

ClipProperty

Identifica la proprietà di dipendenza Clip.

CompositeMode

Ottiene o imposta una proprietà che dichiara modalità di composizione e fusione alternative per l'elemento nel layout e nella finestra padre. Questo è rilevante per gli elementi coinvolti in un'interfaccia utente XAML/Microsoft DirectX mista.

CompositeModeProperty

Identifica la proprietà di dipendenza CompositeMode.

ContextFlyout

Ottiene o imposta il riquadro a comparsa associato a questo elemento.

ContextFlyoutProperty

Identifica per la ContextFlyout proprietà di dipendenza.

ContextRequestedEvent

Ottiene l'identificatore per l'evento indirizzato ContextRequested.

DesiredSize

Ottiene le dimensioni calcolate da questo UIElement durante il passaggio della misura del processo di layout.

Dispatcher

Restituisce sempre null in un'app di Windows App SDK. In alternativa, usare DispatcherQueue.

(Ereditato da DependencyObject)
DispatcherQueue

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

(Ereditato da DependencyObject)
DoubleTappedEvent

Ottiene l'identificatore per l'evento indirizzato DoubleTapped.

DragEnterEvent

Ottiene l'identificatore per l'evento DragEnter indirizzato.

DragLeaveEvent

Ottiene l'identificatore per l'evento indirizzato DragLeave.

DragOverEvent

Ottiene l'identificatore per l'evento DragOver indirizzato.

DropEvent

Ottiene l'identificatore per l'evento indirizzato Drop.

ExitDisplayModeOnAccessKeyInvoked

Ottiene o imposta un valore che specifica se la visualizzazione della chiave di scelta viene chiusa quando viene richiamata una chiave di scelta.

ExitDisplayModeOnAccessKeyInvokedProperty

Identifica il ExitDisplayModeOnAccessKeyInvoked proprietà di dipendenza.

FocusState

Ottiene un valore che specifica se il controllo ha lo stato attivo e la modalità con cui è stato ottenuto lo stato attivo.

FocusStateProperty

Identifica la proprietà di dipendenza FocusState.

GettingFocusEvent

Ottiene l'identificatore per l'evento GettingFocus indirizzato.

HighContrastAdjustment

Ottiene o imposta un valore che indica se il framework regola automaticamente le proprietà visive dell'elemento quando sono abilitati i temi a contrasto elevato.

HighContrastAdjustmentProperty

Identifica il HighContrastAdjustment proprietà di dipendenza.

HoldingEvent

Ottiene l'identificatore per l'evento indirizzato Holding.

IsAccessKeyScope

Ottiene o imposta un valore che indica se un elemento definisce il proprio ambito della chiave di accesso.

IsAccessKeyScopeProperty

Identifica per la proprietà di dipendenza isAccessKeyScope .

IsDoubleTapEnabled

Ottiene o imposta un valore che determina se l'evento DoubleTapped può provenire da tale elemento.

IsDoubleTapEnabledProperty

Identifica la proprietà di dipendenza IsDoubleTapEnabled.

IsHitTestVisible

Ottiene o imposta un valore che indica se l'area contenuta di questo UIElement può restituire valori true per l'hit testing.

IsHitTestVisibleProperty

Identifica la proprietà di dipendenza isHitTestVisible .

IsHoldingEnabled

Ottiene o imposta un valore che determina se l'evento Holding può provenire da tale elemento.

IsHoldingEnabledProperty

Identifica la proprietà di dipendenza IsHoldingEnabled.

IsRightTapEnabled

Ottiene o imposta un valore che determina se l'evento RightTapped può provenire da tale elemento.

IsRightTapEnabledProperty

Identifica la proprietà di dipendenza IsRightTapEnabled.

IsTabStop

Ottiene o imposta un valore che indica se un controllo è incluso nella struttura di spostamento tramite tabulazioni.

IsTabStopProperty

Identifica la proprietà di dipendenza UIElement.IsTabStop.

IsTapEnabled

Ottiene o imposta un valore che determina se l'evento Tapped può provenire da tale elemento.

IsTapEnabledProperty

Identifica la proprietà di dipendenza IsTapEnabled.

KeyboardAcceleratorPlacementMode

Ottiene o imposta un valore che indica se il controllo descrizione comando visualizza la combinazione di tasti per l'acceleratore di tastiera associato.

KeyboardAcceleratorPlacementModeProperty

Identifica il KeyboardAcceleratorPlacementMode proprietà di dipendenza.

KeyboardAcceleratorPlacementTarget

Ottiene o imposta un valore che indica il controllo descrizione comando che visualizza la combinazione di tasti di scelta rapida.

KeyboardAcceleratorPlacementTargetProperty

Identifica la proprietà di dipendenza KeyboardAcceleratorPlacementTarget.

KeyboardAccelerators

Ottiene la raccolta di combinazioni di tasti che richiamano un'azione usando la tastiera.

Gli acceleratori vengono in genere assegnati a pulsanti o voci di menu.

esempio di un menu che mostra gli acceleratori di tastiera per varie voci di menu
Esempio di menu che mostra gli acceleratori di tastiera per varie voci di menu

KeyDownEvent

Ottiene l'identificatore per l'evento indirizzato KeyDown.

KeyTipHorizontalOffset

Ottiene o imposta un valore che indica l'estrema sinistra o destra in cui viene posizionato il suggerimento per il tasto in relazione all'oggetto UIElement.

KeyTipHorizontalOffsetProperty

Identifica la proprietà di dipendenza KeyTipHorizontalOffset.

KeyTipPlacementMode

Ottiene o imposta un valore che indica dove viene inserito il suggerimento chiave di scelta rispetto al limite dell'oggetto UIElement.

KeyTipPlacementModeProperty

Identifica il KeyTipPlacementMode proprietà di dipendenza.

KeyTipTarget

Ottiene o imposta un valore che indica l'elemento di destinazione del suggerimento tasto di scelta.

KeyTipTargetProperty

Identifica il KeyTipTarget proprietà di dipendenza.

KeyTipVerticalOffset

Ottiene o imposta un valore che indica l'altezza o la riduzione del suggerimento per il tasto rispetto all'elemento dell'interfaccia utente.

KeyTipVerticalOffsetProperty

Identifica il KeyTipVerticalOffset proprietà di dipendenza.

KeyUpEvent

Ottiene l'identificatore dell'evento indirizzato KeyUp.

Lights

Ottiene la raccolta di oggetti XamlLight associati a questo elemento.

LightsProperty

Identifica la proprietà di dipendenza Lights.

LosingFocusEvent

Ottiene l'identificatore per l'evento indirizzato LosingFocus.

ManipulationCompletedEvent

Ottiene l'identificatore per l'evento indirizzato ManipulationCompleted.

ManipulationDeltaEvent

Ottiene l'identificatore per l'evento indirizzato ManipulationDelta.

ManipulationInertiaStartingEvent

Ottiene l'identificatore per l'evento indirizzato ManipulationInertiaStarting.

ManipulationMode

Ottiene o imposta il valore ManipulationModes utilizzato per comportamento uiElement e l'interazione con i movimenti. L'impostazione di questo valore consente di gestire gli eventi di manipolazione da questo elemento nel codice dell'app.

ManipulationModeProperty

Identifica la proprietà di dipendenza ManipulationMode.

ManipulationStartedEvent

Ottiene l'identificatore per l'evento ManipulationStarted indirizzato.

ManipulationStartingEvent

Ottiene l'identificatore per l'evento ManipulationStarting indirizzato.

NoFocusCandidateFoundEvent

Ottiene l'identificatore per l'evento indirizzato NoFocusCandidateFound.

Opacity

Ottiene o imposta il grado di opacità dell'oggetto.

OpacityProperty

Identifica la proprietà di dipendenza isHitTestVisible .

OpacityTransition

Ottiene o imposta l'oggetto ScalarTransition che anima le modifiche apportate alla proprietà Opacity.

PointerCanceledEvent

Ottiene l'identificatore per l'evento indirizzato PointerCanceled .

PointerCaptureLostEvent

Ottiene l'identificatore per l'evento indirizzato PointerCaptureLost.

PointerCaptures

Ottiene il set di tutti i puntatori acquisiti, rappresentati come puntatore valori.

PointerCapturesProperty

Identifica la proprietà di dipendenza PointerCaptures.

PointerEnteredEvent

Ottiene l'identificatore per l'evento indirizzato PointerEntered.

PointerExitedEvent

Ottiene l'identificatore per l'evento indirizzato PointerExited.

PointerMovedEvent

Ottiene l'identificatore dell'evento indirizzato PointerMoved.

PointerPressedEvent

Ottiene l'identificatore per l'evento indirizzato PointerPressed.

PointerReleasedEvent

Ottiene l'identificatore per l'evento indirizzato PointerReleased.

PointerWheelChangedEvent

Ottiene l'identificatore per l'evento indirizzato PointerWheelChanged.

PreviewKeyDownEvent

Ottiene l'identificatore per l'evento indirizzato PreviewKeyDown.

PreviewKeyUpEvent

Ottiene l'identificatore per l'evento indirizzato PreviewKeyUp.

Projection

Ottiene o imposta la proiezione prospettica (effetto 3D) da applicare durante il rendering di questo elemento.

ProjectionProperty

Identifica la proprietà di dipendenza proiezione.

ProtectedCursor

Ottiene o imposta il cursore visualizzato quando il puntatore si trova su questo elemento. Il valore predefinito è Null, che indica che non viene apportata alcuna modifica al cursore.

RasterizationScale

Ottiene un valore che rappresenta il numero di pixel non elaborati (fisici) per ogni pixel di visualizzazione.

RenderSize

Ottiene le dimensioni di rendering finali di un UIElement. L'uso non è consigliato, vedere La sezione Osservazioni.

RenderTransform

Ottiene o imposta informazioni di trasformazione che influiscono sulla posizione di rendering di un UIElement.

RenderTransformOrigin

Ottiene o imposta il punto di origine di qualsiasi possibile trasformazione di rendering dichiarata da RenderTransform, rispetto ai limiti del UIElement.

RenderTransformOriginProperty

Identifica la proprietà di dipendenza RenderTransformOrigin.

RenderTransformProperty

Identifica la proprietà di dipendenza RenderTransform.

RightTappedEvent

Ottiene l'identificatore per l'evento RightTapped indirizzato.

Rotation

Ottiene o imposta l'angolo di rotazione in senso orario, espresso in gradi. Ruota rispetto a RotationAxis e CenterPoint. Influisce sulla posizione di rendering dell'elemento.

RotationAxis

Ottiene o imposta l'asse per ruotare l'elemento.

RotationTransition

Ottiene o imposta l'oggetto ScalarTransition che anima le modifiche apportate alla proprietà Rotation.

Scale

Ottiene o imposta la scala dell'elemento. Scala rispetto a CenterPoint dell'elemento. Influisce sulla posizione di rendering dell'elemento.

ScaleTransition

Ottiene o imposta Vector3Transition che anima le modifiche apportate alla proprietà Scale.

Shadow

Ottiene o imposta l'effetto ombreggiatura eseguito dall'elemento .

ShadowProperty

Identifica la proprietà di dipendenza shadow .

TabFocusNavigation

Ottiene o imposta un valore che modifica il funzionamento di tabulazione e TabIndex per questo controllo.

TabFocusNavigationProperty

Identifica l'TabFocusNavigation proprietà di dipendenza.

TabIndex

Ottiene o imposta un valore che determina l'ordine in cui gli elementi ricevono lo stato attivo quando l'utente passa attraverso i controlli utilizzando il tasto tab .

TabIndexProperty

Identifica la proprietà di dipendenza TabIndex.

TappedEvent

Ottiene l'identificatore per l'evento indirizzato Tapped.

Transform3D

Ottiene o imposta l'effetto di trasformazione 3D da applicare durante il rendering di questo elemento.

Transform3DProperty

Identifica la proprietà di dipendenza Transform3D.

TransformMatrix

Ottiene o imposta la matrice di trasformazione da applicare all'elemento .

Transitions

Ottiene o imposta la raccolta di elementi di stile Transition che si applicano a un UIElement.

TransitionsProperty

Identifica la proprietà di dipendenza transizioni.

Translation

Ottiene o imposta la posizione di rendering x, y e z dell'elemento.

TranslationTransition

Ottiene o imposta Vector3Transition che anima le modifiche apportate alla proprietà Translation.

UseLayoutRounding

Ottiene o imposta un valore che determina se il rendering per l'oggetto e il relativo sottoalbero visivo devono utilizzare il comportamento di arrotondamento che allinea il rendering a pixel interi.

UseLayoutRoundingProperty

Identifica il UseLayoutRounding proprietà di dipendenza.

UseSystemFocusVisuals

Ottiene o imposta un valore che indica se il controllo utilizza oggetti visivi dello stato attivo disegnati dal sistema o dagli oggetti visivi dello stato attivo definiti nel modello di controllo.

UseSystemFocusVisualsProperty

Identifica il UseSystemFocusVisuals proprietà di dipendenza.

Visibility

Ottiene o imposta la visibilità di un UIElement. Un UIElement che non è visibile non viene sottoposto a rendering e non comunica le dimensioni desiderate al layout.

VisibilityProperty

Identifica la proprietà di dipendenza Visibility.

XamlRoot

Ottiene o imposta il XamlRoot in cui viene visualizzato questo elemento.

XYFocusDown

Ottiene o imposta l'oggetto che ottiene lo stato attivo quando un utente preme verso il basso il riquadro direzionale (D-pad) di un controller di gioco.

XYFocusDownNavigationStrategy

Ottiene o imposta un valore che specifica la strategia utilizzata per determinare l'elemento di destinazione di una navigazione verso il basso.

XYFocusDownNavigationStrategyProperty

Identifica la proprietà di dipendenza XYFocusDownNavigationStrategy.

XYFocusDownProperty

Identifica la proprietà di dipendenza XYFocusDown.

XYFocusKeyboardNavigation

Ottiene o imposta un valore che abilita o disabilita la navigazione utilizzando le frecce direzionali della tastiera.

XYFocusKeyboardNavigationProperty

Identifica il XYFocusKeyboardNavigation proprietà di dipendenza.

XYFocusLeft

Ottiene o imposta l'oggetto che ottiene lo stato attivo quando un utente preme a sinistra sul riquadro direzionale (D-pad) di un controller di gioco.

XYFocusLeftNavigationStrategy

Ottiene o imposta un valore che specifica la strategia utilizzata per determinare l'elemento di destinazione di una navigazione a sinistra.

XYFocusLeftNavigationStrategyProperty

Identifica il XYFocusLeftNavigationStrategy proprietà di dipendenza.

XYFocusLeftProperty

Identifica la proprietà di dipendenza XYFocusLeft.

XYFocusRight

Ottiene o imposta l'oggetto che ottiene lo stato attivo quando un utente preme direttamente sul riquadro direzionale (D-pad) di un controller di gioco.

XYFocusRightNavigationStrategy

Ottiene o imposta un valore che specifica la strategia utilizzata per determinare l'elemento di destinazione di una navigazione a destra.

XYFocusRightNavigationStrategyProperty

Identifica la proprietà di dipendenza XYFocusRightNavigationStrategy .

XYFocusRightProperty

Identifica la proprietà di dipendenza XYFocusRight .

XYFocusUp

Ottiene o imposta l'oggetto che ottiene lo stato attivo quando un utente preme verso l'alto sul riquadro direzionale (D-pad) di un controller di gioco.

XYFocusUpNavigationStrategy

Ottiene o imposta un valore che specifica la strategia utilizzata per determinare l'elemento di destinazione di una navigazione verso l'alto.

XYFocusUpNavigationStrategyProperty

Identifica la proprietà di dipendenza XYFocusUpNavigationStrategy.

XYFocusUpProperty

Identifica la proprietà di dipendenza XYFocusUp.

Metodi

AddHandler(RoutedEvent, Object, Boolean)

Aggiunge un gestore eventi indirizzato per un evento indirizzato specificato, aggiungendo il gestore alla raccolta del gestore nell'elemento corrente. Specificare handledEventsToo come true per richiamare il gestore fornito anche se l'evento viene gestito altrove.

Arrange(Rect)

Posiziona gli oggetti figlio e determina una dimensione per un UIElement. Gli oggetti padre che implementano il layout personalizzato per i relativi elementi figlio devono chiamare questo metodo dalle implementazioni di override del layout per formare un aggiornamento ricorsivo del layout.

CancelDirectManipulations()

Annulla l'elaborazione continua della manipolazione diretta (panoramica/zoom definita dal sistema) su qualsiasi elemento padre ScrollViewer che contiene l'UIElement corrente.

CapturePointer(Pointer)

Imposta l'acquisizione del puntatore su un UIElement. Dopo l'acquisizione, solo l'elemento che ha acquisito genera eventi correlati al puntatore.

ClearValue(DependencyProperty)

Cancella il valore locale di una proprietà di dipendenza.

(Ereditato da DependencyObject)
FindSubElementsForTouchTargeting(Point, Rect)

Consente a un UIElement sottoclasse di esporre elementi figlio che consentono di risolvere la destinazione del tocco.

Focus(FocusState)

Tenta di impostare lo stato attivo su questo elemento.

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)
GetChildrenInTabFocusOrder()

Consente a un UIElement sottoclasse di esporre elementi figlio che partecipano allo stato attivo tabulazione.

GetValue(DependencyProperty)

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

(Ereditato da DependencyObject)
GetVisualInternal()

Recupera il Visual in cui l'elemento viene risolto.

InvalidateArrange()

Invalida lo stato di disposizione (layout) per un UIElement. Dopo l'invalidazione, il UIElement avrà il layout aggiornato, che si verificherà in modo asincrono.

InvalidateMeasure()

Invalida lo stato di misurazione (layout) per un UIElement.

Measure(Size)

Aggiorna il desiredSize di un UIElement. In genere, gli oggetti che implementano il layout personalizzato per i relativi elementi figlio di layout chiamano questo metodo dalle proprie implementazioni MeasureOverride per formare un aggiornamento ricorsivo del layout.

OnBringIntoViewRequested(BringIntoViewRequestedEventArgs)

Chiamato prima che si verifichi l'evento BringIntoViewRequested .

OnCreateAutomationPeer()

Se implementato in una classe derivata, restituisce implementazioni di automationPeer specifiche della classe per l'infrastruttura di automazione interfaccia utente Microsoft.

OnDisconnectVisualChildren()

Eseguire l'override di questo metodo per implementare il comportamento del layout e della logica quando gli elementi vengono rimossi da una proprietà figlio o contenuto specifico della classe.

OnKeyboardAcceleratorInvoked(KeyboardAcceleratorInvokedEventArgs)

Chiamato quando un tasti di scelta rapida (o acceleratore) viene elaborato nell'app. Eseguire l'override di questo metodo per gestire la risposta dell'app quando viene richiamato un acceleratore di tastiera.

OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs)

Chiamato subito prima che un tasti di scelta rapida (o acceleratore) venga elaborato nell'app. Richiamato ogni volta che il codice dell'applicazione o i processi interni chiamano ProcessKeyboardAccelerators. Eseguire l'override di questo metodo per influenzare la gestione dell'acceleratore predefinita.

PopulatePropertyInfo(String, AnimationPropertyInfo)

Definisce una proprietà che può essere animata.

PopulatePropertyInfoOverride(String, AnimationPropertyInfo)

Quando sottoposto a override in una classe derivata, definisce una proprietà che può essere animata.

ReadLocalValue(DependencyProperty)

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

(Ereditato da DependencyObject)
RegisterAsScrollPort(UIElement)

Registra un elemento come che rappresenta un riquadro di visualizzazione scorrevole.

RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

Registra una funzione di notifica per l'ascolto delle modifiche apportate a una specifica DependencyProperty in questa istanza DependencyObject.

(Ereditato da DependencyObject)
ReleasePointerCapture(Pointer)

Rilascia le acquisizioni del puntatore per l'acquisizione di un puntatore specifico da questo UIElement.

ReleasePointerCaptures()

Rilascia tutte le acquisizioni del puntatore contenute in questo elemento.

RemoveHandler(RoutedEvent, Object)

Rimuove il gestore eventi indirizzato specificato da questo UIElement. In genere il gestore in questione è stato aggiunto da AddHandler.

SetValue(DependencyProperty, Object)

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

(Ereditato da DependencyObject)
StartAnimation(ICompositionAnimationBase)

Avvia l'animazione specificata sull'elemento .

StartBringIntoView()

Avvia una richiesta al framework XAML per visualizzare l'elemento all'interno di qualsiasi area scorrevole contenuta all'interno.

StartBringIntoView(BringIntoViewOptions)

Avvia una richiesta al framework XAML per visualizzare l'elemento usando le opzioni specificate.

StartDragAsync(ExpPointerPoint)

UIElement è una classe di base per la maggior parte degli oggetti dell'interfaccia utente di Windows Runtime con aspetto visivo e può elaborare l'input di base come parte dell'interfaccia utente dell'app.

StartDragAsync(PointerPoint)

Avvia un'operazione di trascinamento della selezione.

Importante

Non supportato se un utente esegue l'app in modalità con privilegi elevati, come amministratore.

StopAnimation(ICompositionAnimationBase)

Arresta l'animazione specificata sull'elemento .

TransformToVisual(UIElement)

Restituisce un oggetto transform che può essere utilizzato per trasformare le coordinate dal UIElement all'oggetto specificato.

TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs)

Tenta di richiamare un tasti di scelta rapida (o di tasti di scelta rapida) cercando l'intera struttura ad albero visuale di UIElement per il collegamento.

TryStartDirectManipulation(Pointer)

Riprende l'elaborazione diretta della manipolazione (panoramica/zoom definita dal sistema) su qualsiasi elemento padre ScrollViewer che contiene l'UIElement corrente.

UnregisterPropertyChangedCallback(DependencyProperty, Int64)

Annulla una notifica di modifica registrata in precedenza chiamando RegisterPropertyChangedCallback.

(Ereditato da DependencyObject)
UpdateLayout()

Assicura che tutte le posizioni degli oggetti figlio di un UIElement vengano aggiornate correttamente per il layout.

Eventi

AccessKeyDisplayDismissed

Si verifica quando i tasti di scelta non devono più essere visualizzati.

AccessKeyDisplayRequested

Si verifica quando l'utente richiede la visualizzazione delle chiavi di accesso.

AccessKeyInvoked

Si verifica quando un utente completa una sequenza di tasti di scelta.

BringIntoViewRequested

Si verifica quando StartBringIntoView viene chiamato su questo elemento o su uno dei relativi discendenti.

CharacterReceived

Si verifica quando un singolo carattere composto viene ricevuto dalla coda di input.

ContextCanceled

Si verifica quando un movimento di input del contesto continua in un movimento di manipolazione, per notificare all'elemento che il riquadro a comparsa del contesto non deve essere aperto.

ContextRequested

Si verifica quando l'utente ha completato un movimento di input del contesto, ad esempio un clic con il pulsante destro del mouse.

DoubleTapped

Si verifica quando si verifica un 'interazione doubletap diversamente non gestita sull'area di hit test di questo elemento.

DragEnter

Si verifica quando il sistema di input segnala un evento di trascinamento sottostante con questo elemento come destinazione.

DragLeave

Si verifica quando il sistema di input segnala un evento di trascinamento sottostante con questo elemento come origine.

DragOver

Si verifica quando il sistema di input segnala un evento di trascinamento sottostante con questo elemento come destinazione potenziale di rilascio.

DragStarting

Si verifica quando viene avviata un'operazione di trascinamento.

Drop

Si verifica quando il sistema di input segnala un evento di rilascio sottostante con questo elemento come destinazione di rilascio.

DropCompleted

Si verifica quando viene terminata un'operazione di trascinamento della selezione con questo elemento al termine dell'origine.

GettingFocus

Si verifica prima che un UIElement riceva lo stato attivo. Questo evento viene generato in modo sincrono per assicurarsi che lo stato attivo non venga spostato mentre l'evento è in stato di bubbling.

GotFocus

Si verifica quando un UIElement riceve lo stato attivo. Questo evento viene generato in modo asincrono, in modo che lo stato attivo possa spostarsi nuovamente prima del completamento del bubbling.

Holding

Si verifica quando si verifica un'interazione blocco non gestita sull'area di hit test di questo elemento.

KeyDown

Si verifica quando viene premuto un tasto della tastiera mentre la UIElement ha lo stato attivo.

KeyUp

Si verifica quando viene rilasciato un tasto della tastiera mentre l'UIElement ha lo stato attivo.

LosingFocus

Si verifica prima che un UIElement perde lo stato attivo. Questo evento viene generato in modo sincrono per assicurarsi che lo stato attivo non venga spostato mentre l'evento è in stato di bubbling.

LostFocus

Si verifica quando un UIElement perde lo stato attivo. Questo evento viene generato in modo asincrono, in modo che lo stato attivo possa spostarsi nuovamente prima del completamento del bubbling.

ManipulationCompleted

Si verifica quando viene completata una manipolazione sul UIElement .

ManipulationDelta

Si verifica quando il dispositivo di input cambia posizione durante una manipolazione.

ManipulationInertiaStarting

Si verifica quando il dispositivo di input perde il contatto con l'oggetto UIElement durante una manipolazione e inizia l'inerzia.

ManipulationStarted

Si verifica quando un dispositivo di input inizia una manipolazione sul UIElement.

ManipulationStarting

Si verifica quando viene creato per la prima volta il processore di manipolazione.

NoFocusCandidateFound

Si verifica quando un utente tenta di spostare lo stato attivo (tramite le frecce direzionali o tabulazioni), ma lo stato attivo non si sposta perché non viene trovato alcun candidato per lo stato attivo nella direzione del movimento.

PointerCanceled

Si verifica quando un puntatore che ha effettuato un contatto perde in modo anomalo il contatto.

PointerCaptureLost

Si verifica quando l'acquisizione del puntatore precedentemente mantenuta da questo elemento passa a un altro elemento o altrove.

PointerEntered

Si verifica quando un puntatore entra nell'area hit test di questo elemento.

PointerExited

Si verifica quando un puntatore lascia l'area di hit test di questo elemento.

PointerMoved

Si verifica quando un puntatore si sposta mentre il puntatore rimane all'interno dell'area hit test di questo elemento.

PointerPressed

Si verifica quando il dispositivo puntatore avvia un'azione Premere all'interno di questo elemento.

PointerReleased

Si verifica quando il dispositivo puntatore che in precedenza ha avviato un'azione di Press viene rilasciata, mentre si trova all'interno di questo elemento. Si noti che la fine di un'azione di Press non è garantita l'esecuzione di un evento PointerReleased; altri eventi possono invece essere attivati. Per altre info, vedi Osservazioni.

PointerWheelChanged

Si verifica quando cambia il valore differenziale di una rotellina del puntatore.

PreviewKeyDown

Si verifica quando viene premuto un tasto della tastiera mentre la UIElement ha lo stato attivo.

PreviewKeyUp

Si verifica quando viene rilasciato un tasto della tastiera mentre l'UIElement ha lo stato attivo.

ProcessKeyboardAccelerators

Si verifica quando viene premuto un tasti di scelta rapida .

RightTapped

Si verifica quando si verifica uno stimolo di input con tocco destro mentre il puntatore si trova sull'elemento.

Tapped

Si verifica quando si verifica un'interazione tocco non gestita sull'area hit test di questo elemento.

Si applica a

Vedi anche