AnimatedIcon Classe

Definizione

Rappresenta un'icona che visualizza e controlla un oggetto visivo che può essere animato in risposta alle modifiche dello stato dell'utente e dell'interazione dell'utente.

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="Source")]
class AnimatedIcon : IconElement
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="Source")]
public class AnimatedIcon : IconElement
Public Class AnimatedIcon
Inherits IconElement
Ereditarietà
Attributi

Esempio

Mancia

Per altre info, indicazioni sulla progettazione ed esempi di codice, vedi icona animata.

L'app raccolta winUI 3 include esempi interattivi della maggior parte dei controlli, delle funzionalità e delle funzionalità di WinUI 3. Ottenere l'app dal di Microsoft Store o ottenere il codice sorgente in GitHub

Aggiungere un oggetto AnimatedIcon a un pulsante

In questo esempio viene illustrato un pulsante Indietro con un'icona freccia indietro che anima quando si verificano eventi puntatore.

<!-- 
xmlns:animatedvisuals="using:Microsoft.UI.Xaml.Controls.AnimatedVisuals"
-->

<AppBarButton x:Name="BackButton" Label="Back"
              AnimatedIcon.State="Normal"
              PointerEntered="AppBarButton_PointerEntered"
              PointerExited="AppBarButton_PointerExited">
    <AnimatedIcon>
        <animatedvisuals:AnimatedBackVisualSource/>
        <AnimatedIcon.FallbackIconSource>
            <SymbolIconSource Symbol="Back"/>
        </AnimatedIcon.FallbackIconSource>
    </AnimatedIcon>
</AppBarButton>
// Add handlers.
protected override void OnNavigatedTo(NavigationEventArgs e)
{
    SettingsButton.AddHandler(UIElement.PointerPressedEvent, 
        new PointerEventHandler(AppBarButton_PointerPressed), true);
    SettingsButton.AddHandler(UIElement.PointerReleasedEvent, 
        new PointerEventHandler(AppBarButton_PointerReleased), true);
    base.OnNavigatedTo(e);
}

// Remove handlers.
protected override void OnNavigatedFrom(NavigationEventArgs e)
{
    SettingsButton.RemoveHandler(UIElement.PointerPressedEvent, 
        (PointerEventHandler)AppBarButton_PointerPressed);
    SettingsButton.RemoveHandler(UIElement.PointerReleasedEvent, 
        (PointerEventHandler)AppBarButton_PointerReleased);
    base.OnNavigatedFrom(e);
}

private void AppBarButton_PointerEntered(object sender, PointerRoutedEventArgs e)
{
    AnimatedIcon.SetState((UIElement)sender, "PointerOver");
}

private void AppBarButton_PointerPressed(object sender, PointerRoutedEventArgs e)
{
    AnimatedIcon.SetState((UIElement)sender, "Pressed");
}

private void AppBarButton_PointerReleased(object sender, PointerRoutedEventArgs e)
{
    AnimatedIcon.SetState((UIElement)sender, "Normal");
}

private void AppBarButton_PointerExited(object sender, PointerRoutedEventArgs e)
{
    AnimatedIcon.SetState((UIElement)sender, "Normal");
}

Commenti

Impostare la proprietà AnimatedIcon.Source per specificare l'oggetto visivo animato per l'icona. WinUI fornisce oggetti visivi animati per alcune icone comuni nello spazio dei nomi Microsoft.UI.Xaml.Controls.AnimatedVisuals.

In alcuni casi, le impostazioni di sistema o le limitazioni possono impedire l'animazione dell'icona.

  • Se l'utente disattiva le animazioni nelle impostazioni di sistema, AnimatedIcon visualizza il fotogramma finale della transizione di stato in cui si trovava il controllo.
  • Specificare un FallbackIconSource da usare quando le animazioni non sono supportate, ad esempio nelle versioni precedenti di Windows che non supportano le animazioni Lottie.

Animazioni personalizzate

