Microsoft.UI.Xaml Spazio dei nomi
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Fornisce API di framework generali per la libreria dell'interfaccia utente di Windows (WinUI).
Classi
| Nome | Descrizione |
|---|---|
| AdaptiveTrigger |
Rappresenta una regola dichiarativa che applica gli stati di visualizzazione in base alle proprietà della finestra. |
| Application |
Rappresenta l'applicazione corrente e i relativi servizi disponibili. |
| ApplicationInitializationCallbackParams |
Rappresenta un oggetto per passare informazioni per una sequenza di inizializzazione personalizzata. (Obsoleto) |
| BindingFailedEventArgs |
Fornisce i dati degli eventi per l'evento DebugSettings.BindingFailed . |
| BringIntoViewOptions |
Rappresenta le opzioni che possono essere applicate quando viene visualizzato un elemento. |
| BringIntoViewRequestedEventArgs |
Fornisce i dati per l'evento UIElement.BringIntoViewRequested . |
| BrushTransition |
Fornisce il comportamento di transizione animato quando cambia il pennello di un elemento. Attualmente limitato alle modifiche tra |
| ColorPaletteResources |
Rappresenta un dizionario risorse specializzato che contiene risorse colore usate dagli elementi XAML. |
| CornerRadiusHelper |
Fornisce metodi di utilità di base per l'elaborazione dei valori CornerRadius . Il codice C# deve usare invece metodi di CornerRadius . |
| DataContextChangedEventArgs |
Fornisce dati per l'evento DataContextChanged . |
| DataTemplate |
Descrive la struttura visiva di un oggetto dati. Usare il data binding per elementi specifici nel modello che visualizzano i valori dei dati. |
| DataTemplateKey |
Rappresenta la chiave di risorsa per la classe DataTemplate . |
| DebugSettings |
Dichiara il comportamento di alcuni aspetti dell'app quando viene eseguito in un ambiente di debug |
| DependencyObject |
Rappresenta un oggetto che partecipa al sistema di proprietà di dipendenza. |
| DependencyObjectCollection |
Implementa una classe di raccolta pratica che può contenere elementi DependencyObject . |
| DependencyProperty |
Rappresenta una proprietà di dipendenza registrata con il sistema di proprietà di dipendenza. Le proprietà di dipendenza forniscono il supporto per espressioni di valore, data binding, animazione e notifica delle modifiche delle proprietà. Per altre info su come i valori dependencyProperty fungono da identificatori per le proprietà di dipendenza, vedi Panoramica delle proprietà di dipendenza. |
| DependencyPropertyChangedEventArgs |
Fornisce dati per un'implementazione PropertyChangedCallback richiamata quando una proprietà di dipendenza modifica il relativo valore. Fornisce inoltre i dati dell'evento Control.IsEnabledChanged e qualsiasi altro evento che usa il delegato DependencyPropertyChangedEventHandler . |
| DispatcherTimer |
Fornisce un timer integrato nella coda dispatcher , elaborato a un intervallo di tempo specificato e a una priorità specificata. |
| DragEventArgs |
Fornisce i dati per gli eventi di trascinamento della selezione. |
| DragOperationDeferral |
Consente di trascinare il contenuto con un'app di destinazione in modo asincrono. |
| DragStartingEventArgs |
Fornisce i dati degli eventi per l'evento DragStarting . |
| DragUI |
Fornisce la rappresentazione visiva dei dati trascinati all'inizio di un'operazione di trascinamento della selezione. |
| DragUIOverride |
Fornisce la rappresentazione visiva dei dati trascinati durante un'operazione di trascinamento della selezione, incluso il feedback dalla destinazione di rilascio. |
| DropCompletedEventArgs |
Fornisce i dati dell'evento DropCompleted . |
| DurationHelper |
Fornisce metodi di utilità di base per l'elaborazione dei valori duration . Il codice C# deve invece usare metodi di Duration . |
| EffectiveViewportChangedEventArgs |
Fornisce dati per l'evento FrameworkElement.EffectiveViewportChanged . |
| ElementFactoryGetArgs |
Rappresenta gli argomenti facoltativi da utilizzare quando si chiama un'implementazione del metodo GetElementFactory di IElementFactory. |
| ElementFactoryRecycleArgs |
Rappresenta gli argomenti facoltativi da utilizzare quando si chiama un'implementazione del metodo RecycleElement di IElementFactory. |
| ElementSoundPlayer |
Rappresenta un lettore per i suoni del controllo XAML. |
| EventTrigger |
Rappresenta un trigger che applica un set di azioni (storyboard di animazione) in risposta a un evento. Non usato comunemente. Vedere la sezione Osservazioni. |
| ExceptionRoutedEventArgs |
Fornisce i dati dell'evento per le eccezioni generate come eventi da operazioni asincrone, ad esempio ImageFailed. |
| FrameworkElement |
Fornisce una classe di elementi di base per Windows Runtime oggetti dell'interfaccia utente.
|
| FrameworkTemplate |
Crea un albero degli elementi. FrameworkTemplate è una classe di base per le classi con un comportamento di creazione modelli specifico, tra cui ControlTemplate e DataTemplate. |
| FrameworkView |
Rappresenta la finestra dell'interfaccia utente di un'applicazione. |
| FrameworkViewSource |
Crea visualizzazioni, in particolare istanze di FrameworkView . Si tratta dell'infrastruttura e non è necessario accedervi nella maggior parte degli scenari di app. |
| GridLengthHelper |
Fornisce metodi helper per valutare o impostare i valori GridLength . Il codice C# deve usare invece metodi di GridLength . |
| LaunchActivatedEventArgs |
Fornisce informazioni sugli eventi per l'evento Application.OnLaunched . |
| MediaFailedRoutedEventArgs |
Fornisce i dati degli eventi per l'evento MediaElement.MediaFailed . |
| PointHelper |
Fornisce metodi helper per impostare i valori Point . Il codice C# deve invece usare metodi di Point . |
| PropertyMetadata |
Definisce gli aspetti del comportamento di una proprietà di dipendenza, incluse le condizioni con cui è stato registrato. Per altre info su come |
| PropertyPath |
Implementa una struttura di dati per descrivere una proprietà come percorso sotto un'altra proprietà o sotto un tipo proprietario. I percorsi delle proprietà vengono utilizzati nell'associazione dati agli oggetti . |
| RectHelper |
Fornisce metodi helper per valutare o impostare i valori Rect . Il codice C# deve usare invece i membri di Rect . |
| ResourceDictionary |
Definisce un repository per le risorse XAML, ad esempio gli stili, usati dall'app. Definisci le risorse in XAML e puoi recuperarle in XAML usando l'estensione di markup {StaticResource} e l'estensione di markup {ThemeResource}. È anche possibile accedere alle risorse con il codice, ma questo è meno comune. |
| ResourceManagerRequestedEventArgs |
Fornisce i dati dell'evento |
| RoutedEvent |
Rappresenta un evento indirizzato al sistema eventi Windows Runtime. |
| RoutedEventArgs |
Contiene informazioni sullo stato e dati dell'evento associati a un evento indirizzato. |
| ScalarTransition |
Fornisce il comportamento di transizione animato quando le proprietà Opacity o Rotation di un elemento cambiano. |
| Setter |
Applica un valore a una proprietà in uno stile o in un oggetto VisualState. |
| SetterBase |
Rappresenta la classe di base per i setter di valore. |
| SetterBaseCollection |
Rappresenta una raccolta di oggetti che ereditano da SetterBase. |
| SizeChangedEventArgs |
Fornisce dati correlati all'evento FrameworkElement.SizeChanged . |
| SizeHelper |
Fornisce metodi helper per valutare o impostare i valori size . Il codice C# deve invece usare i membri di Size . |
| StateTrigger |
Rappresenta un trigger che applica gli stati di visualizzazione in modo condizionale. |
| StateTriggerBase |
Rappresenta la classe base per i trigger di stato. |
| Style |
Contiene setter di proprietà che possono essere condivisi tra istanze di un tipo. Un |
| StyleTypedPropertyAttribute |
Rappresenta un attributo applicato alla definizione della classe e determina i TargetType delle proprietà di tipo Style. |
| TargetPropertyPath |
Rappresenta il percorso di una proprietà in un elemento di destinazione. |
| TemplatePartAttribute |
Rappresenta un attributo applicato alla definizione della classe per identificare i tipi delle parti denominate utilizzate per la creazione di modelli. |
| TemplateVisualStateAttribute |
Specifica che un controllo può trovarsi in un determinato stato e che un oggetto VisualState è previsto nel ControlTemplate del controllo. |
| ThicknessHelper |
Fornisce metodi helper per valutare o impostare valori di Spessore . Il codice C# deve invece usare i membri di Thickness . |
| TriggerAction |
Funge da classe base per BeginStoryboard. Non usato comunemente. Vedere la sezione Osservazioni. |
| TriggerActionCollection |
Rappresenta un insieme di oggetti BeginStoryboard . |
| TriggerBase |
Funge da classe base per EventTrigger. Non usato comunemente. Vedere la sezione Osservazioni. |
| TriggerCollection |
Rappresenta un insieme di oggetti EventTrigger . |
| UIElement |
|
| UIElementWeakCollection |
Rappresenta una raccolta di riferimenti deboli agli oggetti UIElement. |
| UnhandledExceptionEventArgs |
Fornisce dati per l'evento UnhandledException . |
| Vector3Transition |
Fornisce il comportamento di transizione animato quando le proprietà Translation o Scale di un elemento cambiano. |
| VisualState |
Rappresenta l'aspetto visivo di un elemento dell'interfaccia utente quando si trova in uno stato specifico. Gli stati di visualizzazione usano setter o storyboard per impostare le proprietà dell'interfaccia utente all'interno di pagine o modelli di controllo in cui |
| VisualStateChangedEventArgs |
Fornisce dati per gli eventi CurrentStateChanging e CurrentStateChanged . |
| VisualStateGroup |
Contiene oggetti VisualState e oggetti VisualTransition che vengono usati per passare da uno stato a un altro. |
| VisualStateManager |
Gestisce gli stati di visualizzazione e la logica per le transizioni tra stati di visualizzazione per i controlli. Fornisce inoltre il supporto delle proprietà associate per |
| VisualTransition |
Rappresenta il comportamento visivo che si verifica quando il controllo passa da uno stato di visualizzazione a un altro. |
| Window |
Rappresenta una finestra dell'applicazione corrente. |
| WindowActivatedEventArgs |
Contiene le informazioni sullo stato di attivazione della finestra restituite dal Microsoft. UI. Evento Xaml.Window.Activated. |
| WindowEventArgs |
Contiene le informazioni sullo stato della finestra restituite dall'evento Window.Closed . |
| WindowSizeChangedEventArgs |
Contiene le informazioni sullo stato delle dimensioni della finestra restituite dall'evento Window.SizeChanged . |
| WindowVisibilityChangedEventArgs |
Contiene le informazioni sullo stato di visibilità della finestra restituite dall'evento Window.VisibilityChanged . |
| XamlIsland |
Definisce un oggetto che consente a un'applicazione di ospitare frammenti di contenuto XAML. |
| XamlResourceReferenceFailedEventArgs |
Fornisce i dati dell'evento |
| XamlRoot |
Rappresenta un albero di contenuto XAML e informazioni sul contesto in cui è ospitato. |
| XamlRootChangedEventArgs |
Fornisce dati per l'evento XamlRoot.Changed. |
Struct
| Nome | Descrizione |
|---|---|
| CornerRadius |
Descrive le caratteristiche di un angolo arrotondato, ad esempio può essere applicato a un bordo. |
| Duration |
Rappresenta la durata di tempo in cui una sequenza temporale è attiva o più in genere rappresenta una durata di tempo che supporta anche due valori |
| GridLength |
Rappresenta una misura per la logica di controllo che supporta in modo esplicito il ridimensionamento star (*) e il ridimensionamento automatico . |
| Thickness |
Descrive lo spessore di una cornice attorno a un rettangolo. Quattro valori Double descrivono rispettivamente i lati Left, Top, Right e Bottom del rettangolo. |
Interfacce
| Nome | Descrizione |
|---|---|
| IDataTemplateExtension |
Definisce i metodi helper per il rendering in più fasi di un modello di dati. |
| IElementFactory |
Supporta la creazione e il riciclo di oggetti UIElement . |
| IXamlServiceProvider |
Definisce un meccanismo per il recupero di un oggetto servizio; ovvero un oggetto che fornisce supporto personalizzato ad altri oggetti. |
Enumerazioni
| Nome | Descrizione |
|---|---|
| ApplicationHighContrastAdjustment |
Definisce le costanti che specificano se il framework regola automaticamente le proprietà visive per l'app quando i temi a contrasto elevato sono abilitati. |
| ApplicationRequiresPointerMode |
Important Non usare. ApplicationRequiresPointerMode non è supportato nella SDK per app di Windows. Specifica le esperienze di interazione per dispositivi non puntatori, ad esempio una tastiera o un controller di gioco. |
| ApplicationTheme |
Dichiara la preferenza del tema per un'app. |
| AutomationTextAttributesEnum |
Definisce costanti che identificano gli attributi di testo di un intervallo di testo Microsoft Automazione interfaccia utente. |
| DispatcherShutdownMode |
Definisce le costanti che specificano la modalità di arresto di un'applicazione. |
| DurationType |
Dichiara se un valore speciale di Duration è Automatic o Forever o contiene informazioni valide nel relativo |
| ElementHighContrastAdjustment |
Definisce le costanti che specificano se il framework regola automaticamente le proprietà visive per un elemento quando sono abilitati i temi a contrasto elevato. |
| ElementSoundKind |
Definisce le costanti che specificano il suono riprodotto dal metodo ElementSoundPlayer.Play . |
| ElementSoundMode |
Definisce le costanti che specificano la preferenza di un controllo per determinare se i suoni vengono riprodotti. |
| ElementSoundPlayerState |
Definisce costanti che specificano se i controlli XAML riproducono suoni. |
| ElementSpatialAudioMode |
Definisce costanti che indicano se il suono spaziale è attivato, disattivato o gestito automaticamente. |
| ElementTheme |
Specifica un tema dell'interfaccia utente che deve essere usato per singole parti UIElement di un'interfaccia utente dell'app. |
| FlowDirection |
Definisce costanti che specificano la direzione del flusso del contenuto per gli elementi di testo e interfaccia utente. |
| FocusState |
Descrive come un elemento ha ottenuto lo stato attivo. |
| FocusVisualKind |
Specifica il feedback visivo usato per indicare l'elemento dell'interfaccia utente con lo stato attivo durante lo spostamento con una tastiera o un controller di gioco. |
| FontCapitals |
Descrive il valore dello stile della lettera maiuscola per la proprietà associata Typography.Capitals . |
| FontEastAsianLanguage |
Fornisce un meccanismo per la selezione di versioni specifiche del tipo di carattere dei glifi per un sistema o una lingua di scrittura per l'Asia orientale specificata. |
| FontEastAsianWidths |
Fornisce un meccanismo per la selezione di glifi di stili di larghezza diversi. |
| FontFraction |
Descrive un valore di stile frazionaria per la proprietà associata Typography.Fraction . |
| FontNumeralAlignment |
Descrive il valore di allineamento numerale per la proprietà associata Typography.NumeralAlignment . |
| FontNumeralStyle |
Descrive un valore di stile numerale per la proprietà associata Typography.NumeralStyle . |
| FontVariants |
Descrive un valore variant del tipo di carattere per la proprietà associata Typography.Variants . |
| GridUnitType |
Descrive il tipo di valore che un oggetto GridLength contiene. |
| HorizontalAlignment |
Indica dove deve essere visualizzato un elemento sull'asse orizzontale rispetto allo slot di layout allocato dell'elemento padre. |
| LayoutCycleDebugBreakLevel |
Definisce costanti che specificano il livello di eventi di traccia del ciclo di layout che devono attivare un punto di interruzione del debugger quando viene visualizzato un arresto anomalo del ciclo di layout imminente. |
| LayoutCycleTracingLevel |
Definisce le costanti che specificano se le informazioni di traccia del ciclo di layout vengono scritte nel debugger nativo e il livello di dettaglio registrato. |
| LineStackingStrategy |
Descrive il meccanismo in base al quale viene determinata una casella di riga per ogni riga. |
| OpticalMarginAlignment |
Specifica il modo in cui i valori con orientamento laterale nella tipografia per carattere vengono gestiti quando si allineano a un limite del contenitore di testo. |
| TextAlignment |
Specifica se il testo è allineato al centro, allineato a sinistra o allineato a destra. |
| TextLineBounds |
Influenza il modo in cui viene calcolata l'altezza di una casella di linea |
| TextReadingOrder |
Fornisce un valore per |
| TextTrimming |
Descrive il modo in cui il testo viene tagliato quando supera il bordo della casella contenitore. |
| TextWrapping |
Specifica se il testo viene disposto quando raggiunge il bordo del contenitore. |
| Vector3TransitionComponents |
Definisce le costanti che specificano quali assi animare durante l'animazione Vector3Transition. |
| VerticalAlignment |
Descrive il modo in cui un elemento figlio viene posizionato verticalmente o esteso all'interno dello slot di layout di un padre. |
| Visibility |
Specifica lo stato di visualizzazione di un elemento. |
| WindowActivationState |
Specifica i motivi per cui un evento Activated deve essere generato in una finestra. |
Delegati
| Nome | Descrizione |
|---|---|
| ApplicationInitializationCallback |
Rappresenta il callback che deve essere richiamato durante la sequenza di inizializzazione. |
| BindingFailedEventHandler |
Rappresenta il metodo che gestirà l'evento DebugSettings.BindingFailed . |
| CreateDefaultValueCallback |
Rappresenta il metodo che può essere richiamato come parte di un costruttore PropertyMetadata per rinviare la definizione di un valore predefinito della proprietà di dipendenza. |
| DependencyPropertyChangedCallback |
Rappresenta il callback richiamato quando viene modificato un valore della proprietà, per le notifiche di modifica delle proprietà registrate con la tecnica RegisterPropertyChangedCallback . |
| DependencyPropertyChangedEventHandler |
Rappresenta il metodo che gestirà gli eventi che si verificano quando un oggetto DependencyProperty viene modificato in una particolare implementazione dependencyObject . |
| DragEventHandler |
Rappresenta il metodo che gestirà gli eventi DragEnter, DragLeave, DragOver e Drop di un oggetto UIElement. |
| EnteredBackgroundEventHandler |
Gestore per l'evento Application.EnteredBackground. |
| ExceptionRoutedEventHandler |
Rappresenta il metodo che gestirà determinati eventi che segnalano eccezioni. Queste eccezioni provengono in genere da operazioni asincrone. |
| LeavingBackgroundEventHandler |
Gestore per l'evento Application.LeavingBackground. |
| PropertyChangedCallback |
Rappresenta il callback richiamato quando viene modificato il valore effettivo della proprietà di una proprietà di dipendenza. |
| RoutedEventHandler |
Rappresenta il metodo che gestirà gli eventi indirizzati. |
| SizeChangedEventHandler |
Rappresenta il metodo che gestirà l'evento SizeChanged . |
| SuspendingEventHandler |
Gestore per l'evento Application.Suspending. |
| UnhandledExceptionEventHandler |
Rappresenta il metodo che gestirà l'evento UnhandledException . |
| VisualStateChangedEventHandler |
Rappresenta il metodo che gestirà gli eventi CurrentStateChanging e CurrentStateChanged . |
Esempio
L'app Raccolta WinUI 3 include esempi interattivi della maggior parte dei controlli e delle funzionalità di WinUI 3. Ottenere l'app dal Microsoft Store o ottenere il codice sorgente in GitHub.