CommandBarFlyout Classe

Definizione

Spazio dei nomi:

Windows.UI.Xaml.Controls

Rappresenta un riquadro a comparsa specializzato che fornisce il layout per AppBarButton e gli elementi di comando correlati.

API WinUI 2 equivalente per UWP: Microsoft.UI.Xaml.Controls.CommandBarFlyout (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 458752)]
/// [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")]
class CommandBarFlyout : FlyoutBase

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 458752)]
[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")]
public class CommandBarFlyout : FlyoutBase

Public Class CommandBarFlyout
Inherits FlyoutBase

<CommandBarFlyout .../>
-or-
<CommandBarFlyout>
  commandBarElements
</CommandBarFlyout>

Ereditarietà

Object IInspectable DependencyObject FlyoutBase CommandBarFlyout

Derivato

Windows.UI.Xaml.Controls.TextCommandBarFlyout

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10, version 1809 (è stato introdotto in 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v7.0)

Esempio

Suggerimento

Per altre info, linee guida per la progettazione ed esempi di codice, vedi Riquadro a comparsa della barra dei comandi.

Se è installata l'app WinUI 2 Gallery , fai clic qui per aprire l'app e vedere CommandBarFlyout in azione.

• Ottenere l'app Raccolta WinUI 2 (Microsoft Store)
• Ottieni il codice sorgente (GitHub)

Commenti

Stile di controllo e modello

È 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 Applicazione di stili ai controlli. Lo stile predefinito, il modello e le risorse che definiscono l'aspetto del controllo sono inclusi nel generic.xaml file. Ai fini della progettazione, generic.xaml è disponibile in locale con l'installazione dell'SDK o del pacchetto NuGet.

• *Stili WinUI (scelta consigliata): Usare Microsoft.UI.Xaml.Controls.CommandBarFlyout.
• Stili non WinUI: Per gli stili predefiniti, vedere %ProgramFiles(x86)%\Windows Kits\10\DesignTime\CommonConfiguration\Neutral\UAP\<SDK version>\Generic\generic.xaml.

I percorsi potrebbero essere diversi se l'installazione è stata personalizzata. 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 . Le risorse di stili leggeri sono disponibili a partire da Windows 10 versione 1607 (SDK 14393).

Costruttori

CommandBarFlyout()

Inizializza una nuova istanza della classe CommandBarFlyout . API WinUI 2 equivalente per UWP: Microsoft.UI.Xaml.Controls.CommandBarFlyout.-ctor (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).

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)
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	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)
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. (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 della luce 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. API WinUI 2 equivalente per UWP: Microsoft.UI.Xaml.Controls.CommandBarFlyout.PrimaryCommands (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).
SecondaryCommands	Ottiene la raccolta di elementi di comando secondari per CommandBarFlyout. API WinUI 2 equivalente per UWP: Microsoft.UI.Xaml.Controls.CommandBarFlyout.SecondaryCommands (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).
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 viene visualizzato. (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

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 apportate a una dipendenza specifica in questa istanza di DependencyObject . (Ereditato da DependencyObject)
SetValue(DependencyProperty, Object)	Imposta il valore locale di una proprietà di dipendenza su 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 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)