Condividi tramite


Image Classe

Definizione

Rappresenta un controllo per la visualizzazione di un'immagine. L'origine dell'immagine viene specificata facendo riferimento a un file di immagine, usando diversi formati supportati. L'origine dell'immagine può essere impostata anche con un flusso. Vedere La sezione Note per l'elenco dei formati di origine delle immagini supportati.

public ref class Image sealed : FrameworkElement
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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 Image final : FrameworkElement
/// [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)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class Image final : FrameworkElement
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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 sealed class Image : FrameworkElement
[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)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class Image : FrameworkElement
Public NotInheritable Class Image
Inherits FrameworkElement
<Image .../>
Ereditarietà
Object Platform::Object IInspectable DependencyObject UIElement FrameworkElement Image
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)

Esempio

Suggerimento

Per altre info, linee guida per la progettazione ed esempi di codice, vedi Immagine.

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

Commenti

Formati dei file di immagine

Un'immagine può visualizzare questi formati di file di immagine:

  • Joint Photographic Experts Group (JPEG)
  • Portable Network Graphics (PNG)
  • bitmap (BMP)
  • Graphics Interchange Format (GIF)
  • Tagged Image File Format (TIFF)
  • JPEG XR
  • icone (ICO)
  • Scalable Vector Graphics (SVG)

Nota

File icona supportati solo in Windows. Non supportato in Windows Phone 8.1

A partire da Windows 10 versione 1607, l'elemento Image supporta immagini GIF (Graphics Interchange Format) animate. Quando si usa bitmapImage come origine dell'immagine, è possibile accedere all'API BitmapImage per controllare la riproduzione dell'immagine GIF (Graphics Interchange Format) animata. Per altre info, vedi le osservazioni nella pagina relativa alla classe BitmapImage.

Nota

Il supporto gif (Graphics Interchange Format) animato è disponibile quando l'app viene compilata per Windows 10 versione 1607 e in esecuzione nella versione 1607 (o successiva). Quando l'app viene compilata per o eseguita nelle versioni precedenti, viene visualizzata la prima cornice del formato GIF (Graphics Interchange Format), ma non è animata.

A partire da Windows 10 versione 1703, l'elemento Image supporta immagini SVG (Scalable Vector Graphics) statiche tramite SvgImageSource. SvgImageSource supporta la modalità statica sicura dalla specifica SVG e non supporta animazioni o interazioni. Direct2D fornisce il supporto per il rendering SVG sottostante e per altre info su supporto di attributi e elementi SVG specifici, vedi Supporto SVG. Per altre informazioni su come inserire un svg nella tua app, visita la pagina della classe SvgImageSource .

Nota

Il supporto SVG (Scalable Vector Graphics) è disponibile quando l'app viene compilata per Windows 10, versione 1703 e in esecuzione nella versione 1703 (o successiva). Quando l'app viene compilata per o eseguita nelle versioni precedenti, l'immagine SVG non verrà visualizzata.

Impostazione di Image.Source

Per impostare il file di origine dell'immagine visualizzato da un'immagine, impostarne la proprietà Source , in XAML o nel codice. Ecco un semplice esempio di impostazione di Source in XAML:

<Image Width="200" Source="Images/myimage.png"/>

Questo utilizzo è l'impostazione Source by Uniform Resource Identifier (URI), che è un collegamento abilitato da XAML. Si noti che l'URI (Uniform Resource Identifier) sembra essere un URI (Uniform Resource Identifier) relativo; il supporto di un URI (Uniform Resource Identifier) parziale è un altro collegamento XAML. La radice di questo URI (Uniform Resource Identifier) è la cartella di base per un progetto di app. Si tratta in genere della stessa posizione da cui viene caricato il file XAML contenente il tag Image. In questo esempio, il file di origine dell'immagine si trova in una sottocartella Images all'interno della struttura di file dell'app.

L'impostazione della proprietà Source è intrinsecamente un'azione asincrona. Poiché si tratta di una proprietà, non esiste una sintassi awaitable, ma per la maggior parte degli scenari non è necessario interagire con gli aspetti asincroni del caricamento delle immagini. Il framework attenderà la restituzione dell'origine dell'immagine e avvierà un ciclo di layout quando il file di origine dell'immagine è disponibile e decodificato.

