Condividi tramite


CommandBarFlyout Classe

Definizione

Rappresenta un riquadro a comparsa specializzato che fornisce il layout per i controlli 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à
Object IInspectable DependencyObject FlyoutBase CommandBarFlyout
Derivato
Attributi

Esempio

Suggerimento

Per altre informazioni, indicazioni sulla progettazione ed esempi di codice, vedere riquadro a comparsa della barra dei comandi.

L'app WinUI 3 Gallery 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

Commenti

È possibile aggiungere altri controlli a un CommandBarFlyout eseguendo il wrapping in un AppBarElementContainer. Include 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, vedere Stili XAML. Lo stile predefinito, il modello e le risorse che definiscono l'aspetto del controllo sono inclusi nel generic.xaml file. A scopo di 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 provenienti da versioni diverse dell'SDK potrebbero avere valori diversi.

XAML include anche risorse che è possibile usare per modificare i colori di un controllo in diversi stati visivi senza modificare il modello di controllo. La modifica di queste risorse è preferibile impostare le proprietà, ad esempio Background e Foreground. Per altre informazioni, vedere la sezione Stile a peso leggero dell'articolo stili XAML .

Costruttori

CommandBarFlyout()

Inizializza una nuova istanza della classe CommandBarFlyout .

Proprietà

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 immettere lo stato Compresso. Il valore predefinito è false.

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 null sempre in un'app SDK per app di Windows. Usare invece DispatcherQueue .

(Ereditato da DependencyObject)
DispatcherQueue

Ottiene l'oggetto DispatcherQueue associato. Rappresenta DispatcherQueue una struttura che può accedere al thread dell'interfaccia utente anche se il codice viene avviato da un thread non dell'interfaccia DependencyObject utente.

(Ereditato da DependencyObject)
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 usato 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 di 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 sotto la sovrapposizione del riquadro a comparsa.

(Ereditato da FlyoutBase)
Placement

Ottiene o imposta il posizionamento predefinito da usare 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 all'interno dei limiti della radice XAML.

(Ereditato da FlyoutBase)
ShowMode

Ottiene o imposta un valore che indica il comportamento di un riquadro a comparsa quando visualizzato.

(Ereditato da FlyoutBase)
SystemBackdrop

Ottiene o imposta lo sfondo del sistema da applicare a questo riquadro a comparsa. Lo sfondo viene eseguito il rendering dietro il contenuto del riquadro a comparsa.

(Ereditato da FlyoutBase)
Target

Ottiene l'elemento da usare come destinazione di posizionamento del riquadro a comparsa.

(Ereditato da FlyoutBase)
XamlRoot

Ottiene o imposta XamlRoot in cui viene visualizzato questo riquadro a comparsa.

(Ereditato da FlyoutBase)

Metodi

ClearValue(DependencyProperty)

Cancella il valore locale di una proprietà di dipendenza.

(Ereditato da DependencyObject)
CreatePresenter()

Quando sottoposto a 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 alcuna 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 un oggetto DependencyObject.

(Ereditato da DependencyObject)
Hide()

Chiude il riquadro a comparsa.

(Ereditato da FlyoutBase)
OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs)

Chiamato appena prima che venga elaborata una scelta rapida da tastiera (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 viene impostato un valore locale.

(Ereditato da DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

Registra una funzione di notifica per l'ascolto delle modifiche a un'istanza di DependencyObject specifica.

(Ereditato da DependencyObject)
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 usando 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 una scelta rapida da tastiera (acceleratore).

(Ereditato da FlyoutBase)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

Annulla una notifica di modifica registrata in precedenza chiamando RegisterPropertyChangedCallback.

(Ereditato da DependencyObject)

Eventi

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)

Si applica a

Vedi anche