CommandBarFlyout 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.
Rappresenta un riquadro a comparsa specializzato che fornisce il layout per AppBarButton, AppBarToggleButton e AppBarSeparator.
/// [Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=7)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Version(1)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="PrimaryCommands")]
class CommandBarFlyout : FlyoutBase
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="PrimaryCommands")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class CommandBarFlyout : FlyoutBase
[Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=7)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Version(1)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="PrimaryCommands")]
public class CommandBarFlyout : FlyoutBase
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="PrimaryCommands")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public class CommandBarFlyout : FlyoutBase
Public Class CommandBarFlyout
Inherits FlyoutBase
<CommandBarFlyout .../>
-or-
<CommandBarFlyout>
commandBarElements
</CommandBarFlyout>
- Ereditarietà
- Derivato
- Attributi
-
Microsoft.UI.Xaml.CustomAttributes.MUXContractPropertyAttribute MarshalingBehaviorAttribute ThreadingAttribute VersionAttribute ContentPropertyAttribute ContractVersionAttribute
Esempio
Tip
Per altre info, linee guida per la progettazione ed esempi di codice, vedi riquadro a comparsa della barra dei comandi.
L'app Raccolta WinUI 3 include esempi interattivi della maggior parte dei controlli e delle funzionalità di WinUI 3. Scaricare l'app da Microsoft Store od ottenere il codice sorgente su GitHub
Commenti
È possibile aggiungere altri controlli a un oggetto CommandBarFlyout eseguendo il wrapping in un oggetto AppBarElementContainer. Sono inclusi controlli come DropDownButton o SplitButton o contenitori come StackPanel per un'interfaccia utente più complessa.
Stile e modello di controllo
È possibile modificare lo stile predefinito e controlTemplate per assegnare al controllo un aspetto univoco. Per informazioni sulla modifica dello stile e del modello di un controllo, vedi Stili XAML. Lo stile predefinito, il modello e le risorse che definiscono l'aspetto del controllo vengono inclusi nel generic.xaml file. Ai fini della progettazione, generic.xaml viene installato con il pacchetto NuGet SDK per app di Windows. Per impostazione predefinita, il percorso è \Users\<username>\.nuget\packages\microsoft.windowsappsdk\<version>\lib\uap10.0\Microsoft.UI\Themes\generic.xaml. Gli stili e le risorse di versioni diverse dell'SDK potrebbero avere valori diversi.
XAML include anche risorse che è possibile usare per modificare i colori di un controllo in stati di visualizzazione diversi senza modificare il modello di controllo. La modifica di queste risorse è preferibile per impostare proprietà come Background e Foreground. Per altre info, vedi la sezione Stili leggeri dell'articolo Stili XAML .
Costruttori
| Nome | Descrizione |
|---|---|
| CommandBarFlyout() |
Inizializza una nuova istanza della classe CommandBarFlyout . |
Proprietà
| Nome | Descrizione |
|---|---|
| AllowFocusOnInteraction |
Ottiene o imposta un valore che indica se l'elemento ottiene automaticamente lo stato attivo quando l'utente interagisce con esso. (Ereditato da FlyoutBase) |
| AllowFocusWhenDisabled |
Ottiene o imposta un valore che specifica se il controllo può ricevere lo stato attivo quando è disabilitato. (Ereditato da FlyoutBase) |
| AlwaysExpanded |
Ottiene o imposta un valore che indica se CommandBarFlyout deve sempre rimanere nello stato Espanso e impedire all'utente di entrare nello stato Compresso. Il valore predefinito è falso. |
| AreOpenCloseAnimationsEnabled |
Ottiene o imposta un valore che indica se le animazioni vengono riprodotte quando il riquadro a comparsa viene aperto o chiuso. (Ereditato da FlyoutBase) |
| Dispatcher |
Restituisce |
| DispatcherQueue |
Ottiene l'oggetto |
| ElementSoundMode |
Ottiene o imposta un valore che specifica la preferenza del controllo per la riproduzione di suoni. (Ereditato da FlyoutBase) |
| InputDevicePrefersPrimaryCommands |
Ottiene un valore che indica se il dispositivo di input utilizzato per aprire il riquadro a comparsa non apre facilmente i comandi secondari. (Ereditato da FlyoutBase) |
| IsConstrainedToRootBounds |
Ottiene un valore che indica se il riquadro a comparsa viene visualizzato all'interno dei limiti della radice XAML. Questa proprietà è sempre true per le app SDK per app di Windows. (Ereditato da FlyoutBase) |
| IsOpen |
Ottiene un valore che indica se il riquadro a comparsa è aperto. (Ereditato da FlyoutBase) |
| LightDismissOverlayMode |
Ottiene o imposta un valore che specifica se l'area esterna a un'interfaccia utente di chiusura chiara viene oscurata. (Ereditato da FlyoutBase) |
| OverlayInputPassThroughElement |
Ottiene o imposta un elemento che deve ricevere eventi di input del puntatore anche quando si trova sotto la sovrimpressione del riquadro a comparsa. (Ereditato da FlyoutBase) |
| Placement |
Ottiene o imposta il posizionamento predefinito da utilizzare per il riquadro a comparsa, in relazione alla destinazione di posizionamento. (Ereditato da FlyoutBase) |
| PrimaryCommands |
Ottiene la raccolta di elementi di comando primari per CommandBarFlyout. |
| SecondaryCommands |
Ottiene la raccolta di elementi di comando secondari per CommandBarFlyout. |
| ShouldConstrainToRootBounds |
Ottiene o imposta un valore che indica se il riquadro a comparsa deve essere visualizzato entro i limiti della radice XAML. (Ereditato da FlyoutBase) |
| ShowMode |
Ottiene o imposta un valore che indica il comportamento di un riquadro a comparsa quando viene visualizzato. (Ereditato da FlyoutBase) |
| SystemBackdrop |
Ottiene o imposta lo sfondo del sistema da applicare a questo riquadro a comparsa. Il rendering dello sfondo viene eseguito dietro il contenuto del riquadro a comparsa. (Ereditato da FlyoutBase) |
| Target |
Ottiene l'elemento da utilizzare come destinazione di posizionamento del riquadro a comparsa. (Ereditato da FlyoutBase) |
| XamlRoot |
Ottiene o imposta l'oggetto XamlRoot in cui viene visualizzato questo riquadro a comparsa. (Ereditato da FlyoutBase) |
Metodi
| Nome | Descrizione |
|---|---|
| ClearValue(DependencyProperty) |
Cancella il valore locale di una proprietà di dipendenza. (Ereditato da DependencyObject) |
| CreatePresenter() |
Quando ne viene eseguito l'override in una classe derivata, inizializza un controllo per visualizzare il contenuto del riquadro a comparsa come appropriato per il controllo derivato. Nota: questo metodo non ha implementazione della classe di base e deve essere sottoposto a override in una classe derivata. (Ereditato da FlyoutBase) |
| 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) |
| GetValue(DependencyProperty) |
Restituisce il valore effettivo corrente di una proprietà di dipendenza da dependencyObject. (Ereditato da DependencyObject) |
| Hide() |
Chiude il riquadro a comparsa. (Ereditato da FlyoutBase) |
| OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs) |
Chiamato subito prima dell'elaborazione di un tasto di scelta rapida (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 FlyoutBase) |
| 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 a una dipendenza specifica in questa istanza dependencyObject . (Ereditato da DependencyObject) |
| SetValue(DependencyProperty, Object) |
Imposta il valore locale di una proprietà di dipendenza in un Oggetto DependencyObject. (Ereditato da DependencyObject) |
| ShowAt(DependencyObject, FlyoutShowOptions) |
Mostra il riquadro a comparsa posizionato in relazione all'elemento specificato utilizzando le opzioni specificate. (Ereditato da FlyoutBase) |
| ShowAt(FrameworkElement) |
Mostra il riquadro a comparsa posizionato in relazione all'elemento specificato. (Ereditato da FlyoutBase) |
| TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs) |
Tenta di richiamare un tasto di scelta rapida (acceleratore). (Ereditato da FlyoutBase) |
| UnregisterPropertyChangedCallback(DependencyProperty, Int64) |
Annulla una notifica di modifica registrata in precedenza chiamando RegisterPropertyChangedCallback. (Ereditato da DependencyObject) |
Eventi
| Nome | Descrizione |
|---|---|
| Closed |
Si verifica quando il riquadro a comparsa è nascosto. (Ereditato da FlyoutBase) |
| Closing |
Si verifica quando il riquadro a comparsa inizia a essere nascosto. (Ereditato da FlyoutBase) |
| Opened |
Si verifica quando viene visualizzato il riquadro a comparsa. (Ereditato da FlyoutBase) |
| Opening |
Si verifica prima che venga visualizzato il riquadro a comparsa. (Ereditato da FlyoutBase) |