Puoi creare animazioni personalizzate da usare come icona animata nella tua app. Le animazioni possono essere create con Adobe AfterEffects, quindi è possibile usare tale output con la libreria Lottie-Windows per generare una classe personalizzata che implementa IAnimatedVisualSource2. È possibile usare questa classe come origine per un'icona animata. Per altre informazioni, vedere Usare Lottie per creare contenuto animato per unAnimatedIcon .

Controllare lo stato dell'icona animata

Puoi modificare la posizione di riproduzione e lo stato dell'animazione impostando la proprietà associata AnimatedIcon.State. La proprietà state accetta un valore stringa che descrive lo stato di visualizzazione, ad esempio "Normal", "PointerOver" o "Pressed". È anche possibile specificare una transizione di stato specifica, ad esempio "PressedToNormal".

Un'icona animata Source contiene Marcatori che eseguono il mapping di una posizione nella sequenza temporale dell'animazione a uno stato di visualizzazione. I valori stringa supportati da un Source per impostare la proprietà associata State vengono definiti nell'insieme Markers. Per altre info, vedi Definire indicatori AnimatedIcon.

Le origini visive animate usate nei modelli di controllo hanno spesso un set più complesso di Markers che eseguono il mapping agli stati di controllo, mentre gli oggetti visivi animati per un uso più generale spesso hanno un set più semplice di Markers che eseguono il mapping agli eventi puntatore.

Dove impostare lo stato

Puoi impostare la proprietà sul AnimatedIcon o su un predecessore nell'albero XAML. In entrambi i casi, è necessario usare la sintassi della proprietà associata, come illustrato di seguito:

<AnimatedIcon AnimatedIcon.State="Normal">...</AnimatedIcon>

Importante

Se aggiungi un AnimatedIcon all'albero XAML e imposti la proprietà State su un elemento predecessore, la proprietà State deve essere impostata su un valore iniziale prima che l'icona animata venga caricata per poter animare l'icona. In genere si imposta lo stato iniziale in XAML, come illustrato di seguito.

<StackPanel AnimatedIcon.State="Normal" ...>
   <AnimatedIcon>
       <animatedvisuals:AnimatedBackVisualSource/>
   </AnimatedIcon>
</StackPanel>

Usare gli stati di visualizzazione

Puoi aggiungere un AnimatedIcon alla ControlTemplate di un controllo XAML e usare un VisualStateManager per impostarne lo stato. Alcuni controlli, ad esempio NavigationViewItem, impostano automaticamente lo stato per un AnimatedIcon impostato come Icon.

Per un esempio che imposta AnimatedIcon.State in uno stato di visualizzazione del modello di controllo, vedere il modello predefinito per CheckBox. Il controllo CheckBox usa il AnimatedAcceptVisualSource per il segno di spunta. I setter dello stato di visualizzazione hanno un aspetto simile al seguente:

<VisualState x:Name="CheckedPointerOver">
    ...
    <VisualState.Setters>
        <Setter Target="CheckGlyph.(AnimatedIcon.State)" Value="PointerOverOn"/>
    </VisualState.Setters>
</VisualState>

Gestire gli eventi del puntatore

Per fare in modo che il AnimatedIcon risponda all'interazione dell'utente, è necessario impostare la proprietà associata AnimatedIcon.State in risposta ad alcuni eventi puntatore. Questa tabella mostra gli eventi del puntatore gestiti in genere e gli stati comuni che eseguono il mapping a questi eventi. Tuttavia, non tutte le origini di icone animate verranno mappate esattamente a questi stati.

Evento Stato
UIElement.PointerEntered "PointerOver"
UIElement.PointerPressed "Pressed"
UIElement.PointerReleased "Normal"
UIElement.PointerExited "Normal"

Mancia

Se si inserisce il AnimatedIcon all'interno di un Button o di un altro controllo con un evento Click, gli eventi PointerPressed e PointerReleased vengono contrassegnati come PointerRoutedEventArgs.Handled. Per gestire questi eventi in un pulsante, usare il metodo UIElement.AddHandler per connettere il gestore eventi e specificare handledEventsToo come true. Usare UIElement.RemoveHandler per disconnettere il gestore eventi.

