Поделиться через


ContentDialog Класс

Определение

Представляет диалоговое окно, которое можно настроить так, чтобы он содержал флажки, гиперссылки, кнопки и любое другое содержимое XAML.

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ContentDialog : ContentControl
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class ContentDialog : ContentControl
Public Class ContentDialog
Inherits ContentControl
<ContentDialog .../>
-or-
<ContentDialog>
    singleObject
</ContentDialog>
-or-
<ContentDialog>stringContent</ContentDialog>
Наследование
Атрибуты

Примеры

Совет

Дополнительные сведения, рекомендации по проектированию и примеры кода см. в разделе Элементы управления диалогом.

Приложение "Коллекция WinUI 3" содержит интерактивные примеры большинства элементов управления, функций и функций WinUI 3. Получите приложение из Microsoft Store или получите исходный код в GitHub.

В этом примере показано, как создать и отобразить простой ContentDialog в коде.

Важно!

В этом примере предполагается, что диалоговое окно отображается на странице. Сведения о том, как отобразить диалоговое окно из окна, см. в разделе Set the XamlRoot статьи Примечания.

private async void DisplayNoWifiDialog()
{
    ContentDialog noWifiDialog = new ContentDialog()
    {
        XamlRoot = this.XamlRoot,
        Title = "No wifi connection",
        Content = "Check connection and try again.",
        CloseButtonText = "Ok"
    };

    await noWifiDialog.ShowAsync();
}

В этом примере показано, как создать ContentDialog в XAML страницы приложения. Несмотря на то, что диалоговое окно определено на странице приложения, оно не отображается, пока вы не вызовете ShowAsync в коде.

Здесь свойству IsPrimaryButtonEnabled присвоено значение false. Основная кнопка включается в коде, когда пользователь проверяет CheckBox , чтобы подтвердить свой возраст.

Свойство TitleTemplate используется для создания заголовка, который содержит как логотип, так и текст.

<ContentDialog x:Name="termsOfUseContentDialog"
           PrimaryButtonText="Accept" IsPrimaryButtonEnabled="False"
           CloseButtonText="Cancel"
           Opened="TermsOfUseContentDialog_Opened">
    <ContentDialog.TitleTemplate>
        <DataTemplate>
            <StackPanel Orientation="Horizontal">
                <Image Source="ms-appx:///Assets/SmallLogo.png" Width="40" Height="40" Margin="10,0"/>
                <TextBlock Text="Terms of use"/>
            </StackPanel>
        </DataTemplate>
    </ContentDialog.TitleTemplate>
    <StackPanel>
        <TextBlock TextWrapping="WrapWholeWords">
        <Run>Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Maecenas porttitor
             congue massa. Fusce posuere, magna sed pulvinar ultricies, purus lectus
             malesuada libero, sit amet commodo magna eros quis urna.</Run><LineBreak/>
        <Run>Nunc viverra imperdiet enim. Fusce est. Vivamus a tellus.</Run><LineBreak/>
        <Run>Pellentesque habitant morbi tristique senectus et netus et malesuada fames
             ac turpis egestas. Proin pharetra nonummy pede. Mauris et orci.</Run><LineBreak/>
        <Run>Suspendisse dui purus, scelerisque at, vulputate vitae, pretium mattis, nunc.
             Mauris eget neque at sem venenatis eleifend. Ut nonummy.</Run>
        </TextBlock>
        <CheckBox x:Name="ConfirmAgeCheckBox" Content="I am over 13 years of age."
              Checked="ConfirmAgeCheckBox_Checked" Unchecked="ConfirmAgeCheckBox_Unchecked"/>
    </StackPanel>
</ContentDialog>
private async void ShowTermsOfUseContentDialogButton_Click(object sender, RoutedEventArgs e)
{
    termsOfUseContentDialog.XamlRoot = this.XamlRoot;
    ContentDialogResult result = await termsOfUseContentDialog.ShowAsync();
    if (result == ContentDialogResult.Primary)
    {
        // Terms of use were accepted.
    }
    else
    {
        // User pressed Cancel, ESC, or the back arrow.
        // Terms of use were not accepted.
    }
}

private void TermsOfUseContentDialog_Opened(ContentDialog sender, ContentDialogOpenedEventArgs args)
{
    // Ensure that the check box is unchecked each time the dialog opens.
    ConfirmAgeCheckBox.IsChecked = false;
}

private void ConfirmAgeCheckBox_Checked(object sender, RoutedEventArgs e)
{
    termsOfUseContentDialog.IsPrimaryButtonEnabled = true;
}

private void ConfirmAgeCheckBox_Unchecked(object sender, RoutedEventArgs e)
{
    termsOfUseContentDialog.IsPrimaryButtonEnabled = false;
}

В этом примере показано, как создать и использовать более сложный пользовательский диалог (SignInContentDialog), производный от ContentDialog. См. также раздел Производные элементы управления со стилями WinUI этой статьи.

<ContentDialog
    x:Class="ContentDialog_WinUI3.SignInContentDialog"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:local="using:ContentDialog_WinUI3"
    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
    mc:Ignorable="d"
    Title="SIGN IN"
    PrimaryButtonText="Sign In"  
    CloseButtonText="Cancel"
    PrimaryButtonClick="ContentDialog_PrimaryButtonClick"
    CloseButtonClick="ContentDialog_CloseButtonClick">

    <ContentDialog.Resources>
        <Style TargetType="local:SignInContentDialog" BasedOn="{StaticResource DefaultContentDialogStyle}"/>
    </ContentDialog.Resources>

    <StackPanel VerticalAlignment="Stretch" HorizontalAlignment="Stretch">
        <TextBox Name="userNameTextBox" Header="User name"
                 TextChanged="UserNameTextBox_TextChanged"/>
        <PasswordBox Name="passwordTextBox" Header="Password" IsPasswordRevealButtonEnabled="True"
                     PasswordChanged="PasswordTextBox_PasswordChanged"/>
        <CheckBox Name="saveUserNameCheckBox" Content="Save user name"/>
        <InfoBar x:Name="errorInfoBar" Severity="Error" IsOpen="False" IsClosable="False"/>

        <!-- Content body -->
        <TextBlock Name="body" Style="{StaticResource BodyTextBlockStyle}" TextWrapping="Wrap">
            <TextBlock.Text>
                Lorem ipsum dolor sit amet, consectetur adipisicing elit,
                    sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
            </TextBlock.Text>
        </TextBlock>
    </StackPanel>
</ContentDialog>
using Microsoft.UI.Xaml;
using Microsoft.UI.Xaml.Controls;
using System.Threading.Tasks;

namespace ContentDialog_WinUI3
{
    public enum SignInResult
    {
        SignInOK,
        SignInFail,
        SignInCancel,
        Nothing
    }

    public sealed partial class SignInContentDialog : ContentDialog
    {
        public SignInResult Result { get; private set; }

        public SignInContentDialog()
        {
            this.InitializeComponent();
            this.Opened += SignInContentDialog_Opened;
            this.Closing += SignInContentDialog_Closing;
        }

