ContentDialog.DefaultButton Свойство

  • Ссылка

Определение

Пространство имен:
Windows.UI.Xaml.Controls
Изменить

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

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

void DefaultButton(ContentDialogButton value);
public ContentDialogButton DefaultButton { get; set; }
var contentDialogButton = contentDialog.defaultButton;
contentDialog.defaultButton = contentDialogButton;
Public Property DefaultButton As ContentDialogButton

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

ContentDialogButton

Значение перечисления. Значение по умолчанию — Нет.

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

Семейство устройств
Windows 10 Creators Update (появилось в 10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v4.0)

Комментарии

При необходимости можно выделить одну из трех кнопок в качестве кнопки по умолчанию. Если задать кнопку по умолчанию, то происходит следующее.

  • Кнопка оформляется как кнопка подтверждения действия.
  • Кнопка будет автоматически реагировать на нажатие клавиши "ВВОД".
    • Когда пользователь нажимает клавишу ВВОД на клавиатуре, срабатывает обработчик щелчков, связанный с кнопкой по умолчанию, и ContentDialogResult вернет значение, связанное с кнопкой по умолчанию.
    • Если пользователь переместил фокус на элемент управления, обрабатывающий ввод, кнопка по умолчанию не будет отвечать на нажатия ВВОД.
  • Кнопка будет автоматически получать фокус при открытии диалогового окна, если содержимое диалога не содержит фокусируемый пользовательский интерфейс

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

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

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

<ContentDialog x:Name="contentDialog1" Loaded="ContentDialog_Loaded">
    ...
</ContentDialog>

private void ContentDialog_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.ContentDialog", "DefaultButton"))
    {
        contentDialog1.DefaultButton = ContentDialogButton.Primary;
    }
}

Применяется к