Vedere la sezione Esempi per il codice di esempio che illustra questi gestori eventi.

Proprietà associate XAML

AnimatedIcon è la classe del servizio host per una proprietà associata XAML .

Per supportare l'accesso al processore XAML alle proprietà associate e anche per esporre equivalenti ottenere e impostare operazioni sul codice, ogni proprietà associata XAML ha una coppia di metodi della funzione di accesso Get e Set. Un altro modo per ottenere o impostare il valore nel codice consiste nell'usare il sistema di proprietà di dipendenza, chiamando GetValue o SetValue e passando il campo identificatore come identificatore della proprietà di dipendenza.

Costruttori

AnimatedIcon()

Inizializza una nuova istanza della classe AnimatedIcon.

Proprietà

AccessKey

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

(Ereditato da UIElement)
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.

(Ereditato da UIElement)
ActualHeight

Ottiene l'altezza sottoposta a rendering di un FrameworkElement. Vedere la sezione Osservazioni.

(Ereditato da FrameworkElement)
ActualOffset

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

(Ereditato da UIElement)
ActualSize

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

(Ereditato da UIElement)
ActualTheme

Ottiene il tema dell'interfaccia utente attualmente utilizzato dall'elemento , che potrebbe essere diverso da quello RequestedTheme.

(Ereditato da FrameworkElement)
ActualWidth

Ottiene la larghezza sottoposta a rendering di un FrameworkElement. Vedere la sezione Osservazioni.

(Ereditato da FrameworkElement)
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.

(Ereditato da UIElement)
AllowFocusOnInteraction

Ottiene o imposta un valore che indica se l'elemento ottiene automaticamente lo stato attivo quando l'utente interagisce con esso.

(Ereditato da FrameworkElement)
AllowFocusWhenDisabled

Ottiene o imposta un valore che indica se un controllo disabilitato può ricevere lo stato attivo.

(Ereditato da FrameworkElement)
BaseUri

Ottiene un URI (Uniform Resource Identifier) che rappresenta l'URI di base per un oggetto costruito da XAML in fase di caricamento XAML. Questa proprietà è utile per la risoluzione URI in fase di esecuzione.

(Ereditato da FrameworkElement)
CacheMode

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

(Ereditato da UIElement)
CanBeScrollAnchor

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

(Ereditato da UIElement)
CanDrag

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

(Ereditato da UIElement)
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.

(Ereditato da UIElement)
Clip

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

(Ereditato da UIElement)
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.

(Ereditato da UIElement)
ContextFlyout

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

(Ereditato da UIElement)
DataContext

Ottiene o imposta il contesto dati per un FrameworkElement. Un uso comune di un contesto dati è quando un usa l'estensione di markup {Binding} e partecipa al data binding.

(Ereditato da FrameworkElement)
DesiredSize

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

(Ereditato da UIElement)
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)
ExitDisplayModeOnAccessKeyInvoked

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

(Ereditato da UIElement)
FallbackIconSource

Ottiene o imposta l'icona statica da utilizzare quando l'icona animata non può essere eseguita.

FallbackIconSourceProperty

Identifica la proprietà di dipendenza FallbackIconSource.

FlowDirection

Ottiene o imposta la direzione in cui il testo e altri elementi dell'interfaccia utente vengono trasmessi all'interno di qualsiasi elemento padre che ne controlla il layout. Questa proprietà può essere impostata su LeftToRight o RightToLeft. L'impostazione di FlowDirection su RightToLeft su qualsiasi elemento imposta l'allineamento a destra, l'ordine di lettura da destra a sinistra e il layout del controllo da destra a sinistra.

(Ereditato da FrameworkElement)
FocusState

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

(Ereditato da UIElement)
FocusVisualMargin

Ottiene o imposta il margine esterno dell'oggetto visivo dello stato attivo per un FrameworkElement.

(Ereditato da FrameworkElement)
FocusVisualPrimaryBrush

Ottiene o imposta il pennello utilizzato per disegnare il bordo esterno di un oggetto visivo dello stato attivo HighVisibility o Reveal per un oggetto visivo FrameworkElement.

