FrameworkElement Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Fornisce una classe di elementi di base per Windows Runtime oggetti dell'interfaccia utente. FrameworkElement definisce l'API comune che supporta l'interazione dell'interfaccia utente e il sistema di layout automatico. FrameworkElement definisce anche l'API correlata al data binding, alla definizione e all'esame dell'albero degli oggetti e alla durata dell'oggetto di rilevamento.
public ref class FrameworkElement : UIElement/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class FrameworkElement : UIElement[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class FrameworkElement : UIElementPublic Class FrameworkElement
Inherits UIElement- Ereditarietà
- Derivato
- Attributi
Requisiti Windows
| Famiglia di dispositivi |
Windows 10 (è stato introdotto in 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)
|
Commenti
FrameworkElement è un elemento di base: è una classe che molte altre classi Windows Runtime ereditano da per supportare il modello di elemento dell'interfaccia utente XAML. Le proprietà, i metodi e gli eventi definiti da FrameworkElement vengono ereditati da centinaia di altre classi Windows Runtime.
Molte classi comuni dell'interfaccia utente XAML derivano da FrameworkElement, direttamente o tramite classi di base intermedie, ad esempio Panel o Control. In genere, non si derivano classi direttamente da FrameworkElement, perché alcuni servizi previsti per una classe destinata a una rappresentazione dell'interfaccia utente (ad esempio il supporto del modello) non sono completamente implementati in tale posizione. Le classi di base usate più comunemente per le classi personalizzate derivate sono:
- Controlli specifici che non sono sealed (ad esempio , TextBox).
- Classi di base del controllo (Control, ContentControl, UserControl).
- Elementi di spostamento (Page, Frame).
- Classi panel ( pannello della classe base o implementazioni non sealed specifiche, ad esempio Grid).
Frameworkelement API e funzionalità
FrameworkElement estende UIElement, che è un altro elemento di base, e aggiunge il supporto per varie aree di funzionalità Windows Runtime.
Layout
Il sistema di layout riconosce tutti gli oggetti che derivano da FrameworkElement come elementi che potenzialmente partecipano al layout e devono avere un'area di visualizzazione nell'interfaccia utente dell'app. Il sistema di layout legge varie proprietà definite a livello di FrameworkElement, ad esempio MinWidth. La maggior parte degli elementi dell'interfaccia utente usa La larghezza e l'altezza definite da FrameworkElement per le informazioni di base sul ridimensionamento. FrameworkElement fornisce metodi estendibili per un comportamento di layout specializzato che i pannelli e i controlli con contenuto possono eseguire l'override nelle implementazioni della classe. Per altre info, vedi Definire i layout con XAML.
API prominente di FrameworkElement che supporta il layout: Height, Width, ActualHeight, ActualWidth, Margin, MeasureOverride, ArrangeOverride, HorizontalAlignment, VerticalAlignment, LayoutUpdated.
Eventi di durata degli oggetti
Spesso si vuole sapere quando un oggetto viene caricato per la prima volta (caricato viene definito come quando un oggetto viene collegato a una struttura ad albero di oggetti che si connette all'oggetto visivo radice). FrameworkElement definisce gli eventi correlati alla durata degli oggetti che forniscono hook utili per le operazioni code-behind. Ad esempio, sono necessarie informazioni sulla durata degli oggetti per aggiungere oggetti figlio a una raccolta o impostare proprietà sugli oggetti figlio appena prima dell'uso, con la garanzia che gli oggetti necessari nell'albero degli oggetti siano già state create istanze dal markup XAML. Per altre informazioni, vedi Panoramica degli eventi e degli eventi indirizzati.
API prominente di FrameworkElement che supporta gli eventi di durata degli oggetti: Loaded, SizeChanged, Unloaded, OnApplyTemplate.
Associazione dati
La possibilità di impostare un valore per un contesto dati potenzialmente ereditato per un data binding viene implementata da FrameworkElement. FrameworkElement include anche l'API per stabilire il data binding nel codice anziché in XAML. Per altre info, vedi Informazioni approfondite sul data binding.
API prominente di FrameworkElement che supportano il data binding: DataContext, DataContextChanged, SetBinding, GetBindingExpression.
Integrazione del linguaggio XAML e del modello di programmazione
In genere la struttura degli elementi dell'app è simile al markup XAML definito per creare l'interfaccia utente, ma a volte la struttura cambia dopo l'analisi di XAML. FrameworkElement definisce la proprietà Name e l'API correlata, utili per la ricerca di elementi e relazioni tra elementi in fase di esecuzione. Per altre info, vedi Ambiti dei nomi XAML.
API prominente di FrameworkElement che supportano xaml e modello di programmazione: Name, FindName, Parent, BaseUri, OnApplyTemplate.
Globalizzazione
La classe FrameworkElement definisce la proprietà Language e la proprietà FlowDirection . Per altre info, vedi Globalizzazione dell'app.
Supporto di stili e temi
La classe FrameworkElement definisce la proprietà Style e la proprietà RequestedTheme . Inoltre, la proprietà Resources viene usata per definire i dizionari di risorse XAML a livello di pagina che in genere definiscono stili e modelli, nonché altre risorse condivise. Per altre info, vedi Applicazione di stili ai controllie riferimenti alle risorse ResourceDictionary e XAML.
Proprietà di dipendenza di FrameworkElement
Molte delle proprietà di lettura/scrittura della classe elemento di base FrameworkElement sono proprietà di dipendenza. Le proprietà di dipendenza supportano alcune funzionalità del modello di programmazione di base per un'app UWP usando C++, C# o Visual Basic, ad esempio stili e modelli, data binding, riferimenti alle risorse XAML e logica modificata dalle proprietà. Per altre info sulle proprietà di dipendenza e sulle funzionalità supportate, vedi Panoramica delle proprietà di dipendenza.
Classi derivate di FrameworkElement
FrameworkElement è la classe padre per diverse classi derivate immediatamente che distinguono diverse classificazioni generali degli elementi dell'interfaccia utente. Ecco alcune delle classi derivate rilevanti:
- Controllo: il controllo include molte classi di controllo derivate, fondamentalmente tutti i controlli XAML usati per un'interfaccia utente di Windows Runtime sono derivati da Control.
- Relatori: un relatore è una classe che conferisce un aspetto visivo, in genere contribuendo ad alcuni scenari di controllo, ma il relatore stesso non è in genere interattivo. Ad esempio: Border, ContentPresenter (padre di ScrollContentPresenter e altri), ItemsPresenter, Viewbox.
- Elementi multimediali e Web: Image, WebView, MediaElement, CaptureElement. Questi contenuti vengono visualizzati e hanno un certo livello di interattività che avviene all'interno del contenuto, ma non sono effettivamente controlli.
- Elementi di visualizzazione del testo: TextBlock, RichTextBlock, RichTextBlockOverflow, Glyphs. Gli elementi di testo come Run e Hyperlink, che spesso dichiarano il contenuto di un elemento di visualizzazione del testo, non sono derivati da FrameworkElement.
- La classe base Panel : Panel è la classe padre per i pannelli comuni, ad esempio Grid, StackPanel e così via.
- La classe di base Shape : Shape è la classe padre per Path, Rectangle e così via.
- Classe di base IconElement : classe padre per FontIcon, SymbolIcon e così via.
- Vari elementi dell'interfaccia utente: Popup, TickBar, Viewbox.
Cronologia delle versioni
| Versione di Windows | Versione dell'SDK | Valore aggiunto |
|---|---|---|
| 1607 | 14393 | AllowFocusOnInteraction |
| 1607 | 14393 | AllowFocusWhenDisabled |
| 1607 | 14393 | FocusVisualMargin |
| 1607 | 14393 | FocusVisualPrimaryBrush |
| 1607 | 14393 | FocusVisualPrimaryThickness |
| 1607 | 14393 | FocusVisualSecondaryBrush |
| 1607 | 14393 | FocusVisualSecondaryThickness |
| 1703 | 15063 | DeferTree |
| 1709 | 16299 | ActualTheme |
| 1709 | 16299 | ActualThemeChanged |
| 1809 | 17763 | EffectiveViewportChanged |
| 1809 | 17763 | InvalidateViewport |
| 1809 | 17763 | IsLoaded |
Costruttori
| FrameworkElement() |
Fornisce il comportamento di inizializzazione della classe di base per le classi derivate da FrameworkElement. |
Proprietà
| AccessKey |
Ottiene o imposta la chiave di scelta (mnemonica) 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 di rendering di un FrameworkElement. Vedere la sezione Osservazioni. |
| ActualHeightProperty |
Identifica la proprietà di dipendenza ActualHeight . Vedere la sezione Osservazioni. |
| 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 usato dall'elemento, che potrebbe essere diverso da RequestedTheme. |
| ActualThemeProperty |
Identifica la proprietà di dipendenza ActualTheme. |
| ActualWidth |
Ottiene la larghezza di rendering di un FrameworkElement. Vedere la sezione Osservazioni. |
| ActualWidthProperty |
Identifica la proprietà di dipendenza ActualWidth . Vedere la sezione Osservazioni. |
| AllowDrop |
Ottiene o imposta un valore che determina se questo 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. |
| AllowFocusOnInteractionProperty |
Identifica per la proprietà di dipendenza AllowFocusOnInteraction . |
| AllowFocusWhenDisabled |
Ottiene o imposta se un controllo disabilitato può ricevere lo stato attivo. |
| AllowFocusWhenDisabledProperty |
Identifica la proprietà di dipendenza AllowFocusWhenDisabled . |
| BaseUri |
Ottiene un URI (Uniform Resource Identifier) che rappresenta l'URI (Uniform Resource Identifier) di base per un oggetto costruito XAML in fase di caricamento XAML. Questa proprietà è utile per la risoluzione URI (Uniform Resource Identifier) in fase di esecuzione. |
| 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 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 l'oggetto RectangleGeometry utilizzato per definire la struttura del contenuto di un oggetto 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 dei dati per un FrameworkElement. Un uso comune di un contesto di dati è quando un FrameworkElement usa l'estensione di markup {Binding} e partecipa al data binding. |
| DataContextProperty |
Identifica la proprietà di dipendenza DataContext . |
| DesiredSize |
Ottiene le dimensioni calcolate da uiElement durante il passaggio della misura del processo di layout. (Ereditato da UIElement) |
| Dispatcher |
Ottiene CoreDispatcher associato a questo oggetto. CoreDispatcher rappresenta una struttura che può accedere a DependencyObject nel thread dell'interfaccia utente anche se il codice viene avviato da un thread non interfaccia utente. (Ereditato da DependencyObject) |
| ExitDisplayModeOnAccessKeyInvoked |
Ottiene o imposta un valore che specifica se la visualizzazione del tasto di scelta viene chiusa quando viene richiamata una chiave di scelta. (Ereditato da UIElement) |
| 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 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 a destra a sinistra e il layout del controllo da destra a sinistra. |
| FlowDirectionProperty |
Identifica la proprietà di dipendenza FlowDirection . |
| FocusVisualMargin |
Ottiene o imposta il margine esterno dell'oggetto visivo dello stato attivo per un FrameworkElement. |
| FocusVisualMarginProperty |
Identifica la proprietà di dipendenza FocusVisualMargin . |
| FocusVisualPrimaryBrush |
Ottiene o imposta il pennello usato per disegnare il bordo esterno di un oggetto visivo o |
| FocusVisualPrimaryBrushProperty |
Identifica la proprietà di dipendenza FocusVisualPrimaryBrush . |
| FocusVisualPrimaryThickness |
Ottiene o imposta lo spessore del bordo esterno di un oggetto visivo o |
| FocusVisualPrimaryThicknessProperty |
Identifica la proprietà di dipendenza FocusVisualPrimaryThickness . |
| FocusVisualSecondaryBrush |
Ottiene o imposta il pennello usato per disegnare il bordo interno di un oggetto visivo o |
| FocusVisualSecondaryBrushProperty |
Identifica la proprietà di dipendenza FocusVisualSecondaryBrush . |
| FocusVisualSecondaryThickness |
Ottiene o imposta lo spessore del bordo interno di un oggetto visivo o |
| FocusVisualSecondaryThicknessProperty |
Identifica la proprietà di dipendenza FocusVisualSecondaryThickness . |
| Height |
Ottiene o imposta l'altezza suggerita di un FrameworkElement. |
| HeightProperty |
Identifica la proprietà di dipendenza Height . |
| 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. |
| HorizontalAlignmentProperty |
Identifica la proprietà di dipendenza HorizontalAlignment . |
| 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ò avere origine 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ò avere origine 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. |
| IsRightTapEnabled |
Ottiene o imposta un valore che determina se l'evento RightTapped può avere origine da tale elemento. (Ereditato da UIElement) |
| IsTapEnabled |
Ottiene o imposta un valore che determina se l'evento Tapped può avere origine da tale elemento. (Ereditato da UIElement) |
| KeyboardAcceleratorPlacementMode |
Ottiene o imposta un valore che indica se la descrizione comando del controllo visualizza la combinazione di tasti per il tasto di scelta rapida associato. (Ereditato da UIElement) |
| KeyboardAcceleratorPlacementTarget |
Ottiene o imposta un valore che indica la descrizione comando del controllo che visualizza la combinazione di tasti di scelta rapida. (Ereditato da UIElement) |
| KeyboardAccelerators |
Ottiene la raccolta di combinazioni di tasti che richiamano un'azione utilizzando la tastiera. Gli acceleratori vengono in genere assegnati a pulsanti o voci di menu.
|
| KeyTipHorizontalOffset |
Ottiene o imposta un valore che indica l'estrema sinistra o destra in cui viene posizionato il suggerimento per i tasti rispetto a UIElement. (Ereditato da UIElement) |
| KeyTipPlacementMode |
Ottiene o imposta un valore che indica dove viene inserito il tasto di scelta Suggerimento chiave in relazione al limite dell'oggetto UIElement. (Ereditato da UIElement) |
| KeyTipTarget |
Ottiene o imposta un valore che indica l'elemento di destinazione del suggerimento per il tasto di scelta. (Ereditato da UIElement) |
| KeyTipVerticalOffset |
Ottiene o imposta un valore che indica la distanza verso l'alto o il basso del suggerimento per i tasti rispetto all'elemento dell'interfaccia utente. (Ereditato da UIElement) |
| Language |
Ottiene o imposta informazioni sul linguaggio di localizzazione/globalizzazione applicabili a un FrameworkElement e anche a tutti gli elementi figlio di FrameworkElement corrente nella rappresentazione dell'oggetto e nell'interfaccia utente. |
| LanguageProperty |
Identifica la proprietà di dipendenza Language . |
| Lights |
Ottiene la raccolta di oggetti XamlLight associati a questo elemento. (Ereditato da UIElement) |
| ManipulationMode |
Ottiene o imposta il valore ManipulationModes utilizzato per il 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. |
| MarginProperty |
Identifica la proprietà di dipendenza Margin . |
| MaxHeight |
Ottiene o imposta il vincolo di altezza massima di un oggetto FrameworkElement. |
| MaxHeightProperty |
Identifica la proprietà di dipendenza MaxHeight . |
| MaxWidth |
Ottiene o imposta il vincolo di larghezza massima di un oggetto FrameworkElement. |
| MaxWidthProperty |
Identifica la proprietà di dipendenza MaxWidth . |
| MinHeight |
Ottiene o imposta il vincolo di altezza minima di un frameworkElement. |
| MinHeightProperty |
Identifica la proprietà di dipendenza MinHeight . |
| MinWidth |
Ottiene o imposta il vincolo di larghezza minima di un frameworkElement. |
| MinWidthProperty |
Identifica la proprietà di dipendenza MinWidth . |
| 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. |
| NameProperty |
Identifica la proprietà di dipendenza Name . |
| Opacity |
Ottiene o imposta il grado di opacità dell'oggetto. (Ereditato da UIElement) |
| OpacityTransition |
Ottiene o imposta scalarTransition che anima le modifiche apportate alla proprietà Opacity. (Ereditato da UIElement) |
| Parent |
Ottiene l'oggetto padre di questo FrameworkElement nell'albero degli oggetti. |
| PointerCaptures |
Ottiene il set di tutti i puntatori acquisiti, rappresentati come valori puntatore . (Ereditato da UIElement) |
| Projection |
Ottiene o imposta la proiezione prospettica (effetto 3D) da applicare durante il rendering di questo elemento. (Ereditato da UIElement) |
| RenderSize |
Ottiene la dimensione di rendering finale di un oggetto UIElement. L'utilizzo non è consigliato, vedere La sezione Osservazioni. (Ereditato da UIElement) |
| RenderTransform |
Ottiene o imposta le informazioni di trasformazione che influiscono sulla posizione di rendering di un oggetto UIElement. (Ereditato da UIElement) |
| RenderTransformOrigin |
Ottiene o imposta il punto di origine di qualsiasi possibile trasformazione di rendering dichiarata da RenderTransform, rispetto ai limiti dell'oggetto UIElement. (Ereditato da UIElement) |
| RequestedTheme |
Ottiene o imposta il tema dell'interfaccia utente utilizzato da UIElement (e i relativi elementi figlio) per la determinazione delle risorse. Il tema dell'interfaccia utente specificato con RequestedTheme può eseguire l'override di RequestedTheme a livello di app. |
| RequestedThemeProperty |
Identifica la proprietà di dipendenza RequestedTheme . |
| Resources |
Ottiene il dizionario risorse definito localmente. In XAML puoi stabilire elementi di risorsa come elementi oggetto figlio di un |
| 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 in cui ruotare l'elemento. (Ereditato da UIElement) |
| RotationTransition |
Ottiene o imposta 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) |
| Style |
Ottiene o imposta uno stile di istanza applicato per questo oggetto durante il layout e il rendering. |
| StyleProperty |
Identifica la proprietà di dipendenza Style . |
| TabFocusNavigation |
Ottiene o imposta un valore che modifica il funzionamento di tabbing e TabIndex per questo controllo. (Ereditato da UIElement) |
| Tag |
Ottiene o imposta un valore arbitrario dell'oggetto che può essere utilizzato per archiviare informazioni personalizzate su questo oggetto. |
| TagProperty |
Identifica la proprietà di dipendenza Tag . |
| 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 dello stile Di transizione che si applicano a un oggetto 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. |
| UIContext |
Ottiene l'identificatore di contesto per l'elemento . (Ereditato da UIElement) |
| 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 interi pixel. (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. |
| VerticalAlignmentProperty |
Identifica la proprietà di dipendenza VerticalAlignment . |
| Visibility |
Ottiene o imposta la visibilità di un oggetto UIElement. Il rendering di un oggetto UIElement non visibile non viene eseguito e non comunica le dimensioni desiderate al layout. (Ereditato da UIElement) |
| Width |
Ottiene o imposta la larghezza di un oggetto FrameworkElement. |
| WidthProperty |
Identifica la proprietà di dipendenza Width . |
| XamlRoot |
Ottiene o imposta l'oggetto |
| XYFocusDownNavigationStrategy |
Ottiene o imposta un valore che specifica la strategia utilizzata per determinare l'elemento di destinazione di uno spostamento verso il basso. (Ereditato da UIElement) |
| XYFocusKeyboardNavigation |
Ottiene o imposta un valore che abilita o disabilita lo spostamento usando le frecce direzionali della tastiera. (Ereditato da UIElement) |
| XYFocusLeftNavigationStrategy |
Ottiene o imposta un valore che specifica la strategia utilizzata per determinare l'elemento di destinazione di uno spostamento a sinistra. (Ereditato da UIElement) |
| XYFocusRightNavigationStrategy |
Ottiene o imposta un valore che specifica la strategia utilizzata per determinare l'elemento di destinazione di uno spostamento a destra. (Ereditato da UIElement) |
| XYFocusUpNavigationStrategy |
Ottiene o imposta un valore che specifica la strategia utilizzata per determinare l'elemento di destinazione di uno spostamento verso l'alto. (Ereditato da UIElement) |
Metodi
| AddHandler(RoutedEvent, Object, Boolean) |
Aggiunge un gestore eventi indirizzati per un evento indirizzato specifico, aggiungendo il gestore alla raccolta di gestori nell'elemento corrente. Specificare handledEventsToo come true per fare in modo che il gestore fornito venga richiamato anche se l'evento viene gestito altrove. (Ereditato da UIElement) |
| Arrange(Rect) |
Posiziona gli oggetti figlio e determina una dimensione per un OGGETTO UIElement. Gli oggetti padre che implementano il layout personalizzato per gli elementi figlio devono chiamare questo metodo dalle implementazioni di override del layout per formare un aggiornamento del layout ricorsivo. (Ereditato da UIElement) |
| ArrangeOverride(Size) |
Fornisce il comportamento per il passaggio di layout "Arrange". Le classi possono eseguire l'override di questo metodo per definire il proprio comportamento di passaggio "Arrange". |
| CancelDirectManipulations() |
Annulla l'elaborazione continua della manipolazione diretta (panoramica/zoom definita dal sistema) su qualsiasi elemento padre scrollViewer che contiene l'oggetto UIElement corrente. (Ereditato da UIElement) |
| CapturePointer(Pointer) |
Imposta l'acquisizione del puntatore su un oggetto UIElement. Dopo l'acquisizione, solo l'elemento con acquisizione genera eventi correlati al puntatore. (Ereditato da UIElement) |
| ClearValue(DependencyProperty) |
Cancella il valore locale di una proprietà di dipendenza. (Ereditato da DependencyObject) |
| DeferTree(DependencyObject) |
Rimuove l'elemento specificato dall'albero visivo XAML in modo da poterlo annullare in un secondo momento. |
| FindName(String) |
Recupera un oggetto con il nome dell'identificatore specificato. |
| FindSubElementsForTouchTargeting(Point, Rect) |
Consente a una sottoclasse UIElement di esporre gli elementi figlio che consentono di risolvere la destinazione tocco. (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 bindingExpression che rappresenta l'associazione nella proprietà specificata. |
| GetChildrenInTabFocusOrder() |
Consente a una sottoclasse UIElement di esporre gli elementi figlio che prendono parte allo stato attivo tabulazione. (Ereditato da UIElement) |
| GetValue(DependencyProperty) |
Restituisce il valore effettivo corrente di una proprietà di dipendenza da un oggetto DependencyObject. (Ereditato da DependencyObject) |
| 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. |
| InvalidateArrange() |
Invalida lo stato di disposizione (layout) per un UIElement. Dopo l'invalidazione, uiElement avrà aggiornato il layout, che si verificherà in modo asincrono. (Ereditato da UIElement) |
| InvalidateMeasure() |
Invalida lo stato di misurazione (layout) per un OGGETTO UIElement. (Ereditato da UIElement) |
| InvalidateViewport() |
Invalida lo stato del riquadro di visualizzazione per un UIElement utilizzato per calcolare il viewport effettivo. |
| Measure(Size) |
Aggiornamenti desiredSize di un oggetto UIElement. In genere, gli oggetti che implementano il layout personalizzato per i relativi elementi figlio di layout chiamano questo metodo dalle proprie implementazioni di MeasureOverride per formare un aggiornamento del layout ricorsivo. (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". |
| OnApplyTemplate() |
Richiamato ogni volta che il codice dell'applicazione o i processi interni ,ad esempio un passaggio di layout di ricompilazione, chiama ApplyTemplate. In termini più semplici, questo significa che il metodo viene chiamato subito prima che venga visualizzato un elemento dell'interfaccia utente nella tua app. Eseguire l'override di questo metodo per influenzare la logica post-modello predefinita di una classe. |
| OnBringIntoViewRequested(BringIntoViewRequestedEventArgs) |
Chiamato prima che si verifichi l'evento BringIntoViewRequested . (Ereditato da UIElement) |
| OnCreateAutomationPeer() |
Se implementato in una classe derivata, restituisce implementazioni AutomationPeer specifiche della classe per l'infrastruttura di Microsoft Automazione interfaccia utente. (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 tasto di scelta rapida (o un tasto di scelta rapida) viene elaborato nell'app. Eseguire l'override di questo metodo per gestire la risposta dell'app quando viene richiamato un tasto di scelta rapida. (Ereditato da UIElement) |
| OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs) |
Chiamato subito prima dell'elaborazione di un tasto di scelta rapida (o dell'acceleratore) 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) |
In caso di 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 viene impostato un valore locale. (Ereditato da DependencyObject) |
| RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Registra una funzione di notifica per l'ascolto delle modifiche a un'istanza di DependencyObject specifica. (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 mantenute da 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) |
Collega un'associazione a un FrameworkElement usando l'oggetto binding fornito. |
| SetValue(DependencyProperty, Object) |
Imposta il valore locale di una proprietà di dipendenza in un oggetto 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 tutte le aree scorrevoli in cui è contenuto. (Ereditato da UIElement) |
| StartBringIntoView(BringIntoViewOptions) |
Avvia una richiesta al framework XAML per visualizzare l'elemento usando le opzioni specificate. (Ereditato da UIElement) |
| StartDragAsync(PointerPoint) |
Inizia un’operazione di trascinamento della selezione. (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 da UIElement all'oggetto specificato. (Ereditato da UIElement) |
| TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs) |
Tenta di richiamare una scelta rapida da tastiera (o un tasto di scelta rapida) eseguendo una ricerca nell'intera struttura ad albero visuale di UIElement per individuare 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. |
| 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 il valore della proprietà FrameworkElement.DataContext cambia. |
| DoubleTapped |
Si verifica quando si verifica un'interazione DoubleTap non gestita sull'area 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 per il quale l'elemento rappresenta la destinazione del rilascio potenziale. (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 del 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 il viewport efficace di FrameworkElement cambia. |
| 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 è bubbling. (Ereditato da UIElement) |
| GotFocus |
Si verifica quando un oggetto 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 di blocco non gestita sull'area hit test di questo elemento. (Ereditato da UIElement) |
| KeyDown |
Si verifica quando viene premuto un tasto di tastiera mentre UIElement ha lo stato attivo. (Ereditato da UIElement) |
| KeyUp |
Si verifica quando viene rilasciato un tasto di tastiera mentre 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. |
| Loaded |
Si verifica quando un FrameworkElement è stato costruito e aggiunto all'albero degli oggetti ed è pronto per l'interazione. |
| Loading |
Si verifica quando un FrameworkElement inizia a essere caricato. |
| LosingFocus |
Si verifica prima che un UIElement perda lo stato attivo. Questo evento viene generato in modo sincrono per assicurarsi che lo stato attivo non venga spostato mentre l'evento è 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 al completamento di una manipolazione dell'oggetto UIElement . (Ereditato da UIElement) |
| ManipulationDelta |
Si verifica quando il dispositivo di input cambia posizione durante una manipolazione. (Ereditato da UIElement) |
| ManipulationInertiaStarting |
Si verifica quanto il dispositivo di input perde il contatto con l'oggetto UIElement durante una manipolazione e ha inizio l'inerzia. (Ereditato da UIElement) |
| ManipulationStarted |
Si verifica quando un dispositivo di input inizia una manipolazione sull'oggetto UIElement. (Ereditato da UIElement) |
| ManipulationStarting |
Si verifica quando il processore di manipolazione viene creato per la prima volta. (Ereditato da UIElement) |
| NoFocusCandidateFound |
Si verifica quando un utente tenta di spostare lo stato attivo (tramite tabulazione o frecce direzionali), 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 anormalemente 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 di 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 di hit test di questo elemento. (Ereditato da UIElement) |
| PointerPressed |
Si verifica quando il dispositivo puntatore avvia un'azione Press all'interno di questo elemento. (Ereditato da UIElement) |
| PointerReleased |
Si verifica quando il dispositivo puntatore che ha avviato in precedenza un'azione Press viene rilasciato, mentre all'interno di questo elemento. Si noti che la fine di un'azione Press non è garantita l'attivazione di un evento PointerReleased; altri eventi possono essere attivati invece. 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 di tastiera mentre UIElement ha lo stato attivo. (Ereditato da UIElement) |
| PreviewKeyUp |
Si verifica quando viene rilasciato un tasto di tastiera mentre UIElement ha lo stato attivo. (Ereditato da UIElement) |
| ProcessKeyboardAccelerators |
Si verifica quando viene premuto un tasto di scelta rapida (o un tasto di scelta rapida ). (Ereditato da UIElement) |
| RightTapped |
Si verifica quando si verifica uno stimolo di input di tocco destro mentre il puntatore si trova sull'elemento. (Ereditato da UIElement) |
| SizeChanged |
Si verifica quando la proprietà ActualHeight o ActualWidth modifica il valore in un 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 degli oggetti principale. |