L'impostazione dell'origine su un valore URI (Uniform Resource Identifier) che non può essere risolto in un file di origine dell'immagine valido non genera un'eccezione. Genera invece un evento ImageFailed . È possibile scrivere un gestore ImageFailed e collegarlo all'oggetto Image ed eventualmente usare ErrorMessage nei dati dell'evento per determinare la natura dell'errore. Un errore nella decodifica può anche generare ImageFailed. Se si desidera verificare che un file di origine dell'immagine sia stato caricato correttamente, è possibile gestire l'evento ImageOpened nell'elemento Image.

In genere si usano i file di origine dell'immagine inclusi come parte del pacchetto di download dell'app. Per i file di grandi dimensioni, potrebbe verificarsi un ritardo molto ridotto mentre il file di origine dell'immagine viene decodificato, se questa è la prima volta che viene usata l'origine. Per altre info sulle risorse dell'app e su come creare un pacchetto di file di origine dell'immagine in un pacchetto dell'app, vedi Definizione delle risorse dell'app.

È anche possibile usare i file di origine dell'immagine che non fanno parte dell'app, ad esempio immagini provenienti da server esterni. Queste immagini vengono scaricate da una richiesta HTTP interna e quindi decodificate. Se il file di origine dell'immagine è un file di grandi dimensioni o se si verificano problemi di connessione, potrebbe verificarsi un ritardo prima che un'immagine esterna possa essere visualizzata in un elemento Image.

Impostazione di Image.Source tramite il codice

Se si crea un oggetto Image usando codice, chiamare il costruttore predefinito, quindi impostare la proprietà Image.Source . L'impostazione della proprietà Image.Source richiede un'istanza della classe BitmapImage , che è necessario costruire. Se l'origine dell'immagine è un file a cui fa riferimento l'URI (Uniform Resource Identifier), usare il costruttore BitmapImage che accetta un parametro URI (Uniform Resource Identifier). Quando si fa riferimento al contenuto locale, è necessario includere lo schema ms-appx: nell'URI (Uniform Resource Identifier) assoluto usato come parametro del costruttore BitmapImage . Nel codice non si ottengono i collegamenti di elaborazione per combinare parti URI (Uniform Resource Identifier) relative e lo schema ms-appx: che avviene automaticamente se si specifica Source come attributo XAML. È invece necessario costruire in modo esplicito un URI (Uniform Resource Identifier) assoluto con lo schema appropriato. In genere si usa lo schema ms-appx: per un file di immagine incluso nell'app.

Suggerimento

Se si usa C# o Microsoft Visual Basic, è possibile ottenere la proprietà BaseUri dell'oggetto Image e passarne il valore come parametro baseUri per i costruttori System.Uri che combinano una posizione di base URI (Uniform Resource Identifier) e un percorso relativo all'interno di tale posizione.

Ecco un esempio di impostazione di Image.Source in C#. In questo esempio l'oggetto Image è stato creato in XAML, ma non ha un'origine o altri valori di proprietà; questi valori vengono invece forniti in fase di esecuzione quando l'immagine viene caricata da XAML.

void Image_Loaded(object sender, RoutedEventArgs e)
{
    Image img = sender as Image; 
    BitmapImage bitmapImage = new BitmapImage();
    img.Width = bitmapImage.DecodePixelWidth = 80; //natural px width of image source
    // don't need to set Height, system maintains aspect ratio, and calculates the other
    // dimension, so long as one dimension measurement is provided
    bitmapImage.UriSource = new Uri(img.BaseUri,"Assets/StoreLogo.png");
    img.Source = bitmapImage;
}

Uso di un'origine di flusso per un'origine immagine

Se l'origine dell'immagine è un flusso, è necessario scrivere codice che imposta l'istanza image per usare il flusso. Questa operazione non può essere eseguita solo in XAML. Costruire l'immagine da usare o fare riferimento a un'istanza image esistente (che potrebbe essere stata definita nel markup XAML, ma senza un'origine). Usare quindi il metodo asincrono SetSourceAsync di BitmapImage per definire le informazioni sull'immagine da un flusso, passando il flusso da usare come parametro streamSource . L'uso di un flusso per un'origine immagine è piuttosto comune. Ad esempio, se l'app consente a un utente di scegliere un file di immagine usando un controllo FileOpenPicker , l'oggetto che si ottiene che rappresenta il file scelto dall'utente può essere aperto come flusso, ma non fornisce un riferimento URI (Uniform Resource Identifier) al file.

