ScrollViewer Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет прокручиваемую область, которая может содержать другие видимые элементы.
public ref class ScrollViewer sealed : ContentControl, IScrollAnchorProvider
/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ScrollViewer final : ContentControl, IScrollAnchorProvider
[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ScrollViewer : ContentControl, IScrollAnchorProvider
Public NotInheritable Class ScrollViewer
Inherits ContentControl
Implements IScrollAnchorProvider
<ScrollViewer .../>
-or-
<ScrollViewer ...>
content
</ScrollViewer>
- Наследование
-
Object Platform::Object IInspectable DependencyObject UIElement FrameworkElement Control ContentControl ScrollViewer
- Атрибуты
- Реализации
Примеры
Tip
Дополнительные сведения, рекомендации по проектированию и примеры кода см. в разделе "Элементы управления средства просмотра прокрутки".
Приложение Галерея WinUI 3 включает интерактивные примеры большинства элементов управления, особенностей и возможностей WinUI 3. Получите приложение из Microsoft Store или получите исходный код в GitHub.
Следующий КОД XAML создает большой TextBlock внутри ScrollViewer, а также другую копию TextBlock для сравнения.
<StackPanel>
<!-- A large TextBlock. -->
<TextBlock Width="300" TextWrapping="Wrap" Margin="0,0,0,30"
Text="Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed ac mi ipsum. Phasellus vel malesuada mauris. Donec pharetra, enim sit amet mattis tincidunt, felis nisi semper lectus, vel porta diam nisi in augue. Pellentesque lacus tortor, aliquam et faucibus id, rhoncus ut justo. Sed id lectus odio, eget pulvinar diam. Suspendisse eleifend ornare libero, in luctus purus aliquet non. Sed interdum, sem vitae rutrum rhoncus, felis ligula ultrices sem, in eleifend eros ante id neque." />
<!-- The same large TextBlock, wrapped in a ScrollViewer. -->
<ScrollViewer Height="200" Width="200"
HorizontalScrollBarVisibility="Auto"
VerticalScrollBarVisibility="Auto">
<TextBlock Width="300" TextWrapping="Wrap"
Text="Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed ac mi ipsum. Phasellus vel malesuada mauris. Donec pharetra, enim sit amet mattis tincidunt, felis nisi semper lectus, vel porta diam nisi in augue. Pellentesque lacus tortor, aliquam et faucibus id, rhoncus ut justo. Sed id lectus odio, eget pulvinar diam. Suspendisse eleifend ornare libero, in luctus purus aliquet non. Sed interdum, sem vitae rutrum rhoncus, felis ligula ultrices sem, in eleifend eros ante id neque." />
</ScrollViewer>
</StackPanel>
Комментарии
Tip
Дополнительные сведения, рекомендации по проектированию и примеры кода см. в разделе "Элементы управления средства просмотра прокрутки".
ScrollViewer — это элемент управления контейнером, позволяющий пользователю сдвигать содержимое и масштабировать его содержимое.
ScrollViewer позволяет отображать содержимое в меньшей области, чем фактический размер. Если содержимое ScrollViewer не является полностью видимым, ScrollViewer отображает полосы прокрутки, которые пользователь может использовать для перемещения видимых областей содержимого. Область, содержащая все содержимое ScrollViewer, является экстентом. Видимая область содержимого — это окно просмотра.
Обычно элемент управления ScrollViewer существует как составная часть других элементов управления. Часть ScrollViewer вместе с классом ScrollContentPresenter для поддержки будет отображать окно просмотра вместе с полосами прокрутки, только если пространство макета элемента управления узла ограничивается меньше, чем размер развернутого содержимого. Это часто относится к спискам, поэтому шаблоны ListView и GridView всегда включают ScrollViewer . TextBox и RichEditBox также включают ScrollViewer в свои шаблоны.
Если часть ScrollViewer в элементе управления существует, элемент управления узла часто имеет встроенную обработку событий для определенных входных событий и манипуляций, позволяющих прокручивать содержимое. Например, GridView интерпретирует жест прокрутки, и это приводит к горизонтальной прокрутке содержимого. Входные события и необработанные манипуляции, получаемые элементом управления узла, обрабатываются элементом управления, а события нижнего уровня, такие как PointerPressed , не будут вызываться и не будут пузыриться на родительские контейнеры. Вы можете изменить некоторые встроенные средства управления, переопределив класс элемента управления и виртуальные методы OnEvent для событий или перенастроив элемент управления. Но в любом случае это не является тривиальным для воспроизведения исходного поведения по умолчанию, который обычно существует таким образом, чтобы элемент управления реагировал ожидаемыми способами на события и входные действия и жесты пользователя. Поэтому следует рассмотреть вопрос о том, действительно ли вам нужно, чтобы событие ввода было пожарным. Вам может потребоваться изучить наличие других событий ввода или жестов, которые не обрабатываются с помощью элемента управления, и использовать их в проектировании взаимодействия с приложением или элементом управления.
Чтобы сделать возможным для элементов управления, которые включают ScrollViewer, влияют на некоторые из поведения и свойств, которые находятся в части ScrollViewer, ScrollViewer определяет ряд присоединенных свойств XAML, которые можно задать в стилях и использовать в привязках шаблонов.
Если необходимо обрабатывать события указателя для UIElement в прокручиваемом представлении (например, ScrollViewer), необходимо явно отключить поддержку событий манипуляции в представлении, вызвав UIElement.CancelDirectmanipulation(). Чтобы повторно включить события манипуляции в представлении, вызовите UIElement.TryStartDirectManipulation.
Взаимодействие с пером
Начиная с Windows 10 версии 1709 (ПАКЕТ SDK 16299), поведение активного пера в приложении UWP — прокрутка и сдвига (так же, как сенсорное, сенсорное перо и пассивное перо). ScrollViewer использует события указателя, если не указать, что вы хотите обрабатывать события самостоятельно, и не хотите, чтобы они использовались для манипуляции.
В версиях Windows 10 до 1709 года поведение по умолчанию было выделение текста.
Если приложение должно использовать активное перо для выделения текста, можно переопределить прокрутку пера и вернуться к предыдущему поведению. Для этого обработайте событие PointerPressed и задайте свойство ManipulationMode , чтобы указать, что система не должна обрабатывать взаимодействие пера для прокрутки основного ScrollViewer. Вы также обрабатываете события PointerReleased и PointerCanceled , чтобы вернуть системное поведение по умолчанию обратно при удалении пера.
В этом примере показано, как:
- Зарегистрируйте события с помощью метода UIElement.AddHandler с параметром handledEventsToo , равным true.
- Проверьте, является ли устройство указателя пером.
- В обработчике событий PointerPressed отключите поддержку системных манипуляций в ScrollViewer.
- В обработчиках событий PointerReleased и PointerCanceled включите поддержку управления системой.
<Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
<ScrollViewer x:Name="myScrollViewer">
<Image Source="Assets/StoreLogo.png"/>
</ScrollViewer>
</Grid>
public MainPage()
{
this.InitializeComponent();
this.myScrollViewer.AddHandler(UIElement.PointerPressedEvent,
new PointerEventHandler(myScrollViewer_PointerPressed),
true /*handledEventsToo*/);
this.myScrollViewer.AddHandler(UIElement.PointerReleasedEvent,
new PointerEventHandler(myScrollViewer_PointerReleased),
true /*handledEventsToo*/);
this.myScrollViewer.AddHandler(UIElement.PointerCanceledEvent,
new PointerEventHandler(myScrollViewer_PointerCanceled),
true /*handledEventsToo*/);
}
private void myScrollViewer_PointerPressed(object sender, PointerRoutedEventArgs e)
{
if (e.Pointer.PointerDeviceType == Windows.Devices.Input.PointerDeviceType.Pen)
{
(myScrollViewer.Content as UIElement).ManipulationMode &= ~ManipulationModes.System;
}
}
private void myScrollViewer_PointerReleased(object sender, PointerRoutedEventArgs e)
{
if (e.Pointer.PointerDeviceType == Windows.Devices.Input.PointerDeviceType.Pen)
{
(myScrollViewer.Content as UIElement).ManipulationMode |= ManipulationModes.System;
}
}
private void myScrollViewer_PointerCanceled(object sender, PointerRoutedEventArgs e)
{
if (e.Pointer.PointerDeviceType == Windows.Devices.Input.PointerDeviceType.Pen)
{
(myScrollViewer.Content as UIElement).ManipulationMode |= ManipulationModes.System;
}
}
Присоединенные свойства XAML ScrollViewer
ScrollViewer определяет следующие присоединенные свойства XAML:
- ScrollViewer.BringIntoViewOnFocusChange
- ScrollViewer.HorizontalScrollBarVisibility
- ScrollViewer.HorizontalScrollMode
- ScrollViewer.IsDeferredScrollingEnabled
- ScrollViewer.IsHorizontalRailEnabled
- ScrollViewer.IsHorizontalScrollChainingEnabled
- ScrollViewer.IsScrollInertiaEnabled
- ScrollViewer.IsVerticalRailEnabled
- ScrollViewer.IsVerticalScrollChainingEnabled
- ScrollViewer.IsZoomChainingEnabled
- ScrollViewer.IsZoomInertiaEnabled
- ScrollViewer.VerticalScrollBarVisibility
- ScrollViewer.VerticalScrollMode
- ScrollViewer.ZoomMode
Эти присоединенные свойства XAML предназначены для случаев, когда ScrollViewer неявно, например, когда ScrollViewer существует в шаблоне по умолчанию для ListView или GridView, и вы хотите иметь возможность влиять на поведение прокрутки элемента управления без доступа к частям шаблона. В случаях, когда ScrollViewer является явным в XAML, как показано в примере кода в разделе "Примеры", вам не нужно использовать синтаксис присоединенного свойства. Просто используйте синтаксис атрибутов, например <ScrollViewer ZoomMode="Enabled" />.
Для поддержки доступа процессора XAML к присоединенным свойствам, а также для предоставления эквивалентных операций получения и задания кода каждое присоединенное свойство XAML имеет пару методов доступа Get и Set . Например, методы GetHorizontalScrollMode и SetHorizontalScrollMode поддерживают и предоставляют эквивалентную поддержку scrollViewer.HorizontalScrollMode. Кроме того, можно использовать систему свойств зависимостей для получения или задания значения присоединенного свойства. Вызовите GetValue или SetValue, передав аргументы идентификатора свойства зависимостей для задания, а также ссылку на целевой объект, для которого необходимо получить или задать значение.
Стиль и шаблон элемента управления
Вы можете изменить стиль по умолчанию и ControlTemplate , чтобы предоставить элементу управления уникальный внешний вид. Сведения об изменении стиля и шаблона элемента управления см. в стилях XAML. Стиль, шаблон и ресурсы по умолчанию, определяющие внешний вид элемента управления, включаются в generic.xaml файл. В целях разработки generic.xaml устанавливается с пакетом NuGet Windows App SDK. По умолчанию, это расположение \Users\<username>\.nuget\packages\microsoft.windowsappsdk\<version>\lib\uap10.0\Microsoft.UI\Themes\generic.xaml. Стили и ресурсы из разных версий пакета SDK могут иметь разные значения.
XAML также содержит ресурсы, которые можно использовать для изменения цветов элемента управления в разных визуальных состояниях без изменения шаблона элемента управления. Изменение этих ресурсов предпочтительнее задавать такие свойства, как фон и передний план. Дополнительные сведения см. в разделе стилей легкого веса статьи стилей XAML .
Обработка жестов с помощью устройств панели отслеживания
Входные и жесты сенсорной панели не активируют события PointerWheelChanged в элементе управления ScrollViewer . Эти жесты обрабатываются внутри элемента управления ScrollViewer .
Пользовательский интерфейс приложения для экранной клавиатуры
Экранная клавиатура (OSK) — это функция специальных возможностей, которую пользователи могут включить по запросу (параметры -> Специальные возможности -> клавиатуры или Windows+CTRL+O). Это не то же самое, что и мягкая клавиатура , которая может отображаться в пользовательском интерфейсе приложения для поддержки элементов управления вводом текста, когда система не обнаруживает наличие клавиатуры.
При появлении OSK система настраивает поведение пользовательского интерфейса и макета приложения и обеспечивает прокрутку по мере необходимости. Это поведение прокрутки системы не предоставляется приложению.
Конструкторы
| Имя | Описание |
|---|---|
| ScrollViewer() |
Инициализирует новый экземпляр класса ScrollViewer . |
Свойства
| Имя | Описание |
|---|---|
| AccessKey |
Получает или задает ключ доступа (mnemonic) для этого элемента. (Унаследовано от UIElement) |
| AccessKeyScopeOwner |
Возвращает или задает исходный элемент, предоставляющий область ключа доступа для этого элемента, даже если он не находится в визуальном дереве исходного элемента. (Унаследовано от UIElement) |
| ActualHeight |
Возвращает отрисованную высоту объекта FrameworkElement. См. примечания. (Унаследовано от FrameworkElement) |
| ActualOffset |
Получает позицию этого UIElement относительно родительского элемента, вычисляемого во время прохождения процесса макета. (Унаследовано от UIElement) |
| ActualSize |
Возвращает размер, вычисляемый этим UIElement во время упорядочивания процесса макета. (Унаследовано от UIElement) |
| ActualTheme |
Возвращает тему пользовательского интерфейса, которая в настоящее время используется элементом, который может отличаться от запрошенного элемента. (Унаследовано от FrameworkElement) |
| ActualWidth |
Возвращает отрисованную ширину объекта FrameworkElement. См. примечания. (Унаследовано от FrameworkElement) |
| AllowDrop |
Возвращает или задает значение, определяющее, может ли этот UIElement быть целевым объектом удаления для целей операций перетаскивания. (Унаследовано от UIElement) |
| AllowFocusOnInteraction |
Возвращает или задает значение, указывающее, автоматически ли элемент получает фокус при взаимодействии с ним пользователем. (Унаследовано от FrameworkElement) |
| AllowFocusWhenDisabled |
Возвращает или задает, может ли отключенный элемент управления получать фокус. (Унаследовано от FrameworkElement) |
| Background |
Возвращает или задает кисть, которая предоставляет фон элемента управления. (Унаследовано от Control) |
| BackgroundSizing |
Возвращает или задает значение, указывающее, насколько далеко фон расширяется относительно границы этого элемента. (Унаследовано от Control) |
| BaseUri |
Возвращает универсальный идентификатор ресурса (URI), представляющий базовый URI для объекта XAML, созданного во время загрузки XAML. Это свойство полезно для разрешения URI во время выполнения. (Унаследовано от FrameworkElement) |
| BorderBrush |
Возвращает или задает кисть, описывающую заливку границы элемента управления. (Унаследовано от Control) |
| BorderThickness |
Возвращает или задает толщину границы элемента управления. (Унаследовано от Control) |
| BringIntoViewOnFocusChange |
Возвращает или задает значение, определяющее, использует ли ScrollViewer поведение прокрутки при получении фокуса элемента в представлении. |
| BringIntoViewOnFocusChangeProperty |
Определяет свойство зависимостей BringIntoViewOnFocusChange . |
| CacheMode |
Возвращает или задает значение, указывающее, что отображаемое содержимое должно кэшироваться как составное растровое изображение, когда это возможно. (Унаследовано от UIElement) |
| CanBeScrollAnchor |
Возвращает или задает значение, указывающее, может ли UIElement быть кандидатом на привязку прокрутки. (Унаследовано от UIElement) |
| CanContentRenderOutsideBounds |
Возвращает или задает значение, указывающее, может ли прокрученное содержимое отображаться вне границ ScrollViewer. |
| CanContentRenderOutsideBoundsProperty |
Определяет свойство зависимостей CanContentRenderOutsideBounds . |
| CanDrag |
Возвращает или задает значение, указывающее, можно ли перетаскивать элемент в виде данных в операции перетаскивания. (Унаследовано от UIElement) |
| CenterPoint |
Возвращает или задает центральную точку элемента, которая является точкой, в которой происходит поворот или масштабирование. Влияет на положение отрисовки элемента. (Унаследовано от UIElement) |
| CharacterSpacing |
Возвращает или задает равномерное интервал между символами в единицах 1/1000 эм. (Унаследовано от Control) |
| Clip |
Возвращает или задает прямоугольникGeometry , используемый для определения структуры содержимого UIElement. (Унаследовано от UIElement) |
| CompositeMode |
Возвращает или задает свойство, которое объявляет альтернативные режимы композиции и смешивания для элемента в родительском макете и окне. Это относится к элементам, участвующим в смешанном пользовательском интерфейсе XAML или Microsoft DirectX. (Унаследовано от UIElement) |
| ComputedHorizontalScrollBarVisibility |
Возвращает значение, указывающее, отображается ли горизонтальная полоса прокрутки . |
| ComputedHorizontalScrollBarVisibilityProperty |
Определяет свойство зависимости ComputedHorizontalScrollBarVisibility . |
| ComputedVerticalScrollBarVisibility |
Возвращает значение, указывающее, отображается ли вертикальная полоса прокрутки . |
| ComputedVerticalScrollBarVisibilityProperty |
Определяет свойство зависимости ComputedVerticalScrollBarVisibility . |
| Content |
Возвращает или задает содержимое ContentControl. (Унаследовано от ContentControl) |
| ContentTemplate |
Возвращает или задает шаблон данных, используемый для отображения содержимого ContentControl. (Унаследовано от ContentControl) |
| ContentTemplateRoot |
Возвращает корневой элемент шаблона данных, указанного свойством ContentTemplate . (Унаследовано от ContentControl) |
| ContentTemplateSelector |
Возвращает или задает объект выбора, который изменяет DataTemplate для применения к содержимому на основе обработки сведений о элементе содержимого или его контейнере во время выполнения. (Унаследовано от ContentControl) |
| ContentTransitions |
Возвращает или задает коллекцию элементов стиля перехода , которые применяются к содержимому ContentControl. (Унаследовано от ContentControl) |
| ContextFlyout |
Возвращает или задает всплывающий элемент, связанный с этим элементом. (Унаследовано от UIElement) |
| CornerRadius |
Возвращает или задает радиус для углов границы элемента управления. (Унаследовано от Control) |
| CurrentAnchor |
В настоящее время выбранный элемент привязки, используемый для привязки прокрутки. |
| DataContext |
Возвращает или задает контекст данных для FrameworkElement. Обычно используется контекст данных, когда |
| DefaultStyleKey |
Возвращает или задает ключ, ссылающийся на стиль по умолчанию для элемента управления. Авторы пользовательских элементов управления используют это свойство для изменения стиля, используемого их элементом управления по умолчанию. (Унаследовано от Control) |
| DefaultStyleResourceUri |
Возвращает или задает путь к файлу ресурсов, который содержит стиль по умолчанию для элемента управления. (Унаследовано от Control) |
| DesiredSize |
Возвращает размер, вычисляемый этим UIElement во время прохождения меры процесса макета. (Унаследовано от UIElement) |
| Dispatcher |
Всегда возвращается |
| DispatcherQueue |
Возвращает, |
| ElementSoundMode |
Получает или задает значение, указывающее предпочтения элемента управления о том, будут ли воспроизводиться звуки. (Унаследовано от Control) |
| ExitDisplayModeOnAccessKeyInvoked |
Возвращает или задает значение, указывающее, закрывается ли отображение ключа доступа при вызове ключа доступа. (Унаследовано от UIElement) |
| ExtentHeight |
Возвращает вертикальный размер всего прокручиваемого содержимого в ScrollViewer. |
| ExtentHeightProperty |
Идентификатор свойства зависимости ExtentHeight . |
| ExtentWidth |
Возвращает горизонтальный размер всего прокручиваемого содержимого в ScrollViewer. |
| ExtentWidthProperty |
Идентификатор свойства зависимости ExtentWidth . |
| FlowDirection |
Получает или задает направление, в котором поток текста и других элементов пользовательского интерфейса в любом родительском элементе, который управляет их макетом. Это свойство может иметь значение |
| FocusState |
Возвращает значение, указывающее, имеет ли этот элемент управления фокус и режим получения фокуса. (Унаследовано от UIElement) |
| FocusVisualMargin |
Возвращает или задает внешнее поле визуального элемента фокуса для FrameworkElement. (Унаследовано от FrameworkElement) |
| FocusVisualPrimaryBrush |
Возвращает или задает кисть, используемую для рисования внешней границы визуального элемента или |
| FocusVisualPrimaryThickness |
Возвращает или задает толщину внешней границы визуального элемента или |
| FocusVisualSecondaryBrush |
Возвращает или задает кисть, используемую для рисования внутренней границы визуального элемента или |
| FocusVisualSecondaryThickness |
Возвращает или задает толщину внутренней границы визуального элемента или |
| FontFamily |
Возвращает или задает шрифт, используемый для отображения текста в элементе управления. (Унаследовано от Control) |
| FontSize |
Возвращает или задает размер текста в этом элементе управления. (Унаследовано от Control) |
| FontStretch |
Возвращает или задает степень, к которой сжат или развернут шрифт на экране. (Унаследовано от Control) |
| FontStyle |
Возвращает или задает стиль отрисовки текста. (Унаследовано от Control) |
| FontWeight |
Возвращает или задает толщину указанного шрифта. (Унаследовано от Control) |
| Foreground |
Возвращает или задает кисть, описывающую цвет переднего плана. (Унаследовано от Control) |
| Height |
Возвращает или задает рекомендуемую высоту frameworkElement. (Унаследовано от FrameworkElement) |
| HighContrastAdjustment |
Возвращает или задает значение, указывающее, настраивает ли платформа визуальные свойства элемента автоматически при включении тем высокой контрастности. (Унаследовано от UIElement) |
| HorizontalAlignment |
Возвращает или задает характеристики горизонтального выравнивания, применяемые к FrameworkElement при его создании в родительском элементе макета, например панели или элемента управления элементами. (Унаследовано от FrameworkElement) |
| HorizontalAnchorRatio |
Определяет горизонтальную позицию точки привязки ScrollViewer относительно окна просмотра. По умолчанию ScrollViewer выбирает элемент в качестве элемента CurrentAnchor , определяя элемент в его представлении, ближайший к точке привязки. |
| HorizontalAnchorRatioProperty |
Определяет свойство зависимостей HorizontalAnchorRatio . |
| HorizontalContentAlignment |
Возвращает или задает горизонтальное выравнивание содержимого элемента управления. (Унаследовано от Control) |
| HorizontalOffset |
Получает расстояние, которое содержимое было прокручено по горизонтали. |
| HorizontalOffsetProperty |
Определяет свойство зависимостей HorizontalOffset . |
| HorizontalScrollBarVisibility |
Возвращает или задает значение, указывающее, следует ли отображать горизонтальную полосу прокрутки . |
| HorizontalScrollBarVisibilityProperty |
Определяет свойство зависимости HorizontalScrollBarVisibility . |
| HorizontalScrollMode |
Возвращает или задает значение, определяющее, как входные данные манипуляции влияют на поведение прокрутки на горизонтальной оси. |
| HorizontalScrollModeProperty |
Определяет свойство зависимостей HorizontalScrollMode . |
| HorizontalSnapPointsAlignment |
Возвращает или задает значение, указывающее, как существующие точки привязки выровнены по горизонтали и исходного окна просмотра. |
| HorizontalSnapPointsAlignmentProperty |
Определяет свойство зависимостей HorizontalSnapPointsAlignment . |
| HorizontalSnapPointsType |
Возвращает или задает значение, указывающее, как поведение манипуляции реагирует на точки привязки вдоль горизонтальной оси. |
| HorizontalSnapPointsTypeProperty |
Определяет свойство зависимостей HorizontalSnapPointsType . |
| IsAccessKeyScope |
Возвращает или задает значение, указывающее, определяет ли элемент собственную область ключа доступа. (Унаследовано от UIElement) |
| IsDeferredScrollingEnabled |
Возвращает или задает значение, определяющее отложенное поведение прокрутки для ScrollViewer. |
| IsDeferredScrollingEnabledProperty |
Определяет свойство зависимостей IsDeferredScrollingEnabled . |
| IsDoubleTapEnabled |
Возвращает или задает значение, определяющее, может ли событие DoubleTapped исходить из этого элемента. (Унаследовано от UIElement) |
| IsEnabled |
Возвращает или задает значение, указывающее, может ли пользователь взаимодействовать с элементом управления. (Унаследовано от Control) |
| IsFocusEngaged |
Получает или задает значение, указывающее, ограничен ли фокус элементом управления, когда пользователь нажимает кнопку A/Select на игровом контроллере. (Унаследовано от Control) |
| IsFocusEngagementEnabled |
Получает или задает значение, указывающее, может ли фокус быть ограничен элементом управления, когда пользователь нажимает кнопку A/Select на игровом контроллере. (Унаследовано от Control) |
| IsHitTestVisible |
Возвращает или задает, может ли содержащаяся область этого UIElement возвращать истинные значения для тестирования попаданий. (Унаследовано от UIElement) |
| IsHoldingEnabled |
Возвращает или задает значение, определяющее, может ли событие Holding исходить из этого элемента. (Унаследовано от UIElement) |
| IsHorizontalRailEnabled |
Возвращает или задает значение, указывающее, включена ли полоса прокрутки для горизонтальной оси. |
| IsHorizontalRailEnabledProperty |
Определяет свойство зависимостей IsHorizontalRailEnabled . |
| IsHorizontalScrollChainingEnabled |
Возвращает или задает значение, указывающее, включена ли цепочка прокрутки от этого дочернего элемента к родительскому элементу для горизонтальной оси. |
| IsHorizontalScrollChainingEnabledProperty |
Определяет свойство зависимостей IsHorizontalScrollChainingEnabled . |
| IsLoaded |
Возвращает значение, указывающее, был ли элемент добавлен в дерево элементов и готов к взаимодействию. (Унаследовано от FrameworkElement) |
| IsRightTapEnabled |
Возвращает или задает значение, определяющее, может ли событие RightTapped исходить из этого элемента. (Унаследовано от UIElement) |
| IsScrollInertiaEnabled |
Возвращает или задает значение, указывающее, должны ли действия прокрутки включать инерцию в их поведение и значение. |
| IsScrollInertiaEnabledProperty |
Определяет свойство зависимостей IsScrollInertiaEnabled . |
| IsTabStop |
Возвращает или задает значение, указывающее, включен ли элемент управления в навигацию по вкладкам. (Унаследовано от UIElement) |
| IsTapEnabled |
Возвращает или задает значение, определяющее, может ли событие "Касаться" из этого элемента. (Унаследовано от UIElement) |
| IsTextScaleFactorEnabled |
Возвращает или задает, включен ли автоматическое расширение текста для отражения параметра размера системного текста. (Унаследовано от Control) |
| IsVerticalRailEnabled |
Возвращает или задает значение, указывающее, включена ли полоса прокрутки для вертикальной оси. |
| IsVerticalRailEnabledProperty |
Определяет свойство зависимостей IsVerticalRailEnabled . |
| IsVerticalScrollChainingEnabled |
Возвращает или задает значение, указывающее, включена ли цепочка прокрутки от этого дочернего элемента к родительскому элементу для вертикальной оси. |
| IsVerticalScrollChainingEnabledProperty |
Определяет свойство зависимостей IsVerticalScrollChainingEnabled . |
| IsZoomChainingEnabled |
Возвращает или задает значение, указывающее, включена ли цепочка масштабирования от этого дочернего элемента к родительскому элементу. |
| IsZoomChainingEnabledProperty |
Определяет свойство зависимостей IsZoomChainingEnabled . |
| IsZoomInertiaEnabled |
Возвращает или задает значение, указывающее, должны ли действия масштабирования включать инерцию в их поведение и значение. |
| IsZoomInertiaEnabledProperty |
Определяет свойство зависимостей IsZoomInertiaEnabled . |
| KeyboardAcceleratorPlacementMode |
Возвращает или задает значение, указывающее, отображается ли подсказка элемента управления сочетание клавиш для связанного акселератора клавиатуры. (Унаследовано от UIElement) |
| KeyboardAcceleratorPlacementTarget |
Возвращает или задает значение, указывающее подсказку элемента управления, отображающую сочетание клавиш акселератора. (Унаследовано от UIElement) |
| KeyboardAccelerators |
Возвращает коллекцию сочетаний клавиш, которые вызывают действие с помощью клавиатуры. Ускорители обычно назначаются кнопкам или элементам меню.
|
| KeyTipHorizontalOffset |
Возвращает или задает значение, указывающее, насколько слева или справа подсказка ключа помещается в отношение uiElement. (Унаследовано от UIElement) |
| KeyTipPlacementMode |
Возвращает или задает значение, указывающее, где находится подсказка ключа доступа относительно границы UIElement. (Унаследовано от UIElement) |
| KeyTipTarget |
Возвращает или задает значение, указывающее элемент, предназначенный для подсказки ключа доступа. (Унаследовано от UIElement) |
| KeyTipVerticalOffset |
Возвращает или задает значение, указывающее, насколько далеко вверх или вниз подсказка помещается в отношение к элементу пользовательского интерфейса. (Унаследовано от UIElement) |
| Language |
Возвращает или задает сведения о языке локализации и глобализации, которые применяются к FrameworkElement, а также ко всем дочерним элементам текущего FrameworkElement в представлении объекта и пользовательском интерфейсе. (Унаследовано от FrameworkElement) |
| LeftHeader |
Возвращает или задает содержимое левого заголовка. |
| LeftHeaderProperty |
Определяет свойство зависимостей LeftHeader . |
| Lights |
Возвращает коллекцию объектов XamlLight , присоединенных к этому элементу. (Унаследовано от UIElement) |
| ManipulationMode |
Возвращает или задает значение ManipulationModes , используемое для поведения uiElement и взаимодействия с жестами. Задание этого значения позволяет обрабатывать события манипуляции из этого элемента в коде приложения. (Унаследовано от UIElement) |
| Margin |
Возвращает или задает внешнее поле FrameworkElement. (Унаследовано от FrameworkElement) |
| MaxHeight |
Возвращает или задает максимальное ограничение высоты frameworkElement. (Унаследовано от FrameworkElement) |
| MaxWidth |
Возвращает или задает максимальное ограничение ширины frameworkElement. (Унаследовано от FrameworkElement) |
| MaxZoomFactor |
Возвращает или задает значение, указывающее максимально допустимое значение времени выполнения ZoomFactor. |
| MaxZoomFactorProperty |
Определяет свойство зависимостей MaxZoomFactor . |
| MinHeight |
Возвращает или задает минимальное ограничение высоты платформы FrameworkElement. (Унаследовано от FrameworkElement) |
| MinWidth |
Возвращает или задает минимальное ограничение ширины frameworkElement. (Унаследовано от FrameworkElement) |
| MinZoomFactor |
Возвращает или задает значение, указывающее минимально допустимое значение времени выполнения ZoomFactor. |
| MinZoomFactorProperty |
Определяет свойство зависимостей MinZoomFactor . |
| Name |
Возвращает или задает идентификатор имени объекта. Когда обработчик XAML создает дерево объектов из разметки XAML, код времени выполнения может ссылаться на объект, объявленный XAML, по этому имени. (Унаследовано от FrameworkElement) |
| Opacity |
Возвращает или задает степень непрозрачности объекта. (Унаследовано от UIElement) |
| OpacityTransition |
Возвращает или задает ScalarTransition, который анимирует изменения свойства Opacity. (Унаследовано от UIElement) |
| Padding |
Возвращает или задает заполнение внутри элемента управления. (Унаследовано от Control) |
| Parent |
Возвращает родительский объект этого FrameworkElement в дереве объектов. (Унаследовано от FrameworkElement) |
| PointerCaptures |
Возвращает набор всех захваченных указателей, представленных как значения указателя . (Унаследовано от UIElement) |
| Projection |
Получает или задает проекцию перспективы (эффект 3-D), применяемую при отрисовке этого элемента. (Унаследовано от UIElement) |
| ProtectedCursor |
Возвращает или задает курсор, отображающийся, когда указатель находится над этим элементом. По умолчанию имеет значение NULL, указывающее, что курсор не изменяется. (Унаследовано от UIElement) |
| RasterizationScale |
Возвращает значение, представляющее дополнительный коэффициент масштабирования, используемый при отрисовке фигур, изображений, текста или мультимедиа, как правило, для отрисовки в более высоком разрешении, чем обычно. (Унаследовано от UIElement) |
| ReduceViewportForCoreInputViewOcclusions |
Возвращает или задает значение, указывающее, следует ли scrollViewer пытаться настроить его содержимое, чтобы сохранить его видимым при закрепленной части CoreInputView occludes. |
| ReduceViewportForCoreInputViewOcclusionsProperty |
Определяет свойство зависимостей ReduceViewportForCoreInputViewOcclusions . |
| RenderSize |
Возвращает окончательный размер отрисовки пользовательского элемента UIElement. Использование не рекомендуется, см. примечания. (Унаследовано от UIElement) |
| RenderTransform |
Возвращает или задает сведения о преобразовании, влияющие на положение отрисовки пользовательского элемента UIElement. (Унаследовано от UIElement) |
| RenderTransformOrigin |
Возвращает или задает точку источника любого возможного преобразования отрисовки, объявленного RenderTransform, относительно границ uiElement. (Унаследовано от UIElement) |
| RequestedTheme |
Возвращает или задает тему пользовательского интерфейса, используемую UIElement (и ее дочерними элементами) для определения ресурсов. Указанная тема |
| RequiresPointer |
Возвращает или задает, поддерживает ли элемент пользовательского интерфейса режим мыши, который эмулирует взаимодействие указателя с устройствами ввода без указателя, такими как клавиатура или игровой контроллер. (Унаследовано от Control) |
| Resources |
Возвращает локально определенный словарь ресурсов. В XAML можно установить элементы ресурсов в качестве дочерних |
| Rotation |
Получает или задает угол поворота по часовой стрелке в градусах. Поворот по отношению к RotationAxis и CenterPoint. Влияет на положение отрисовки элемента. (Унаследовано от UIElement) |
| RotationAxis |
Возвращает или задает ось для поворота элемента вокруг. (Унаследовано от UIElement) |
| RotationTransition |
Возвращает или задает ScalarTransition, который анимирует изменения свойства "Поворот". (Унаследовано от UIElement) |
| Scale |
Возвращает или задает масштаб элемента. Масштабируется относительно ЦентраPoint элемента. Влияет на положение отрисовки элемента. (Унаследовано от UIElement) |
| ScaleTransition |
Возвращает или задает объект Vector3Transition, который анимирует изменения свойства Scale. (Унаследовано от UIElement) |
| ScrollableHeight |
Возвращает значение, представляющее вертикальный размер области, которую можно прокрутить; разница между высотой экстента и высотой окна просмотра. |
| ScrollableHeightProperty |
Определяет свойство зависимостей ScrollableHeight . |
| ScrollableWidth |
Возвращает значение, представляющее горизонтальный размер области, которую можно прокрутить; разница между шириной экстента и шириной окна просмотра. |
| ScrollableWidthProperty |
Определяет свойство зависимостей ScrollableWidth . |
| Shadow |
Возвращает или задает эффект тени, приведение к элементу. (Унаследовано от UIElement) |
| Style |
Возвращает или задает стиль экземпляра, применяемый для этого объекта во время макета и отрисовки. (Унаследовано от FrameworkElement) |
| TabFocusNavigation |
Возвращает или задает значение, которое изменяет работу табуляции и tabIndex для этого элемента управления. (Унаследовано от UIElement) |
| TabIndex |
Возвращает или задает значение, определяющее порядок, в котором элементы получают фокус при переходе пользователя через элементы управления с помощью клавиши TAB . (Унаследовано от UIElement) |
| TabNavigation |
Возвращает или задает значение, которое изменяет способ работы табуляции и UIElement.TabIndex для этого элемента управления. Note Для Windows 10 Creators Update (сборка 10.0.15063) и более поздней версии Свойство TabFocusNavigation доступно в базовом классе UIElement для включения объектов в последовательность вкладок, не использующих ControlTemplate. |
| Tag |
Возвращает или задает произвольное значение объекта, которое можно использовать для хранения пользовательских сведений об этом объекте. (Унаследовано от FrameworkElement) |
| Template |
Возвращает или задает шаблон элемента управления. Шаблон элемента управления определяет визуальный вид элемента управления в пользовательском интерфейсе и определяется в разметке XAML. (Унаследовано от Control) |
| TopHeader |
Возвращает или задает содержимое верхнего заголовка. |
| TopHeaderProperty |
Определяет свойство зависимости TopHeader . |
| TopLeftHeader |
Возвращает или задает содержимое верхнего левого заголовка. |
| TopLeftHeaderProperty |
Определяет свойство зависимостей TopLeftHeader . |
| Transform3D |
Возвращает или задает эффект преобразования 3-D, применяемый при отрисовке этого элемента. (Унаследовано от UIElement) |
| TransformMatrix |
Возвращает или задает матрицу преобразования, применяемую к элементу. (Унаследовано от UIElement) |
| Transitions |
Возвращает или задает коллекцию элементов стиля перехода , которые применяются к UIElement. (Унаследовано от UIElement) |
| Translation |
Возвращает или задает положение отрисовки элемента x, y и z. (Унаследовано от UIElement) |
| TranslationTransition |
Возвращает или задает объект Vector3Transition, который анимирует изменения свойства Translation. (Унаследовано от UIElement) |
| Triggers |
Возвращает коллекцию триггеров для анимаций, определенных для FrameworkElement. Часто не используется. См. примечания. (Унаследовано от FrameworkElement) |
| UseLayoutRounding |
Возвращает или задает значение, определяющее, должна ли отрисовка объекта и его визуального поддерева использовать циклический режим, который выравнивает отрисовку по всему пикселям. (Унаследовано от UIElement) |
| UseSystemFocusVisuals |
Возвращает или задает значение, указывающее, используется ли элемент управления визуальные элементы фокуса, рисуемые системой или визуальными элементами фокуса, определенными в шаблоне элемента управления. (Унаследовано от UIElement) |
| VerticalAlignment |
Возвращает или задает характеристики вертикального выравнивания, применяемые к FrameworkElement , когда он состоит в родительском объекте, например панели или элемента управления элементами. (Унаследовано от FrameworkElement) |
| VerticalAnchorRatio |
Определяет вертикальную позицию точки привязки ScrollViewer относительно окна просмотра. По умолчанию ScrollViewer выбирает элемент в качестве элемента CurrentAnchor , определяя элемент в его представлении, ближайший к точке привязки. |
| VerticalAnchorRatioProperty |
Определяет свойство зависимостей VerticalAnchorRatio . |
| VerticalContentAlignment |
Возвращает или задает вертикальное выравнивание содержимого элемента управления. (Унаследовано от Control) |
| VerticalOffset |
Получает расстояние, которое содержимое прокручивается по вертикали. |
| VerticalOffsetProperty |
Определяет свойство зависимостей VerticalOffset . |
| VerticalScrollBarVisibility |
Возвращает или задает значение, указывающее, следует ли отображать вертикальную полосу прокрутки . |
| VerticalScrollBarVisibilityProperty |
Определяет свойство зависимости VerticalScrollBarVisibility . |
| VerticalScrollMode |
Возвращает или задает значение, определяющее, как входные данные манипуляции влияют на поведение прокрутки на вертикальной оси. |
| VerticalScrollModeProperty |
Определяет свойство зависимостей VerticalScrollMode . |
| VerticalSnapPointsAlignment |
Возвращает или задает значение, указывающее, как существующие точки привязки выровнены по вертикали по вертикали и в исходном представлении. |
| VerticalSnapPointsAlignmentProperty |
Определяет свойство зависимостей VerticalSnapPointsAlignment . |
| VerticalSnapPointsType |
Возвращает или задает значение, указывающее, как поведение манипуляции реагирует на точки привязки вдоль вертикальной оси. |
| VerticalSnapPointsTypeProperty |
Определяет свойство зависимостей VerticalSnapPointsType . |
| ViewportHeight |
Возвращает вертикальный размер просматриваемого содержимого. |
| ViewportHeightProperty |
Определяет свойство зависимости ViewportHeight . |
| ViewportWidth |
Возвращает горизонтальный размер просматриваемого содержимого. |
| ViewportWidthProperty |
Определяет свойство зависимостей ViewportWidth . |
| Visibility |
Возвращает или задает видимость uiElement. Объект |
| Width |
Возвращает или задает ширину FrameworkElement. (Унаследовано от FrameworkElement) |
| XamlRoot |
Возвращает или задает объект |
| XYFocusDown |
Получает или задает объект, который получает фокус, когда пользователь нажимает вниз на панели направления (D-pad) игрового контроллера. (Унаследовано от UIElement) |
| XYFocusDownNavigationStrategy |
Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента навигации вниз. (Унаследовано от UIElement) |
| XYFocusKeyboardNavigation |
Возвращает или задает значение, которое включает или отключает навигацию с помощью клавишных стрелков. (Унаследовано от UIElement) |
| XYFocusLeft |
Получает или задает объект, который получает фокус, когда пользователь нажимает слева на панели направления (D-pad) игрового контроллера. (Унаследовано от UIElement) |
| XYFocusLeftNavigationStrategy |
Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента навигации слева. (Унаследовано от UIElement) |
| XYFocusRight |
Получает или задает объект, который получает фокус, когда пользователь нажимает прямо на панели направления (D-pad) игрового контроллера. (Унаследовано от UIElement) |
| XYFocusRightNavigationStrategy |
Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента правой навигации. (Унаследовано от UIElement) |
| XYFocusUp |
Возвращает или задает объект, который получает фокус, когда пользователь нажимает клавишу Directional Pad (D-pad) игрового контроллера. (Унаследовано от UIElement) |
| XYFocusUpNavigationStrategy |
Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента навигации вверх. (Унаследовано от UIElement) |
| ZoomFactor |
Возвращает значение, указывающее текущий коэффициент масштабирования для масштабирования содержимого. |
| ZoomFactorProperty |
Определяет свойство зависимостей ZoomFactor . |
| ZoomMode |
Возвращает или задает значение, указывающее, включено ли поведение масштабирования в содержимом ScrollViewer . |
| ZoomModeProperty |
Определяет свойство зависимостей ZoomMode . |
| ZoomSnapPoints |
Возвращает наблюдаемую коллекцию факторов точки оснастки масштабирования, которые хранятся в ScrollViewer. |
| ZoomSnapPointsProperty |
Определяет свойство зависимостей ZoomSnapPoints . |
| ZoomSnapPointsType |
Возвращает или задает значение, указывающее, как точки привязки масштабирования обрабатываются для входных данных взаимодействия. |
| ZoomSnapPointsTypeProperty |
Определяет свойство зависимостей ZoomSnapPointsType . |
Методы
| Имя | Описание |
|---|---|
| AddHandler(RoutedEvent, Object, Boolean) |
Добавляет перенаправленный обработчик событий для указанного перенаправленного события, добавив обработчик в коллекцию обработчика текущего элемента. Укажите |
| ApplyTemplate() |
Загружает соответствующий шаблон элемента управления, чтобы на нее можно было ссылаться. (Унаследовано от Control) |
| Arrange(Rect) |
Позиционирует дочерние объекты и определяет размер пользовательского элемента UIElement. Родительские объекты, реализующие пользовательский макет для дочерних элементов, должны вызывать этот метод из реализации переопределения макета, чтобы сформировать рекурсивное обновление макета. (Унаследовано от UIElement) |
| ArrangeOverride(Size) |
Предоставляет поведение для передачи макета "Упорядочить". Классы могут переопределить этот метод, чтобы определить собственное поведение передачи "Упорядочить". (Унаследовано от FrameworkElement) |
| CancelDirectManipulations() |
Отменяет текущую прямую обработку манипуляций (системное сдвига или масштабирование) на любом родительском элементе ScrollViewer , содержающем текущий UIElement. (Унаследовано от UIElement) |
| CapturePointer(Pointer) |
Задает запись указателя в UIElement. После захвата только элемент, имеющий запись, будет запускать события, связанные с указателем. (Унаследовано от UIElement) |
| ChangeView(IReference<Double>, IReference<Double>, IReference<Single>, Boolean) |
Приводит к загрузке нового представления в окно просмотра с помощью указанных смещения и коэффициента масштабирования, а также при необходимости отключает анимацию прокрутки. |
| ChangeView(IReference<Double>, IReference<Double>, IReference<Single>) |
Позволяет ScrollViewer загрузить новое представление в окно просмотра с помощью указанных смещения и коэффициента масштабирования. |
| ClearValue(DependencyProperty) |
Очищает локальное значение свойства зависимостей. (Унаследовано от DependencyObject) |
| FindName(String) |
Извлекает объект с указанным именем идентификатора. (Унаследовано от FrameworkElement) |
| FindSubElementsForTouchTargeting(Point, Rect) |
Позволяет подклассу UIElement предоставлять дочерние элементы, которые помогают разрешать целевые объекты касания. (Унаследовано от UIElement) |
| Focus(FocusState) |
Пытается задать фокус для этого элемента. (Унаследовано от UIElement) |
| GetAnimationBaseValue(DependencyProperty) |
Возвращает любое базовое значение, установленное для свойства зависимостей, которое будет применяться в случаях, когда анимация не активна. (Унаследовано от DependencyObject) |
| GetBindingExpression(DependencyProperty) |
Возвращает bindingExpression , представляющий привязку для указанного свойства. (Унаследовано от FrameworkElement) |
| GetBringIntoViewOnFocusChange(DependencyObject) |
Возвращает значение свойства зависимостей BringIntoViewOnFocusChange / |
| GetCanContentRenderOutsideBounds(DependencyObject) |
Возвращает значение свойства зависимостей CanContentRenderOutsideBounds / |
| GetChildrenInTabFocusOrder() |
Позволяет подклассу UIElement предоставлять дочерние элементы, участвующие в фокусе TAB. (Унаследовано от UIElement) |
| GetHorizontalScrollBarVisibility(DependencyObject) |
Возвращает значение свойства зависимости HorizontalScrollBarVisibility / |
| GetHorizontalScrollMode(DependencyObject) |
Возвращает значение свойства зависимостей HorizontalScrollMode / |
| GetIsDeferredScrollingEnabled(DependencyObject) |
Возвращает значение свойства зависимости IsDeferredScrollingEnabled / |
| GetIsHorizontalRailEnabled(DependencyObject) |
Возвращает значение свойства зависимости IsHorizontalRailEnabled / |
| GetIsHorizontalScrollChainingEnabled(DependencyObject) |
Возвращает значение свойства зависимости IsHorizontalScrollChainingEnabled / |
| GetIsScrollInertiaEnabled(DependencyObject) |
Возвращает значение свойства зависимостей IsScrollInertiaEnabled / |
| GetIsVerticalRailEnabled(DependencyObject) |
Возвращает значение свойства зависимостей IsVerticalRailEnabled или |
| GetIsVerticalScrollChainingEnabled(DependencyObject) |
Возвращает значение свойства зависимости IsVerticalScrollChainingEnabled или |
| GetIsZoomChainingEnabled(DependencyObject) |
Возвращает значение свойства зависимости IsZoomChainingEnabled / |
| GetIsZoomInertiaEnabled(DependencyObject) |
Возвращает значение свойства зависимостей IsZoomInertiaEnabled / |
| GetTemplateChild(String) |
Извлекает именованный элемент в экземплярном визуальном дереве ControlTemplate . (Унаследовано от Control) |
| GetValue(DependencyProperty) |
Возвращает текущее эффективное значение свойства зависимостей из DependencyObject. (Унаследовано от DependencyObject) |
| GetVerticalScrollBarVisibility(DependencyObject) |
Возвращает значение свойства зависимости VerticalScrollBarVisibility / |
| GetVerticalScrollMode(DependencyObject) |
Возвращает значение свойства зависимостей VerticalScrollMode / |
| GetVisualInternal() |
Извлекает разрешение |
| GetZoomMode(DependencyObject) |
Возвращает значение свойства зависимостей ZoomMode / |
| GoToElementStateCore(String, Boolean) |
При реализации в производном классе позволяет создавать визуальное дерево визуального дерева для шаблона элемента управления в коде, а не загружать XAML для всех состояний при запуске элемента управления. (Унаследовано от FrameworkElement) |
| InvalidateArrange() |
Отменяет состояние упорядочивания (макет) для UIElement. После недопустимости uiElement будет обновлен его макет, который будет выполняться асинхронно. (Унаследовано от UIElement) |
| InvalidateMeasure() |
Отменяет состояние измерения (макет) для UIElement. (Унаследовано от UIElement) |
| InvalidateScrollInfo() |
Вызывается при значении свойств, описывающих размер и расположение области прокрутки. |
| InvalidateViewport() |
Отменяет состояние окна просмотра для пользовательского интерфейса, используемого для вычисления эффективного окна просмотра. (Унаследовано от FrameworkElement) |
| Measure(Size) |
Обновляет элемент DesiredSizeпользовательского интерфейса. Как правило, объекты, реализующие настраиваемый макет для дочерних элементов макета, вызывают этот метод из собственных реализаций MeasureOverride для формирования рекурсивного обновления макета. (Унаследовано от UIElement) |
| MeasureOverride(Size) |
Предоставляет поведение для прохода "Measure" цикла макета. Классы могут переопределить этот метод, чтобы определить собственное поведение передачи Measure. (Унаследовано от FrameworkElement) |
| OnApplyTemplate() |
Вызывается всякий раз, когда код приложения или внутренние процессы (например, перестроение прохода макета) вызывают ApplyTemplate. В самых простых терминах это означает, что метод вызывается непосредственно перед отображением элемента пользовательского интерфейса в приложении. Переопределите этот метод, чтобы повлиять на логику после шаблона по умолчанию класса. (Унаследовано от FrameworkElement) |
| OnBringIntoViewRequested(BringIntoViewRequestedEventArgs) |
Вызывается перед событием BringIntoViewRequested . (Унаследовано от UIElement) |
| OnCharacterReceived(CharacterReceivedRoutedEventArgs) |
Вызывается перед событием CharacterReceived . (Унаследовано от Control) |
| OnContentChanged(Object, Object) |
Вызывается при изменении значения свойства Content . (Унаследовано от ContentControl) |
| OnContentTemplateChanged(DataTemplate, DataTemplate) |
Вызывается при изменении значения свойства ContentTemplate . (Унаследовано от ContentControl) |
| OnContentTemplateSelectorChanged(DataTemplateSelector, DataTemplateSelector) |
Вызывается при изменении значения свойства ContentTemplateSelector . (Унаследовано от ContentControl) |
| OnCreateAutomationPeer() |
При реализации в производном классе возвращает AutomationPeer реализации для инфраструктуры Microsoft UI Automation. (Унаследовано от UIElement) |
| OnDisconnectVisualChildren() |
Переопределите этот метод, чтобы реализовать поведение макета и логики при удалении элементов из содержимого определенного класса или дочернего свойства. (Унаследовано от UIElement) |
| OnDoubleTapped(DoubleTappedRoutedEventArgs) |
Вызывается перед событием DoubleTapped . (Унаследовано от Control) |
| OnDragEnter(DragEventArgs) |
Вызывается перед событием DragEnter . (Унаследовано от Control) |
| OnDragLeave(DragEventArgs) |
Вызывается перед событием DragLeave . (Унаследовано от Control) |
| OnDragOver(DragEventArgs) |
Вызывается перед событием DragOver . (Унаследовано от Control) |
| OnDrop(DragEventArgs) |
Вызывается перед событием drop . (Унаследовано от Control) |
| OnGotFocus(RoutedEventArgs) |
Вызывается перед событием GotFocus . (Унаследовано от Control) |
| OnHolding(HoldingRoutedEventArgs) |
Вызывается перед событием Холдинга . (Унаследовано от Control) |
| OnKeyboardAcceleratorInvoked(KeyboardAcceleratorInvokedEventArgs) |
Вызывается при обработке сочетания клавиш (или акселератора) в приложении. Переопределите этот метод для обработки реагирования приложения при вызове акселератора клавиатуры. (Унаследовано от UIElement) |
| OnKeyDown(KeyRoutedEventArgs) |
Вызывается перед событием KeyDown . (Унаследовано от Control) |
| OnKeyUp(KeyRoutedEventArgs) |
Вызывается перед событием KeyUp . (Унаследовано от Control) |
| OnLostFocus(RoutedEventArgs) |
Вызывается перед событием LostFocus . (Унаследовано от Control) |
| OnManipulationCompleted(ManipulationCompletedRoutedEventArgs) |
Вызывается перед событием ManipulationCompleted . (Унаследовано от Control) |
| OnManipulationDelta(ManipulationDeltaRoutedEventArgs) |
Вызывается перед событием ManipulationDelta . (Унаследовано от Control) |
| OnManipulationInertiaStarting(ManipulationInertiaStartingRoutedEventArgs) |
Вызывается перед событием ManipulationInertiaStarting . (Унаследовано от Control) |
| OnManipulationStarted(ManipulationStartedRoutedEventArgs) |
Вызывается перед событием ManipulationStarted . (Унаследовано от Control) |
| OnManipulationStarting(ManipulationStartingRoutedEventArgs) |
Вызывается перед событием ManipulationStarting . (Унаследовано от Control) |
| OnPointerCanceled(PointerRoutedEventArgs) |
Вызывается перед событием PointerCanceled . (Унаследовано от Control) |
| OnPointerCaptureLost(PointerRoutedEventArgs) |
Вызывается перед событием PointerCaptureLost . (Унаследовано от Control) |
| OnPointerEntered(PointerRoutedEventArgs) |
Вызывается перед событием PointerEntered . (Унаследовано от Control) |
| OnPointerExited(PointerRoutedEventArgs) |
Вызывается перед событием PointerExited . (Унаследовано от Control) |
| OnPointerMoved(PointerRoutedEventArgs) |
Вызывается перед событием PointerMoved . (Унаследовано от Control) |
| OnPointerPressed(PointerRoutedEventArgs) |
Вызывается перед событием PointerPressed . (Унаследовано от Control) |
| OnPointerReleased(PointerRoutedEventArgs) |
Вызывается перед событием PointerReleased . (Унаследовано от Control) |
| OnPointerWheelChanged(PointerRoutedEventArgs) |
Вызывается перед событием PointerWheelChanged . (Унаследовано от Control) |
| OnPreviewKeyDown(KeyRoutedEventArgs) |
Вызывается перед событием PreviewKeyDown . (Унаследовано от Control) |
| OnPreviewKeyUp(KeyRoutedEventArgs) |
Вызывается перед событием PreviewKeyUp . (Унаследовано от Control) |
| OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs) |
Вызывается непосредственно перед обработкой сочетания клавиш (или акселератора) в приложении. Вызывается всякий раз, когда код приложения или внутренние процессы вызывают ProcessKeyboardAccelerator. Переопределите этот метод, чтобы повлиять на обработку акселератора по умолчанию. (Унаследовано от UIElement) |
| OnRightTapped(RightTappedRoutedEventArgs) |
Вызывается перед событием RightTapped . (Унаследовано от Control) |
| OnTapped(TappedRoutedEventArgs) |
Вызывается перед событием "Касания ". (Унаследовано от Control) |
| PopulatePropertyInfo(String, AnimationPropertyInfo) |
Определяет свойство, которое может быть анимировано. (Унаследовано от UIElement) |
| PopulatePropertyInfoOverride(String, AnimationPropertyInfo) |
При переопределении в производном классе определяет свойство, которое может быть анимировано. (Унаследовано от UIElement) |
| ReadLocalValue(DependencyProperty) |
Возвращает локальное значение свойства зависимостей, если задано локальное значение. (Унаследовано от DependencyObject) |
| RegisterAnchorCandidate(UIElement) |
Регистрирует UIElement в качестве потенциальной привязки прокрутки. |
| RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Регистрирует функцию уведомлений для прослушивания изменений в определенном экземпляре DependencyProperty в этом экземпляре DependencyObject . (Унаследовано от DependencyObject) |
| ReleasePointerCapture(Pointer) |
Освобождает записи указателя для записи одного конкретного указателя с помощью этого UIElement. (Унаследовано от UIElement) |
| ReleasePointerCaptures() |
Освобождает все записи указателя, удерживаемые этим элементом. (Унаследовано от UIElement) |
| RemoveFocusEngagement() |
Освобождает элемент управления из ограничений фокуса, поддерживающих взаимодействие с игровым контроллером (где IsFocusEngaged имеет значение true). (Унаследовано от Control) |
| RemoveHandler(RoutedEvent, Object) |
Удаляет указанный обработчик перенаправленных событий из этого UIElement. Как правило, обработчик в вопросе был добавлен AddHandler. (Унаследовано от UIElement) |
| ScrollToHorizontalOffset(Double) |
Note ScrollToHorizontalOffset может быть изменен или недоступен для выпусков после Windows 8.1. Вместо этого используйте ChangeView. Прокручивает содержимое, которое находится в ScrollViewer , до указанной позиции горизонтального смещения. |
| ScrollToVerticalOffset(Double) |
Note ScrollToVerticalOffset может быть изменен или недоступен для выпусков после Windows 8.1. Вместо этого используйте ChangeView. Прокручивает содержимое, которое находится в ScrollViewer , до указанной позиции вертикального смещения. |
| SetBinding(DependencyProperty, BindingBase) |
Присоединяет привязку к FrameworkElement, используя предоставленный объект привязки. (Унаследовано от FrameworkElement) |
| SetBringIntoViewOnFocusChange(DependencyObject, Boolean) |
Задает значение свойства зависимостей BringIntoViewOnFocusChange / |
| SetCanContentRenderOutsideBounds(DependencyObject, Boolean) |
Задает значение свойства зависимостей CanContentRenderOutsideBounds / |
| SetHorizontalScrollBarVisibility(DependencyObject, ScrollBarVisibility) |
Задает значение свойства зависимости HorizontalScrollBarVisibility / |
| SetHorizontalScrollMode(DependencyObject, ScrollMode) |
Задает значение свойства зависимостей HorizontalScrollMode / |
| SetIsDeferredScrollingEnabled(DependencyObject, Boolean) |
Задает значение свойства зависимостей IsDeferredScrollingEnabled / |
| SetIsHorizontalRailEnabled(DependencyObject, Boolean) |
Задает значение свойства зависимостей IsHorizontalRailEnabled / |
| SetIsHorizontalScrollChainingEnabled(DependencyObject, Boolean) |
Задает значение свойства зависимостей IsHorizontalScrollChainingEnabled / |
| SetIsScrollInertiaEnabled(DependencyObject, Boolean) |
Задает значение свойства зависимостей IsScrollInertiaEnabled / |
| SetIsVerticalRailEnabled(DependencyObject, Boolean) |
Задает значение свойства зависимостей IsVerticalRailEnabled / |
| SetIsVerticalScrollChainingEnabled(DependencyObject, Boolean) |
Задает значение свойства зависимости IsVerticalScrollChainingEnabled / |
| SetIsZoomChainingEnabled(DependencyObject, Boolean) |
Задает значение свойства зависимостей IsZoomChainingEnabled / |
| SetIsZoomInertiaEnabled(DependencyObject, Boolean) |
Задает значение свойства зависимостей IsZoomInertiaEnabled / |
| SetValue(DependencyProperty, Object) |
Задает локальное значение свойства зависимостей в DependencyObject. (Унаследовано от DependencyObject) |
| SetVerticalScrollBarVisibility(DependencyObject, ScrollBarVisibility) |
Задает значение свойства зависимости VerticalScrollBarVisibility / |
| SetVerticalScrollMode(DependencyObject, ScrollMode) |
Задает значение свойства зависимостей VerticalScrollMode / |
| SetZoomMode(DependencyObject, ZoomMode) |
Задает значение свойства зависимостей ZoomMode / |
| StartAnimation(ICompositionAnimationBase) |
Начинает указанную анимацию элемента. (Унаследовано от UIElement) |
| StartBringIntoView() |
Инициирует запрос к платформе XAML для представления элемента в любом прокручиваемом регионе, в котором он содержится. (Унаследовано от UIElement) |
| StartBringIntoView(BringIntoViewOptions) |
Инициирует запрос к платформе XAML для представления элемента с помощью указанных параметров. (Унаследовано от UIElement) |
| StartDragAsync(ExpPointerPoint) |
Представляет прокручиваемую область, которая может содержать другие видимые элементы. (Унаследовано от UIElement) |
| StartDragAsync(PointerPoint) |
Инициирует операцию перетаскивания. Important Не поддерживается, если пользователь запускает приложение в режиме с повышенными привилегиями, как администратор. |
| StopAnimation(ICompositionAnimationBase) |
Останавливает указанную анимацию элемента. (Унаследовано от UIElement) |
| TransformToVisual(UIElement) |
Возвращает объект преобразования, который можно использовать для преобразования координат из UIElement в указанный объект. (Унаследовано от UIElement) |
| TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs) |
Пытается вызвать сочетание клавиш (или акселератор), выполнив поиск всего визуального дерева uiElement для сочетания клавиш. (Унаследовано от UIElement) |
| UnregisterAnchorCandidate(UIElement) |
Отменяет регистрацию UIElement в качестве потенциальной привязки прокрутки. |
| UnregisterPropertyChangedCallback(DependencyProperty, Int64) |
Отменяет уведомление об изменении, которое ранее было зарегистрировано путем вызова RegisterPropertyChangedCallback. (Унаследовано от DependencyObject) |
| UpdateLayout() |
Гарантирует правильность обновления всех позиций дочерних объектов uiElement для макета. (Унаследовано от UIElement) |
| ZoomToFactor(Single) |
Note ZoomToFactor может быть изменен или недоступен для выпусков после Windows 8.1. Вместо этого используйте ChangeView. Задает эффективное значение ZoomFactor. |
События
| Имя | Описание |
|---|---|
| AccessKeyDisplayDismissed |
Происходит, когда ключи доступа больше не должны отображаться. (Унаследовано от UIElement) |
| AccessKeyDisplayRequested |
Происходит, когда пользователь запрашивает отображение ключей доступа. (Унаследовано от UIElement) |
| AccessKeyInvoked |
Происходит, когда пользователь завершает последовательность ключей доступа. (Унаследовано от UIElement) |
| ActualThemeChanged |
Происходит при изменении значения свойства ActualTheme. (Унаследовано от FrameworkElement) |
| AnchorRequested |
Происходит при запросе привязки в начале прохода "Упорядочить". Обработайте это событие, чтобы переопределить логику ScrollViewer по умолчанию, чтобы выбрать элемент привязки в рамках привязки прокрутки. |
| BringIntoViewRequested |
Происходит при вызове StartBringIntoView для этого элемента или одного из его потомков. (Унаследовано от UIElement) |
| CharacterReceived |
Возникает, когда один состоящий символ получается входной очередью. (Унаследовано от UIElement) |
| ContextCanceled |
Происходит, когда жест ввода контекста продолжается в жесте манипуляции, чтобы уведомить элемент о том, что всплывающий элемент контекста не должен быть открыт. (Унаследовано от UIElement) |
| ContextRequested |
Происходит, когда пользователь завершил жест ввода контекста, например правой кнопкой мыши. (Унаследовано от UIElement) |
| DataContextChanged |
Происходит при изменении значения свойства FrameworkElement.DataContext . (Унаследовано от FrameworkElement) |
| DirectManipulationCompleted |
Происходит при завершении любой прямой манипуляции с ScrollViewer . |
| DirectManipulationStarted |
Происходит при начале любой прямой манипуляции с ScrollViewer . |
| DoubleTapped |
Возникает, когда в противном случае необработанное взаимодействие DoubleTap происходит через область теста попадания этого элемента. (Унаследовано от UIElement) |
| DragEnter |
Происходит, когда входная система сообщает базовое событие перетаскивания с этим элементом в качестве целевого объекта. (Унаследовано от UIElement) |
| DragLeave |
Происходит, когда входная система сообщает базовое событие перетаскивания с этим элементом в качестве источника. (Унаследовано от UIElement) |
| DragOver |
Происходит, когда входная система сообщает базовое событие перетаскивания с этим элементом в качестве потенциального целевого объекта удаления. (Унаследовано от UIElement) |
| DragStarting |
Происходит при инициировании операции перетаскивания. (Унаследовано от UIElement) |
| Drop |
Происходит, когда входная система сообщает базовое событие удаления с этим элементом в качестве целевого объекта удаления. (Унаследовано от UIElement) |
| DropCompleted |
Происходит при завершении операции перетаскивания с этим элементом. (Унаследовано от UIElement) |
| EffectiveViewportChanged |
Происходит при изменении эффективного окна просмотраFrameworkElement. (Унаследовано от FrameworkElement) |
| FocusDisengaged |
Происходит, как фокус освобождается из элемента управления, когда пользователь нажимает кнопку B/Back на игровом контроллере. (Унаследовано от Control) |
| FocusEngaged |
Происходит, так как фокус ограничен элементом управления, когда пользователь нажимает кнопку A/Select на игровом контроллере. (Унаследовано от Control) |
| GettingFocus |
Происходит перед получением фокуса UIElement . Это событие вызывается синхронно, чтобы убедиться, что фокус не перемещается, пока событие бурно. (Унаследовано от UIElement) |
| GotFocus |
Возникает, когда UIElement получает фокус. Это событие возникает асинхронно, поэтому фокус может снова перемещаться до завершения пузырьков. (Унаследовано от UIElement) |
| Holding |
Возникает, когда в противном случае необработанное взаимодействие удержания происходит через область теста попадания этого элемента. (Унаследовано от UIElement) |
| IsEnabledChanged |
Происходит при изменении свойства IsEnabled . (Унаследовано от Control) |
| KeyDown |
Происходит при нажатии клавиши клавиатуры, когда элемент UIElement имеет фокус. (Унаследовано от UIElement) |
| KeyUp |
Происходит при выпуске клавиши клавиатуры, когда элемент UIElement имеет фокус. (Унаследовано от UIElement) |
| LayoutUpdated |
Происходит при изменении макета визуального дерева из-за изменения значения свойств макета или другого действия, обновляющего макет. (Унаследовано от FrameworkElement) |
| Loaded |
Происходит, когда платформа FrameworkElement была создана и добавлена в дерево объектов и готова к взаимодействию. (Унаследовано от FrameworkElement) |
| Loading |
Происходит при начале загрузки FrameworkElement . (Унаследовано от FrameworkElement) |
| LosingFocus |
Происходит до того, как UIElement теряет фокус. Это событие вызывается синхронно, чтобы убедиться, что фокус не перемещается, пока событие бурно. (Унаследовано от UIElement) |
| LostFocus |
Происходит, когда UIElement теряет фокус. Это событие возникает асинхронно, поэтому фокус может снова перемещаться до завершения пузырьков. (Унаследовано от UIElement) |
| ManipulationCompleted |
Происходит при завершении манипуляции в UIElement . (Унаследовано от UIElement) |
| ManipulationDelta |
Происходит при изменении положения входного устройства во время манипуляции. (Унаследовано от UIElement) |
| ManipulationInertiaStarting |
Происходит, когда входное устройство теряет контакт с объектом UIElement во время манипуляции и инерции начинается. (Унаследовано от UIElement) |
| ManipulationStarted |
Происходит, когда устройство ввода начинает манипуляцию с UIElement. (Унаследовано от UIElement) |
| ManipulationStarting |
Возникает при первом создании обработчика манипуляций. (Унаследовано от UIElement) |
| NoFocusCandidateFound |
Происходит, когда пользователь пытается переместить фокус (с помощью табуляции или стрелки направления), но фокус не перемещается, так как в направлении перемещения не найден кандидат фокуса. (Унаследовано от UIElement) |
| PointerCanceled |
Происходит, когда указатель, который сделал контакт ненормально теряет контакт. (Унаследовано от UIElement) |
| PointerCaptureLost |
Происходит, когда запись указателя, ранее удерживаемая этим элементом, перемещается в другой элемент или в другом месте. (Унаследовано от UIElement) |
| PointerEntered |
Происходит, когда указатель входит в область теста попадания этого элемента. (Унаследовано от UIElement) |
| PointerExited |
Происходит, когда указатель покидает область теста попадания этого элемента. (Унаследовано от UIElement) |
| PointerMoved |
Происходит при перемещении указателя, пока указатель остается в области теста попадания этого элемента. (Унаследовано от UIElement) |
| PointerPressed |
Происходит, когда устройство указателя инициирует действие Press в этом элементе. (Унаследовано от UIElement) |
| PointerReleased |
Происходит при выпуске указателя устройства, инициированного ранее действием Press , в то время как в этом элементе. Обратите внимание, что конец действия прессы не гарантируется для запуска |
| PointerWheelChanged |
Происходит при изменении разностного значения колесика указателя. (Унаследовано от UIElement) |
| PreviewKeyDown |
Происходит при нажатии клавиши клавиатуры, когда элемент UIElement имеет фокус. (Унаследовано от UIElement) |
| PreviewKeyUp |
Происходит при выпуске клавиши клавиатуры, когда элемент UIElement имеет фокус. (Унаследовано от UIElement) |
| ProcessKeyboardAccelerators |
Происходит при нажатии сочетания клавиш (или акселератора ). (Унаследовано от UIElement) |
| RightTapped |
Происходит, когда стимул ввода правого касания происходит, пока указатель находится над элементом. (Унаследовано от UIElement) |
| SizeChanged |
Происходит при изменении значения свойства ActualHeight или ActualWidth в FrameworkElement. (Унаследовано от FrameworkElement) |
| Tapped |
Возникает, когда в противном случае необработанное взаимодействие касания происходит через область теста попадания этого элемента. (Унаследовано от UIElement) |
| Unloaded |
Происходит, когда этот объект больше не подключен к дереву основного объекта. (Унаследовано от FrameworkElement) |
| ViewChanged |
Происходит, когда такие манипуляции, как прокрутка и масштабирование, привели к изменению представления. |
| ViewChanging |
Происходит при манипуляциях, таких как прокрутка и масштабирование, приводит к изменению представления. |