(Ereditato da FrameworkElement)
FocusVisualPrimaryThickness

Ottiene o imposta lo spessore del bordo esterno di un oggetto visivo dello stato attivo HighVisibility o Reveal per un oggetto visivo FrameworkElement.

(Ereditato da FrameworkElement)
FocusVisualSecondaryBrush

Ottiene o imposta il pennello utilizzato per disegnare il bordo interno di un oggetto visivo dello stato attivo HighVisibility o Reveal per un oggetto visivo FrameworkElement.

(Ereditato da FrameworkElement)
FocusVisualSecondaryThickness

Ottiene o imposta lo spessore del bordo interno di un oggetto visivo dello stato attivo HighVisibility o Reveal per un oggetto visivo FrameworkElement.

(Ereditato da FrameworkElement)
Foreground

Ottiene o imposta un pennello che descrive il colore di primo piano.

(Ereditato da IconElement)
Height

Ottiene o imposta l'altezza suggerita di un FrameworkElement.

(Ereditato da FrameworkElement)
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.

(Ereditato da UIElement)
HorizontalAlignment

Ottiene o imposta le caratteristiche di allineamento orizzontale applicate a un FrameworkElement quando è composto in un elemento padre di layout, ad esempio un pannello o un controllo elementi.

(Ereditato da FrameworkElement)
IsAccessKeyScope

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

(Ereditato da UIElement)
IsDoubleTapEnabled

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

(Ereditato da UIElement)
IsHitTestVisible

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

(Ereditato da UIElement)
IsHoldingEnabled

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

(Ereditato da UIElement)
IsLoaded

Ottiene un valore che indica se l'elemento è stato aggiunto all'albero degli elementi ed è pronto per l'interazione.

(Ereditato da FrameworkElement)
IsRightTapEnabled

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

(Ereditato da UIElement)
IsTabStop

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

(Ereditato da UIElement)
IsTapEnabled

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

(Ereditato da UIElement)
KeyboardAcceleratorPlacementMode

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

(Ereditato da UIElement)
KeyboardAcceleratorPlacementTarget

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

(Ereditato da UIElement)
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

(Ereditato da UIElement)
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.

(Ereditato da UIElement)
KeyTipPlacementMode

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

(Ereditato da UIElement)
KeyTipTarget

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

(Ereditato da UIElement)
KeyTipVerticalOffset

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

(Ereditato da UIElement)
Language

Ottiene o imposta informazioni sul linguaggio di localizzazione/globalizzazione applicabili a un FrameworkElemente anche a tutti gli elementi figlio dell'FrameworkElement corrente nella rappresentazione dell'oggetto e nell'interfaccia utente.

(Ereditato da FrameworkElement)
Lights

Ottiene la raccolta di oggetti XamlLight associati a questo elemento.

(Ereditato da UIElement)
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.

(Ereditato da UIElement)
Margin

Ottiene o imposta il margine esterno di un FrameworkElement.

(Ereditato da FrameworkElement)
MaxHeight

Ottiene o imposta il vincolo di altezza massima di un FrameworkElement.

(Ereditato da FrameworkElement)
MaxWidth

Ottiene o imposta il vincolo di larghezza massima di un FrameworkElement.

(Ereditato da FrameworkElement)
MinHeight

Ottiene o imposta il vincolo di altezza minima di un FrameworkElement.

(Ereditato da FrameworkElement)
MinWidth

Ottiene o imposta il vincolo di larghezza minima di un FrameworkElement.

(Ereditato da FrameworkElement)
MirroredWhenRightToLeft

Ottiene o imposta un valore che indica se l'icona è con mirroring quando l' FlowDirection è RightToLeft.

MirroredWhenRightToLeftProperty

Identifica il MirroredWhenRightToLeft proprietà di dipendenza.

Name

Ottiene o imposta il nome di identificazione dell'oggetto. Quando un processore XAML crea l'albero degli oggetti dal markup XAML, il codice di runtime può fare riferimento all'oggetto dichiarato da XAML con questo nome.

