ComboBox.LightDismissOverlayMode Свойство

Определение

Пространство имен:

Windows.UI.Xaml.Controls

Возвращает или задает значение, указывающее, затенена ли область за пределами пользовательского интерфейса со светлым закрытием .

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

LightDismissOverlayMode LightDismissOverlayMode();

void LightDismissOverlayMode(LightDismissOverlayMode value);

public LightDismissOverlayMode LightDismissOverlayMode { get; set; }

var lightDismissOverlayMode = comboBox.lightDismissOverlayMode;
comboBox.lightDismissOverlayMode = lightDismissOverlayMode;

Public Property LightDismissOverlayMode As LightDismissOverlayMode

Значение свойства

LightDismissOverlayMode

Значение перечисления , указывающее, затенена ли область за пределами закрываемого пользовательского интерфейса. Значение по умолчанию — Auto.

Требования к Windows

Семейство устройств	Windows 10 Anniversary Edition (появилось в 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v3.0)

Комментарии

Временный пользовательский интерфейс, например открытый раскрывающийся список ComboBox, закрывается при щелчке или касании за его пределами. Это называется светлым закрытием. "Наложение" относится к области за пределами пользовательского интерфейса со светлым закрытием.

По умолчанию "наложение" затемнено на Xbox, а не затемнение на других семействах устройств. Вы можете установить для параметра LightDismissOverlayMode значение Вкл. , чтобы сделать приложение темным область наложения на всех семействах устройств, или установить для него значение Выкл ., чтобы не затемнение области наложения на всех семействах устройств.

Совместимость версий

Свойство LightDismissOverlayMode недоступно до Windows 10 версии 1607. Если параметр "минимальная версия платформы" вашего приложения в Microsoft Visual Studio меньше значения "введенной версии", показанной в блоке "Требования" далее на этой странице, необходимо разработать и протестировать приложение, чтобы учесть это. Дополнительные сведения см. в разделе Адаптивный к версии код.

Чтобы избежать исключений при запуске приложения в предыдущих версиях Windows 10, не устанавливайте это свойство в XAML и не используйте его без выполнения проверка среды выполнения. В этом примере показано, как использовать класс ApiInformation для проверка наличия этого свойства перед его настройкой.

 private void MainPage_Loaded(object sender, RoutedEventArgs e)
 {
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.ComboBox", "LightDismissOverlayMode"))
    {
        comboBox1.LightDismissOverlayMode = LightDismissOverlayMode.On;
    }
}