In questo esempio, il codice è già awaitable perché è in attesa che l'utente scelga un file e venga eseguito solo dopo tale operazione. Il flusso da usare proviene da StorageFile.OpenAsync dopo che un'istanza di StorageFile viene restituita dalle azioni di selezione asincrone.

FileOpenPicker open = new FileOpenPicker(); 
// Open a stream for the selected file 
StorageFile file = await open.PickSingleFileAsync(); 
// Ensure a file was selected 
if (file != null) 
{ 
    using (IRandomAccessStream fileStream = await file.OpenAsync(Windows.Storage.FileAccessMode.Read)) 
    { 
        // Set the image source to the selected bitmap 
         BitmapImage bitmapImage = new BitmapImage(); 
         bitmapImage.DecodePixelWidth = 600; //match the target Image.Width, not shown
         await bitmapImage.SetSourceAsync(fileStream); 
         Scenario2Image.Source = bitmapImage; 
    } 
}

Suggerimento

Se si usa C# o Microsoft Visual Basic, i flussi possono usare il tipo System.IO.Stream con cui si ha familiarità con l'esperienza di programmazione Microsoft .NET precedente. È possibile chiamare il metodo di estensione AsStream come metodo di istanza su qualsiasi oggetto di tipo IRandomAccessStream ottenuto da un'API Windows Runtime. L'esempio precedente ha usato IRandomAccessStream per il passaggio dei parametri e non è necessario usare AsStream. Tuttavia, se è necessario modificare il flusso, AsStream è disponibile come utilità per la conversione in system.IO.Stream , se necessario.

Vedi l'esempio di immagini XAML per altri esempi di codice.

File di immagine e prestazioni

I file di immagine di grandi dimensioni possono influire sulle prestazioni perché vengono caricati in memoria. Se si fa riferimento a un file di immagine in cui si è certi che il file di origine è un'immagine di grandi dimensioni ad alta risoluzione, ma l'app la visualizza in un'area dell'interfaccia utente inferiore alla dimensione naturale dell'immagine, è necessario impostare la proprietà DecodePixelWidth o DecodePixelHeight. Le proprietà DecodePixel* consentono di passare le informazioni direttamente al codec specifico del formato e il codec può usare queste informazioni per decodificare in modo più efficiente e a un footprint di memoria inferiore. Imposta DecodePixelWidth sulla stessa larghezza in pixel dell'area che vuoi che l'app visualizzi effettivamente. In altre parole, DecodePixelWidth per l'origine BitmapImage deve essere lo stesso valore del controllo Width o ActualWidth del controllo Image che visualizza tale origine.

È possibile impostare DecodePixelWidth o impostare DecodePixelHeight. Se si imposta una di queste due proprietà, il sistema calcola la proprietà corrispondente per mantenere le proporzioni corrette. È anche possibile impostare entrambe le proprietà, ma in genere è consigliabile usare valori che mantengono le proporzioni. Se si desidera modificare le proporzioni, è possibile farlo in modo migliore, ad esempio usando TranslateTransform come RenderTransform.

Per impostare DecodePixelWidth (o DecodePixelHeight) in XAML, devi usare una sintassi XAML leggermente più dettagliata che includa un elemento BitmapImage esplicito come valore dell'elemento proprietà, come illustrato di seguito:

<Image>
  <Image.Source>
    <BitmapImage DecodePixelWidth="200" UriSource="images/myimage.png"/>
  </Image.Source>
</Image>

DecodePixelWidth (o DecodePixelHeight) sono proprietà di BitmapImage, quindi è necessario un elemento oggetto XAML BitmapImage esplicito per impostare le proprietà DecodePixel* come attributi in XAML.

Se si crea un'istanza image nel codice, probabilmente si sta già creando un'istanza BitmapImage come valore da fornire per la proprietà Source , quindi è sufficiente impostare DecodePixelWidth (o DecodePixelHeight) nell'istanza BitmapImage prima di impostare la proprietà UriSource . La proprietà DecodePixelType influisce anche sul modo in cui i valori pixel vengono interpretati dalle operazioni di decodifica.

Per evitare che le immagini vengano decodificate più volte, assegnare la proprietà di origine dell'immagine dall'URI (Uniform Resource Identifier) anziché usare flussi di memoria ogni volta che è possibile. Il framework XAML può associare lo stesso URI (Uniform Resource Identifier) in più posizioni a un'immagine decodificata, ma non può eseguire la stessa operazione per più flussi di memoria anche se contengono gli stessi dati.