(Ereditato da FrameworkElement)
Opacity

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

(Ereditato da UIElement)
OpacityTransition

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

(Ereditato da UIElement)
Parent

Ottiene l'oggetto padre di questo FrameworkElement nell'albero degli oggetti.

(Ereditato da FrameworkElement)
PointerCaptures

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

(Ereditato da UIElement)
Projection

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

(Ereditato da UIElement)
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.

(Ereditato da UIElement)
RasterizationScale

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

(Ereditato da UIElement)
RenderSize

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

(Ereditato da UIElement)
RenderTransform

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

(Ereditato da UIElement)
RenderTransformOrigin

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

(Ereditato da UIElement)
RequestedTheme

Ottiene o imposta il tema dell'interfaccia utente utilizzato dal UIElement (e i relativi elementi figlio) per la determinazione delle risorse. Il tema dell'interfaccia utente specificato con RequestedTheme può eseguire l'override dell'a livello di app RequestedTheme.

(Ereditato da FrameworkElement)
Resources

Ottiene il dizionario risorse definito in locale. In XAML puoi stabilire gli elementi delle risorse come elementi oggetto figlio di un elemento proprietà frameworkElement.Resources tramite la sintassi della raccolta implicita XAML.

(Ereditato da FrameworkElement)
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.

(Ereditato da UIElement)
RotationAxis

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

(Ereditato da UIElement)
RotationTransition

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

(Ereditato da UIElement)
Scale

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

(Ereditato da UIElement)
ScaleTransition

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

(Ereditato da UIElement)
Shadow

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

(Ereditato da UIElement)
Source

Ottiene o imposta l'oggetto visivo animato visualizzato dall'oggetto AnimatedIcon.

SourceProperty

Identifica la proprietà di dipendenza origine .

StateProperty

Identifica la proprietà associata AnimatedIcon.State XAML.

Style

Ottiene o imposta un'istanza Style applicata per questo oggetto durante il layout e il rendering.

(Ereditato da FrameworkElement)
TabFocusNavigation

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

(Ereditato da UIElement)
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 .

(Ereditato da UIElement)
Tag

Ottiene o imposta un valore arbitrario dell'oggetto che può essere utilizzato per archiviare informazioni personalizzate su questo oggetto.

(Ereditato da FrameworkElement)
Transform3D

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

(Ereditato da UIElement)
TransformMatrix

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

(Ereditato da UIElement)
Transitions

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

(Ereditato da UIElement)
Translation

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

(Ereditato da UIElement)
TranslationTransition

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

(Ereditato da UIElement)
Triggers

Ottiene la raccolta di trigger per le animazioni definite per un FrameworkElement. Non comunemente usato. Vedere la sezione Osservazioni.

(Ereditato da FrameworkElement)
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.

(Ereditato da UIElement)
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.

(Ereditato da UIElement)
VerticalAlignment

Ottiene o imposta le caratteristiche di allineamento verticale applicate a un FrameworkElement quando è composto in un oggetto padre, ad esempio un pannello o un controllo elementi.

(Ereditato da FrameworkElement)
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.

(Ereditato da UIElement)
Width

Ottiene o imposta la larghezza di un FrameworkElement.

(Ereditato da FrameworkElement)
XamlRoot

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

(Ereditato da UIElement)
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.

(Ereditato da UIElement)
XYFocusDownNavigationStrategy

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

(Ereditato da UIElement)
XYFocusKeyboardNavigation

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

(Ereditato da UIElement)
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.

(Ereditato da UIElement)
XYFocusLeftNavigationStrategy

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

(Ereditato da UIElement)
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.

(Ereditato da UIElement)
XYFocusRightNavigationStrategy

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

(Ereditato da UIElement)
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.

(Ereditato da UIElement)
XYFocusUpNavigationStrategy

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

(Ereditato da UIElement)

Proprietà associate

State

Proprietà impostata dallo sviluppatore in AnimatedIcon.

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.

(Ereditato da UIElement)
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.

(Ereditato da UIElement)
ArrangeOverride(Size)

