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>
Наследование
Атрибуты

Примеры

Tip

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

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

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

Important

В этом примере предполагается, что диалоговое окно отображается на странице. Чтобы отобразить диалоговое окно из окна, см. раздел "Задать 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. 
    }
}

Комментарии

Tip

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

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

Заголовок

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

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

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

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

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

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

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

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

Настройка XamlRoot

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

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

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

<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, чтобы получить ответ пользователя при нажатии кнопки и проверить состояние диалогового окна перед закрытием. Вы также можете обработать событие закрытия , прежде чем диалоговое окно закрывается.

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

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

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

Производные элементы управления с помощью стилей 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>

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

Вы можете изменить стиль по умолчанию и 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 также содержит ресурсы, которые можно использовать для изменения цветов элемента управления в разных визуальных состояниях без изменения шаблона элемента управления. Изменение этих ресурсов предпочтительнее задавать такие свойства, как фон и передний план. Дополнительные сведения см. в разделе стилей легкого веса статьи стилей XAML .

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

Имя Описание
ContentDialog()

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

Свойства

Имя Описание
AccessKey

Получает или задает ключ доступа (mnemonic) для этого элемента.

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

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

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

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

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

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

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

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

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

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

(Унаследовано от 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 эм.

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

Возвращает или задает прямоугольникGeometry , используемый для определения структуры содержимого 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 в приложении пакета SDK для приложений windows. Вместо этого используйте DispatcherQueue .

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Возвращает или задает толщину внутренней границы визуального элемента или Reveal фокуса HighVisibility для 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

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

(Унаследовано от 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

Получает или задает проекцию перспективы (эффект 3-D), применяемую при отрисовке этого элемента.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

SecondaryButtonCommandParameter

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

SecondaryButtonCommandParameterProperty

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

SecondaryButtonCommandProperty

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

SecondaryButtonStyle

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

SecondaryButtonStyleProperty

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

SecondaryButtonText

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

SecondaryButtonTextProperty

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

Shadow

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

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

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

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

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

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

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

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

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

Note

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

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

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

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

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

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

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

TitleProperty

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

TitleTemplate

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

TitleTemplateProperty

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

Transform3D

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

(Унаследовано от 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

Возвращает или задает объект, который получает фокус, когда пользователь нажимает клавишу Directional Pad (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()

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

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

Обновляет элемент DesiredSizeпользовательского интерфейса. Как правило, объекты, реализующие настраиваемый макет для дочерних элементов макета, вызывают этот метод из собственных реализаций 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 UI Automation.

(Унаследовано от 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)

Вызывается перед событием Холдинга .

(Унаследовано от 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)

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

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

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

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

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

(Унаследовано от 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)

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

Important

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

(Унаследовано от 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

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

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

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

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

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

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

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

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

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

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

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

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

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

ProcessKeyboardAccelerators

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

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

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

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

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

SizeChanged

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

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

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

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

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

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

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

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