ContentDialog Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет диалоговое окно, которое можно настроить так, чтобы он содержал флажки, гиперссылки, кнопки и любое другое содержимое XAML.
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 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(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class ContentDialog : ContentControlPublic Class ContentDialog
Inherits ContentControl<ContentDialog .../>
-or-
<ContentDialog>
singleObject
</ContentDialog>
-or-
<ContentDialog>stringContent</ContentDialog>
- Наследование
-
Object IInspectable DependencyObject UIElement FrameworkElement Control ContentControl ContentDialog
- Атрибуты
Требования к Windows
| Семейство устройств |
Windows 10 (появилось в 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (появилось в v1.0)
|
Примеры
Совет
Дополнительные сведения, рекомендации по проектированию и примеры кода см. в разделе Элементы управления диалогом.
Если у вас установлено приложение коллекции WinUI 2 , щелкните здесь, чтобы открыть приложение и увидеть ContentDialog в действии.
В этом примере показано, как создать и отобразить простой ContentDialog в коде.
private async void DisplayNoWifiDialog()
{
ContentDialog noWifiDialog = new ContentDialog()
{
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)
{
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 2.2 или более поздней версии, также см. раздел Производные элементы управления со стилями WinUI.
<!-- SignInContentDialog.xaml -->
<ContentDialog
x:Class="ExampleApp.SignInContentDialog"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:local="using:ExampleApp"
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>
<!-- Uncomment this Style if using WinUI 2.2 or later. -->
<!-- <Style TargetType="local:SignInContentDialog" BasedOn="{StaticResource DefaultContentDialogStyle}"/> -->
<!-- These flyouts or used for confirmation when the user changes
the option to save their user name. -->
<Flyout x:Key="DiscardNameFlyout" Closed="Flyout_Closed">
<StackPanel>
<TextBlock Text="Discard user name?"/>
<Button Content="Discard" Click="DiscardButton_Click"/>
</StackPanel>
</Flyout>
<Flyout x:Key="SaveNameFlyout" Closed="Flyout_Closed">
<StackPanel>
<TextBlock Text="Save user name?"/>
<Button Content="Save" Click="SaveButton_Click"/>
</StackPanel>
</Flyout>
</ContentDialog.Resources>
<StackPanel VerticalAlignment="Stretch" HorizontalAlignment="Stretch">
<TextBox Name="userNameTextBox" Header="User name"/>
<PasswordBox Name="passwordTextBox" Header="Password" IsPasswordRevealButtonEnabled="True"/>
<CheckBox Name="saveUserNameCheckBox" Content="Save user name"/>
<TextBlock x:Name="errorTextBlock" Style="{StaticResource ControlContextualInfoTextBlockStyle}"/>
<!-- Content body -->
<TextBlock Name="body" Style="{StaticResource MessageDialogContentStyle}" 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>
// SignInContentDialog.xaml.cs
using System;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
namespace ExampleApp
{
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 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))
{
args.Cancel = true;
errorTextBlock.Text = "User name is required.";
}
else if (string.IsNullOrEmpty(passwordTextBox.Password))
{
args.Cancel = true;
errorTextBlock.Text = "Password is required.";
}
// 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.
ContentDialogButtonClickDeferral deferral = args.GetDeferral();
if (await SomeAsyncSignInOperation())
{
this.Result = SignInResult.SignInOK;
}
else
{
this.Result = SignInResult.SignInFail;
}
deferral.Complete();
}
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 roamingSettings = Windows.Storage.ApplicationData.Current.RoamingSettings;
if (roamingSettings.Values.ContainsKey("userName"))
{
userNameTextBox.Text = roamingSettings.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();
}
}
// If the user entered a name and checked or cleared the 'save user name' checkbox, then clicked the back arrow,
// confirm if it was their intention to save or clear the user name without signing in.
if (this.Result == SignInResult.Nothing && !string.IsNullOrEmpty(userNameTextBox.Text))
{
if (saveUserNameCheckBox.IsChecked == false)
{
args.Cancel = true;
FlyoutBase.SetAttachedFlyout(this, (FlyoutBase)this.Resources["DiscardNameFlyout"]);
FlyoutBase.ShowAttachedFlyout(this);
}
else if (saveUserNameCheckBox.IsChecked == true && !string.IsNullOrEmpty(userNameTextBox.Text))
{
args.Cancel = true;
FlyoutBase.SetAttachedFlyout(this, (FlyoutBase)this.Resources["SaveNameFlyout"]);
FlyoutBase.ShowAttachedFlyout(this);
}
}
}
private void SaveUserName()
{
Windows.Storage.ApplicationDataContainer roamingSettings = Windows.Storage.ApplicationData.Current.RoamingSettings;
roamingSettings.Values["userName"] = userNameTextBox.Text;
}
private void ClearUserName()
{
Windows.Storage.ApplicationDataContainer roamingSettings = Windows.Storage.ApplicationData.Current.RoamingSettings;
roamingSettings.Values["userName"] = null;
userNameTextBox.Text = string.Empty;
}
// Handle the button clicks from the flyouts.
private void SaveButton_Click(object sender, RoutedEventArgs e)
{
SaveUserName();
FlyoutBase.GetAttachedFlyout(this).Hide();
}
private void DiscardButton_Click(object sender, RoutedEventArgs e)
{
ClearUserName();
FlyoutBase.GetAttachedFlyout(this).Hide();
}
// When the flyout closes, hide the sign in dialog, too.
private void Flyout_Closed(object sender, object e)
{
this.Hide();
}
}
}
Ниже приведен код, в котором отображается SignInContentDialog и используется его пользовательский SignInResult.
private async void ShowSignInDialogButton_Click(object sender, RoutedEventArgs e)
{
SignInContentDialog signInDialog = new SignInContentDialog();
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 встроенные кнопки, описывающие действия, которые пользователь может предпринять в ответ на запрос диалогового окна. Все диалоги должны иметь безопасное, неразрушающее действие. Диалоговые окна также могут содержать одно или два конкретных действия "сделать это" в ответ на запрос.
Используйте свойство CloseButtonText и , чтобы задать отображаемый текст для безопасной неразрушительной кнопки. Кнопка закрытия диалогового окна также будет вызываться при выполнении пользователем действия Отмена, например нажатия клавиши ESC или кнопки возврата системы. Используйте свойства PrimaryButtonText и SecondaryButtonText, чтобы отобразить ответы на main вопрос или действие, заданные диалоговым окном.
Свойство CloseButtonText недоступно до Windows 10 версии 1703. Если параметр "минимальная версия платформы" приложения в Microsoft Visual Studio меньше , чем "введенная версия", показанная в блоке "Требования" далее на этой странице, следует использовать свойство SecondaryButtonText . Дополнительные сведения см. в разделе Код с адаптивной версией.
Чтобы отобразить диалоговое окно, вызовите метод ShowAsync . Используйте результат этого метода, чтобы определить, какая из кнопок была нажата, если какая-либо кнопка была нажата. Если пользователь нажимает esc, системную стрелку назад или геймпад B, результатом этого метода будет Нет.
При необходимости можно выделить одну из трех кнопок в качестве кнопки диалогового окна по умолчанию. Используйте свойство DefaultButton , чтобы различать одну из кнопок. Эта кнопка будет получать визуальную обработку кнопки акцента, автоматически реагировать на клавишу ВВОД и получать фокус при открытии диалогового окна, если содержимое диалогового окна не содержит элементы, доступные для фокусировки.
Возможно, потребуется выполнить некоторые действия перед закрытием диалогового окна (например, чтобы убедиться, что пользователь ввел поля формы перед отправкой запроса). Перед закрытием диалогового окна можно выполнить работу двумя способами. Вы можете обрабатывать события PrimaryButtonClick, SecondaryButtonClick или CloseButtonClick , чтобы получить ответ пользователя при нажатии кнопки и проверить состояние диалогового окна перед его закрытием. Вы также можете обработать событие Closing , чтобы выполнить работу до закрытия диалогового окна.
Одновременно может отображаться только один ContentDialog. Чтобы связать несколько объектов ContentDialog, обработайте событие Closing первого ContentDialog. В обработчике событий Закрытия вызовите Метод ShowAsync во втором диалоговом окне, чтобы отобразить его.
Производные элементы управления со стилями WinUI
ПРИМЕЧАНИЕ. Этот раздел относится только к приложениям, которые используют WinUI 2.2 или более поздней версии.
Библиотека пользовательского интерфейса Windows 2.2 или более поздней версии содержит новый шаблон для этого элемента управления, использующий обновленные стили. Если пользовательский элемент управления является производным от существующего элемента управления XAML, он не получит стили WinUI 2 по умолчанию. Чтобы применить стили WinUI 2, выполните следующие действия.
- Создайте новый стиль с параметром TargetType , установленным для пользовательского элемента управления.
- На основе стиля по умолчанию используется элемент управления, производный от.
Один из распространенных сценариев — получение нового элемента управления от ContentDialog. В этом примере показано, как создать новый стиль, который применяется к DefaultContentDialogStyle пользовательскому диалогу.
<ContentDialog
x:Class="ExampleApp.SignInContentDialog"
... >
<ContentDialog.Resources>
<Style TargetType="local:SignInContentDialog" BasedOn="{StaticResource DefaultContentDialogStyle}"/>
...
</ContentDialog.Resources>
<!-- CONTENT -->
</ContentDialog>
ContentDialog в объектах AppWindow или XAML Island
ПРМЕЧАНИЕ. Этот раздел относится только к приложениям, предназначенным для Windows 10 версии 1903 или более поздней версии. Объекты AppWindow и XAML Island недоступны в более ранних версиях. Дополнительные сведения об управлении версиями см. в статье Приложения с адаптивным к версии кодом.
По умолчанию диалоговые окна содержимого модально связаны с корневым объектом ApplicationView. При использовании ContentDialog в объекте AppWindow или XAML Island необходимо вручную задать XamlRoot для диалогового окна, указав корень узла XAML.
Для этого задайте для свойства XamlRoot элемента ContentDialog то же значение XamlRoot, что и у элемента, уже заданного в AppWindow или XAML Island, как показано ниже.
private async void DisplayNoWifiDialog()
{
ContentDialog noWifiDialog = new ContentDialog
{
Title = "No wifi connection",
Content = "Check your connection and try again.",
CloseButtonText = "Ok"
};
// Use this code to associate the dialog to the appropriate AppWindow by setting
// the dialog's XamlRoot to the same XamlRoot as an element that is already present in the AppWindow.
if (ApiInformation.IsApiContractPresent("Windows.Foundation.UniversalApiContract", 8))
{
noWifiDialog.XamlRoot = elementAlreadyInMyAppWindow.XamlRoot;
}
ContentDialogResult result = await noWifiDialog.ShowAsync();
}
Предупреждение
В потоке может существовать только один элемент ContentDialog одновременно. Попытка открыть два элемента ContentDialogs породит исключение, даже если они пытаются открыться в отдельных объектах AppWindow.
Стиль и шаблон элемента управления
Вы можете изменить стандартные параметры Style и ControlTemplate , чтобы придать элементу управления уникальный внешний вид. Сведения об изменении стиля и шаблона элемента управления см. в разделе Стилизация элементов управления. Стиль, шаблон и ресурсы по умолчанию, определяющие внешний вид элемента управления, включаются в generic.xaml файл . В целях разработки generic.xaml доступен локально с установкой пакета SDK или Пакета NuGet.
-
Стили WinUI (рекомендуется): Обновленные стили из WinUI см. в разделе
\Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml. -
Стили, отличные от WinUI: Встроенные стили см. в разделе
%ProgramFiles(x86)%\Windows Kits\10\DesignTime\CommonConfiguration\Neutral\UAP\<SDK version>\Generic\generic.xaml.
Если вы настроили установку, расположения могут отличаться. Стили и ресурсы из разных версий пакета SDK могут иметь разные значения.
XAML также включает ресурсы, которые можно использовать для изменения цветов элемента управления в различных визуальных состояниях без изменения шаблона элемента управления. Изменение этих ресурсов предпочтительнее, чем установка таких свойств, как Background и Foreground. Дополнительные сведения см. в разделе Облегчаемые стили статьио стилях XAML . Легкие ресурсы по стилю доступны начиная с Windows 10 версии 1607 (пакет SDK 14393).
Журнал версий
| Версия Windows | Версия пакета SDK | Добавленная стоимость |
|---|---|---|
| 1703 | 15063 | CloseButtonClick |
| 1703 | 15063 | CloseButtonCommand |
| 1703 | 15063 | CloseButtonCommandParameter |
| 1703 | 15063 | CloseButtonStyle |
| 1703 | 15063 | CloseButtonText |
| 1703 | 15063 | DefaultButton |
| 1703 | 15063 | PrimaryButtonStyle |
| 1703 | 15063 | SecondaryButtonStyle |
| 1709 | 16299 | ShowAsync(ContentDialogPlacement) |
Конструкторы
| 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 |
Возвращает CoreDispatcher , с которым связан этот объект. CoreDispatcher представляет средство, которое может получить доступ к DependencyObject в потоке пользовательского интерфейса, даже если код инициируется потоком, не относящегося к пользовательскому интерфейсу. (Унаследовано от DependencyObject) |
| ElementSoundMode |
Возвращает или задает значение, указывающее предпочтительное значение элемента управления для воспроизведения звуков. (Унаследовано от Control) |
| ExitDisplayModeOnAccessKeyInvoked |
Возвращает или задает значение, указывающее, закрывается ли отображение ключа доступа при вызове ключа доступа. (Унаследовано от UIElement) |
| FlowDirection |
Возвращает или задает направление потока текста и других элементов пользовательского интерфейса в любом родительском элементе, управляющего их макетом. Этому свойству можно задать значение LeftToRight или RightToLeft. Для параметра FlowDirection значение RightToLeft для любого элемента устанавливается выравнивание справа, порядок чтения — справа налево, а макет элемента управления — справа налево. (Унаследовано от FrameworkElement) |
| FocusState |
Возвращает значение, указывающее, имеет ли этот элемент управления фокус и режим, в котором был получен фокус. (Унаследовано от Control) |
| FocusVisualMargin |
Возвращает или задает внешнее поле визуального элемента фокуса для FrameworkElement. (Унаследовано от FrameworkElement) |
| FocusVisualPrimaryBrush |
Получает или задает кисть, используемую для рисования внешней границы визуального |
| FocusVisualPrimaryThickness |
Возвращает или задает толщину внешней границы визуального элемента или |
| FocusVisualSecondaryBrush |
Получает или задает кисть, используемую для рисования внутренней границы визуального |
| FocusVisualSecondaryThickness |
Возвращает или задает толщину внутренней границы визуального элемента или |
| 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 |
Получает или задает значение, указывающее, ограничен ли фокус в границах элемента управления (для игровой площадки или удаленного взаимодействия). (Унаследовано от Control) |
| IsFocusEngagementEnabled |
Получает или задает значение, указывающее, может ли фокус быть ограничен в границах элемента управления (для игровой площадки или удаленного взаимодействия). (Унаследовано от Control) |
| IsHitTestVisible |
Возвращает или задает значение, указывающее, может ли автономная область этого элемента UIElement возвращать истинные значения для проверки попадания. (Унаследовано от UIElement) |
| IsHoldingEnabled |
Возвращает или задает значение, определяющее, может ли событие Holding исходить из этого элемента. (Унаследовано от UIElement) |
| IsLoaded |
Возвращает значение, указывающее, был ли элемент добавлен в дерево элементов и готов ли он к взаимодействию. (Унаследовано от FrameworkElement) |
| IsPrimaryButtonEnabled |
Возвращает или задает значение, указывающее, включена ли основная кнопка диалогового окна. |
| IsPrimaryButtonEnabledProperty |
Возвращает идентификатор свойства зависимости IsPrimaryButtonEnabled . |
| IsRightTapEnabled |
Возвращает или задает значение, определяющее, может ли событие RightTapped исходить из этого элемента. (Унаследовано от UIElement) |
| IsSecondaryButtonEnabled |
Возвращает или задает значение, указывающее, включена ли дополнительная кнопка диалогового окна. |
| IsSecondaryButtonEnabledProperty |
Возвращает идентификатор свойства зависимости IsSecondaryButtonEnabled . |
| IsTabStop |
Возвращает или задает значение, показывающее, включается ли элемент управления в переходы по ТАВ. (Унаследовано от Control) |
| IsTapEnabled |
Возвращает или задает значение, определяющее, может ли событие Tapped исходить из этого элемента. (Унаследовано от UIElement) |
| IsTextScaleFactorEnabled |
Возвращает или задает значение, указывающее, включено ли автоматическое увеличение текста в соответствии с параметром системного размера текста. (Унаследовано от Control) |
| KeyboardAcceleratorPlacementMode |
Возвращает или задает значение, указывающее, отображает ли подсказка элемента управления сочетание клавиш для связанного ускорителя клавиатуры. (Унаследовано от UIElement) |
| KeyboardAcceleratorPlacementTarget |
Возвращает или задает значение, указывающее подсказку элемента управления, отображающую сочетание клавиш ускорителя. (Унаследовано от UIElement) |
| KeyboardAccelerators |
Возвращает коллекцию сочетаний клавиш, которые вызывают действие с помощью клавиатуры. Ускорители обычно назначаются кнопкам или пунктам меню.
|
| 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) |
| RenderSize |
Возвращает окончательный размер отрисовки элемента UIElement. Использовать не рекомендуется, см. примечания. (Унаследовано от UIElement) |
| RenderTransform |
Возвращает или задает сведения о преобразовании, влияющие на положение отрисовки элемента UIElement. (Унаследовано от UIElement) |
| RenderTransformOrigin |
Возвращает или задает исходную точку любого возможного преобразования отрисовки, объявленного RenderTransform, относительно границ UIElement. (Унаследовано от UIElement) |
| RequestedTheme |
Возвращает или задает тему пользовательского интерфейса, используемую элементом UIElement (и его дочерними элементами) для определения ресурсов. Тема пользовательского интерфейса, указанная с помощью RequestedTheme, может переопределить элемент RequestedTheme на уровне приложения. (Унаследовано от FrameworkElement) |
| RequiresPointer |
Возвращает или задает значение, указывающее, поддерживает ли элемент пользовательского интерфейса режим мыши, который эмулирует взаимодействие указателя с устройствами ввода без указателя, такими как игровая площадка или пульт дистанционного управления. (Унаследовано от Control) |
| Resources |
Возвращает локально определенный словарь ресурсов. В XAML элементы ресурсов можно установить в качестве дочерних объектных |
| 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. (Унаследовано от Control) |
| TabNavigation |
Возвращает или задает значение, изменяющее работу tabbing и TabIndex для этого элемента управления. Примечание Для Windows 10 Creators Update (сборка 10.0.15063) и более поздней версии свойство TabFocusNavigation доступно в базовом классе UIElement для включения объектов в последовательность вкладок, не использующих ControlTemplate. |
| 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) |
| UIContext |
Возвращает идентификатор контекста для элемента . (Унаследовано от UIElement) |
| UseLayoutRounding |
Возвращает или задает значение, определяющее, должна ли отрисовка объекта и его визуального поддереви использовать поведение округления, которое выравнивает отрисовку по целым пикселям. (Унаследовано от UIElement) |
| UseSystemFocusVisuals |
Возвращает или задает значение, указывающее, использует ли элемент управления визуальные элементы фокуса, нарисованные системой, или те, которые определены в шаблоне элемента управления. (Унаследовано от Control) |
| VerticalAlignment |
Возвращает или задает характеристики вертикального выравнивания, применяемые к Объекту FrameworkElement при его создании в родительском объекте, например в элементе управления "Панель" или "Элементы". (Унаследовано от FrameworkElement) |
| VerticalContentAlignment |
Возвращает или задает способ вертикального выравнивания содержимого элемента управления. (Унаследовано от Control) |
| Visibility |
Возвращает или задает видимость uiElement. Невидимый элемент UIElement не отображается и не передает нужный размер макету. (Унаследовано от UIElement) |
| Width |
Возвращает или задает ширину элемента FrameworkElement. (Унаследовано от FrameworkElement) |
| XamlRoot |
Возвращает или задает объект , |
| XYFocusDown |
Возвращает или задает объект, который получает фокус при нажатии пользователем направленной панели (D-pad) вниз. (Унаследовано от Control) |
| XYFocusDownNavigationStrategy |
Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента навигации вниз. (Унаследовано от UIElement) |
| XYFocusKeyboardNavigation |
Возвращает или задает значение, которое включает или отключает навигацию с помощью стрелки направления клавиатуры. (Унаследовано от UIElement) |
| XYFocusLeft |
Возвращает или задает объект, который получает фокус при нажатии пользователем направленной панели (D-pad) влево. (Унаследовано от Control) |
| XYFocusLeftNavigationStrategy |
Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента левой навигации. (Унаследовано от UIElement) |
| XYFocusRight |
Возвращает или задает объект, который получает фокус при нажатии пользователем направленной панели (D-pad) вправо. (Унаследовано от Control) |
| XYFocusRightNavigationStrategy |
Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента правильной навигации. (Унаследовано от UIElement) |
| XYFocusUp |
Возвращает или задает объект, который получает фокус при нажатии пользователем направленной панели (D-pad). (Унаследовано от Control) |
| 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) |
Пытается установить фокус на элементе управления. (Унаследовано от Control) |
| GetAnimationBaseValue(DependencyProperty) |
Возвращает любое базовое значение, установленное для свойства зависимостей, которое применяется в случаях, когда анимация не активна. (Унаследовано от DependencyObject) |
| GetBindingExpression(DependencyProperty) |
Возвращает BindingExpression , представляющее привязку к указанному свойству. (Унаследовано от FrameworkElement) |
| GetChildrenInTabFocusOrder() |
Позволяет подклассу UIElement предоставлять дочерние элементы, которые принимают участие в фокусе tab. (Унаследовано от UIElement) |
| GetTemplateChild(String) |
Извлекает именованный элемент в визуальном дереве ControlTemplate , созданном экземпляром. (Унаследовано от Control) |
| GetValue(DependencyProperty) |
Возвращает текущее действующее значение свойства зависимостей из DependencyObject. (Унаследовано от DependencyObject) |
| 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. Проще говоря, это означает, что метод вызывается непосредственно перед отображением элемента пользовательского интерфейса в приложении. Переопределите этот метод, чтобы повлиять на логику post-template по умолчанию класса. (Унаследовано от 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() |
Освобождает фокус от границ элемента управления для элемента управления с фокусом (для игровой панели или удаленного взаимодействия). (Унаследовано от 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(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 |
Происходит при освобождении фокуса от границ элемента управления (для игровой площадки или удаленного взаимодействия). (Унаследовано от Control) |
| FocusEngaged |
Происходит, когда фокус ограничен в пределах границ элемента управления (для игровой площадки или удаленного взаимодействия). (Унаследовано от 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) |