Compartir a través de


AppBar.LightDismissOverlayMode Propiedad

Definición

Obtiene o establece un valor que especifica si el área fuera de una interfaz de usuario de cierre de luz se oscurece.

public:
 property LightDismissOverlayMode LightDismissOverlayMode { LightDismissOverlayMode get(); void set(LightDismissOverlayMode value); };
LightDismissOverlayMode LightDismissOverlayMode();

void LightDismissOverlayMode(LightDismissOverlayMode value);
public LightDismissOverlayMode LightDismissOverlayMode { get; set; }
var lightDismissOverlayMode = appBar.lightDismissOverlayMode;
appBar.lightDismissOverlayMode = lightDismissOverlayMode;
Public Property LightDismissOverlayMode As LightDismissOverlayMode
<appBar LightDismissOverlayMode="lightDismissOverlayModeMemberName" />

Valor de propiedad

Valor de la enumeración que especifica si el área fuera de una interfaz de usuario de cierre de luz se oscurece. El valor predeterminado es Automático.

Requisitos de Windows

Familia de dispositivos
Windows 10 Anniversary Edition (se introdujo en la versión 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v3.0)

Comentarios

La interfaz de usuario transitoria, como un menú MenuFlyout o secundario en una barra de comandos, se cierra al hacer clic o pulsar fuera de él. Esto se denomina cierre de luz. "Superposición" hace referencia al área fuera de una interfaz de usuario de cierre de luz.

De forma predeterminada, la "superposición" se oscurece en xbox y no se oscurece en otras familias de dispositivos. Puedes establecer LightDismissOverlayMode en Activado para que tu aplicación oscurezca el área de "superposición" en todas las familias de dispositivos o establézcalo en Desactivado para que no oscurezca el área de "superposición" en todas las familias de dispositivos.

Compatibilidad de versiones

La propiedad LightDismissOverlayMode no está disponible antes de Windows 10, versión 1607. Si la configuración "versión mínima de la plataforma" de la aplicación en Microsoft Visual Studio es menor que la "versión introducida" que se muestra en el bloque Requisitos más adelante en esta página, debe diseñar y probar la aplicación para que tenga en cuenta esto. Para obtener más información, consulta Código adaptable de versión.

Para evitar excepciones cuando la aplicación se ejecute en versiones anteriores de Windows 10, no establezca esta propiedad en XAML ni úsela sin realizar una comprobación en tiempo de ejecución. En este ejemplo se muestra cómo usar la clase ApiInformation para comprobar la presencia de esta propiedad antes de establecerla.

<CommandBar x:Name="commandBar1" Loaded="CommandBar_Loaded"/>
private void CommandBar_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.AppBar", "LightDismissOverlayMode"))
    {
        commandBar1.LightDismissOverlayMode = LightDismissOverlayMode.On;
    }
}

Se aplica a