ThemeSettings Classe

Definição

Namespace:

Microsoft.UI.System

A API ThemeSettings permite que o Win32 Windows Runtime aplicativos detectem que a configuração de Alto Contraste do sistema foi alterada.

public ref class ThemeSettings sealed

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.WindowsAppSDKContract, 65540)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ThemeSettings final

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.WindowsAppSDKContract), 65540)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ThemeSettings

Public NotInheritable Class ThemeSettings

Herança

Object Platform::Object IInspectable ThemeSettings

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Exemplos

Neste código de exemplo, um aplicativo usa um objeto ThemeSettings para escutar alterações de alto contraste no sistema:

void MyApp::ListenForHighContrastChange(XamlRoot& xamlRoot) 
{
  const auto myWindowId = xamlRoot.ContentEnvironment().AppWindowId();
  m_themeSettings = ThemeSettings::CreateForWindowId(myWindowId);

  m_themeSettings.Changed([xamlRoot](const ThemeSettings& ts, const auto&) {
    if (ts.HighContrast())
    {
      ::OutputDebugString(L"High contrast is ON, scheme is: ");
      ::OutputDebugString(ts.HighContrastScheme().c_str());
    }
    else
    {
      ::OutputDebugString(L"High contrast is OFF.\n");
    }
  });
}

void MyApp.ListenForHighContrastChange(XamlRoot xamlRoot)
{
    var myWindowId = xamlRoot.ContentEnvironment().AppWindowId();
    m_themeSettings = ThemeSettings.CreateForWindowId(myWindowId);

    m_themeSettings.Changed += (ts, _) =>
    {
        if (ts.HighContrast())
        {
            Debug.WriteLine("High contrast is ON, scheme is: ");
            Debug.WriteLine(ts.HighContrastScheme());
        }
        else
        {
            Debug.WriteLine("High contrast is OFF.");
        }
    };
}

Comentários

Quando o aplicativo liberar todas as suas referências a um objeto ThemeSettings , o objeto será destruído e o evento Alterado não será mais acionado.

Propriedades

HighContrast	Obtém a configuração atual de Alto Contraste.
HighContrastScheme	O esquema ou estilo de Alto Contraste do sistema, se um for aplicado no momento.

Métodos

CreateForWindowId(WindowId)

Cria um objeto ThemeSettings que fornecerá informações de tema para o WindowId fornecido.

Eventos

Changed

Esse evento é gerado quando uma das propriedades do objeto ThemeSettings é alterada.

Confira também

• Changed