Canvas 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.
Definisce un'area all'interno della quale è possibile posizionare in modo esplicito gli oggetti figlio, usando coordinate relative all'area Canvas.
/// [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 Canvas : Panel[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 Canvas : PanelPublic Class Canvas
Inherits Panel<Canvas ...>
oneOrMoreUIElements
</Canvas>
-or-
<Canvas .../>
- Ereditarietà
- Derivato
- Attributi
Esempio
Suggerimento
Per altre info, linee guida per la progettazione ed esempi di codice, vedi Pannelli di layout.
L'app Raccolta WinUI 3 include esempi interattivi della maggior parte dei controlli, delle funzionalità e delle funzionalità winUI 3. Ottenere l'app da Microsoft Store o ottenere il codice sorgente in GitHub.
In questo esempio viene illustrato come posizionare un rettangolo di 30 pixel da sinistra e 30 pixel dalla parte superiore di un oggetto Canvas.
<Canvas Width="640" Height="480" >
<Rectangle Canvas.Left="30" Canvas.Top="30"
Fill="Red" Width="200" Height="200" />
</Canvas>
Commenti
Canvas è un pannello di layout che supporta il posizionamento assoluto degli elementi figlio rispetto all'angolo superiore sinistro dell'area di disegno.
Canvas è uno degli elementi Panel che abilitano il layout. Canvas usa il posizionamento assoluto come tecnica di layout per i relativi elementi figlio contenuti. Viene eseguito il rendering di ogni elemento figlio all'interno dell'area Canvas. È possibile controllare il posizionamento degli elementi all'interno dell'oggetto Canvas specificando le coordinate x e y. Queste coordinate sono in pixel. Le coordinate x e y vengono spesso specificate usando le proprietà associate Canvas.Left e Canvas.Top . Canvas.Left specifica la distanza dell'oggetto dal lato sinistro dell'oggetto Canvas contenitore (coordinata x) e Canvas.Top specifica la distanza dell'oggetto dalla parte superiore dell'oggetto Canvas contenitore (coordinata y).
Nota
Poiché il posizionamento assoluto non tiene conto delle dimensioni della finestra dell'app, del ridimensionamento o di un altro ridimensionamento selezionato dall'utente, usando un elemento contenitore che si adatta a diversi orientamenti e impostazioni dello schermo, ad esempio Grid o StackPanel, è spesso una scelta migliore rispetto all'uso di Canvas. Per altre informazioni, vedere Definire i layout con XAML.
È possibile annidare oggetti Canvas. Quando si annidano oggetti, le coordinate utilizzate da ogni oggetto sono relative al relativo oggetto Canvas che lo contiene immediatamente.
Ogni oggetto figlio di un oggetto Canvas deve essere un OGGETTO UIElement. In XAML dichiari oggetti figlio come contenuto di un elemento oggetto Canvas. Nel codice è possibile modificare la raccolta di oggetti figlio Canvas ottenendo la raccolta a cui si accede dalla proprietà Children .
In molti casi, un oggetto Canvas viene usato esclusivamente come contenitore per altri oggetti e non ha proprietà visibili. Un oggetto Canvas e i relativi elementi figlio (se presenti) non sono visibili se una di queste condizioni è vera:
- La proprietà Visibility è impostata su Collapsed.
- La proprietà Opacity dell'oggetto Canvas è 0.
Gli elementi figlio di un oggetto Canvas (se presenti) sono ancora visibili anche se canvas presenta una di queste condizioni:
- La proprietà Background dell'oggetto Canvas è Null.
- La proprietà Height o Width dell'oggetto Canvas è 0.
Un oggetto Canvas senza elementi figlio e con un valore predefinito Altezza e Larghezza di Auto non ha dimensioni. Questo è anche il caso in cui Canvas ha elementi figlio, ma tutti gli elementi figlio hanno Visibilitàcompressa o zero Altezza o Larghezza.
Proprietà associate XAML
Canvas è la classe del servizio host per diverse proprietà associate XAML.
Per supportare l'accesso del processore XAML alle proprietà associate e anche per esporre operazioni get e set equivalenti al 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 dell'identificatore come identificatore della proprietà di dipendenza.
| Proprietà associata | Descrizione |
|---|---|
| Sinistra | Ottiene o imposta la distanza tra il lato sinistro di un oggetto e il lato sinistro dell'oggetto Canvas padre.
|
| TOP | Ottiene o imposta la distanza tra la parte superiore di un elemento e la parte superiore del relativo oggetto Canvas padre.
Un valore Canvas.Top viene interpretato dall'elemento Canvas padre più immediato da cui viene impostato il valore. Il valore viene usato insieme a Canvas.Left per specificare le caratteristiche di layout di ogni elemento figlio di un oggetto Canvas. |
| ZIndex | Ottiene o imposta l'ordine Z di un elemento quando tale elemento viene presentato nel contenitore di layout Canvas padre.
In genere si usano valori 0 e superiori, ma sono consentiti valori negativi. Un valore negativo, ad esempio -99, posiziona l'oggetto anche più lontano dal primo piano rispetto a qualsiasi valore predefinito. Un valore viene interpretato dall'elemento Canvas padre più immediato da cui viene impostato il valore. Il valore viene usato per definire in modo esplicito l'ordine di disegno nei casi in cui gli elementi figlio si sovrappongono. |
Costruttori
| Canvas() |
Inizializza una nuova istanza della classe Canvas . |
Proprietà
| AccessKey |
Ottiene o imposta la chiave di accesso (mnemonic) 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 nell'albero visivo dell'elemento di origine. (Ereditato da UIElement) |
| ActualHeight |
Ottiene l'altezza di cui è stato eseguito il 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 del processo di layout. (Ereditato da UIElement) |
| ActualTheme |
Ottiene il tema dell'interfaccia utente attualmente utilizzato dall'elemento , che potrebbe essere diverso da RequestedTheme. (Ereditato da FrameworkElement) |
| ActualWidth |
Ottiene la larghezza sottoposta a rendering di un oggetto FrameworkElement. Vedere la sezione Osservazioni. (Ereditato da FrameworkElement) |
| AllowDrop |
Ottiene o imposta un valore che determina se questo UIElement può essere una destinazione di rilascio a scopo di operazioni di trascinamento e rilascio. (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) |
| Background |
Ottiene o imposta un oggetto Brush che riempie l'area del contenuto del pannello. (Ereditato da Panel) |
| BackgroundTransition |
Ottiene o imposta un'istanza di BrushTransition per animare automaticamente le modifiche apportate alla proprietà Background. (Ereditato da Panel) |
| 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 degli 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 UIElement può essere un candidato per l'ancoraggio di 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. (Ereditato da UIElement) |
| CenterPoint |
Ottiene o imposta il punto centrale dell'elemento, ovvero il punto di rotazione o ridimensionamento. Influisce sulla posizione di rendering dell'elemento. (Ereditato da UIElement) |
| Children |
Ottiene la raccolta di elementi figlio del pannello. (Ereditato da Panel) |
| ChildrenTransitions |
Ottiene o imposta l'insieme di elementi dello stile Transition che si applicano al contenuto figlio di una sottoclasse Panel . (Ereditato da Panel) |
| Clip |
Ottiene o imposta la proprietà RectangleGeometry utilizzata per definire la struttura del contenuto di un oggetto UIElement. (Ereditato da UIElement) |
| CompositeMode |
Ottiene o imposta una proprietà che dichiara la composizione alternativa e le modalità di fusione per l'elemento nel layout e nella finestra padre. Ciò è 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 |
| DesiredSize |
Ottiene le dimensioni calcolate da questo UIElement durante il passaggio della misura del processo di layout. (Ereditato da UIElement) |
| Dispatcher |
Restituisce |
| DispatcherQueue |
Ottiene l'oggetto a cui è associato l'oggetto |
| ExitDisplayModeOnAccessKeyInvoked |
Ottiene o imposta un valore che specifica se la visualizzazione della chiave di accesso viene ignorata quando viene richiamata una chiave di accesso. (Ereditato da UIElement) |
| FlowDirection |
Ottiene o imposta la direzione in cui il testo e altri elementi dell'interfaccia utente scorrono all'interno di qualsiasi elemento padre che controlla il layout. Questa proprietà può essere impostata su |
| FocusState |
Ottiene un valore che specifica se questo controllo ha lo stato attivo e la modalità in base alla quale è 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 o |
| FocusVisualPrimaryThickness |
Ottiene o imposta lo spessore del bordo esterno di un |
| FocusVisualSecondaryBrush |
Ottiene o imposta il pennello utilizzato per disegnare il bordo interno di un oggetto visivo o |
| FocusVisualSecondaryThickness |
Ottiene o imposta lo spessore del bordo interno di un |
| 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 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 di 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 se l'area contenuta di questo UIElement può restituire valori true per il 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) |
| IsItemsHost |
Ottiene un valore che indica se questo Pannello è un contenitore per gli elementi dell'interfaccia utente generati da itemsControl. (Ereditato da Panel) |
| 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ò avere origine da tale elemento. (Ereditato da UIElement) |
| IsTabStop |
Ottiene o imposta un valore che indica se un controllo è incluso nella navigazione tramite tabulazione. (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 visualizza la combinazione di tasti per l'acceleratore di tastiera 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 usando la tastiera. Gli acceleratori vengono in genere assegnati ai pulsanti o alle voci di menu.
|
| KeyTipHorizontalOffset |
Ottiene o imposta un valore che indica l'estrema sinistra o destra in relazione all'UIElement. (Ereditato da UIElement) |
| KeyTipPlacementMode |
Ottiene o imposta un valore che indica dove viene posizionato il suggerimento chiave di accesso in relazione al limite dell'UIElement. (Ereditato da UIElement) |
| KeyTipTarget |
Ottiene o imposta un valore che indica l'elemento di destinazione della chiave di accesso Key Tip. (Ereditato da UIElement) |
| KeyTipVerticalOffset |
Ottiene o imposta un valore che indica l'altezza o il basso del suggerimento chiave in relazione 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. (Ereditato da FrameworkElement) |
| LeftProperty |
Identifica la proprietà associata XAML Canvas.Left . |
| Lights |
Ottiene l'insieme di oggetti XamlLight collegati a questo elemento. (Ereditato da UIElement) |
| ManipulationMode |
Ottiene o imposta il valore ManipulationModes usato 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. (Ereditato da FrameworkElement) |
| MaxHeight |
Ottiene o imposta il vincolo di altezza massima di un oggetto FrameworkElement. (Ereditato da FrameworkElement) |
| MaxWidth |
Ottiene o imposta il vincolo di larghezza massima di un oggetto 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) |
| 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 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 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) |
| 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 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 |
| 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. (Ereditato da FrameworkElement) |
| TabFocusNavigation |
Ottiene o imposta un valore che modifica il funzionamento di tabbing 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) |
| TopProperty |
Identifica la proprietà associata Canvas.Top XAML. |
| 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. (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 interi pixel. (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 oggetto UIElement. Un |
| Width |
Ottiene o imposta la larghezza di un FrameworkElement. (Ereditato da FrameworkElement) |
| XamlRoot |
Ottiene o imposta l'oggetto |
| 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 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) |
| 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 uno spostamento a sinistra. (Ereditato da UIElement) |
| XYFocusRight |
Ottiene o imposta l'oggetto che ottiene lo stato attivo quando un utente preme a destra 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 uno spostamento a destra. (Ereditato da UIElement) |
| XYFocusUp |
Ottiene o imposta l'oggetto che ottiene lo stato attivo quando un utente preme 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 uno spostamento verso l'alto. (Ereditato da UIElement) |
| ZIndexProperty |
Identifica la proprietà associata XAML Canvas.ZIndex . |
Proprietà associate
| Left |
Ottiene o imposta la distanza tra il lato sinistro di un oggetto e il lato sinistro dell'oggetto Canvas padre. |
| Top |
Ottiene o imposta la distanza tra la parte superiore di un elemento e la parte superiore del relativo oggetto Canvas padre. |
| ZIndex |
Ottiene o imposta l'ordine Z di un elemento quando tale elemento viene presentato nel contenitore di layout Canvas padre. |
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 |
| Arrange(Rect) |
Posiziona oggetti figlio e determina una dimensione per un 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 di layout ricorsivo. (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) in qualsiasi elemento padre ScrollViewer contenente l'oggetto UIElement corrente. (Ereditato da UIElement) |
| CapturePointer(Pointer) |
Imposta l'acquisizione del puntatore su un UIElement. Dopo aver acquisito, solo l'elemento con acquisizione attiverà 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 una sottoclasse UIElement 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 l'oggetto BindingExpression che rappresenta l'associazione nella proprietà specificata. (Ereditato da FrameworkElement) |
| GetChildrenInTabFocusOrder() |
Consente a una sottoclasse UIElement di esporre gli elementi figlio che partecipano allo stato attivo tabulazione. (Ereditato da UIElement) |
| GetLeft(UIElement) |
Ottiene il valore della proprietà associata XAML Canvas.Left per l'elemento di destinazione. |
| GetTop(UIElement) |
Ottiene il valore della proprietà associata Canvas.Top XAML per l'elemento di destinazione. |
| GetValue(DependencyProperty) |
Restituisce il valore effettivo corrente di una proprietà di dipendenza da dependencyObject. (Ereditato da DependencyObject) |
| GetVisualInternal() |
Recupera l'oggetto a cui viene risolto l'elemento |
| GetZIndex(UIElement) |
Ottiene il valore della proprietà associata XAML Canvas.ZIndex per l'elemento di destinazione. |
| 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, uiElement avrà il relativo layout aggiornato, che si verificherà in modo asincrono. (Ereditato da UIElement) |
| InvalidateMeasure() |
Invalida lo stato di misura (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) |
Aggiornamenti DesiredSize di un UIElement. In genere, gli oggetti che implementano il layout personalizzato per i propri figli di layout chiamano questo metodo dalle proprie implementazioni di MeasureOverride per formare un aggiornamento di 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". (Ereditato da FrameworkElement) |
| 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. (Ereditato da FrameworkElement) |
| OnBringIntoViewRequested(BringIntoViewRequestedEventArgs) |
Chiamato prima che si verifichi l'evento BringIntoViewRequested . (Ereditato da UIElement) |
| OnCreateAutomationPeer() |
Quando 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 un contenuto o da una proprietà figlio specifici della classe. (Ereditato da UIElement) |
| OnKeyboardAcceleratorInvoked(KeyboardAcceleratorInvokedEventArgs) |
Chiamato quando viene elaborata una scelta rapida da tastiera (o acceleratore) 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 appena prima che venga elaborata una scelta rapida da tastiera (o 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 è impostato un valore locale. (Ereditato da DependencyObject) |
| RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Registra una funzione di notifica per l'ascolto delle modifiche apportate a una dipendenza specifica in questa istanza di 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 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. (Ereditato da FrameworkElement) |
| SetLeft(UIElement, Double) |
Imposta il valore della proprietà associata XAML Canvas.Left per un elemento di destinazione. |
| SetTop(UIElement, Double) |
Imposta il valore della proprietà associata Canvas.Top XAML per un elemento di destinazione. |
| SetValue(DependencyProperty, Object) |
Imposta il valore locale di una proprietà di dipendenza su dependencyObject. (Ereditato da DependencyObject) |
| SetZIndex(UIElement, Int32) |
Imposta il valore della proprietà associata XAML Canvas.ZIndex per un elemento di destinazione. |
| 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(ExpPointerPoint) |
Definisce un'area all'interno della quale è possibile posizionare in modo esplicito gli oggetti figlio, usando coordinate relative all'area Canvas. (Ereditato da UIElement) |
| StartDragAsync(PointerPoint) |
Inizia 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 . (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 le chiavi di accesso non devono più essere visualizzate. (Ereditato da UIElement) |
| AccessKeyDisplayRequested |
Si verifica quando l'utente richiede che vengano visualizzate le chiavi di accesso. (Ereditato da UIElement) |
| AccessKeyInvoked |
Si verifica quando un utente completa una sequenza di chiavi di accesso. (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 viene modificato il valore della proprietà FrameworkElement.DataContext . (Ereditato da FrameworkElement) |
| DoubleTapped |
Si verifica quando si verifica un'interazione DoubleTap altrimenti 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 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 con questo elemento. (Ereditato da UIElement) |
| EffectiveViewportChanged |
Si verifica quando cambia il viewport effettivo di FrameworkElement. (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 sta bubbling. (Ereditato da UIElement) |
| GotFocus |
Si verifica quando un UIElement riceve lo stato attivo. Questo evento viene generato in modo asincrono, quindi lo stato attivo può nuovamente spostarsi prima che venga completato il bubbling. (Ereditato da UIElement) |
| Holding |
Si verifica quando si verifica un'interazione di blocco altrimenti non gestita sull'area di hit test di questo elemento. (Ereditato da UIElement) |
| KeyDown |
Si verifica quando viene premuto un tasto da tastiera mentre UIElement ha lo stato attivo. (Ereditato da UIElement) |
| KeyUp |
Si verifica quando viene rilasciato un tasto da 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. (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 sta bubbling. (Ereditato da UIElement) |
| LostFocus |
Si verifica quando un UIElement perde lo stato attivo. Questo evento viene generato in modo asincrono, quindi lo stato attivo può nuovamente spostarsi prima che venga completato il bubbling. (Ereditato da UIElement) |
| ManipulationCompleted |
Si verifica quando viene completata una manipolazione sull'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 la scheda o le frecce direzionali), ma lo stato attivo non viene spostato 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 fatto contatto anormale perde 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 Stampa non è garantita l'attivazione di un |
| 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. (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 degli oggetti principale. (Ereditato da FrameworkElement) |