        private async void ContentDialog_PrimaryButtonClick(ContentDialog sender, ContentDialogButtonClickEventArgs args)
        {
            // Ensure the user name and password fields aren't empty. If a required
            // field is empty, set args.Cancel = true to keep the dialog open.
              if (string.IsNullOrEmpty(userNameTextBox.Text))
            {
                errorInfoBar.Message = "User name is required.";
                errorInfoBar.IsOpen = true;
            }
            else if (string.IsNullOrEmpty(passwordTextBox.Password))
            {
                errorInfoBar.Message = "Password is required.";
                errorInfoBar.IsOpen = true;
            }
            args.Cancel = errorInfoBar.IsOpen;

            // If you're performing async operations in the button click handler,
            // get a deferral before you await the operation. Then, complete the
            // deferral when the async operation is complete.
            if (args.Cancel == false) 
            {
                ContentDialogButtonClickDeferral deferral = args.GetDeferral();
                if (await SimulateAsyncSignInOperation())
                {
                    this.Result = SignInResult.SignInOK;
                }
                else
                {
                    this.Result = SignInResult.SignInFail;
                }
                deferral.Complete();
            }
        }

        private async Task<bool> SimulateAsyncSignInOperation()
        {
            // return true to simulate sign-in success.
            return true;
            // return false to simulate sign-in failure.
            /// return false;
        }

        private void ContentDialog_CloseButtonClick(ContentDialog sender, ContentDialogButtonClickEventArgs args)
        {
            // User clicked Cancel, ESC, or the system back button.
            this.Result = SignInResult.SignInCancel;
        }

        void SignInContentDialog_Opened(ContentDialog sender, ContentDialogOpenedEventArgs args)
        {
            this.Result = SignInResult.Nothing;

            // If the user name is saved, get it and populate the user name field.
            Windows.Storage.ApplicationDataContainer localSettings = Windows.Storage.ApplicationData.Current.LocalSettings;
            if (localSettings.Values.ContainsKey("userName"))
            {
                userNameTextBox.Text = localSettings.Values["userName"].ToString();
                saveUserNameCheckBox.IsChecked = true;
            }
        }

        void SignInContentDialog_Closing(ContentDialog sender, ContentDialogClosingEventArgs args)
        {
            // If sign in was successful, save or clear the user name based on the user choice.
            if (this.Result == SignInResult.SignInOK)
            {
                if (saveUserNameCheckBox.IsChecked == true)
                {
                    SaveUserName();
                }
                else
                {
                    ClearUserName();
                }
            }
        }

        private void SaveUserName()
        {
            Windows.Storage.ApplicationDataContainer localSettings = Windows.Storage.ApplicationData.Current.LocalSettings;
            localSettings.Values["userName"] = userNameTextBox.Text;
        }

        private void ClearUserName()
        {
            Windows.Storage.ApplicationDataContainer localSettings = Windows.Storage.ApplicationData.Current.LocalSettings;
            localSettings.Values["userName"] = null;
            userNameTextBox.Text = string.Empty;
        }

        private void UserNameTextBox_TextChanged(object sender, TextChangedEventArgs e)
        {
            // Clear the error if the user name field isn't empty.
            if (!string.IsNullOrEmpty(userNameTextBox.Text))
            {
                errorInfoBar.Message = string.Empty;
                errorInfoBar.IsOpen = false;
            }
        }

        private void PasswordTextBox_PasswordChanged(object sender, RoutedEventArgs e)
        {
            // Clear the error if the password field isn't empty.
            if (!string.IsNullOrEmpty(passwordTextBox.Password))
            {
                errorInfoBar.Message = string.Empty;
                errorInfoBar.IsOpen = false;
            }
        }
    }
}

Ниже приведен код, в котором отображается SignInContentDialog и используется его пользовательский SignInResult.

private async void ShowSignInDialogButton_Click(object sender, RoutedEventArgs e)
{
    SignInContentDialog signInDialog = new SignInContentDialog()
    {
        XamlRoot = rootPanel.XamlRoot
    };
    await signInDialog.ShowAsync();

    if (signInDialog.Result == SignInResult.SignInOK)
    {
        // Sign in was successful.
    }
    else if (signInDialog.Result == SignInResult.SignInFail)
    {
        // Sign in failed.
    }
    else if (signInDialog.Result == SignInResult.SignInCancel)
    {
        // Sign in was cancelled by the user. 
    }
}

Комментарии

Совет

Дополнительные сведения, рекомендации по проектированию и примеры кода см. в разделе Элементы управления диалогом.

Используйте ContentDialog для запроса входных данных от пользователя или отображения информации в модальном диалоговом окне. Вы можете добавить ContentDialog на страницу приложения с помощью кода или XAML или создать пользовательский класс диалога, производный от ContentDialog. Оба способа показаны в разделе примеров этого раздела.

Заголовок

Используйте свойство Title , чтобы поместить заголовок в диалоговое окно. Чтобы добавить сложный элемент title с более простым текстом, можно использовать свойство TitleTemplate .

Кнопки команд

ContentDialog имеет 3 встроенные кнопки, описывающие действия, которые пользователь может предпринять в ответ на запрос диалогового окна. Все диалоги должны иметь безопасное, неразрушающее действие. Диалоговые окна также могут содержать одно или два конкретных действия "сделать это" в ответ на запрос.

Используйте свойства PrimaryButtonText и SecondaryButtonText для отображения ответов на main вопрос или действие, заданные диалогом.

Используйте свойство CloseButtonText , чтобы задать отображаемый текст для безопасной неразрушающей кнопки. Кнопка закрытия диалогового окна также вызывается, когда пользователь выполняет действие Отмена , например нажатие клавиши ESC или нажатие системной кнопки "Назад".

При необходимости можно выделить одну из трех кнопок в качестве кнопки диалогового окна по умолчанию. Используйте свойство DefaultButton , чтобы различать одну из кнопок. Эта кнопка будет получать визуальную обработку кнопки акцента, автоматически реагировать на клавишу ВВОД и получать фокус при открытии диалогового окна, если содержимое диалога не содержит элементы, доступные для фокусировки.

Отображение диалогового окна и использование результата

Чтобы отобразить диалоговое окно, вызовите метод ShowAsync . Используйте ContentDialogResult , возвращенный этим методом, чтобы определить, какая из кнопок была нажата, если они были нажаты. Если пользователь нажимает клавишу ESC, системную стрелку назад или геймпад B, результатом этого метода будет None.

Установка XamlRoot

При показе ContentDialog необходимо вручную задать для xamlRoot диалогового окна корень узла XAML. Для этого задайте для свойства ContentDialog XamlRoot тот же xamlRoot, что и элемент в дереве XAML.

Если ContentDialog отображается со страницы, можно задать для свойства XamlRoot ContentDialog значение XamlRoot страницы ( XamlRoot = this.XamlRoot).

Window не имеет свойства XamlRoot, поэтому, если диалоговое окно отображается из окна, задайте для свойства XamlRoot диалогового окна значение корневого элемента содержимого Window, как показано ниже.

<Window
    ... >
    <Grid x:Name="rootPanel">

    </Grid>
</Window>
private async void DisplayNoWifiDialog()
{
    ContentDialog noWifiDialog = new ContentDialog
    {
        XamlRoot = rootPanel.XamlRoot,
        Title = "No wifi connection",
        Content = "Check your connection and try again.",
        CloseButtonText = "Ok"
    };

    ContentDialogResult result = await noWifiDialog.ShowAsync();
}

Закрытие диалогового окна

Возможно, потребуется выполнить некоторые действия перед закрытием диалогового окна (например, чтобы убедиться, что пользователь ввел данные в поля формы перед отправкой запроса). Перед закрытием диалогового окна можно выполнить работу двумя способами. Вы можете обрабатывать события PrimaryButtonClick, SecondaryButtonClick или CloseButtonClick , чтобы получить ответ пользователя при нажатии кнопки и проверить состояние диалогового окна перед его закрытием. Вы также можете обработать событие Closing , чтобы выполнить работу до закрытия диалогового окна.