È possibile rimuovere i file di immagine dalla cache delle immagini impostando tutti i valori Image.Source associati su Null.

Per altre info sulla classe Image e sulle prestazioni, vedi Ottimizzare animazioni e supporti.

Codifica e decodifica dei file di immagine

Il supporto del codec sottostante per i file di immagine viene fornito dall'API Windows Imaging Component (WIC). Per altre informazioni sui formati di immagine specifici come documentato per i codec, vedi Codec WIC nativi.

L'API per Image, BitmapImage e BitmapSource non include metodi dedicati per la codifica e la decodifica dei formati multimediali. Tutte le operazioni di decodifica sono predefinite come azioni che si verificano quando l'origine viene impostata o reimpostata. In questo modo le classi sono più facili da usare per la costruzione dell'interfaccia utente, perché hanno un set predefinito di formati di file di origine supportati e comportamento di decodifica. Le classi come BitmapImage espongono alcune delle opzioni di decodifica e della logica come parte dei dati dell'evento per gli eventi ImageOpened o ImageFailed . Se è necessaria la decodifica avanzata dei file di immagine o la codifica delle immagini, è consigliabile usare l'API dello spazio dei nomi Windows.Graphics.Imaging . Potrebbe essere necessaria questa API se lo scenario dell'app prevede conversioni di formato di file di immagine o la manipolazione di un'immagine in cui l'utente può salvare il risultato come file. L'API di codifica è supportata anche dal componente Windows Imaging Component (WIC) di Windows.

Larghezza e altezza dell'immagine

La classe Image eredita le proprietà Width e Height da FrameworkElement e queste proprietà controllano potenzialmente le dimensioni di cui verrà eseguito il rendering il controllo Image quando viene visualizzato nell'interfaccia utente. Se non si imposta width oheight, la larghezza e l'altezza sono determinate dalle dimensioni naturali dell'origine dell'immagine. Ad esempio, se si carica un'immagine bitmap alta 300 pixel e una larghezza di 400 pixel, come registrato nel formato del file di origine, queste misurazioni vengono usate per la larghezza e l'altezza quando il controllo Image calcola le dimensioni naturali. È possibile controllare ActualHeight e ActualWidth in fase di esecuzione dopo il rendering dell'immagine per ottenere le informazioni di misurazione. In alternativa, puoi gestire ImageOpened e controllare le proprietà del file di immagine, ad esempio PixelHeight e PixelWidth immediatamente prima del rendering dell'immagine.

Se si imposta solo una delle proprietà Width o Height ma non entrambe, il sistema può usare tale dimensione come linee guida e calcolare l'altra, mantenendo le proporzioni. Se non si è certi delle dimensioni del file di origine, selezionare la dimensione più importante da controllare nello scenario di layout e consentire al sistema di calcolare l'altra dimensione e quindi il comportamento del layout del contenitore si adatta in genere al layout.

Se non imposti Width e/o Height e lascia l'immagine come dimensione naturale, la proprietà Stretch per l'immagine può controllare il modo in cui il file di origine dell'immagine riempirà lo spazio specificato come Width e Height. Il valore predefinito Stretch è Uniform, che mantiene le proporzioni quando si adatta l'immagine a un contenitore di layout. Se le dimensioni del contenitore non hanno le stesse proporzioni, ci sarà spazio vuoto che fa ancora parte di Image ma non mostra pixel di immagine, almeno quando si usa il valore Uniform per Stretch. UniformToFill per Stretch non lascerà spazio vuoto, ma potrebbe ritagliarsi l'immagine se le dimensioni sono diverse. Il riempimento per Stretch non lascerà spazio vuoto, ma potrebbe modificare le proporzioni. È possibile sperimentare questi valori per vedere cosa è meglio per la visualizzazione delle immagini nello scenario di layout. Tenere inoltre presente che alcuni contenitori di layout potrebbero ridimensionare un'immagine senza larghezza e altezza specifiche per riempire l'intero spazio di layout, nel qual caso è possibile scegliere di impostare dimensioni specifiche per l'immagine o il contenitore.

NineGrid

L'uso della tecnica NineGrid è un'altra opzione per ridimensionare le immagini con dimensioni naturali diverse rispetto all'area di visualizzazione, se l'immagine contiene aree che non devono essere ridimensionate in modo uniforme. Ad esempio, è possibile usare un'immagine di sfondo con un bordo intrinseco che deve estendersi solo in una dimensione e angoli che non devono estendersi affatto, ma il centro immagini può estendersi in base ai requisiti di layout in entrambe le dimensioni. Per altre info, vedi NineGrid.

