Image Класс

Определение

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

public ref class Image sealed : FrameworkElement
/// [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 Image final : FrameworkElement
[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 Image : FrameworkElement
Public NotInheritable Class Image
Inherits FrameworkElement
<Image .../>
Наследование
Object Platform::Object IInspectable DependencyObject UIElement FrameworkElement Image
Атрибуты

Примеры

Tip

Дополнительные сведения, рекомендации по проектированию и примеры кода см. в разделе "Изображения и кисти изображений".

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

Комментарии

Форматы файлов изображений

Изображение может отображать следующие форматы файлов изображений:

  • Совместная группа экспертов по фотографии (JPEG)
  • Переносимая сетевая графика (PNG)
  • точечный рисунок (BMP)
  • Формат обмена графикой (GIF)
  • Формат файла изображений с тегами (TIFF)
  • JPEG XR
  • значки (ICO)
  • Масштабируемая векторная графика (SVG)

Элемент Image поддерживает анимированные изображения формата обмена графикой (GIF). При использовании BitmapImage в качестве источника изображения вы можете получить доступ к API BitmapImage для управления воспроизведением изображения анимированного формата обмена графикой (GIF). Дополнительные сведения см. на странице класса BitmapImage .

Элемент Image поддерживает статические изображения векторной графики (SVG) через SvgImageSource. SvgImageSource поддерживает безопасный статический режим из спецификации SVG и не поддерживает анимации или взаимодействия. Direct2D предоставляет базовую поддержку отрисовки SVG и дополнительные сведения о конкретных элементах и атрибутах SVG, см. в разделе "Поддержка SVG". Дополнительные сведения о вставке SVG в приложение см. на странице класса SvgImageSource .

Настройка Image.Source

Чтобы задать исходный файл изображения, отображаемый изображением, задайте его свойство Source либо в XAML, либо в коде. Ниже приведен простой пример настройки источника в XAML:

<Image Width="200" Source="Images/myimage.png"/>

Это использование задает источник по универсальному идентификатору ресурса (URI), который является ярлыком, включенным XAML. Обратите внимание, что универсальный идентификатор ресурса (URI) здесь, как представляется, относительным универсальным идентификатором ресурса (URI); поддержка частичного универсального идентификатора ресурса (URI) — это еще один ярлык XAML. Корнем этого универсального идентификатора ресурса (URI) является базовая папка для проекта приложения. Обычно это то же расположение, из которое загружается XAML-файл, содержащий тег изображения. В этом примере исходный файл изображения находится в подпапке Images в структуре файлов приложения.

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

Установка источника в значение универсального идентификатора ресурса (URI), которое не может быть разрешено для допустимого исходного файла образа, не вызывает исключения. Вместо этого он запускает событие ImageFailed . Обработчик ImageFailed можно написать и подключить его к объекту Image, а также использовать ErrorMessage в данных события для определения характера сбоя. Ошибка при декодировании также может запускать ImageFailed. Если вы хотите убедиться, что исходный файл изображения загружен правильно, можно обработать событие ImageOpened в элементе Image.

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

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

Настройка Image.Source с помощью кода

Если вы создаете объект Image с помощью кода, вызовите конструктор по умолчанию, а затем задайте свойство Image.Source . Для задания свойства Image.Source требуется экземпляр класса BitmapImage , который также необходимо создать. Если источник изображения является файлом, на который ссылается универсальный идентификатор ресурса (URI), используйте конструктор BitmapImage , который принимает параметр универсального идентификатора ресурса (URI). При ссылке на локальное содержимое необходимо включить схему ms-appx в абсолютный универсальный идентификатор ресурса (URI), используемый в качестве параметра конструктора BitmapImage . В коде вы не получаете ярлыки обработки для объединения относительных частей универсального идентификатора ресурса (URI) и ms-appx: схема, которая происходит автоматически, если указать источник в качестве атрибута XAML. Вместо этого необходимо явно создать абсолютный универсальный идентификатор ресурса (URI) с соответствующей схемой. Обычно вы используете схему ms-appx для файла изображения, упаковаемого как часть приложения.

Tip

Если вы используете C#, вы можете получить свойство BaseUri образа и передать его в качестве параметра baseUri для конструкторов System.Uri , которые объединяют базовое расположение универсального идентификатора ресурса (URI) и относительный путь в этом расположении.

Ниже приведен пример настройки Image.Source в C#. В этом примере объект Image был создан в XAML, но не имеет источника или других значений свойств; Вместо этого эти значения предоставляются во время выполнения при загрузке образа из XAML.

void Image_Loaded(object sender, RoutedEventArgs e)
{
    Image img = sender as Image; 
    BitmapImage bitmapImage = new BitmapImage();
    img.Width = bitmapImage.DecodePixelWidth = 80; //natural px width of image source
    // don't need to set Height, system maintains aspect ratio, and calculates the other
    // dimension, so long as one dimension measurement is provided
    bitmapImage.UriSource = new Uri(img.BaseUri,"Assets/StoreLogo.png");
    img.Source = bitmapImage;
}

Использование источника потока для источника изображения

Если источник изображения является потоком, необходимо написать код, который задает экземпляр образа для использования потока. Это невозможно сделать только в XAML. Создайте образ для использования или сослаться на существующий экземпляр изображения (который мог быть определен в разметке XAML, но без источника). Затем используйте асинхронный метод SetSourceAsyncBitmapImage , чтобы определить сведения о изображении из потока, передав поток для использования в качестве параметра streamSource . Использование потока для источника изображения довольно распространено. Например, если приложение позволяет пользователю выбрать файл изображения с помощью элемента управления FileOpenPicker , то объект, представляющий выбранный пользователем файл, можно открыть в виде потока, но не предоставляет ссылку на универсальный идентификатор ресурса (URI) к файлу.

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

FileOpenPicker open = new FileOpenPicker(); 
// Open a stream for the selected file 
StorageFile file = await open.PickSingleFileAsync(); 
// Ensure a file was selected 
if (file != null) 
{ 
    using (IRandomAccessStream fileStream = await file.OpenAsync(Windows.Storage.FileAccessMode.Read)) 
    { 
        // Set the image source to the selected bitmap 
         BitmapImage bitmapImage = new BitmapImage(); 
         bitmapImage.DecodePixelWidth = 600; //match the target Image.Width, not shown
         await bitmapImage.SetSourceAsync(fileStream); 
         Scenario2Image.Source = bitmapImage; 
    } 
}

Tip

Если вы используете C#, потоки могут использовать тип System.IO.Stream, который вы можете ознакомиться с предыдущим интерфейсом программирования Microsoft .NET. Метод расширения AsStream можно вызвать в качестве метода экземпляра для любого объекта типа IRandomAccessStream, полученного из API Windows Runtime. В предыдущем примере для передачи параметров использовался IRandomAccessStream и не требуется использовать AsStream. Но если вам когда-либо нужно управлять потоком, AsStream есть в качестве служебной программы для преобразования в System.IO.Stream , если вам это нужно.

Дополнительные примеры кода см. в примере образов XAML .

Файлы изображений и производительность

Большие файлы изображений могут повлиять на производительность, так как они загружаются в память. Если вы ссылаетесь на файл изображения, где вы знаете, что исходный файл является большим, высоким разрешением, но ваше приложение отображает его в регионе пользовательского интерфейса, который меньше естественного размера изображения, следует задать свойство DecodePixelWidth или DecodePixelHeight. Свойства DecodePixel* позволяют передавать сведения непосредственно в кодек формата, а кодек может использовать эти сведения для декодирования более эффективно и меньшего объема памяти. Задайте для декодеPixelWidth ту же ширину пикселя области, которую вы хотите отобразить приложение. Другими словами, DecodePixelWidth для источника BitmapImage должно совпадать со значением Width или ActualWidth элемента управления Image, отображающим этот источник.

Можно задать decodePixelWidth или задать DecodePixelHeight. Если задать одно из этих двух свойств, система вычисляет соответствующее свойство для поддержания правильного пропорции. Можно также задать оба свойства, но обычно следует использовать значения, которые поддерживают это соотношение аспектов. Если вы хотите изменить пропорции, лучше сделать это, например с помощью TranslateTransform в качестве RenderTransform.

Чтобы задать decodePixelWidth (или DecodePixelHeight) в XAML, необходимо использовать более подробный синтаксис XAML, включающий явный элемент BitmapImage в качестве значения элемента свойства, как показано ниже.

<Image>
  <Image.Source>
    <BitmapImage DecodePixelWidth="200" UriSource="images/myimage.png"/>
  </Image.Source>
</Image>

DecodePixelWidth (или DecodePixelHeight) — это свойства BitmapImage, поэтому для задания свойств DecodePixel* в XAML требуется явный элемент объекта BitmapImage XAML.

Если вы создаете экземпляр Image в коде, возможно, вы уже создаете экземпляр BitmapImage в качестве значения для свойства Source, поэтому просто задайте параметр DecodePixelWidth (или DecodePixelHeight) в экземпляре BitmapImage перед настройкой свойства UriSource. Свойство DecodePixelType также влияет на то, как значения пикселей интерпретируются операциями декодирования.

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

Файлы изображений можно удалить из кэша изображений, установив для всех связанных значений Image.Sourceзначение NULL.

Дополнительные сведения о классе изображений и производительности см. в разделе "Оптимизация анимаций" и мультимедиа.

Кодировка и декодирование файлов изображений

Базовая поддержка кодека файлов изображений предоставляется API Windows компонентом визуализации (WIC). Дополнительные сведения о конкретных форматах изображений, как описано для кодеков, см. в кодеках Native WIC.

API для изображения, BitmapImage и BitmapSource не включают в себя какие-либо выделенные методы для кодирования и декодирования форматов мультимедиа. Все операции декодирования являются встроенными как действия, которые происходят при установке или сбросе источника. Это упрощает использование классов для создания пользовательского интерфейса, так как они имеют набор поддерживаемых форматов исходных файлов и поведения декодирования. Классы, такие как BitmapImage , предоставляют некоторые из параметров декодирования и логики в рамках данных о событиях ImageOpened или ImageFailed . Если требуется расширенное декодирование файла изображения или кодировка изображений, следует использовать API из Windows. Graphics.Imaging пространство имен. Вам может потребоваться этот API, если сценарий приложения включает преобразования формата изображений или манипуляцию с изображением, где пользователь может сохранить результат в виде файла. API кодирования также поддерживается компонентом компонента Windows визуализации (WIC) Windows.

Ширина изображения и высота

Класс Image наследует свойства Width и Height от FrameworkElement, и эти свойства потенциально управляют размером, который элемент управления Image будет отображаться при отображении в пользовательском интерфейсе. Если вы не задаете ширину или высоту , ширина и высота определяются естественным размером источника изображения. Например, при загрузке растрового изображения размером 300 пикселей и шириной 400 пикселей, как записано в формате исходного файла, эти измерения используются для ширины и высоты, когда элемент управления "Изображение" вычисляет его естественный размер. Вы можете проверить ActualHeight и ActualWidth во время выполнения после отрисовки изображения, чтобы получить сведения об измерении. Кроме того, вы можете обрабатывать ImageOpened и проверять свойства файла изображения, такие как PixelHeight и PixelWidth непосредственно перед отрисовкой изображения.

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

Если вы не задаете ширину и/ или высоту и оставляете изображение естественным размером, свойство Stretch для изображения может управлять тем, как исходный файл изображения заполняет пространство, указанное в качестве ширины и высоты. Значение Stretch по умолчанию равно "Однородное", которое сохраняет пропорции, если оно соответствует изображению в контейнер макета. Если размеры контейнера не имеют одинаковых пропорций, то будет пустое пространство, которое по-прежнему является частью изображения, но не отображает пиксели изображения, по крайней мере при использовании универсального значения для Stretch. UniformToFill для Stretch не оставляет пустое пространство, но может закрепить изображение, если размеры отличаются. ЗаливкаStretch не оставляет пустое место, но может изменить пропорции. Вы можете поэкспериментировать с этими значениями, чтобы узнать, что лучше всего подходит для отображения изображений в сценарии макета. Кроме того, помните, что некоторые контейнеры макета могут иметь размер изображения, не имеющего определенной ширины и высоты , чтобы заполнить все пространство макета, в этом случае можно задать определенные размеры на изображении или контейнере для него.

NineGrid

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

Квалификация ресурсов и локализация для образа

Исходные файлы изображений и масштабирование

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

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

Использование неквалифицированных ресурсов

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

FlowDirection для изображения

Если вы задаете FlowDirection как RightToLeft для изображения, визуальное содержимое изображения перевернуто по горизонтали. Однако элемент Image не наследует значение FlowDirection от любого родительского элемента. Как правило, требуется только поведение перелистывания изображений в изображениях, относящихся к макету, но не обязательно к элементам с внедренным текстом или другими компонентами, которые не имеют смысла перевернутые для аудитории справа налево. Чтобы получить поведение перевернутого изображения, необходимо задать элемент FlowDirection в элементе Image специально для RightToLeft или задать свойство FlowDirection в коде программной части. Рассмотрите возможность идентификации элемента Image с помощью директивы x:Uid и указания значений FlowDirection в качестве ресурса Windows Runtime, чтобы специалисты по локализации могли изменить это значение позже, не изменив XAML или код.

Класс Image и специальные возможности

Класс Image не является истинным классом элемента управления в том, что он не является потомком элемента Управления. Вы не можете вызвать фокус на элемент Image или поместить элемент Image в последовательность вкладок. Дополнительные сведения о специальных возможностях использования изображений и элемента Image в пользовательском интерфейсе см. в разделе "Основные сведения о специальных возможностях".

Ресурсы изображений

Ресурсы могут использовать шаблон квалификатора ресурсов для загрузки разных ресурсов в зависимости от масштабирования устройства. Любой ресурс, изначально полученный для приложения, автоматически вычисляется при изменении коэффициента масштабирования во время выполнения приложения. Кроме того, если этот ресурс является источником образа для объекта Image , то один из событий исходной загрузки (ImageOpened или ImageFailed) запускается в результате действия системы запроса нового ресурса и последующего применения его к Image. Сценарий, в котором может произойти изменение масштаба выполнения, заключается в том, что пользователь перемещает приложение в другой монитор, если доступно несколько. В результате события ImageOpened или ImageFailed могут происходить во время выполнения при обработке изменения масштаба, даже в случаях, когда источник установлен в XAML.

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

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

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

Свойства

Имя Описание
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)
BaseUri

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Возвращает или задает минимальное ограничение высоты платформы FrameworkElement.

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

Возвращает или задает минимальное ограничение ширины frameworkElement.

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

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

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

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

NineGridProperty

Определяет свойство зависимостей NineGrid .

Opacity

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

SourceProperty

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

Stretch

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

StretchProperty

Определяет свойство зависимостей Stretch .

Style

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Методы

Имя Описание
AddHandler(RoutedEvent, Object, Boolean)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Возвращает маску, представляющую альфа-канал изображения в виде CompositionBrush.

GetAnimationBaseValue(DependencyProperty)

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

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

Возвращает изображение как CastingSource.

GetBindingExpression(DependencyProperty)

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

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

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

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

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

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

Извлекает разрешение Visual элемента.

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

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

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

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

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

Отменяет состояние измерения (макет) для UIElement.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Important

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

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

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

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

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

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

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

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

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

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

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

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

События

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Происходит при изменении эффективного окна просмотраFrameworkElement.

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

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

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

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

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

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

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

Возникает при возникновении ошибки, связанной с извлечением изображения или форматированием.

ImageOpened

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

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 , в то время как в этом элементе. Обратите внимание, что конец действия прессы не гарантируется для запуска PointerReleased события; другие события могут запускаться вместо этого. Дополнительные сведения см. в разделе "Примечания".

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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