Одновременно может отображаться только один ContentDialog. Чтобы связать несколько объектов ContentDialog, обработайте событие Closing первого ContentDialog. В обработчике событий Закрытия вызовите Метод ShowAsync во втором диалоговом окне, чтобы отобразить его.

Предупреждение

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

Производные элементы управления со стилями WinUI

Если вы наследуете пользовательский элемент управления из существующего элемента управления XAML, он не получит стили WinUI по умолчанию. Чтобы применить стили WinUI, выполните следующие действия.

  • Создайте новый стиль с параметром TargetType , установленным для пользовательского элемента управления.
  • На основе стиля по умолчанию используется элемент управления, производный от.

Один из распространенных сценариев — получение нового элемента управления от ContentDialog. В этом примере показано, как создать новый стиль, который применяется к DefaultContentDialogStyle пользовательскому диалогу.

<ContentDialog
    x:Class="ExampleApp.SignInContentDialog"
    ... >
    <ContentDialog.Resources>
        <Style TargetType="local:SignInContentDialog" 
               BasedOn="{StaticResource DefaultContentDialogStyle}"/>
    </ContentDialog.Resources> 
    <!-- CONTENT -->
</ContentDialog>

Стиль и шаблон элемента управления

Вы можете изменить стандартные параметры Style и ControlTemplate , чтобы придать элементу управления уникальный внешний вид. Сведения об изменении стиля и шаблона элемента управления см. в разделе Стили XAML. Стиль, шаблон и ресурсы по умолчанию, определяющие внешний вид элемента управления, включаются в generic.xaml файл . В целях разработки generic.xaml устанавливается вместе с пакетом NuGet Windows App SDK. По умолчанию, это расположение \Users\<username>\.nuget\packages\microsoft.windowsappsdk\<version>\lib\uap10.0\Microsoft.UI\Themes\generic.xaml. Стили и ресурсы из разных версий пакета SDK могут иметь разные значения.

XAML также включает ресурсы, которые можно использовать для изменения цветов элемента управления в различных визуальных состояниях без изменения шаблона элемента управления. Изменение этих ресурсов предпочтительнее, чем установка таких свойств, как Background и Foreground. Дополнительные сведения см. в разделе Облегчаемые стили статьио стилях XAML .

Конструкторы

ContentDialog()

Инициализирует новый экземпляр класса ContentDialog .

Свойства

AccessKey

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

(Унаследовано от UIElement)
AccessKeyScopeOwner

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

(Унаследовано от UIElement)
ActualHeight

Возвращает отрисованную высоту объекта FrameworkElement. См. заметки.

(Унаследовано от FrameworkElement)
ActualOffset

Возвращает положение этого элемента UIElement относительно его родительского элемента, вычисленное во время прохода упорядочения процесса макета.

(Унаследовано от UIElement)
ActualSize

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

(Унаследовано от UIElement)
ActualTheme

Возвращает тему пользовательского интерфейса, которая в настоящее время используется элементом , который может отличаться от RequestedTheme.

(Унаследовано от FrameworkElement)
ActualWidth

Возвращает отрисованную ширину элемента FrameworkElement. См. заметки.

(Унаследовано от FrameworkElement)
AllowDrop

Возвращает или задает значение, определяющее, может ли этот элемент UIElement быть целевым объектом перетаскивания для операций перетаскивания.

(Унаследовано от UIElement)
AllowFocusOnInteraction

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

(Унаследовано от FrameworkElement)
AllowFocusWhenDisabled

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

(Унаследовано от FrameworkElement)
Background

Возвращает или задает кисть, которая предоставляет фон элемента управления .

(Унаследовано от Control)
BackgroundSizing

Возвращает или задает значение, указывающее, насколько далеко фон расширяется относительно границы этого элемента.

(Унаследовано от Control)
BaseUri

Возвращает универсальный код ресурса (URI), представляющий базовый URI для объекта, созданного в XAML, во время загрузки XAML. Это свойство полезно для разрешения URI во время выполнения.

(Унаследовано от FrameworkElement)
BorderBrush

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

(Унаследовано от Control)
BorderThickness

Возвращает или задает толщину границы элемента управления.

(Унаследовано от Control)
CacheMode

Возвращает или задает значение, указывающее, что отображаемое содержимое должно кэшироваться в виде составного растрового изображения, если это возможно.

(Унаследовано от UIElement)
CanBeScrollAnchor

Возвращает или задает значение, указывающее, может ли UIElement быть кандидатом для привязки прокрутки.

(Унаследовано от UIElement)
CanDrag

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

(Унаследовано от UIElement)
CenterPoint

Возвращает или задает центральную точку элемента, то есть точку, о которой происходит поворот или масштабирование. Влияет на позицию отрисовки элемента.

(Унаследовано от UIElement)
CharacterSpacing

Возвращает или задает единый интервал между символами в единицах 1/1000 em.

(Унаследовано от Control)
Clip

Возвращает или задает объект RectangleGeometry, используемый для определения структуры содержимого элемента UIElement.

(Унаследовано от UIElement)
CloseButtonCommand

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

CloseButtonCommandParameter

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

CloseButtonCommandParameterProperty

Возвращает идентификатор свойства зависимости CloseButtonCommandParameter.

CloseButtonCommandProperty

Возвращает идентификатор свойства зависимости CloseButtonCommand.

CloseButtonStyle

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

CloseButtonStyleProperty

Возвращает идентификатор свойства зависимостей CloseButtonStyle.

CloseButtonText

Возвращает или задает текст, отображаемый на кнопке закрытия.

CloseButtonTextProperty

Возвращает идентификатор свойства зависимости CloseButtonText.

CompositeMode

Возвращает или задает свойство, объявляющее альтернативные режимы композиции и наложения для элемента в родительском макете и окне. Это относится к элементам, участвующим в смешанном пользовательском интерфейсе XAML/Microsoft DirectX.

(Унаследовано от UIElement)
Content

Возвращает или задает содержимое ContentControl.

(Унаследовано от ContentControl)
ContentTemplate

Возвращает или задает шаблон данных, используемый для отображения содержимого ContentControl.

(Унаследовано от ContentControl)
ContentTemplateRoot

Возвращает корневой элемент шаблона данных, заданного свойством ContentTemplate .

(Унаследовано от ContentControl)
ContentTemplateSelector

Получает или задает объект выделения, который изменяет DataTemplate для применения к содержимому на основе данных об обработке сведений об элементе содержимого или его контейнере во время выполнения.

(Унаследовано от ContentControl)
ContentTransitions

Возвращает или задает коллекцию элементов стиля перехода , применяемых к содержимому ContentControl.

(Унаследовано от ContentControl)
ContextFlyout

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

(Унаследовано от UIElement)
CornerRadius

Возвращает или задает радиус для углов границы элемента управления.

(Унаследовано от Control)
DataContext

Возвращает или задает контекст данных для FrameworkElement. Контекст данных часто используется, когда FrameworkElement использует расширение разметки {Binding} и участвует в привязке данных.

(Унаследовано от FrameworkElement)
DefaultButton

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

DefaultButtonProperty

Возвращает идентификатор свойства зависимости DefaultButton.

DefaultStyleKey

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

(Унаследовано от Control)
DefaultStyleResourceUri

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

(Унаследовано от Control)
DesiredSize

Возвращает размер, вычисленный этим элементом UIElement во время прохождения меры процесса макета.