Fornisce il comportamento per il passaggio "Disponi" del layout. Le classi possono eseguire l'override di questo metodo per definire il proprio comportamento di passaggio "Arrange".

(Ereditato da FrameworkElement)
CancelDirectManipulations()

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

(Ereditato da UIElement)
CapturePointer(Pointer)

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

(Ereditato da UIElement)
ClearValue(DependencyProperty)

Cancella il valore locale di una proprietà di dipendenza.

(Ereditato da DependencyObject)
FindName(String)

Recupera un oggetto con il nome dell'identificatore specificato.

(Ereditato da FrameworkElement)
FindSubElementsForTouchTargeting(Point, Rect)

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

(Ereditato da UIElement)
Focus(FocusState)

Tenta di impostare lo stato attivo su questo elemento.

(Ereditato da UIElement)
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)
GetBindingExpression(DependencyProperty)

Restituisce il binding BindingExpression che rappresenta l'associazione nella proprietà specificata.

(Ereditato da FrameworkElement)
GetChildrenInTabFocusOrder()

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

(Ereditato da UIElement)
GetState(DependencyObject)

Recupera il valore della proprietà associata AnimatedIcon.State per il DependencyObject specificato.

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.

(Ereditato da UIElement)
GoToElementStateCore(String, Boolean)

Se implementato in una classe derivata, abilita la costruzione per stato di una struttura ad albero visuale per un modello di controllo nel codice, anziché caricando XAML per tutti gli stati all'avvio del controllo.

(Ereditato da FrameworkElement)
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.

(Ereditato da UIElement)
InvalidateMeasure()

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

(Ereditato da UIElement)
InvalidateViewport()

Invalida lo stato del riquadro di visualizzazione per un UIElement utilizzato per calcolare il viewport effettivo .

(Ereditato da FrameworkElement)
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.

(Ereditato da UIElement)
MeasureOverride(Size)

Fornisce il comportamento per il passaggio "Misura" del ciclo di layout. Le classi possono eseguire l'override di questo metodo per definire il proprio comportamento di passaggio "Measure".

(Ereditato da FrameworkElement)
OnApplyTemplate()

Richiamato ogni volta che il codice dell'applicazione o i processi interni (ad esempio un passaggio di layout di ricompilazione) chiamano ApplyTemplate. In termini più semplici, questo significa che il metodo viene chiamato poco prima che venga visualizzato un elemento dell'interfaccia utente nell'app. Eseguire l'override di questo metodo per influenzare la logica post-modello predefinita di una classe.

(Ereditato da FrameworkElement)
OnBringIntoViewRequested(BringIntoViewRequestedEventArgs)

Chiamato prima che si verifichi l'evento BringIntoViewRequested .

(Ereditato da UIElement)
OnCreateAutomationPeer()

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

(Ereditato da UIElement)
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.

(Ereditato da UIElement)
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.

(Ereditato da UIElement)
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.

(Ereditato da UIElement)
PopulatePropertyInfo(String, AnimationPropertyInfo)

Definisce una proprietà che può essere animata.

(Ereditato da UIElement)
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)

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

(Ereditato da UIElement)
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 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.

(Ereditato da UIElement)
ReleasePointerCaptures()

Rilascia tutte le acquisizioni del puntatore contenute in questo elemento.

(Ereditato da UIElement)
RemoveHandler(RoutedEvent, Object)

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

(Ereditato da UIElement)
SetBinding(DependencyProperty, BindingBase)

Associa un'associazione a un FrameworkElement, usando l'oggetto di associazione fornito.

(Ereditato da FrameworkElement)
SetState(DependencyObject, String)

Specifica il valore della proprietà associata AnimatedIcon.State per il DependencyObject specificato.

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 .

(Ereditato da UIElement)
StartBringIntoView()

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

(Ereditato da UIElement)
StartBringIntoView(BringIntoViewOptions)

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

(Ereditato da UIElement)
StartDragAsync(ExpPointerPoint)

Rappresenta un'icona che visualizza e controlla un oggetto visivo che può essere animato in risposta alle modifiche dello stato dell'utente e dell'interazione dell'utente.