Qualificazione e localizzazione delle risorse per Image

File di origine e scalabilità delle immagini

Devi creare le origini delle immagini con diverse dimensioni consigliate, per assicurarti che l'app abbia un aspetto ottimale quando Windows 8 lo ridimensiona. Quando si specifica un'origine per un'immagine, è possibile usare una convenzione di denominazione per le risorse che useranno la risorsa corretta per i fattori di ridimensionamento specifici del dispositivo. Ciò è determinato automaticamente dall'app in fase di esecuzione. Per informazioni specifiche sulle convenzioni di denominazione da usare e altre informazioni, vedi Guida introduttiva: Uso di risorse di file o immagini.

Per altre info su come progettare correttamente le immagini per il ridimensionamento, vedi Linee guida per l'esperienza utente per il layout e il ridimensionamento.

Uso di risorse non qualificate

Le risorse non qualificate sono una tecnica che è possibile usare in cui il riferimento alla risorsa di base fa riferimento a una risorsa predefinita e il processo di gestione delle risorse può trovare automaticamente la risorsa localizzata equivalente. È possibile usare la gestione automatica per accedere a risorse non qualificate con qualificatori di scala e impostazioni cultura correnti oppure è possibile usare ResourceManager e ResourceMap con qualificatori per le impostazioni cultura e la scalabilità per ottenere direttamente le risorse. Per altre informazioni, vedi Sistema gestione risorse.

FlowDirection per Image

Se si imposta FlowDirection su RightToLeft per un'immagine, il contenuto visivo di un'immagine viene capovolto orizzontalmente. Tuttavia, un elemento Image non eredita il valore FlowDirection da alcun elemento padre. In genere si vuole solo il comportamento di scorrimento delle immagini nelle immagini rilevanti per il layout, ma non necessariamente per gli elementi con testo incorporato o altri componenti che non hanno senso capovolgere per un gruppo di destinatari da destra a sinistra. Per ottenere il comportamento di scorrimento delle immagini, è necessario impostare l'elemento FlowDirection sull'elemento Image in modo specifico su RightToLeft oppure impostare la proprietà FlowDirection nel code-behind. Prendere in considerazione l'identificazione dell'elemento Image mediante la direttiva x:Uid e la specifica dei valori FlowDirection come risorsa Windows Runtime, in modo che gli esperti di localizzazione possano modificare questo valore in un secondo momento senza modificare il codice o XAML.

Classe Image e accessibilità

La classe Image non è una classe di controllo vera in quanto non è una classe discendente di Control. Non è possibile chiamare lo stato attivo a un elemento Image o posizionare un elemento Image in una sequenza di tabulazioni. Per altre info sugli aspetti di accessibilità relativi all'uso di immagini e all'elemento Image nell'interfaccia utente, vedi Informazioni di accessibilità di base.

Comportamento di Windows 8