(Унаследовано от UIElement)
Dispatcher

Всегда возвращает в null приложении Windows App SDK. Вместо этого используйте DispatcherQueue .

(Унаследовано от DependencyObject)
DispatcherQueue

Возвращает объект , DispatcherQueue с которым связан этот объект. представляет DispatcherQueue средство, которое может получить доступ к в потоке DependencyObject пользовательского интерфейса, даже если код инициируется потоком, не относящегося к пользовательскому интерфейсу.

(Унаследовано от DependencyObject)
ElementSoundMode

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

(Унаследовано от Control)
ExitDisplayModeOnAccessKeyInvoked

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

(Унаследовано от UIElement)
FlowDirection

Возвращает или задает направление, в котором текст и другие элементы пользовательского интерфейса передаются в любом родительском элементе, который управляет их макетом. Этому свойству можно присвоить значение LeftToRight или RightToLeft. При установке FlowDirection значения для RightToLeft любого элемента устанавливается выравнивание справа, порядок чтения справа налево и макет элемента управления для перехода справа налево.

(Унаследовано от FrameworkElement)
FocusState

Возвращает значение, указывающее, имеет ли этот элемент управления фокус и режим, в котором был получен фокус.

(Унаследовано от UIElement)
FocusVisualMargin

Возвращает или задает внешнее поле визуального элемента фокуса для FrameworkElement.

(Унаследовано от FrameworkElement)
FocusVisualPrimaryBrush

Возвращает или задает кисть, используемую для рисования внешней границы визуального HighVisibility элемента или Reveal фокуса для FrameworkElement.

(Унаследовано от FrameworkElement)
FocusVisualPrimaryThickness

Возвращает или задает толщину внешней границы визуального элемента или Reveal фокуса HighVisibility для FrameworkElement.

(Унаследовано от FrameworkElement)
FocusVisualSecondaryBrush

Получает или задает кисть, используемую для рисования внутренней границы визуального HighVisibility элемента или Reveal фокуса для FrameworkElement.

(Унаследовано от FrameworkElement)
FocusVisualSecondaryThickness

Возвращает или задает толщину внутренней границы визуального HighVisibility элемента или Reveal фокуса для FrameworkElement.

(Унаследовано от FrameworkElement)
FontFamily

Возвращает или задает шрифт, используемый при отображении текста в элементе управления.

(Унаследовано от Control)
FontSize

Возвращает или задает размер текста в этом элементе управления.

(Унаследовано от Control)
FontStretch

Получение или установка межсимвольного интервала.

(Унаследовано от Control)
FontStyle

Возвращает или задает стиль, в котором отображается текст.

(Унаследовано от Control)
FontWeight

Возвращает или задает толщину указанного шрифта.

(Унаследовано от Control)
Foreground

Возвращает или задает кисть, которая описывает основной цвет.

(Унаследовано от Control)
FullSizeDesired

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

FullSizeDesiredProperty

Возвращает идентификатор свойства зависимостей FullSizeDesired.

Height

Возвращает или задает предполагаемую высоту объекта FrameworkElement.

(Унаследовано от FrameworkElement)
HighContrastAdjustment

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

(Унаследовано от UIElement)
HorizontalAlignment

Возвращает или задает характеристики горизонтального выравнивания, применяемые к Объекту FrameworkElement при его создании в родительском элементе макета, например в элементе управления "Панель" или "Элементы".

(Унаследовано от FrameworkElement)
HorizontalContentAlignment

Возвращает или задает способ горизонтального выравнивания содержимого элемента управления.

(Унаследовано от Control)
IsAccessKeyScope

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

(Унаследовано от UIElement)
IsDoubleTapEnabled

Возвращает или задает значение, определяющее, может ли событие DoubleTapped исходить из этого элемента.

(Унаследовано от UIElement)
IsEnabled

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

(Унаследовано от Control)
IsFocusEngaged

Возвращает или задает значение, указывающее, ограничен ли фокус элементом управления, когда пользователь нажимает кнопку A/Select на игровом контроллере.

(Унаследовано от Control)
IsFocusEngagementEnabled

Возвращает или задает значение, указывающее, может ли фокус быть ограничен элементом управления, когда пользователь нажимает кнопку A/Select на игровом контроллере.

(Унаследовано от Control)
IsHitTestVisible

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

(Унаследовано от UIElement)
IsHoldingEnabled

Возвращает или задает значение, определяющее, может ли событие Holding исходить из этого элемента.

(Унаследовано от UIElement)
IsLoaded

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

(Унаследовано от FrameworkElement)
IsPrimaryButtonEnabled

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

IsPrimaryButtonEnabledProperty

Возвращает идентификатор свойства зависимости IsPrimaryButtonEnabled .

IsRightTapEnabled

Возвращает или задает значение, определяющее, может ли событие RightTapped исходить из этого элемента.

(Унаследовано от UIElement)
IsSecondaryButtonEnabled

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

IsSecondaryButtonEnabledProperty

Возвращает идентификатор свойства зависимости IsSecondaryButtonEnabled .

IsTabStop

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

(Унаследовано от UIElement)
IsTapEnabled

Возвращает или задает значение, определяющее, может ли событие Tapped исходить из этого элемента.

(Унаследовано от UIElement)
IsTextScaleFactorEnabled

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

(Унаследовано от Control)
KeyboardAcceleratorPlacementMode

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

(Унаследовано от UIElement)
KeyboardAcceleratorPlacementTarget

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

(Унаследовано от UIElement)
KeyboardAccelerators

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

Ускорители обычно назначаются кнопкам или пунктам меню.

Пример меню с ускорителями клавиатуры для различных пунктов меню
Пример меню с ускорителями клавиатуры для различных пунктов меню

(Унаследовано от UIElement)
KeyTipHorizontalOffset

Возвращает или задает значение, указывающее, насколько далеко слева или справа находится подсказка клавиши по отношению к UIElement.

(Унаследовано от UIElement)
KeyTipPlacementMode

Возвращает или задает значение, указывающее, где находится подсказка клавиши доступа относительно границы UIElement.

(Унаследовано от UIElement)
KeyTipTarget

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

(Унаследовано от UIElement)
KeyTipVerticalOffset

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

(Унаследовано от UIElement)
Language

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

(Унаследовано от FrameworkElement)
Lights

Возвращает коллекцию объектов XamlLight, присоединенных к этому элементу.

(Унаследовано от UIElement)
ManipulationMode

Возвращает или задает значение ManipulationModes, используемое для поведения UIElement и взаимодействия с жестами. Задание этого значения позволяет обрабатывать события манипуляции из этого элемента в коде приложения.

(Унаследовано от UIElement)
Margin

Возвращает или задает внешнее поле элемента FrameworkElement.

(Унаследовано от FrameworkElement)
MaxHeight

Возвращает или задает ограничение максимальной высоты объекта FrameworkElement.

(Унаследовано от FrameworkElement)
MaxWidth

Возвращает или задает ограничение максимальной ширины объекта FrameworkElement.

(Унаследовано от FrameworkElement)
MinHeight

Возвращает или задает ограничение минимальной высоты объекта FrameworkElement.

(Унаследовано от FrameworkElement)
MinWidth

Возвращает или задает ограничение минимальной ширины объекта FrameworkElement.

(Унаследовано от FrameworkElement)
Name

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

(Унаследовано от FrameworkElement)
Opacity

Возвращает или задает степень непрозрачности объекта.

(Унаследовано от UIElement)
OpacityTransition