(Ereditato da UIElement)
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.

(Ereditato da UIElement)
StopAnimation(ICompositionAnimationBase)

Arresta l'animazione specificata sull'elemento .

(Ereditato da UIElement)
TransformToVisual(UIElement)

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

(Ereditato da UIElement)
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.

(Ereditato da UIElement)
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.

(Ereditato da UIElement)

Eventi

AccessKeyDisplayDismissed

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

(Ereditato da UIElement)
AccessKeyDisplayRequested

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

(Ereditato da UIElement)
AccessKeyInvoked

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

(Ereditato da UIElement)
ActualThemeChanged

Si verifica quando il valore della proprietà ActualTheme è stato modificato.

(Ereditato da FrameworkElement)
BringIntoViewRequested

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

(Ereditato da UIElement)
CharacterReceived

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

(Ereditato da UIElement)
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.

(Ereditato da UIElement)
ContextRequested

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

(Ereditato da UIElement)
DataContextChanged

Si verifica quando cambia il valore della proprietà FrameworkElement.DataContext.

(Ereditato da FrameworkElement)
DoubleTapped

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

(Ereditato da UIElement)
DragEnter

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

(Ereditato da UIElement)
DragLeave

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

(Ereditato da UIElement)
DragOver

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

(Ereditato da UIElement)
DragStarting

Si verifica quando viene avviata un'operazione di trascinamento.

(Ereditato da UIElement)
Drop

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

(Ereditato da UIElement)
DropCompleted

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

(Ereditato da UIElement)
EffectiveViewportChanged

Si verifica quando cambia frameworkElement di .

(Ereditato da FrameworkElement)
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.

(Ereditato da UIElement)
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.

(Ereditato da UIElement)
Holding

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

(Ereditato da UIElement)
KeyDown

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

(Ereditato da UIElement)
KeyUp

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

(Ereditato da UIElement)
LayoutUpdated

Si verifica quando il layout della struttura ad albero visuale cambia, a causa della modifica del valore delle proprietà pertinenti al layout o di un'altra azione che aggiorna il layout.

(Ereditato da FrameworkElement)
Loaded

Si verifica quando un FrameworkElement è stato costruito e aggiunto all'albero degli oggetti ed è pronto per l'interazione.

(Ereditato da FrameworkElement)
Loading

Si verifica quando un FrameworkElement inizia a essere caricato.

(Ereditato da FrameworkElement)
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.

(Ereditato da UIElement)
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.

(Ereditato da UIElement)
ManipulationCompleted

Si verifica quando viene completata una manipolazione sul UIElement .

(Ereditato da UIElement)
ManipulationDelta

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

(Ereditato da UIElement)
ManipulationInertiaStarting

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

(Ereditato da UIElement)
ManipulationStarted

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

(Ereditato da UIElement)
ManipulationStarting

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

(Ereditato da UIElement)
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.

(Ereditato da UIElement)
PointerCanceled

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

(Ereditato da UIElement)
PointerCaptureLost

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

(Ereditato da UIElement)
PointerEntered

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

(Ereditato da UIElement)
PointerExited

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

(Ereditato da UIElement)
PointerMoved

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

(Ereditato da UIElement)
PointerPressed

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

(Ereditato da UIElement)
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.

(Ereditato da UIElement)
PointerWheelChanged

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

(Ereditato da UIElement)
PreviewKeyDown

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

(Ereditato da UIElement)
PreviewKeyUp

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

(Ereditato da UIElement)
ProcessKeyboardAccelerators

Si verifica quando viene premuto un tasti di scelta rapida .

(Ereditato da UIElement)
RightTapped

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

(Ereditato da UIElement)
SizeChanged

Si verifica quando il ActualHeight o la proprietà ActualWidth cambia valore in un FrameworkElement.

(Ereditato da FrameworkElement)
Tapped

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

(Ereditato da UIElement)
Unloaded

Si verifica quando questo oggetto non è più connesso all'albero di oggetti principale.

(Ereditato da FrameworkElement)

Si applica a

Vedi anche