TextBox Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет элемент управления, который можно использовать для отображения и редактирования обычного текста (однострочного или многострочного).
/// [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 TextBox : Control[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 TextBox : ControlPublic Class TextBox
Inherits Control<TextBox .../>
- Наследование
- Атрибуты
Требования к Windows
| Семейство устройств |
Windows 10 (появилось в 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (появилось в v1.0)
|
Примеры
Совет
Дополнительные сведения, рекомендации по проектированию и примеры кода см. в разделе Текстовое поле.
Приложения из коллекции WinUI 2 включают интерактивные примеры большинства элементов управления, возможностей и функций WinUI 2. Получите приложение из Microsoft Store или получите исходный код в GitHub.
В этом примере показан элемент TextBox с заголовком и замещающий текст. Текст из TextBox используется для отображения приветствия пользователю.
<StackPanel>
<TextBlock Text="What's your name?"/>
<StackPanel Orientation="Horizontal" Margin="0,20,0,20">
<TextBox x:Name="nameInput"
Header="Enter your name:" PlaceholderText="Name"
Width="300" HorizontalAlignment="Left"/>
<Button Content="Hello button" Click="Button_Click"/>
</StackPanel>
<TextBlock x:Name="greetingOutput"/>
</StackPanel>
private void Button_Click(object sender, RoutedEventArgs e)
{
greetingOutput.Text = "Hello, " + nameInput.Text + "!";
}
Комментарии
Совет
Дополнительные сведения, рекомендации по проектированию и примеры кода см. в разделе Текстовое поле.
Элемент управления TextBox позволяет пользователю вводить текст в приложение. Обычно он используется для записи одной строки текста. Но элемент можно настроить и для записи нескольких строк. Текст отображается на экране в простом универсальном формате открытого текста.
TextBox имеет ряд функций, которые могут упростить ввод текста:
- Он поддерживает ввод текста с клавиатуры или пера (с помощью распознавания рукописного ввода и рукописного ввода).
- В этом элементе работает привычное встроенное контекстное меню с поддержкой копирования и вставки текста.
- Кнопка "Очистить все" позволяет пользователю быстро удалить весь введенный текст.
- В нем также есть встроенные функции проверки орфографии, которые включены по умолчанию.
Ниже описано, как создать элемент TextBox в XAML и в коде.
<TextBox Width="500" Header="Notes" PlaceholderText="Type your notes here"/>
TextBox textBox = new TextBox();
textBox.Width = 500;
textBox.Header = "Notes";
textBox.PlaceholderText = "Type your notes here";
// Add the TextBox to the visual tree.
rootGrid.Children.Add(textBox);
Результирующий элемент TextBox выглядит следующим образом. Синяя граница указывает, что элемент TextBox имеет фокус.
Является ли TextBox правильным элементом управления для использования?
Для отображения и редактирования неформатированного текста можно использовать элемент управления TextBox. Если вам нужно редактируемое текстовое поле, которое принимает пароли или другие важные данные, см. PasswordBox. Если вам нужно текстовое поле для ввода поисковых запросов, см. AutoSuggestBox. Если вам нужно ввести или отредактировать отформатированный текст, см. RichEditBox.
Использование TextBox для ввода данных в форме
Обычно textBox используется для приема входных данных в форме, а свойство Text используется для получения полной текстовой строки из TextBox. Обычно для доступа к свойству Text используется такое событие, как кнопка отправки Нажмите, но вы можете обработать событие TextChanged или TextChanging , если вам нужно что-то сделать при изменении текста. Вы можете добавить верхний колонтитул (или метку) и ЗаполнительТекст (или водяной знак) в TextBox, чтобы предоставить пользователю представление о том, для чего предназначен элемент TextBox. Чтобы настроить внешний вид заголовка, можно задать свойство HeaderTemplate вместо Header. Сведения о проектировании см. в статье Руководство по использованию меток.
Вы можете ограничить число вводимых пользователем символов, настроив свойство MaxLength. Однако MaxLength не ограничивает длину вставленного текста. Используйте событие Paste, чтобы изменить вставленный текст, если это важно для вашего приложения.
TextBox содержит кнопку очистить все ("x"), которая появляется при вводе текста в поле. Когда пользователь щелкает "x", текст в элементе TextBox очищается. Это выглядит следующим образом:
Кнопка "Очистить все " отображается только для редактируемых однострочных текстовых полей, содержащих текст и имеющих фокус. Кнопка "Очистить все " не отображается ни в одном из следующих случаев:
- Параметр IsReadOnly имеет значение true.
- Параметр AcceptsReturn имеет значение true.
- TextWrapping is Wrap
Создание элемента TextBox только для чтения
TextBox можно сделать доступной только для чтения, присвоив свойству IsReadOnlyзначение true. Например, у вас может быть элемент TextBox для пользовательских комментариев, который включается только при определенных условиях. Элемент TextBox можно сделать предназначенным только для чтения, пока не будут выполняться эти условия. Если вам нужен только текст, рассмотрите возможность использования TextBlock или RichTextBlock .
Включение многострочного ввода
Существует два свойства, которые определяют, отображает ли TextBox текст на нескольких строках.
- Чтобы позволить текстовому полю разрешать и отображать символы новой строки или возврата, установите для свойства AcceptsReturn значение true.
- Чтобы включить обтекание текстом, установите для свойства TextWrapping значение Wrap. (TextBox не поддерживает значение перечисления TextWrapping.WrapWholeWords .) Многострочный элемент TextBox будет продолжать увеличиваться по вертикали по мере ввода текста, если он не ограничен его свойством Height или MaxHeight или родительским контейнером. Следует проверить, что многострочный элемент TextBox не вырастает за пределы видимой области, и ограничить его рост, если это так. Прокрутка с помощью колесика прокрутки или пальца включается автоматически по мере необходимости. Однако вертикальные полосы прокрутки не отображаются по умолчанию. Чтобы отобразить вертикальные полосы прокрутки, установите для свойства ScrollViewer.VerticalScrollBarVisibility значение Auto во встроенном ScrollViewer, как показано ниже.
<TextBox AcceptsReturn="True" TextWrapping="Wrap"
MaxHeight="172" Width="300" Header="Description"
ScrollViewer.VerticalScrollBarVisibility="Auto"/>
TextBox textBox = new TextBox();
textBox.AcceptsReturn = true;
textBox.TextWrapping = TextWrapping.Wrap;
textBox.MaxHeight = 172;
textBox.Width = 300;
textBox.Header = "Description";
ScrollViewer.SetVerticalScrollBarVisibility(textBox, ScrollBarVisibility.Auto);
Вот как выглядит элемент TextBox после добавления текста.
Форматирование отображаемого текста
Используйте свойство TextAlignment для выравнивания текста в элементе TextBox. Чтобы выровнять элемент TextBox в макете страницы, используйте свойства HorizontalAlignment и VerticalAlignment .
Хотя TextBox поддерживает только неформатированный текст, вы можете настроить отображение текста в TextBox в соответствии с фирменной символике. Можно задать стандартные свойства Control, например, FontFamily, FontSize, FontStyle, Background, Foreground и CharacterSpacing, чтобы изменить внешний вид текста. Эти свойства влияют только на то, как TextBox отображает текст локально, поэтому, например, если вы хотите скопировать и вставить текст в элемент управления форматированным текстом, форматирование не будет применено.
В этом примере показан элемент TextBox только для чтения с несколькими свойствами, заданными для настройки внешнего вида текста.
<TextBox Text="Sample Text" IsReadOnly="True"
FontFamily="Verdana" FontSize="24"
FontWeight="Bold" FontStyle="Italic"
CharacterSpacing="200" Width="300"
Foreground="Blue" Background="Beige"/>
TextBox textBox = new TextBox();
textBox.Text = "Sample Text";
textBox.IsReadOnly = true;
textBox.FontFamily = new FontFamily("Verdana");
textBox.FontSize = 24;
textBox.FontWeight = Windows.UI.Text.FontWeights.Bold;
textBox.FontStyle = Windows.UI.Text.FontStyle.Italic;
textBox.CharacterSpacing = 200;
textBox.Width = 300;
textBox.Background = new SolidColorBrush(Windows.UI.Colors.Beige);
textBox.Foreground = new SolidColorBrush(Windows.UI.Colors.Blue);
// Add the TextBox to the visual tree.
rootGrid.Children.Add(textBox);
Результирующий элемент TextBox выглядит следующим образом.
Ввод с помощью пера
Начиная с Windows 10 версии 1803, в функции поля для ввода текста XAML реализована поддержка ввода с помощью пера при использовании Windows Ink. Когда пользователь касается пером Windows поля текстового ввода, текстовое поле преобразуется, чтобы пользователь мог писать непосредственно в поле с помощью пера, а не в отдельной панели ввода.
Дополнительные сведения см. в статье о поле рукописного ввода текста.
Изменение контекстного меню
По умолчанию команды, отображаемые в контекстном меню TextBox, зависят от состояния элемента TextBox. Например, следующие команды могут отображаться, если элемент TextBox доступен для редактирования.
| Команда | Отображается, когда... |
|---|---|
| Копировать | ...текст выделен. |
| Вырезать | ...текст выделен. |
| Вставить | ...буфер обмена содержит текст. |
| Выбрать все | ...элемент TextBox содержит текст. |
| Отмена | ...текст был изменен. |
Чтобы изменить команды, отображаемые в контекстном меню, обрабатывайте событие ContextMenuOpening. Пример см. в разделе Настройка CommandBarFlyout RichEditBox в примере добавления "Общий доступ" в коллекцию WinUI 2. Сведения о проектировании см. в разделе Рекомендации по контекстным меню.
Выделение, копирование и вставка
Вы можете получить или задать выделенный текст в элементе TextBox с помощью свойства SelectedText . Чтобы управлять выделением текста, используйте свойства SelectionStart и SelectionLength, а также методы Select и SelectAll. Событие SelectionChanged позволяет выполнять действия, пока пользователь выбирает или отменяет выбор текста. Вы можете изменить цвет, используемый для выделения выбранного текста, настроив свойство SelectionHighlightColor.
Элемент TextBox поддерживает копирование и вставку по умолчанию. Вы можете реализовать в приложении пользовательскую обработку события Paste в редактируемых текстовых элементах управления. Например, можно удалить разрывы строк из многострочного адреса при вставке в однострочное поле поиска. Или вы можете проверить длину вставленного текста и предупредить пользователя, если превышает максимальную длину текста, который можно сохранить в базе данных. Дополнительные сведения и примеры см. в статье о событии Paste.
Использование текстового поля с сенсорной клавиатурой
Сенсорная клавиатура позволяет вводить текст, если приложение выполняется на устройстве с сенсорным экраном. TextBox предоставляет свойства, которые можно задать, чтобы пользователи могли гораздо быстрее и проще вводить данные в приложение с помощью сенсорной клавиатуры. Задайте свойство InputScope в соответствии с типом данных, которые пользователь должен ввести. Например, если Элемент TextBox используется только для ввода 4-значного ПИН-кода, задайте для свойства InputScope значение Number. Это сообщает системе, что нужно отобразить раскладку цифровой клавиатуры, благодаря чему пользователю проще вводить PIN-код.
Другие свойства, влияющие на сенсорную клавиатуру: IsSpellCheckEnabled, IsTextPredictionEnabled и PreventKeyboardDisplayOnProgrammaticFocus. (IsSpellCheckEnabled также влияет на TextBox при использовании аппаратной клавиатуры.) Дополнительные сведения и примеры см. в статье Использование область ввода для изменения сенсорной клавиатуры и в документации по свойствам.
Стиль и шаблон элемента управления
Вы можете изменить стандартные параметры 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).
Ресурсы, которые начинаются с TextControl , совместно TextBoxиспользуются , PasswordBox, RichEditBox и AutoSuggestBox. Изменения в этих ресурсах повлияют на все четыре элемента управления.
Журнал версий
| Версия Windows | Версия пакета SDK | Добавленная стоимость |
|---|---|---|
| 1511 | 10586 | GetLinguisticAlternativesAsync |
| 1703 | 15063 | SelectionHighlightColorWhenNotFocused |
| 1709 | 16299 | BeforeTextChanging |
| 1709 | 16299 | CharacterCasing |
| 1709 | 16299 | CopyingToClipboard |
| 1709 | 16299 | CuttingToClipboard |
| 1709 | 16299 | HorizontalTextAlignment |
| 1709 | 16299 | ЗаполнительForeground |
| 1803 | 17134 | HandwritingView; |
| 1803 | 17134 | IsHandwritingViewEnabled |
| 1809 | 17763 | CanPasteClipboardContent |
| 1809 | 17763 | CanRedo |
| 1809 | 17763 | Канундо |
| 1809 | 17763 | ClearUndoRedoHistory |
| 1809 | 17763 | CopySelectionToClipboard |
| 1809 | 17763 | CutSelectionToClipboard |
| 1809 | 17763 | Описание |
| 1809 | 17763 | PasteFromClipboard |
| 1809 | 17763 | ProofingMenuFlyout |
| 1809 | 17763 | Повторить |
| 1809 | 17763 | SelectionChanging |
| 1809 | 17763 | SelectionFlyout |
| 1809 | 17763 | Отменить |
Конструкторы
| TextBox() |
Инициализирует новый экземпляр класса TextBox . |
Свойства
| AcceptsReturn |
Возвращает или задает значение, определяющее, допускает ли текстовое поле и отображает символы новой строки или возвращаемого значения. |
| AcceptsReturnProperty |
Определяет свойство зависимостей AcceptsReturn . |
| 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) |
| CanPasteClipboardContent |
Возвращает значение, указывающее, можно ли вставить содержимое буфера обмена в элемент управления . |
| CanPasteClipboardContentProperty |
Определяет свойство зависимости CanPasteClipboardContent. |
| CanRedo |
Возвращает значение, указывающее, содержит ли буфер повтора действие, которое можно повторить. |
| CanRedoProperty |
Определяет свойство зависимостей CanRedo. |
| CanUndo |
Возвращает значение, указывающее, содержит ли буфер отмены действие, которое можно отменить. |
| CanUndoProperty |
Определяет свойство зависимостей CanUndo. |
| CenterPoint |
Возвращает или задает центральную точку элемента, то есть точку, относительно которой происходит поворот или масштабирование. Влияет на позицию отрисовки элемента. (Унаследовано от UIElement) |
| CharacterCasing |
Возвращает или задает значение, указывающее, как элемент управления изменяет регистр символов по мере их ввода. |
| CharacterCasingProperty |
Определяет свойство зависимости CharacterCasing. |
| CharacterSpacing |
Возвращает или задает равномерный интервал между символами в единицах 1/1000 em. (Унаследовано от Control) |
| Clip |
Возвращает или задает объект RectangleGeometry, используемый для определения контура содержимого элемента UIElement. (Унаследовано от UIElement) |
| CompositeMode |
Возвращает или задает свойство, объявляющее альтернативные режимы композиции и смешивания для элемента в родительском макете и окне. Это относится к элементам, участвующим в смешанном пользовательском интерфейсе XAML/Microsoft DirectX. (Унаследовано от UIElement) |
| ContextFlyout |
Возвращает или задает всплывающий элемент, связанный с этим элементом. (Унаследовано от UIElement) |
| CornerRadius |
Возвращает или задает радиус для углов границы элемента управления. (Унаследовано от Control) |
| DataContext |
Возвращает или задает контекст данных для Объекта FrameworkElement. Контекст данных часто используется, когда FrameworkElement использует расширение разметки {Binding} и участвует в привязке данных. (Унаследовано от FrameworkElement) |
| DefaultStyleKey |
Возвращает или задает ключ, который ссылается на стиль по умолчанию для элемента управления . Авторы пользовательских элементов управления используют это свойство для изменения стиля по умолчанию, используемого их элементом управления. (Унаследовано от Control) |
| DefaultStyleResourceUri |
Возвращает или задает путь к файлу ресурсов, который содержит стиль по умолчанию для элемента управления . (Унаследовано от Control) |
| Description |
Возвращает или задает содержимое, отображаемое под элементом управления . Содержимое должно предоставлять рекомендации по входным данным, ожидаемым элементом управления. |
| DescriptionProperty |
Определяет свойство зависимости Description. |
| DesiredCandidateWindowAlignment |
Возвращает или задает значение, указывающее предпочтительное выравнивание редактора метода ввода (IME). |
| DesiredCandidateWindowAlignmentProperty |
Определяет свойство зависимости DesiredCandidateWindowAlignment . |
| 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) |
| HandwritingView |
Возвращает или задает элемент управления HandwritingView , связанный с этим текстовым элементом управления. |
| HandwritingViewProperty |
Определяет свойство зависимости HandwritingView. |
| Header |
Возвращает или задает содержимое заголовка элемента управления. |
| HeaderProperty |
Идентифицирует свойство зависимости заголовка . |
| HeaderTemplate |
Возвращает или задает объект DataTemplate, используемый для отображения содержимого заголовка элемента управления. |
| HeaderTemplateProperty |
Определяет свойство зависимости HeaderTemplate . |
| Height |
Возвращает или задает предполагаемую высоту объекта FrameworkElement. (Унаследовано от FrameworkElement) |
| HighContrastAdjustment |
Возвращает или задает значение, указывающее, настраивает ли платформа автоматически визуальные свойства элемента при включении тем с высокой контрастностью. (Унаследовано от UIElement) |
| HorizontalAlignment |
Возвращает или задает характеристики горизонтального выравнивания, применяемые к Объекту FrameworkElement при его создании в родительском элементе макета, например в элементе управления "Панель" или "Элементы". (Унаследовано от FrameworkElement) |
| HorizontalContentAlignment |
Возвращает или задает способ горизонтального выравнивания содержимого элемента управления. (Унаследовано от Control) |
| HorizontalTextAlignment |
Возвращает или задает значение, указывающее, как выравнивается текст в элементе TextBox. |
| HorizontalTextAlignmentProperty |
Определяет свойство зависимости HorizontalTextAlignment. |
| InputScope |
Возвращает или задает контекст для входных данных, используемых этим элементом TextBox. |
| InputScopeProperty |
Определяет свойство зависимостей InputScope. |
| IsAccessKeyScope |
Возвращает или задает значение, указывающее, определяет ли элемент собственный ключ доступа область. (Унаследовано от UIElement) |
| IsColorFontEnabled |
Возвращает или задает значение, определяющее, отображаются ли глифы шрифта, содержащие цветовые слои, такие как Смайлики пользовательского интерфейса Segoe. |
| IsColorFontEnabledProperty |
Определяет свойство зависимости IsColorFontEnabled . |
| IsDoubleTapEnabled |
Возвращает или задает значение, определяющее, может ли событие DoubleTapped исходить из этого элемента. (Унаследовано от UIElement) |
| IsEnabled |
Возвращает или задает значение, указывающее, может ли пользователь взаимодействовать с элементом управления. (Унаследовано от Control) |
| IsFocusEngaged |
Возвращает или задает значение, указывающее, ограничен ли фокус в пределах элемента управления (для игровой площадки или удаленного взаимодействия). (Унаследовано от Control) |
| IsFocusEngagementEnabled |
Возвращает или задает значение, указывающее, можно ли ограничить фокус в пределах элемента управления (для игровой площадки или удаленного взаимодействия). (Унаследовано от Control) |
| IsHandwritingViewEnabled |
Возвращает или задает значение, указывающее, может ли пользователь вводить текст в представлении рукописного ввода. |
| IsHandwritingViewEnabledProperty |
Определяет свойство зависимости IsHandwritingViewEnabled. |
| IsHitTestVisible |
Возвращает или задает значение, указывающее, может ли автономная область этого элемента UIElement возвращать истинные значения для проверки попадания. (Унаследовано от UIElement) |
| IsHoldingEnabled |
Возвращает или задает значение, определяющее, может ли событие Holding исходить из этого элемента. (Унаследовано от UIElement) |
| IsLoaded |
Возвращает значение, указывающее, был ли элемент добавлен в дерево элементов и готов ли он к взаимодействию. (Унаследовано от FrameworkElement) |
| IsReadOnly |
Возвращает или задает значение, определяющее, может ли пользователь изменить текст в текстовом поле. |
| IsReadOnlyProperty |
Определяет свойство зависимости IsReadOnly . |
| IsRightTapEnabled |
Возвращает или задает значение, определяющее, может ли событие RightTapped исходить из этого элемента. (Унаследовано от UIElement) |
| IsSpellCheckEnabled |
Возвращает или задает значение, указывающее, взаимодействует ли входной элемент TextBox с обработчиком орфографии проверка. |
| IsSpellCheckEnabledProperty |
Определяет свойство зависимостей IsSpellCheckEnabled . |
| IsTabStop |
Возвращает или задает значение, показывающее, включается ли элемент управления в переходы по ТАВ. (Унаследовано от Control) |
| IsTapEnabled |
Возвращает или задает значение, определяющее, может ли событие Tapped исходить из этого элемента. (Унаследовано от UIElement) |
| IsTextPredictionEnabled |
Возвращает или задает значение, определяющее, должны ли быть включены функции прогнозирования текста ("автозавершение") для этого элемента TextBox. |
| IsTextPredictionEnabledProperty |
Определяет свойство зависимости IsTextPredictionEnabled . |
| 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) |
| MaxLength |
Возвращает или задает значение, указывающее максимальное число символов, допустимое для ввода пользователем. |
| MaxLengthProperty |
Определяет свойство зависимости MaxLength . |
| 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) |
| PlaceholderForeground |
Возвращает или задает кисть, описывающую цвет текста заполнителя. |
| PlaceholderForegroundProperty |
Определяет свойство зависимости PlaceholderForeground. |
| PlaceholderText |
Возвращает или задает текст, отображаемый в элементе управления, пока значение не будет изменено действием пользователя или какой-либо другой операцией. |
| PlaceholderTextProperty |
Определяет свойство зависимости PlaceholderText . |
| PointerCaptures |
Возвращает набор всех захваченных указателей, представленных в виде значений указателя . (Унаследовано от UIElement) |
| PreventKeyboardDisplayOnProgrammaticFocus |
Возвращает или задает значение, указывающее, отображается ли экранная клавиатура, когда элемент управления получает фокус программным способом. |
| PreventKeyboardDisplayOnProgrammaticFocusProperty |
Определяет свойство зависимости PreventKeyboardDisplayOnProgrammaticFocus . |
| Projection |
Возвращает или задает проекцию перспективы (трехмерный эффект), применяемую при отрисовке этого элемента. (Унаследовано от UIElement) |
| ProofingMenuFlyout |
Возвращает всплывающий элемент, показывающий команды проверки правописания. |
| ProofingMenuFlyoutProperty |
Определяет свойство зависимости ProofingMenuFlyout . |
| 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) |
| SelectedText |
Получает или задает содержимое текущего выделения в текстовом поле. |
| SelectionFlyout |
Возвращает или задает всплывающий элемент, отображаемый при выделении текста с помощью сенсорного ввода или ввода пером. |
| SelectionFlyoutProperty |
Определяет свойство зависимости SelectionFlyout. |
| SelectionHighlightColor |
Возвращает или задает кисть, используемую для выделения выделенного текста. |
| SelectionHighlightColorProperty |
Определяет свойство зависимости SelectionHighlightColor . |
| SelectionHighlightColorWhenNotFocused |
Получает или задает кисть, используемую для выделения выделенного текста, если элемент TextBox не имеет фокуса. |
| SelectionHighlightColorWhenNotFocusedProperty |
Определяет свойство зависимости SelectionHighlightColorWhenNotFocused . |
| SelectionLength |
Возвращает или задает количество символов в текущем выделении в текстовом поле. |
| SelectionStart |
Возвращает или задает начальную позицию текста, выделенного в текстовом поле. Если свойство SelectionLength равно 0 (выделенный текст отсутствует), свойство SelectionStart соответствует позиции курсора. |
| 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) |
| Text |
Возвращает или задает текстовое содержимое текстового поля. |
| TextAlignment |
Возвращает или задает способ выравнивания текста по горизонтали в текстовом поле. |
| TextAlignmentProperty |
Определяет свойство зависимости TextAlignment . |
| TextProperty |
Идентифицирует свойство зависимости Text . |
| TextReadingOrder |
Возвращает или задает значение, указывающее, как определяется порядок чтения для элемента TextBox. |
| TextReadingOrderProperty |
Определяет свойство зависимости TextReadingOrder . |
| TextWrapping |
Возвращает или задает способ разрыва строки, если строка текста выходит за пределы доступной ширины текстового поля. |
| TextWrappingProperty |
Определяет свойство зависимостей TextWrapping . |
| 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) |
| ClearUndoRedoHistory() |
Очищает буферы отмены и повтора. |
| ClearValue(DependencyProperty) |
Очищает локальное значение свойства зависимостей. (Унаследовано от DependencyObject) |
| CopySelectionToClipboard() |
Копирует выбранное содержимое в буфер обмена Windows. |
| CutSelectionToClipboard() |
Перемещает выбранное содержимое в буфер обмена Windows и удаляет его из текстового элемента управления. |
| FindName(String) |
Извлекает объект с указанным именем идентификатора. (Унаследовано от FrameworkElement) |
| FindSubElementsForTouchTargeting(Point, Rect) |
Позволяет подклассу UIElement предоставлять дочерние элементы, помогающие в разрешении сенсорного нацеливания. (Унаследовано от UIElement) |
| Focus(FocusState) |
Пытается установить фокус на элементе управления. (Унаследовано от Control) |
| GetAnimationBaseValue(DependencyProperty) |
Возвращает любое базовое значение, установленное для свойства зависимостей, которое применяется в случаях, когда анимация не активна. (Унаследовано от DependencyObject) |
| GetBindingExpression(DependencyProperty) |
Возвращает bindingExpression , представляющее привязку к указанному свойству. (Унаследовано от FrameworkElement) |
| GetChildrenInTabFocusOrder() |
Позволяет подклассу UIElement предоставлять дочерние элементы, которые принимают участие в фокусе tab. (Унаследовано от UIElement) |
| GetLinguisticAlternativesAsync() |
Асинхронно получает список слов-кандидатов на основе предоставленных фонетических символов в редакторе метода ввода (IME). |
| GetRectFromCharacterIndex(Int32, Boolean) |
Возвращает прямоугольную область для переднего или конечного края символа по определенному индексу символа. |
| GetTemplateChild(String) |
Извлекает именованный элемент в созданном визуальном дереве ControlTemplate . (Унаследовано от Control) |
| GetValue(DependencyProperty) |
Возвращает текущее действующее значение свойства зависимостей из DependencyObject. (Унаследовано от DependencyObject) |
| GoToElementStateCore(String, Boolean) |
При реализации в производном классе позволяет создавать визуальное дерево для шаблона элемента управления в коде, а не загружать XAML для всех состояний при запуске элемента управления. (Унаследовано от FrameworkElement) |
| InvalidateArrange() |
Делает недействительным состояние упорядочения (макет) для UIElement. После аннулирования макет UIElement будет обновлен, что будет происходить асинхронно. (Унаследовано от UIElement) |
| InvalidateMeasure() |
Делает недействительным состояние измерения (макет) для элемента UIElement. (Унаследовано от UIElement) |
| InvalidateViewport() |
Делает недействительным состояние окна просмотра для элемента UIElement , используемого для вычисления действующего окна просмотра. (Унаследовано от FrameworkElement) |
| Measure(Size) |
Обновления DesiredSizeэлемента UIElement. Как правило, объекты, реализующие пользовательский макет для дочерних элементов макета, вызывают этот метод из собственных реализаций MeasureOverride , чтобы сформировать рекурсивное обновление макета. (Унаследовано от UIElement) |
| MeasureOverride(Size) |
Предоставляет поведение для прохода "Measure" цикла макета. Классы могут переопределить этот метод, чтобы определить собственное поведение прохода "Measure". (Унаследовано от FrameworkElement) |
| OnApplyTemplate() |
Вызывается всякий раз, когда код приложения или внутренние процессы (например, перестроение макета) вызывают Метод ApplyTemplate. Проще говоря, это означает, что метод вызывается непосредственно перед отображением элемента пользовательского интерфейса в приложении. Переопределите этот метод, чтобы повлиять на логику после шаблона класса по умолчанию. (Унаследовано от FrameworkElement) |
| OnBringIntoViewRequested(BringIntoViewRequestedEventArgs) |
Вызывается перед событием BringIntoViewRequested . (Унаследовано от UIElement) |
| OnCharacterReceived(CharacterReceivedRoutedEventArgs) |
Вызывается перед событием CharacterReceived . (Унаследовано от Control) |
| 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) |
| PasteFromClipboard() |
Копирует содержимое из буфера обмена Windows в текстовый элемент управления. |
| PopulatePropertyInfo(String, AnimationPropertyInfo) |
Определяет свойство, которое можно анимировать. (Унаследовано от UIElement) |
| PopulatePropertyInfoOverride(String, AnimationPropertyInfo) |
При переопределении в производном классе определяет свойство, которое можно анимировать. (Унаследовано от UIElement) |
| ReadLocalValue(DependencyProperty) |
Возвращает локальное значение свойства зависимостей, если задано локальное значение. (Унаследовано от DependencyObject) |
| Redo() |
Повторно применяет первое действие в буфере повтора. |
| RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Регистрирует функцию уведомления для прослушивания изменений определенной DependencyProperty в этом экземпляре DependencyObject . (Унаследовано от DependencyObject) |
| ReleasePointerCapture(Pointer) |
Освобождает записи указателя для захвата одного конкретного указателя данным элементом UIElement. (Унаследовано от UIElement) |
| ReleasePointerCaptures() |
Освобождает все записи указателей, хранящиеся в этом элементе. (Унаследовано от UIElement) |
| RemoveFocusEngagement() |
Освобождает фокус от границ элемента управления для элемента управления, который включает фокус (для игровой площадки или удаленного взаимодействия). (Унаследовано от Control) |
| RemoveHandler(RoutedEvent, Object) |
Удаляет указанный обработчик перенаправленных событий из этого элемента UIElement. Как правило, рассматриваемый обработчик был добавлен с помощью AddHandler. (Унаследовано от UIElement) |
| Select(Int32, Int32) |
Выбирает диапазон текста в текстовом поле. |
| SelectAll() |
Выделяет все содержимое текстового поля. |
| SetBinding(DependencyProperty, BindingBase) |
Присоединяет привязку к FrameworkElement, используя предоставленный объект привязки. (Унаследовано от FrameworkElement) |
| SetValue(DependencyProperty, Object) |
Задает локальное значение свойства зависимостей для Объекта DependencyObject. (Унаследовано от DependencyObject) |
| StartAnimation(ICompositionAnimationBase) |
Начинает указанную анимацию элемента. (Унаследовано от UIElement) |
| StartBringIntoView() |
Инициирует запрос к платформе XAML для представления элемента в любых прокручиваемых областях, в которые он содержится. (Унаследовано от UIElement) |
| StartBringIntoView(BringIntoViewOptions) |
Инициирует запрос к платформе XAML для вывода элемента в представление с помощью указанных параметров. (Унаследовано от UIElement) |
| StartDragAsync(PointerPoint) |
Инициирует операцию перетаскивания. (Унаследовано от UIElement) |
| StopAnimation(ICompositionAnimationBase) |
Останавливает указанную анимацию в элементе . (Унаследовано от UIElement) |
| TransformToVisual(UIElement) |
Возвращает объект преобразования, который можно использовать для преобразования координат из UIElement в указанный объект. (Унаследовано от UIElement) |
| TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs) |
Пытается вызвать сочетание клавиш (или ускоритель), выполнив поиск сочетания клавиш во всем визуальном дереве UIElement. (Унаследовано от UIElement) |
| Undo() |
Отменяет первое действие в буфере отмены. |
| UnregisterPropertyChangedCallback(DependencyProperty, Int64) |
Отменяет уведомление об изменениях, которое было ранее зарегистрировано путем вызова метода RegisterPropertyChangedCallback. (Унаследовано от DependencyObject) |
| UpdateLayout() |
Обеспечивает правильное обновление всех положений дочерних объектов UIElement для макета. (Унаследовано от UIElement) |
События
| AccessKeyDisplayDismissed |
Происходит, когда ключи доступа больше не должны отображаться. (Унаследовано от UIElement) |
| AccessKeyDisplayRequested |
Происходит, когда пользователь запрашивает отображение ключей доступа. (Унаследовано от UIElement) |
| AccessKeyInvoked |
Происходит, когда пользователь завершает последовательность ключей доступа. (Унаследовано от UIElement) |
| ActualThemeChanged |
Происходит при изменении значения свойства ActualTheme. (Унаследовано от FrameworkElement) |
| BeforeTextChanging |
Происходит синхронно, когда текст в текстовом поле начинает изменяться, но до обновления свойства Text . |
| BringIntoViewRequested |
Происходит при вызове StartBringIntoView для этого элемента или одного из его потомков. (Унаследовано от UIElement) |
| CandidateWindowBoundsChanged |
Происходит при открытии, обновлении или закрытии окна редактора метода ввода (IME). |
| CharacterReceived |
Происходит при получении одного составного символа входной очередью. (Унаследовано от UIElement) |
| ContextCanceled |
Происходит, когда жест ввода контекста переходит в жест манипуляции, чтобы уведомить элемент о том, что всплывающий элемент контекста не должен открываться. (Унаследовано от UIElement) |
| ContextMenuOpening |
Происходит, когда система обрабатывает взаимодействие, отображающее контекстное меню. |
| ContextRequested |
Происходит, когда пользователь завершил жест ввода контекста, например щелчок правой кнопкой мыши. (Унаследовано от UIElement) |
| CopyingToClipboard |
Происходит перед перемещением скопированного текста в буфер обмена. |
| CuttingToClipboard |
Происходит перед перемещением вырезанного текста в буфер обмена. |
| 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) |
| Paste |
Происходит при вставлении текста в элемент управления . |
| PointerCanceled |
Происходит, когда указатель, создающий контакт, теряет контакт. (Унаследовано от UIElement) |
| PointerCaptureLost |
Происходит, когда захват указателя, ранее удерживаемый этим элементом, перемещается в другой элемент или в другое место. (Унаследовано от UIElement) |
| PointerEntered |
Происходит, когда указатель входит в область проверки попадания этого элемента. (Унаследовано от UIElement) |
| PointerExited |
Происходит, когда указатель покидает область проверки попадания этого элемента. (Унаследовано от UIElement) |
| PointerMoved |
Происходит при перемещении указателя, в то время как указатель остается в области проверки попадания этого элемента. (Унаследовано от UIElement) |
| PointerPressed |
Происходит, когда указатель инициирует действие Нажатие в этом элементе. (Унаследовано от UIElement) |
| PointerReleased |
Происходит при освобождении устройства указателя, которое ранее инициировало действие Нажатие , в этом элементе. Обратите внимание, что окончание действия Нажатие не гарантирует срабатывание события PointerReleased. Вместо этого могут возникать другие события. Дополнительные сведения см. в разделе Примечания. (Унаследовано от UIElement) |
| PointerWheelChanged |
Происходит при изменении разностного значения колесика указателя. (Унаследовано от UIElement) |
| PreviewKeyDown |
Происходит при нажатии клавиши клавиатуры, когда элемент UIElement находится в фокусе. (Унаследовано от UIElement) |
| PreviewKeyUp |
Происходит при отпускание клавиши клавиатуры, когда элемент UIElement находится в фокусе. (Унаследовано от UIElement) |
| ProcessKeyboardAccelerators |
Происходит при нажатии сочетания клавиш (или сочетания клавиш). (Унаследовано от UIElement) |
| RightTapped |
Возникает при возникновении стимула ввода правой кнопкой касания, когда указатель находится над элементом. (Унаследовано от UIElement) |
| SelectionChanged |
Происходит при изменении выделения текста. |
| SelectionChanging |
Происходит, когда выделение текста начинает изменяться. |
| SizeChanged |
Происходит при изменении значения свойства ActualHeight или ActualWidth в FrameworkElement. (Унаследовано от FrameworkElement) |
| Tapped |
Происходит, когда в противном случае происходит необработанное взаимодействие с касанием в области проверки попадания этого элемента. (Унаследовано от UIElement) |
| TextChanged |
Происходит при изменении содержимого в текстовом поле. |
| TextChanging |
Происходит синхронно, когда текст в текстовом поле начинает изменяться, но до его отрисовки. |
| TextCompositionChanged |
Происходит при изменении текста, создаваемого с помощью редактора метода ввода (IME). |
| TextCompositionEnded |
Происходит, когда пользователь перестает создавать текст с помощью редактора метода ввода (IME). |
| TextCompositionStarted |
Происходит, когда пользователь начинает создавать текст с помощью редактора метода ввода (IME). |
| Unloaded |
Происходит, когда этот объект больше не подключен к дереву объектов main. (Унаследовано от FrameworkElement) |
Применяется к
См. также раздел
- PasswordBox
- RichEditBox
- RichTextBlock
- SearchBox
- Общие сведения о текстовом поле
- Использование область ввода для изменения сенсорной клавиатуры
- Пример редактирования текста на XAML
- Руководство по проверке орфографии
- Список элементов управления
- Элементы управления по функциям
- Пример ввода текста с сенсорной клавиатуры (Windows 10)
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по