Возвращает или задает scalarTransition, который анимирует изменения в свойстве Opacity.

(Унаследовано от UIElement)
Padding

Получение или установка отбивки внутри элемента управления.

(Унаследовано от Control)
Parent

Возвращает родительский объект этого элемента FrameworkElement в дереве объектов.

(Унаследовано от FrameworkElement)
PointerCaptures

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

(Унаследовано от UIElement)
PrimaryButtonCommand

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

PrimaryButtonCommandParameter

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

PrimaryButtonCommandParameterProperty

Возвращает идентификатор свойства зависимости PrimaryButtonCommandParameter.

PrimaryButtonCommandProperty

Возвращает идентификатор свойства зависимостей PrimaryButtonCommand.

PrimaryButtonStyle

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

PrimaryButtonStyleProperty

Возвращает идентификатор свойства зависимостей PrimaryButtonStyle.

PrimaryButtonText

Возвращает или задает текст, отображаемый на основной кнопке.

PrimaryButtonTextProperty

Возвращает идентификатор свойства зависимости PrimaryButtonText.

Projection

Возвращает или задает перспективную проекцию (трехмерный эффект), применяемую при отрисовке этого элемента.

(Унаследовано от UIElement)
ProtectedCursor

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

(Унаследовано от UIElement)
RasterizationScale

Возвращает значение, представляющее количество необработанных (физических) пикселей для каждого пикселя представления.

(Унаследовано от UIElement)
RenderSize

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

(Унаследовано от UIElement)
RenderTransform

Возвращает или задает сведения о преобразовании, влияющие на положение отрисовки элемента UIElement.

(Унаследовано от UIElement)
RenderTransformOrigin

Возвращает или задает исходную точку любого возможного преобразования отрисовки, объявленного RenderTransform, относительно границ UIElement.

(Унаследовано от UIElement)
RequestedTheme

Возвращает или задает тему пользовательского интерфейса, используемую элементом UIElement (и его дочерними элементами) для определения ресурсов. Тема пользовательского интерфейса, указанная с помощью RequestedTheme , может переопределить элемент RequestedTheme на уровне приложения.

(Унаследовано от FrameworkElement)
RequiresPointer

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

(Унаследовано от Control)
Resources

Возвращает локально определенный словарь ресурсов. В XAML элементы ресурсов можно установить в качестве дочерних объектных frameworkElement.Resources элементов элемента свойства с помощью синтаксиса неявной коллекции XAML.

(Унаследовано от FrameworkElement)
Rotation

Возвращает или задает угол поворота по часовой стрелке в градусах. Поворачивается относительно RotationAxis и CenterPoint. Влияет на позицию отрисовки элемента.

(Унаследовано от UIElement)
RotationAxis

Возвращает или задает ось для поворота элемента вокруг.

(Унаследовано от UIElement)
RotationTransition

Возвращает или задает scalarTransition, который анимирует изменения в свойстве Rotation.

(Унаследовано от UIElement)
Scale

Возвращает или задает масштаб элемента. Масштабируется относительно элемента CenterPoint. Влияет на позицию отрисовки элемента.

(Унаследовано от UIElement)
ScaleTransition

Возвращает или задает объект Vector3Transition, который анимирует изменения в свойстве Scale.

(Унаследовано от UIElement)
SecondaryButtonCommand

Возвращает или задает команду, вызываемую при нажатии дополнительной кнопки.

SecondaryButtonCommandParameter

Возвращает или задает параметр, передаваемый команде для дополнительной кнопки.

SecondaryButtonCommandParameterProperty

Возвращает идентификатор свойства зависимости SecondaryButtonCommandParameter.

SecondaryButtonCommandProperty

Возвращает идентификатор свойства зависимости SecondaryButtonCommand.

SecondaryButtonStyle

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

SecondaryButtonStyleProperty

Возвращает идентификатор свойства зависимостей SecondaryButtonStyle.

SecondaryButtonText

Возвращает или задает текст, отображаемый на дополнительной кнопке.

SecondaryButtonTextProperty

Возвращает идентификатор свойства зависимости SecondaryButtonText.

Shadow

Возвращает или задает эффект тени, отбрасываемый элементом .

(Унаследовано от UIElement)
Style

Возвращает или задает стиль экземпляра, применяемый к данному объекту во время макета и отрисовки.

(Унаследовано от FrameworkElement)
TabFocusNavigation

Возвращает или задает значение, изменяющее работу tabbing и TabIndex для этого элемента управления.

(Унаследовано от UIElement)
TabIndex

Возвращает или задает значение, определяющее порядок, в котором элементы получают фокус при переходе пользователя по элементам управления с помощью клавиши TAB .

(Унаследовано от UIElement)
TabNavigation

Возвращает или задает значение, изменяющее работу табуляции и UIElement.TabIndex для этого элемента управления.

Примечание

Для Windows 10 Creators Update (сборка 10.0.15063) и более поздней версии свойство TabFocusNavigation доступно в базовом классе UIElement для включения объектов в последовательность вкладок, не использующих ControlTemplate.

(Унаследовано от Control)
Tag

Возвращает или задает произвольное значение объекта, которое можно использовать для хранения пользовательских сведений об этом объекте.

(Унаследовано от FrameworkElement)
Template

Получает или задает шаблон элемента управления. Шаблон элемента управления определяет внешний вид элемента управления в пользовательском интерфейсе и определяется в разметке XAML.

(Унаследовано от Control)
Title

Возвращает или задает заголовок диалогового окна.

TitleProperty

Возвращает идентификатор свойства зависимости Title.

TitleTemplate

Возвращает или задает шаблон заголовка.

TitleTemplateProperty

Возвращает идентификатор свойства зависимости TitleTemplate.

Transform3D

Возвращает или задает эффект трехмерного преобразования, применяемый при отрисовке этого элемента.

(Унаследовано от UIElement)
TransformMatrix

Возвращает или задает матрицу преобразования, применяемую к элементу .

(Унаследовано от UIElement)
Transitions

Возвращает или задает коллекцию элементов стиля Перехода , которые применяются к UIElement.

(Унаследовано от UIElement)
Translation

Возвращает или задает позицию отрисовки x, y и z элемента.

(Унаследовано от UIElement)
TranslationTransition

Возвращает или задает объект Vector3Transition, который анимирует изменения в свойстве Translation.

(Унаследовано от UIElement)
Triggers

Возвращает коллекцию триггеров для анимаций, определенных для FrameworkElement. Редко используется. См. заметки.

(Унаследовано от FrameworkElement)
UseLayoutRounding

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

(Унаследовано от UIElement)
UseSystemFocusVisuals

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

(Унаследовано от UIElement)
VerticalAlignment

Возвращает или задает характеристики вертикального выравнивания, применяемые к Объекту FrameworkElement при его создании в родительском объекте, например в элементе управления "Панель" или "Элементы".

(Унаследовано от FrameworkElement)
VerticalContentAlignment

Возвращает или задает способ вертикального выравнивания содержимого элемента управления.

(Унаследовано от Control)
Visibility

Возвращает или задает видимость uiElement. Невидимый UIElement объект не отображается и не передает нужный размер макету.

(Унаследовано от UIElement)
Width

Возвращает или задает ширину элемента FrameworkElement.

(Унаследовано от FrameworkElement)
XamlRoot

Возвращает или задает объект , XamlRoot в котором просматривается данный элемент.

(Унаследовано от UIElement)
XYFocusDown

Возвращает или задает объект, который получает фокус, когда пользователь нажимает на панель направления (D-pad) игрового контроллера.