Per Windows 8, le risorse possono usare un modello di qualificatore di risorse per caricare risorse diverse a seconda del ridimensionamento specifico del dispositivo. Tuttavia, le risorse non vengono ricaricate automaticamente se il fattore di ridimensionamento cambia mentre l'app è in esecuzione. In questo caso, le app devono eseguire il ricaricamento delle risorse, gestendo l'evento DpiChanged (o l'evento LogicalDpiChanged deprecato) e usando l'API ResourceManager per ricaricare manualmente la risorsa appropriata per il nuovo fattore di ridimensionamento. A partire da Windows 8.1, tutte le risorse recuperate originariamente per l'app vengono valutate automaticamente se il fattore di ridimensionamento cambia durante l'esecuzione dell'app. Inoltre, quando tale risorsa è l'origine dell'immagine per un oggetto Image, uno degli eventi di caricamento di origine (ImageOpened o ImageFailed) viene generato in seguito all'azione del sistema di richiesta della nuova risorsa e quindi l'applicazione all'immagine. Lo scenario in cui può verificarsi una modifica della scalabilità in fase di esecuzione è se l'utente sposta l'app in un monitoraggio diverso quando è disponibile più di una.

Se esegui la migrazione del codice dell'app da Windows 8 a Windows 8.1 potresti voler tenere conto di questa modifica del comportamento, perché genera eventi ImageOpened o ImageFailed che si verificano in fase di esecuzione quando viene gestita la modifica della scala, anche nei casi in cui l'origine è impostata in XAML. Inoltre, se si dispone di codice che ha gestito DpiChangedLogicalDpiChanged/ e reimpostato le risorse, è necessario esaminare se tale codice è ancora necessario in base al nuovo comportamento di ricaricamento automatico Windows 8.1.

Le app create per Windows 8 che vengono eseguite in Windows 8.1 continuano a usare il comportamento di Windows 8.

Cronologia delle versioni

Versione di Windows Versione dell'SDK Valore aggiunto
1607 14393 GetAlphaMask

Costruttori

Image()

Inizializza una nuova istanza della classe Image .

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 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 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 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 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 (Uniform Resource Identifier) di base per un oggetto costruito da XAML in fase di caricamento XAML. Questa proprietà è utile per la risoluzione URI (Uniform Resource Identifier) 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 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 dati per un FrameworkElement. Un uso comune di un contesto dati è quando un FrameworkElement usa l'estensione di markup {Binding} e partecipa al data binding.

(Ereditato da FrameworkElement)
DesiredSize

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

(Ereditato da UIElement)
Dispatcher

Ottiene coreDispatcher a cui è associato questo oggetto. CoreDispatcher rappresenta una funzionalità che può accedere a 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 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 scorrono 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 da destra a sinistra e il layout del controllo da destra a sinistra.

(Ereditato da FrameworkElement)
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 Reveal di un HighVisibilityoggetto visivo FrameworkElement.

(Ereditato da FrameworkElement)
FocusVisualPrimaryThickness

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

(Ereditato da FrameworkElement)
FocusVisualSecondaryBrush

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

(Ereditato da FrameworkElement)
FocusVisualSecondaryThickness

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

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

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

Esempio di 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 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.

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

Ottiene o imposta un valore per una metafora a nove griglie che controlla la modalità di ridimensionamento dell'immagine. La metafora a nove griglie consente di estendere i bordi e gli angoli di un'immagine in modo diverso rispetto al centro. Per altre info e un'illustrazione, vedi La sezione Osservazioni.

NineGridProperty

Identifica la proprietà di dipendenza NineGrid .

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)
PlayToSource

Ottiene le informazioni trasmesse se l'immagine viene utilizzata per uno scenario Play To.

PlayToSourceProperty

Identifica la proprietà di dipendenza PlayToSource .

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.

(Ereditato da FrameworkElement)
Resources

Ottiene il dizionario risorse definito localmente. In XAML puoi stabilire elementi di risorsa come elementi oggetto figlio di un frameworkElement.Resources elemento di proprietà 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 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)
Source

Ottiene o imposta l'origine per l'immagine.

SourceProperty

Identifica la proprietà di dipendenza Source .

Stretch

Ottiene o imposta un valore che descrive la modalità di estensione di un'immagine per riempire il rettangolo di destinazione.

StretchProperty

Identifica la proprietà di dipendenza Stretch .

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)
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 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)
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.

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

(Ereditato da FrameworkElement)
XamlRoot

Ottiene o imposta l'oggetto XamlRoot in cui viene visualizzato questo elemento.

(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)
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 "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'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)
FindName(String)

Recupera un oggetto con il nome dell'identificatore specificato.

(Ereditato da FrameworkElement)
FindSubElementsForTouchTargeting(Point, Rect)

Consente a una sottoclasse UIElement di esporre gli elementi figlio che consentono di risolvere la destinazione tocco.

(Ereditato da UIElement)
GetAlphaMask()

Restituisce una maschera che rappresenta il canale alfa di un'immagine come CompositionBrush.

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

Restituisce l'immagine come CastingSource.

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 prendono parte allo stato attivo tabulazione.

(Ereditato da UIElement)
GetValue(DependencyProperty)

Restituisce il valore effettivo corrente di una proprietà di dipendenza da 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.

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

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

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

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 è 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)
SetValue(DependencyProperty, Object)

Imposta il valore locale di una proprietà di dipendenza su 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.

(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 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 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 è 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)
ImageFailed

Si verifica quando si verifica un errore associato al recupero o al formato dell'immagine.

ImageOpened

Si verifica quando l'origine dell'immagine viene scaricata e decodificata senza errori. È possibile usare questo evento per determinare le dimensioni naturali dell'origine dell'immagine.

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.

(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 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.

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

Si applica a

Vedi anche