CommandBarFlyout Clase

Definición

Espacio de nombres:

Windows.UI.Xaml.Controls

Representa un control flotante especializado que proporciona diseño para AppBarButton y elementos de comandos relacionados.

API de WinUI 2 equivalente para UWP: Microsoft.UI.Xaml.Controls.CommandBarFlyout (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para 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>

Herencia

Object IInspectable DependencyObject FlyoutBase CommandBarFlyout

Derivado

Windows.UI.Xaml.Controls.TextCommandBarFlyout

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10, version 1809 (se introdujo en la versión 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v7.0)

Ejemplos

Sugerencia

Para obtener más información, instrucciones de diseño y ejemplos de código, consulta Control flotante de la barra de comandos.

Si tiene instalada la aplicación WinUI 2 Gallery , haga clic aquí para abrir la aplicación y ver CommandBarFlyout en acción.

• Obtenga la aplicación WinUI 2 Gallery (Microsoft Store)
• Obtener el código fuente (GitHub)

Comentarios

Estilo de control y plantilla

Puede modificar el Estilo predeterminado y ControlTemplate para dar al control una apariencia única. Para obtener información sobre cómo modificar el estilo y la plantilla de un control, vea Aplicar estilos a los controles. El estilo, la plantilla y los recursos predeterminados que definen la apariencia del control se incluyen en el generic.xaml archivo . Para fines de diseño, generic.xaml está disponible localmente con el SDK o la instalación del paquete NuGet.

• * Estilos de WinUI (recomendado): Use Microsoft.UI.Xaml.Controls.CommandBarFlyout.
• Estilos que no son de WinUI: Para obtener estilos integrados, vea %ProgramFiles(x86)%\Windows Kits\10\DesignTime\CommonConfiguration\Neutral\UAP\<SDK version>\Generic\generic.xaml.

Las ubicaciones pueden ser diferentes si personaliza la instalación. Los estilos y recursos de diferentes versiones del SDK pueden tener valores diferentes.

XAML también incluye recursos que puedes usar para modificar los colores de un control en distintos estados visuales sin modificar la plantilla de control. Se prefiere modificar estos recursos para establecer propiedades como Fondo y Primer plano. Para obtener más información, consulta la sección Estilo ligero del artículo Estilos XAML . Los recursos de estilo ligero están disponibles a partir de Windows 10, versión 1607 (SDK 14393).

Constructores

CommandBarFlyout()

Inicializa una nueva instancia de la clase CommandBarFlyout . API de WinUI 2 equivalente para UWP: Microsoft.UI.Xaml.Controls.CommandBarFlyout.-ctor (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

Propiedades

AllowFocusOnInteraction	Obtiene o establece un valor que indica si el elemento obtiene automáticamente el foco cuando el usuario interactúa con él. (Heredado de FlyoutBase)
AllowFocusWhenDisabled	Obtiene o establece un valor que especifica si el control puede recibir el foco cuando está deshabilitado. (Heredado de FlyoutBase)
AreOpenCloseAnimationsEnabled	Obtiene o establece un valor que indica si las animaciones se reproducen cuando se abre o cierra el control flotante. (Heredado de FlyoutBase)
Dispatcher	Obtiene el CoreDispatcher al que está asociado este objeto. CoreDispatcher representa una instalación que puede acceder a DependencyObject en el subproceso de la interfaz de usuario, incluso si un subproceso que no es de interfaz de usuario inicia el código. (Heredado de DependencyObject)
ElementSoundMode	Obtiene o establece un valor que especifica la preferencia del control para si reproduce sonidos. (Heredado de FlyoutBase)
InputDevicePrefersPrimaryCommands	Obtiene un valor que indica si el dispositivo de entrada usado para abrir el control flotante no abre fácilmente los comandos secundarios. (Heredado de FlyoutBase)
IsConstrainedToRootBounds	Obtiene un valor que indica si el control flotante se muestra dentro de los límites de la raíz XAML. (Heredado de FlyoutBase)
IsOpen	Obtiene un valor que indica si el control flotante está abierto. (Heredado de FlyoutBase)
LightDismissOverlayMode	Obtiene o establece un valor que especifica si el área fuera de una interfaz de usuario de cierre de luz se oscurece. (Heredado de FlyoutBase)
OverlayInputPassThroughElement	Obtiene o establece un elemento que debe recibir eventos de entrada de puntero incluso cuando se encuentra debajo de la superposición del control flotante. (Heredado de FlyoutBase)
Placement	Obtiene o establece la ubicación predeterminada que se va a usar para el control flotante, en relación con su destino de selección de ubicación. (Heredado de FlyoutBase)
PrimaryCommands	Obtiene la colección de elementos de comando principal para CommandBarFlyout. API de WinUI 2 equivalente para UWP: Microsoft.UI.Xaml.Controls.CommandBarFlyout.PrimaryCommands (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
SecondaryCommands	Obtiene la colección de elementos de comando secundarios para CommandBarFlyout. API de WinUI 2 equivalente para UWP: Microsoft.UI.Xaml.Controls.CommandBarFlyout.SecondaryCommands (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
ShouldConstrainToRootBounds	Obtiene o establece un valor que indica si el control flotante debe mostrarse dentro de los límites de la raíz XAML. (Heredado de FlyoutBase)
ShowMode	Obtiene o establece un valor que indica cómo se comporta un control flotante cuando se muestra. (Heredado de FlyoutBase)
Target	Obtiene el elemento que se va a usar como destino de selección de ubicación del control flotante. (Heredado de FlyoutBase)
XamlRoot	Obtiene o establece el xamlRoot en el que se ve este control flotante. (Heredado de FlyoutBase)

Métodos

ClearValue(DependencyProperty)	Borra el valor local de una propiedad de dependencia. (Heredado de DependencyObject)
CreatePresenter()	Cuando se invalida en una clase derivada, inicializa un control para mostrar el contenido del control flotante según corresponda para el control derivado. Nota: Este método no tiene ninguna implementación de clase base y debe reemplazarse en una clase derivada. (Heredado de FlyoutBase)
GetAnimationBaseValue(DependencyProperty)	Devuelve cualquier valor base establecido para una propiedad de dependencia, que se aplicaría en los casos en los que una animación no está activa. (Heredado de DependencyObject)
GetValue(DependencyProperty)	Devuelve el valor efectivo actual de una propiedad de dependencia de dependencyObject. (Heredado de DependencyObject)
Hide()	Cierra el control flotante. (Heredado de FlyoutBase)
OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs)	Se llama justo antes de que se procese un método abreviado de teclado (acelerador) en la aplicación. Se invoca cada vez que el código de aplicación o los procesos internos llaman a ProcessKeyboardAccelerators. Invalide este método para influir en el control del acelerador predeterminado. (Heredado de FlyoutBase)
ReadLocalValue(DependencyProperty)	Devuelve el valor local de una propiedad de dependencia, si se establece un valor local. (Heredado de DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registra una función de notificación para escuchar los cambios en una dependencyProperty específica en esta instancia de DependencyObject . (Heredado de DependencyObject)
SetValue(DependencyProperty, Object)	Establece el valor local de una propiedad de dependencia en dependencyObject. (Heredado de DependencyObject)
ShowAt(DependencyObject, FlyoutShowOptions)	Muestra el control flotante colocado en relación con el elemento especificado mediante las opciones especificadas. (Heredado de FlyoutBase)
ShowAt(FrameworkElement)	Muestra el control flotante colocado en relación con el elemento especificado. (Heredado de FlyoutBase)
TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs)	Intenta invocar un método abreviado de teclado (acelerador). (Heredado de FlyoutBase)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Cancela una notificación de cambio registrada anteriormente mediante una llamada a RegisterPropertyChangedCallback. (Heredado de DependencyObject)

Eventos

Closed	Se produce cuando el control flotante está oculto. (Heredado de FlyoutBase)
Closing	Se produce cuando el control flotante comienza a ocultarse. (Heredado de FlyoutBase)
Opened	Se produce cuando se muestra el control flotante. (Heredado de FlyoutBase)
Opening	Se produce antes de que se muestre el control flotante. (Heredado de FlyoutBase)