(Унаследовано от UIElement)
XYFocusDownNavigationStrategy

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

(Унаследовано от UIElement)
XYFocusKeyboardNavigation

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

(Унаследовано от UIElement)
XYFocusLeft

Возвращает или задает объект, который получает фокус, когда пользователь нажимает кнопку слева на направленной панели (D-pad) игрового контроллера.

(Унаследовано от UIElement)
XYFocusLeftNavigationStrategy

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

(Унаследовано от UIElement)
XYFocusRight

Возвращает или задает объект, который получает фокус, когда пользователь нажимает прямо на панель направления (D-pad) игрового контроллера.

(Унаследовано от UIElement)
XYFocusRightNavigationStrategy

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

(Унаследовано от UIElement)
XYFocusUp

Возвращает или задает объект, который получает фокус, когда пользователь нажимает кнопку управления направлением (D-pad) игрового контроллера.

(Унаследовано от UIElement)
XYFocusUpNavigationStrategy

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

(Унаследовано от UIElement)

Методы

AddHandler(RoutedEvent, Object, Boolean)

Добавляет обработчик перенаправленного события для указанного перенаправленного события, помещая этот обработчик в коллекцию обработчиков текущего элемента. Укажите handledEventsToo как true , чтобы был вызван предоставленный обработчик, даже если событие обрабатывается в другом месте.

(Унаследовано от UIElement)
ApplyTemplate()

Загружает соответствующий шаблон элемента управления, чтобы можно было ссылаться на его части.

(Унаследовано от Control)
Arrange(Rect)

Размещает дочерние объекты и определяет размер элемента UIElement. Родительские объекты, реализующие пользовательский макет для своих дочерних элементов, должны вызывать этот метод из реализаций переопределения макета, чтобы сформировать рекурсивное обновление макета.

(Унаследовано от UIElement)
ArrangeOverride(Size)

Предоставляет поведение для прохода "Упорядочить" макета. Классы могут переопределить этот метод, чтобы определить собственное поведение передачи "Упорядочить".

(Унаследовано от FrameworkElement)
CancelDirectManipulations()

Отменяет текущую обработку прямых манипуляций (системное сдвига или масштабирование) в любом родительском элементе ScrollViewer , содержающем текущий элемент UIElement.

(Унаследовано от UIElement)
CapturePointer(Pointer)

Задает запись указателя на элемент UIElement. После захвата только элемент, имеющий запись, будет запускать события, связанные с указателем.

(Унаследовано от UIElement)
ClearValue(DependencyProperty)

Очищает локальное значение свойства зависимостей.

(Унаследовано от DependencyObject)
FindName(String)

Извлекает объект с указанным именем идентификатора.

(Унаследовано от FrameworkElement)
FindSubElementsForTouchTargeting(Point, Rect)

Позволяет подклассу UIElement предоставлять дочерние элементы, помогающие разрешать сенсорный нацеливание.

(Унаследовано от UIElement)
Focus(FocusState)

Попытка задать фокус для данного элемента.

(Унаследовано от UIElement)
GetAnimationBaseValue(DependencyProperty)

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

(Унаследовано от DependencyObject)
GetBindingExpression(DependencyProperty)

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

(Унаследовано от FrameworkElement)
GetChildrenInTabFocusOrder()

Позволяет подклассу UIElement предоставлять дочерние элементы, которые участвуют в фокусе tab.

(Унаследовано от UIElement)
GetTemplateChild(String)

Извлекает именованный элемент в визуальном дереве ControlTemplate , созданном экземпляром.

(Унаследовано от Control)
GetValue(DependencyProperty)

Возвращает текущее действующее значение свойства зависимостей из DependencyObject.

(Унаследовано от DependencyObject)
GetVisualInternal()

Извлекает объект , в Visual который разрешается элемент.

(Унаследовано от UIElement)
GoToElementStateCore(String, Boolean)

При реализации в производном классе позволяет создавать визуальное дерево для шаблона элемента управления в коде, а не загружать XAML для всех состояний при запуске элемента управления.

(Унаследовано от FrameworkElement)
Hide()

Скрывает диалоговое окно.

InvalidateArrange()

Делает недействительным состояние упорядочения (макет) для UIElement. После недействительности макет UIElement будет обновлен, что будет происходить асинхронно.

(Унаследовано от UIElement)
InvalidateMeasure()

Делает недействительным состояние измерения (макет) для UIElement.

(Унаследовано от UIElement)
InvalidateViewport()

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

(Унаследовано от FrameworkElement)
Measure(Size)

Обновления DesiredSizeэлемента UIElement. Как правило, объекты, реализующие пользовательский макет для своих дочерних элементов макета, вызывают этот метод из собственных реализаций MeasureOverride для формирования рекурсивного обновления макета.

(Унаследовано от UIElement)
MeasureOverride(Size)

Предоставляет поведение для прохода "Measure" цикла макета. Классы могут переопределить этот метод, чтобы определить собственное поведение прохода "Measure".

(Унаследовано от FrameworkElement)
OnApplyTemplate()

Вызывается всякий раз, когда код приложения или внутренние процессы (например, перестроение макета) вызывают Метод ApplyTemplate. Проще говоря, это означает, что метод вызывается непосредственно перед отображением элемента пользовательского интерфейса в приложении. Переопределите этот метод, чтобы повлиять на логику после шаблона класса по умолчанию.

(Унаследовано от FrameworkElement)
OnBringIntoViewRequested(BringIntoViewRequestedEventArgs)

Вызывается перед событием BringIntoViewRequested .

(Унаследовано от UIElement)
OnCharacterReceived(CharacterReceivedRoutedEventArgs)

Вызывается перед событием CharacterReceived .

(Унаследовано от Control)
OnContentChanged(Object, Object)

Вызывается при изменении значения свойства Content .

(Унаследовано от ContentControl)
OnContentTemplateChanged(DataTemplate, DataTemplate)

Вызывается при изменении значения свойства ContentTemplate .

(Унаследовано от ContentControl)
OnContentTemplateSelectorChanged(DataTemplateSelector, DataTemplateSelector)

Вызывается при изменении значения свойства ContentTemplateSelector .

(Унаследовано от ContentControl)
OnCreateAutomationPeer()

При реализации в производном классе возвращает реализации AutomationPeer для конкретного класса для инфраструктуры Microsoft модель автоматизации пользовательского интерфейса.

(Унаследовано от UIElement)
OnDisconnectVisualChildren()

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

(Унаследовано от UIElement)
OnDoubleTapped(DoubleTappedRoutedEventArgs)

Вызывается перед событием DoubleTapped .

(Унаследовано от Control)
OnDragEnter(DragEventArgs)

Вызывается перед событием DragEnter .

(Унаследовано от Control)
OnDragLeave(DragEventArgs)

Вызывается перед событием DragLeave .

(Унаследовано от Control)
OnDragOver(DragEventArgs)

Вызывается перед событием DragOver .

(Унаследовано от Control)
OnDrop(DragEventArgs)

Вызывается перед событием Drop .

(Унаследовано от Control)
OnGotFocus(RoutedEventArgs)

Вызывается перед событием GotFocus .

(Унаследовано от Control)
OnHolding(HoldingRoutedEventArgs)

Вызывается перед событием Holding .

(Унаследовано от Control)
OnKeyboardAcceleratorInvoked(KeyboardAcceleratorInvokedEventArgs)

Вызывается при обработке сочетания клавиш (или ускорителя) в приложении. Переопределите этот метод для обработки реакции приложения на вызов ускорителя клавиатуры.

(Унаследовано от UIElement)
OnKeyDown(KeyRoutedEventArgs)

Вызывается перед событием KeyDown .

(Унаследовано от Control)
OnKeyUp(KeyRoutedEventArgs)

Вызывается перед событием KeyUp .

(Унаследовано от Control)
OnLostFocus(RoutedEventArgs)

Вызывается перед событием LostFocus .

(Унаследовано от Control)
OnManipulationCompleted(ManipulationCompletedRoutedEventArgs)

Вызывается перед событием ManipulationCompleted .

(Унаследовано от Control)
OnManipulationDelta(ManipulationDeltaRoutedEventArgs)

Вызывается перед событием ManipulationDelta .

(Унаследовано от Control)
OnManipulationInertiaStarting(ManipulationInertiaStartingRoutedEventArgs)

Вызывается перед событием ManipulationInertiaStarting .

(Унаследовано от Control)
OnManipulationStarted(ManipulationStartedRoutedEventArgs)

Вызывается перед событием ManipulationStarted .

(Унаследовано от Control)
OnManipulationStarting(ManipulationStartingRoutedEventArgs)

Вызывается перед событием ManipulationStarting .

(Унаследовано от Control)
OnPointerCanceled(PointerRoutedEventArgs)

Вызывается перед событием PointerCanceled .

(Унаследовано от Control)
OnPointerCaptureLost(PointerRoutedEventArgs)

Вызывается перед событием PointerCaptureLost .

(Унаследовано от Control)
OnPointerEntered(PointerRoutedEventArgs)

Вызывается перед событием PointerEntered .

(Унаследовано от Control)
OnPointerExited(PointerRoutedEventArgs)

Вызывается перед событием PointerExited .

(Унаследовано от Control)
OnPointerMoved(PointerRoutedEventArgs)

Вызывается перед событием PointerMoved .

(Унаследовано от Control)
OnPointerPressed(PointerRoutedEventArgs)

Вызывается перед событием PointerPressed .

(Унаследовано от Control)
OnPointerReleased(PointerRoutedEventArgs)

Вызывается перед событием PointerReleased .

(Унаследовано от Control)
OnPointerWheelChanged(PointerRoutedEventArgs)

Вызывается перед событием PointerWheelChanged .

(Унаследовано от Control)
OnPreviewKeyDown(KeyRoutedEventArgs)

Вызывается перед событием PreviewKeyDown .

(Унаследовано от Control)
OnPreviewKeyUp(KeyRoutedEventArgs)

Вызывается перед событием PreviewKeyUp .

(Унаследовано от Control)
OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs)

Вызывается непосредственно перед обработкой сочетания клавиш (или ускорителя) в приложении. Вызывается всякий раз, когда код приложения или внутренние процессы вызывают ProcessKeyboardAccelerators. Переопределите этот метод, чтобы повлиять на обработку ускорителя по умолчанию.

(Унаследовано от UIElement)
OnRightTapped(RightTappedRoutedEventArgs)

Вызывается перед событием RightTapped .

(Унаследовано от Control)
OnTapped(TappedRoutedEventArgs)

Вызывается перед событием Tapped .

(Унаследовано от Control)
PopulatePropertyInfo(String, AnimationPropertyInfo)

Определяет свойство, которое можно анимировать.

(Унаследовано от UIElement)
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)

При переопределении в производном классе определяет свойство, которое можно анимировать.

(Унаследовано от UIElement)
ReadLocalValue(DependencyProperty)

Возвращает локальное значение свойства зависимостей, если задано локальное значение.

(Унаследовано от DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

Регистрирует функцию уведомления для прослушивания изменений определенного DependencyProperty в этом экземпляре DependencyObject .

(Унаследовано от DependencyObject)
ReleasePointerCapture(Pointer)

Освобождает записи указателя для захвата одного конкретного указателя этим элементом UIElement.

(Унаследовано от UIElement)
ReleasePointerCaptures()

Освобождает все записи указателей, хранящиеся этим элементом.

(Унаследовано от UIElement)
RemoveFocusEngagement()

Освобождает элемент управления от ограничений фокуса, поддерживающих взаимодействие с игровым контроллером (где IsFocusEngaged имеет значение true).

(Унаследовано от Control)
RemoveHandler(RoutedEvent, Object)

Удаляет указанный обработчик перенаправленных событий из этого элемента UIElement. Как правило, рассматриваемый обработчик был добавлен с помощью AddHandler.

(Унаследовано от UIElement)
SetBinding(DependencyProperty, BindingBase)

Присоединяет привязку к FrameworkElement, используя предоставленный объект привязки.

(Унаследовано от FrameworkElement)
SetValue(DependencyProperty, Object)

Задает локальное значение свойства зависимостей для Объекта DependencyObject.

(Унаследовано от DependencyObject)
ShowAsync()

Начинает асинхронную операцию для отображения диалогового окна.

ShowAsync(ContentDialogPlacement)

Начинает асинхронную операцию для отображения диалогового окна с указанным размещением.

StartAnimation(ICompositionAnimationBase)

Начинает указанную анимацию в элементе .

(Унаследовано от UIElement)
StartBringIntoView()

Инициирует запрос к платформе XAML, чтобы отобразить элемент в любых прокручиваемых регионах, в которые он содержится.

(Унаследовано от UIElement)
StartBringIntoView(BringIntoViewOptions)

Инициирует запрос к платформе XAML для вывода элемента в представление с помощью указанных параметров.

(Унаследовано от UIElement)
StartDragAsync(ExpPointerPoint)

Представляет диалоговое окно, которое можно настроить так, чтобы он содержал флажки, гиперссылки, кнопки и любое другое содержимое XAML.

(Унаследовано от UIElement)
StartDragAsync(PointerPoint)

Инициирует операцию перетаскивания.

Важно!

Не поддерживается, если пользователь запускает приложение в режиме с повышенными привилегиями в качестве администратора.

(Унаследовано от UIElement)
StopAnimation(ICompositionAnimationBase)

Останавливает указанную анимацию в элементе .

(Унаследовано от UIElement)
TransformToVisual(UIElement)

Возвращает объект преобразования, который можно использовать для преобразования координат из UIElement в указанный объект.

(Унаследовано от UIElement)
TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs)

Пытается вызвать сочетание клавиш (или ускоритель), выполнив поиск сочетания клавиш во всем визуальном дереве UIElement.

(Унаследовано от UIElement)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

Отменяет уведомление об изменениях, которое было ранее зарегистрировано путем вызова Метода RegisterPropertyChangedCallback.

(Унаследовано от DependencyObject)
UpdateLayout()

Обеспечивает правильное обновление всех позиций дочерних объектов элемента UIElement для макета.

(Унаследовано от UIElement)

События

AccessKeyDisplayDismissed

Происходит, когда ключи доступа больше не должны отображаться.

(Унаследовано от UIElement)
AccessKeyDisplayRequested

Происходит, когда пользователь запрашивает отображение ключей доступа.

(Унаследовано от UIElement)
AccessKeyInvoked

Происходит, когда пользователь завершает последовательность ключей доступа.

(Унаследовано от UIElement)
ActualThemeChanged

Происходит при изменении значения свойства ActualTheme.

(Унаследовано от FrameworkElement)
BringIntoViewRequested

Происходит при вызове StartBringIntoView для этого элемента или одного из его потомков.

(Унаследовано от UIElement)
CharacterReceived

Происходит при получении одного составного символа входной очередью.

(Унаследовано от UIElement)
CloseButtonClick

Происходит после нажатия кнопки закрытия.

Closed

Происходит после закрытия диалогового окна.

Closing

Происходит после того, как диалоговое окно начинает закрываться, но до его закрытия и до возникновения события Closed .

ContextCanceled

Происходит, когда жест ввода контекста переходит в жест манипуляции, чтобы уведомить элемент о том, что всплывающий элемент контекста не должен открываться.

(Унаследовано от UIElement)
ContextRequested

Происходит, когда пользователь завершил жест ввода контекста, например щелчок правой кнопкой мыши.

(Унаследовано от UIElement)
DataContextChanged

Происходит при изменении значения свойства FrameworkElement.DataContext .

(Унаследовано от FrameworkElement)
DoubleTapped

Возникает при необработанных взаимодействиях DoubleTap с областью проверки попадания этого элемента.

(Унаследовано от UIElement)
DragEnter

Происходит, когда входная система сообщает базовое событие перетаскивания с этим элементом в качестве целевого объекта.

(Унаследовано от UIElement)
DragLeave

Происходит, когда входная система сообщает базовое событие перетаскивания с этим элементом в качестве источника.

(Унаследовано от UIElement)
DragOver

Происходит, когда подсистема ввода сообщает о соответствующем событии перетаскивания, имеющем в качестве потенциальной цели данный элемент.

(Унаследовано от UIElement)
DragStarting

Происходит при инициации операции перетаскивания.

(Унаследовано от UIElement)
Drop

Происходит, когда система ввода сообщает о базовом событии удаления с этим элементом в качестве цели удаления.

(Унаследовано от UIElement)
DropCompleted

Происходит при завершении операции перетаскивания с этим элементом в качестве источника.

(Унаследовано от UIElement)
EffectiveViewportChanged

Происходит при изменении действующего окна просмотраFrameworkElement.

(Унаследовано от FrameworkElement)
FocusDisengaged

Происходит при освобождении фокуса из элемента управления, когда пользователь нажимает кнопку B/Back на игровом контроллере.

(Унаследовано от Control)
FocusEngaged

Происходит, когда фокус ограничивается элементом управления, когда пользователь нажимает кнопку A/Select на игровом контроллере.

(Унаследовано от Control)
GettingFocus

Происходит до того, как ЭЛЕМЕНТ UIElement получит фокус. Это событие возникает синхронно, чтобы фокус не перемещался, пока событие не перемещается.

(Унаследовано от UIElement)
GotFocus

Происходит, когда UIElement получает фокус. Это событие возникает асинхронно, поэтому фокус может снова переместиться до завершения восходящего движения.

(Унаследовано от UIElement)
Holding

Происходит, когда в противном случае происходит необработанное взаимодействие удержания в области проверки попадания этого элемента.

(Унаследовано от UIElement)
IsEnabledChanged

Происходит при изменении свойства IsEnabled .

(Унаследовано от Control)
KeyDown

Происходит при нажатии клавиши клавиатуры, когда элемент UIElement находится в фокусе.

(Унаследовано от UIElement)
KeyUp

Происходит при освобождении клавиши клавиатуры, когда элемент UIElement находится в фокусе.

(Унаследовано от UIElement)
LayoutUpdated

Происходит при изменении макета визуального дерева из-за изменения значения релевантных для макета свойств или другого действия, которое обновляет макет.

(Унаследовано от FrameworkElement)
Loaded

Происходит, когда элемент FrameworkElement создан и добавлен в дерево объектов и готов к взаимодействию.

(Унаследовано от FrameworkElement)
Loading

Происходит при начале загрузки FrameworkElement .

(Унаследовано от FrameworkElement)
LosingFocus

Происходит до того, как ЭЛЕМЕНТ UIElement потеряет фокус. Это событие возникает синхронно, чтобы фокус не перемещался, пока событие не перемещается.

(Унаследовано от UIElement)
LostFocus

Происходит, когда ЭЛЕМЕНТ UIElement теряет фокус. Это событие возникает асинхронно, поэтому фокус может снова переместиться до завершения восходящего движения.

(Унаследовано от UIElement)
ManipulationCompleted

Происходит при завершении манипуляции с UIElement .

(Унаследовано от UIElement)
ManipulationDelta

Происходит, когда устройство ввода меняет положение в процессе манипуляции.

(Унаследовано от UIElement)
ManipulationInertiaStarting

Происходит, если во время манипуляции устройство ввода теряет контакт с объектом UIElement и начинает действовать инерция.

(Унаследовано от UIElement)
ManipulationStarted

Происходит, когда устройство ввода начинает манипуляцию над UIElement.

(Унаследовано от UIElement)
ManipulationStarting

Происходит при первоначальном создании процессора манипулирования.

(Унаследовано от UIElement)
NoFocusCandidateFound

Происходит, когда пользователь пытается переместить фокус (с помощью стрелки табуляции или направления), но фокус не перемещается, так как в направлении перемещения не найден кандидат фокуса.

(Унаследовано от UIElement)
Opened

Происходит после открытия диалогового окна.

PointerCanceled

Происходит, когда указатель, который сделал контакт ненормальным образом, теряет контакт.

(Унаследовано от UIElement)
PointerCaptureLost

Происходит, когда запись указателя, ранее удерживаемая этим элементом, перемещается в другой элемент или в другое место.

(Унаследовано от UIElement)
PointerEntered

Происходит, когда указатель входит в область проверки попадания этого элемента.

(Унаследовано от UIElement)
PointerExited

Происходит, когда указатель покидает область проверки попадания этого элемента.

(Унаследовано от UIElement)
PointerMoved

Происходит при перемещении указателя, пока указатель остается в области проверки попадания этого элемента.

(Унаследовано от UIElement)
PointerPressed

Происходит, когда указатель инициирует действие Нажатие в этом элементе.

(Унаследовано от UIElement)
PointerReleased

Происходит при освобождении устройства указателя, которое ранее инициировало действие нажатия , в этом элементе. Обратите внимание, что окончание действия Нажатие не гарантирует срабатывание PointerReleased события; вместо этого могут возникать другие события. Дополнительные сведения см. в разделе Примечания.

(Унаследовано от UIElement)
PointerWheelChanged

Происходит при изменении значения разностного колесика указателя.

(Унаследовано от UIElement)
PreviewKeyDown

Происходит при нажатии клавиши клавиатуры, когда элемент UIElement находится в фокусе.

(Унаследовано от UIElement)
PreviewKeyUp

Происходит при освобождении клавиши клавиатуры, когда элемент UIElement находится в фокусе.

(Унаследовано от UIElement)
PrimaryButtonClick

Происходит после нажатия основной кнопки.

ProcessKeyboardAccelerators

Происходит при нажатии сочетания клавиш (или ускорителя ).

(Унаследовано от UIElement)
RightTapped

Возникает при возникновении стимула ввода правой кнопкой касания, когда указатель находится над элементом.

(Унаследовано от UIElement)
SecondaryButtonClick

Происходит после нажатия дополнительной кнопки.

SizeChanged

Происходит при изменении значения свойства ActualHeight или ActualWidth в FrameworkElement.

(Унаследовано от FrameworkElement)
Tapped

Происходит, когда в противном случае происходит необработанное взаимодействие касания в области проверки попадания этого элемента.

(Унаследовано от UIElement)
Unloaded

Происходит, когда этот объект больше не подключен к дереву объектов main.

(Унаследовано от FrameworkElement)

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

См. также раздел