Image Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет элемент управления, отображающий изображение. Источник изображения указывается путем ссылки на файл изображения с использованием нескольких поддерживаемых форматов. Источник изображения также можно задать с помощью потока. Список поддерживаемых исходных форматов изображений см. в разделе Примечания.
public ref class Image sealed : FrameworkElement/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Image final : FrameworkElement/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class Image final : FrameworkElement[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class Image : FrameworkElement[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class Image : FrameworkElementPublic NotInheritable Class Image
Inherits FrameworkElement<Image .../>
- Наследование
- Атрибуты
Требования к Windows
| Семейство устройств |
Windows 10 (появилось в 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (появилось в v1.0)
|
Примеры
Совет
Дополнительные сведения, рекомендации по проектированию и примеры кода см. в разделе Изображение.
Приложения из коллекции WinUI 2 включают интерактивные примеры большинства элементов управления, возможностей и функций WinUI 2. Получите приложение из Microsoft Store или получите исходный код в GitHub.
Комментарии
Форматы файлов изображений
Изображение может отображать следующие форматы файлов изображений:
- JPEG
- PNG
- BMP
- GIF
- TIFF
- JPEG XR
- значки (ICO)
- SVG (Scalable Vector Graphics — масштабируемый векторный рисунок)
Примечание
Файлы значков поддерживаются только в Windows. Не поддерживается в Windows Phone 8.1
Начиная с Windows 10 версии 1607 элемент Image поддерживает анимированные изображения в формате GIF. При использовании BitmapImage в качестве источника изображения вы можете получить доступ к API BitmapImage для управления воспроизведением анимированного изображения в формате GIF. Дополнительные сведения см. в разделе "Примечания" на странице класса BitmapImage.
Примечание
Поддержка формата GIF доступна, если приложение компилируется для Windows 10 версии 1607 и работает в версии 1607 (или более поздней). Когда приложение компилируется для или выполняется в предыдущих версиях, отображается первый кадр формата GIF, но он не анимируется.
Начиная с Windows 10 версии 1703, элемент Image поддерживает статические изображения SVG через SvgImageSource. SvgImageSource поддерживает безопасный статический режим из спецификации SVG и не поддерживает анимации или взаимодействия. Direct2D предоставляет базовую поддержку отрисовки SVG, а дополнительные сведения о поддержке конкретных элементов SVG и атрибутов см. в разделе Поддержка SVG. Дополнительные сведения о том, как вставить SVG в приложение, см. на странице класса SvgImageSource .
Примечание
Поддержка масштабируемой векторной графики (SVG) доступна, если приложение компилируется для Windows 10 версии 1703 и работает в версии 1703 (или более поздней). Если приложение компилируется для или выполняется в предыдущих версиях, образ SVG не отображается.
Настройка Image.Source
Чтобы задать исходный файл изображения, отображаемый в image, необходимо задать его свойство Source в XAML или в коде. Ниже приведен простой пример настройки source в XAML.
<Image Width="200" Source="Images/myimage.png"/>
Это использование задает источник по универсальному коду ресурса (URI), который является ярлыком, который включается в XAML. Обратите внимание, что универсальный код ресурса (URI) здесь представляется относительным универсальным идентификатором ресурса (URI); поддержка частичного универсального кода ресурса (URI) — еще один ярлык XAML. Корень этого универсального кода ресурса (URI) является базовой папкой для проекта приложения. Обычно это то же расположение, из котором загружается XAML-файл, содержащий тег Image. В этом примере исходный файл изображения находится во вложенной папке 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:, которая происходит автоматически, если указать Source в качестве атрибута XAML. Вместо этого необходимо явно создать абсолютный универсальный код ресурса (URI) с соответствующей схемой. Обычно вы используете схему ms-appx: для файла изображения, упаковав его в составе приложения.
Совет
Если вы используете C# или Microsoft Visual Basic, вы можете получить свойство BaseUri image и передать его в качестве параметра 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;
}
Использование источника потока для источника изображения
Если источником изображения является поток, необходимо написать код, который задает экземпляр image для использования потока. Это невозможно сделать только в XAML. Создайте образ для использования или ссылки на существующий экземпляр Image (который мог быть определен в разметке 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;
}
}
Совет
Если вы используете C# или Microsoft Visual Basic, потоки могут использовать тип System.IO.Stream , с которым вы знакомы из предыдущего опыта программирования Microsoft .NET. Метод расширения AsStream можно вызвать в качестве метода экземпляра для любого объекта типа IRandomAccessStream, полученного из API среда выполнения Windows. В предыдущем примере для передачи параметров использовался IRandomAccessStream , и использовать AsStream не нужно. Но если вам когда-либо потребуется управлять потоком, AsStream — это служебная программа для преобразования в System.IO.Stream , если она вам нужна.
Дополнительные примеры кода см. в разделе Пример изображений XAML .
Файлы изображений и производительность
Большие файлы изображений могут повлиять на производительность, так как они загружаются в память. Если вы ссылаетесь на файл изображения, где вы знаете, что исходный файл является большим изображением с высоким разрешением, но приложение отображает его в области пользовательского интерфейса, которая меньше естественного размера изображения, следует задать свойство DecodePixelWidth или DecodePixelHeight. Свойства DecodePixel* позволяют передавать информацию непосредственно в кодек конкретного формата, и кодек может использовать эти сведения для более эффективного декодирования и уменьшения объема памяти. Задайте для параметра DecodePixelWidth ту же ширину пикселей области, которая будет отображаться в приложении. Иными словами, 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.
Если вы создаете экземпляр Image в коде, вероятно, вы уже создаете экземпляр BitmapImage в качестве значения для свойства Source, поэтому перед настройкой свойства UriSource просто задайте DecodePixelWidth (или DecodePixelHeight) в экземпляре BitmapImage. Свойство DecodePixelType также влияет на интерпретацию значений пикселей операциями декодирования.
Чтобы предотвратить декодирование изображений более одного раза, назначьте свойство источника изображения из универсального кода ресурса (URI), а не использовать потоки памяти, когда это возможно. Платформа XAML может связать один и тот же универсальный код ресурса (URI) в нескольких местах с одним декодируемым изображением, но не может сделать то же самое для нескольких потоков памяти, даже если они содержат одни и те же данные.
Вы можете удалить файлы изображений из кэша образов, задав для всех связанных значений Image.Sourceзначение NULL.
Дополнительные сведения о классе Image и производительности см. в разделе Оптимизация анимации и мультимедиа.
Кодирование и декодирование файлов изображений
Базовая поддержка кодека для файлов изображений предоставляется API компонента образов Windows (WIC). Дополнительные сведения о конкретных форматах изображений, как описано для кодеков, см. в разделе Native WIC Codecs.
API для Image, BitmapImage и BitmapSource не включает специальные методы для кодирования и декодирования форматов мультимедиа. Все операции декодирования являются встроенными как действия, выполняемые при установке или сбросе источника. Это упрощает использование классов для создания пользовательского интерфейса, так как они имеют набор поддерживаемых форматов исходных файлов и поведения декодирования по умолчанию. Классы, такие как BitmapImage , предоставляют некоторые параметры декодирования и логику как часть данных события ImageOpened или ImageFailed . Если требуется расширенное декодирование файлов изображений или кодирование изображений, следует использовать API из пространства имен Windows.Graphics.Imaging . Эти API могут потребоваться, если сценарий приложения включает преобразование формата файлов изображений или обработку изображения, где пользователь может сохранить результат в виде файла. API кодирования также поддерживается компонентом Windows Imaging Component (WIC) Windows.
Ширина и высота изображения
Класс Image наследует свойства Width и Height от FrameworkElement, и эти свойства могут управлять размером, который будет отображаться элементом управления Image при отображении в пользовательском интерфейсе. Если не задать ширину или высоту, ширина и высота определяются естественным размером источника изображения. Например, при загрузке растрового изображения высотой 300 пикселей и шириной 400 пикселей, как указано в исходном формате файла, эти измерения используются для ширины и высоты, когда элемент управления Изображение вычисляет свой естественный размер. Вы можете проверка ActualHeight и ActualWidth во время выполнения после отрисовки изображения, чтобы получить сведения об измерении. Вы также можете обрабатывать свойства ImageOpened и проверка файла изображения, такие как PixelHeight и PixelWidth, непосредственно перед отрисовкой изображения.
Если задать только одно из свойств Width или Height , но не оба, система может использовать это измерение в качестве руководства и вычислить другое, сохранив пропорции. Если вы не уверены в измерениях исходного файла, выберите измерение, наиболее важное для управления в сценарии макета, и позвольте системе вычислить другое измерение, а затем поведение макета контейнера, как правило, адаптирует макет к размеру.
Если не задать ширину и (или ) высоту и оставить для изображения естественный размер, свойство Stretch для изображения может управлять тем, как исходный файл изображения будет заполнять пространство, указанное в полях Ширина и Высота. Значение Stretch по умолчанию равно Uniform, которое сохраняет пропорции, когда изображение помещается в контейнер макета. Если размеры контейнера не имеют одинаковых пропорций, будет пустое пространство, которое по-прежнему является частью изображения, но не отображает пиксели изображения, по крайней мере при использовании значения Uniform для Stretch. UniformToFill для Stretch не оставляет пустого места, но может обрезать изображение, если размеры отличаются. Заливка для Stretch не оставляет пустого места, но может изменить пропорции. Вы можете поэкспериментировать с этими значениями, чтобы узнать, что лучше всего подходит для отображения изображений в сценарии макета. Кроме того, имейте в виду, что некоторые контейнеры макета могут иметь размер изображения без определенной ширины и высоты для заполнения всего пространства макета. В этом случае можно задать определенные размеры для изображения или контейнера для него.
NineGrid
Использование метода NineGrid — еще один вариант изменения размера изображений, размер которых отличается от размера области отображения, если изображение содержит области, которые не должны масштабироваться равномерно. Например, можно использовать фоновое изображение с внутренней границей, которая должна растягиваться только в одном измерении, и углы, которые не должны растягиваться вообще, но центр изображения может растянуться в соответствии с требованиями макета в обоих измерениях. Дополнительные сведения см. в разделе NineGrid.
Квалификация и локализация ресурсов для образа
Исходные файлы изображений и масштабирование
Источники изображений следует создавать в нескольких рекомендуемых размерах, чтобы приложение выглядело отлично при масштабировании Windows 8. При указании источника для изображения можно использовать соглашение об именовании для ресурсов, которые будут использовать правильный ресурс для факторов масштабирования для конкретных устройств. Это определяется приложением автоматически во время выполнения. Особенности используемых соглашений об именовании и дополнительные сведения см. в статье Краткое руководство. Использование файлов или ресурсов изображений.
Дополнительные сведения о том, как правильно спроектировать изображения для масштабирования, см. в разделе Рекомендации по пользовательскому интерфейсу для макета и масштабирования.
Использование неквалифицированных ресурсов
Неквалифицированные ресурсы — это метод, который можно использовать, когда базовая ссылка на ресурс ссылается на ресурс по умолчанию, а процесс управления ресурсами может автоматически найти эквивалентный локализованный ресурс. Вы можете использовать автоматическую обработку для доступа к неквалифицированным ресурсам с помощью текущих квалификаторов масштабирования и языка и региональных параметров или ResourceManager и ResourceMap с квалификаторами для языка и региональных параметров и масштаба, чтобы получить ресурсы напрямую. Подробнее см. в разделе Система управления ресурсами.
FlowDirection для изображения
Если для параметра FlowDirection задано значение RightToLeft для изображения, визуальное содержимое изображения будет перевернуто по горизонтали. Однако элемент Image не наследует значение FlowDirection от родительского элемента. Как правило, требуется поведение перелистывания изображений только в изображениях, относящихся к макету, но не обязательно к элементам с внедренным текстом или другими компонентами, которые не имеют смысла перевернуть для аудитории справа налево. Чтобы получить поведение перелистывания изображения, необходимо задать для элемента FlowDirection в элементе Image конкретное значение RightToLeft или задать свойство FlowDirection в коде программной части. Рассмотрите возможность идентификации элемента Image с помощью директивы x:Uid и указания значений FlowDirection в качестве среда выполнения Windows ресурса, чтобы специалисты по локализации могли позже изменить это значение без изменения XAML или кода.
Класс Image и специальные возможности
Класс Image не является истинным классом элемента управления, поскольку он не является потомком класса Control. Невозможно вызвать фокус для элемента Image или поместить элемент Image в последовательность вкладок. Дополнительные сведения об аспектах специальных возможностей при использовании изображений и элемента Image в пользовательском интерфейсе см. в разделе Основные сведения о специальных возможностях.
Работа в Windows 8
В Windows 8 ресурсы могут использовать шаблон квалификатора ресурсов для загрузки различных ресурсов в зависимости от масштабирования для конкретного устройства. Однако ресурсы не загружаются автоматически, если коэффициент масштабирования изменяется во время работы приложения. В этом случае приложениям придется перезагружать ресурсы, обрабатывая событие DpiChanged (или устаревшее событие LogicalDpiChanged ) и используя API ResourceManager , чтобы вручную перезагрузить ресурс, соответствующий новому коэффициенту масштабирования. Начиная с Windows 8.1, любой ресурс, который был первоначально получен для приложения, автоматически повторно оценивается при изменении коэффициента масштабирования во время работы приложения. Кроме того, если этот ресурс является источником образа для объекта Image, то одно из событий загрузки источника (ImageOpened или ImageFailed) запускается в результате действия системы по запросу нового ресурса и последующему применению его к image. Сценарий, в котором может произойти изменение масштаба во время выполнения, заключается в том, что пользователь перемещает приложение на другой монитор, если доступно несколько мониторов.
При переносе кода приложения из Windows 8 в Windows 8.1 может потребоваться учесть это изменение поведения, так как оно приводит к событиям ImageOpened или ImageFailed, которые происходят во время выполнения при обработке изменения масштаба, даже в тех случаях, когда источник задан в XAML. Кроме того, если у вас есть код, который обрабатывает DpiChanged/LogicalDpiChanged и сбрасывает ресурсы, следует проверить, нужен ли этот код, учитывая новый Windows 8.1 поведение автоматической перезагрузки.
Приложения, которые скомпилированы для Windows 8, но выполняются в Windows 8.1, продолжают использовать правила, действующие в Windows 8.
Журнал версий
| Версия Windows | Версия пакета SDK | Добавленная стоимость |
|---|---|---|
| 1607 | 14393 | GetAlphaMask |
Конструкторы
| Image() |
Инициализирует новый экземпляр класса Image . |
Свойства
| AccessKey |
Возвращает или задает ключ доступа (мнемонический) для этого элемента. (Унаследовано от UIElement) |
| AccessKeyScopeOwner |
Возвращает или задает исходный элемент, предоставляющий ключ доступа область для этого элемента, даже если он не находится в визуальном дереве исходного элемента. (Унаследовано от UIElement) |
| ActualHeight |
Возвращает отрисованную высоту объекта FrameworkElement. См. заметки. (Унаследовано от FrameworkElement) |
| ActualOffset |
Возвращает позицию этого элемента UIElement относительно его родительского элемента, вычисленного во время этапа упорядочения процесса макета. (Унаследовано от UIElement) |
| ActualSize |
Возвращает размер, вычисленный этим элементом UIElement во время этапа упорядочения процесса макета. (Унаследовано от UIElement) |
| ActualTheme |
Возвращает тему пользовательского интерфейса, которая в настоящее время используется элементом , которая может отличаться от RequestedTheme. (Унаследовано от FrameworkElement) |
| ActualWidth |
Возвращает ширину отображаемого элемента FrameworkElement. См. заметки. (Унаследовано от FrameworkElement) |
| AllowDrop |
Возвращает или задает значение, определяющее, может ли этот элемент UIElement быть целевым объектом перетаскивания для операций перетаскивания. (Унаследовано от UIElement) |
| AllowFocusOnInteraction |
Возвращает или задает значение, указывающее, получает ли элемент автоматически фокус при взаимодействии с ним. (Унаследовано от FrameworkElement) |
| AllowFocusWhenDisabled |
Возвращает или задает значение, указывающее, может ли отключенный элемент управления получать фокус. (Унаследовано от FrameworkElement) |
| BaseUri |
Возвращает универсальный код ресурса (URI), представляющий базовый универсальный код ресурса (URI) для созданного на языке XAML объекта во время загрузки XAML. Это свойство полезно для разрешения универсального кода ресурса (URI) во время выполнения. (Унаследовано от FrameworkElement) |
| CacheMode |
Возвращает или задает значение, указывающее, что отображаемое содержимое должно быть кэшировано в виде составного растрового изображения, если это возможно. (Унаследовано от UIElement) |
| CanBeScrollAnchor |
Возвращает или задает значение, указывающее, может ли UIElement быть кандидатом на привязку прокрутки. (Унаследовано от UIElement) |
| CanDrag |
Возвращает или задает значение, указывающее, можно ли перетаскивать элемент как данные в операции перетаскивания. (Унаследовано от UIElement) |
| CenterPoint |
Возвращает или задает центральную точку элемента, то есть точку, относительно которой происходит поворот или масштабирование. Влияет на позицию отрисовки элемента. (Унаследовано от UIElement) |
| Clip |
Возвращает или задает объект RectangleGeometry, используемый для определения контура содержимого элемента UIElement. (Унаследовано от UIElement) |
| CompositeMode |
Возвращает или задает свойство, объявляющее альтернативные режимы композиции и смешивания для элемента в родительском макете и окне. Это относится к элементам, участвующим в смешанном пользовательском интерфейсе XAML/Microsoft DirectX. (Унаследовано от UIElement) |
| ContextFlyout |
Возвращает или задает всплывающий элемент, связанный с этим элементом. (Унаследовано от UIElement) |
| DataContext |
Возвращает или задает контекст данных для Объекта FrameworkElement. Контекст данных часто используется, когда FrameworkElement использует расширение разметки {Binding} и участвует в привязке данных. (Унаследовано от FrameworkElement) |
| DesiredSize |
Возвращает размер, вычисленный этим элементом UIElement во время прохождения меры процесса макета. (Унаследовано от UIElement) |
| Dispatcher |
Возвращает CoreDispatcher , с которым связан этот объект. CoreDispatcher представляет средство, которое может получить доступ к DependencyObject в потоке пользовательского интерфейса, даже если код инициируется потоком, не относящегося к пользовательскому интерфейсу. (Унаследовано от DependencyObject) |
| ExitDisplayModeOnAccessKeyInvoked |
Возвращает или задает значение, указывающее, закрывается ли отображение ключа доступа при вызове ключа доступа. (Унаследовано от UIElement) |
| FlowDirection |
Возвращает или задает направление потока текста и других элементов пользовательского интерфейса в любом родительском элементе, управляющего их макетом. Этому свойству можно задать значение LeftToRight или RightToLeft. Для параметра FlowDirection значение RightToLeft для любого элемента устанавливается выравнивание справа, порядок чтения — справа налево, а макет элемента управления — справа налево. (Унаследовано от FrameworkElement) |
| FocusVisualMargin |
Возвращает или задает внешнее поле визуального элемента фокуса для FrameworkElement. (Унаследовано от FrameworkElement) |
| FocusVisualPrimaryBrush |
Получает или задает кисть, используемую для рисования внешней границы визуального |
| FocusVisualPrimaryThickness |
Возвращает или задает толщину внешней границы визуального элемента или |
| FocusVisualSecondaryBrush |
Получает или задает кисть, используемую для рисования внутренней границы визуального |
| FocusVisualSecondaryThickness |
Возвращает или задает толщину внутренней границы визуального элемента или |
| Height |
Возвращает или задает предполагаемую высоту элемента FrameworkElement. (Унаследовано от FrameworkElement) |
| HighContrastAdjustment |
Возвращает или задает значение, указывающее, настраивает ли платформа автоматически визуальные свойства элемента при включении тем с высокой контрастностью. (Унаследовано от UIElement) |
| HorizontalAlignment |
Возвращает или задает характеристики горизонтального выравнивания, применяемые к Объекту FrameworkElement при его создании в родительском элементе макета, например панели или элемента управления элементами. (Унаследовано от FrameworkElement) |
| IsAccessKeyScope |
Возвращает или задает значение, указывающее, определяет ли элемент собственный ключ доступа область. (Унаследовано от UIElement) |
| IsDoubleTapEnabled |
Возвращает или задает значение, определяющее, может ли событие DoubleTapped исходить из этого элемента. (Унаследовано от UIElement) |
| IsHitTestVisible |
Возвращает или задает значение, указывающее, может ли автономная область этого элемента UIElement возвращать истинные значения для проверки попадания. (Унаследовано от UIElement) |
| IsHoldingEnabled |
Возвращает или задает значение, определяющее, может ли событие Holding исходить из этого элемента. (Унаследовано от UIElement) |
| IsLoaded |
Возвращает значение, указывающее, был ли элемент добавлен в дерево элементов и готов ли он к взаимодействию. (Унаследовано от FrameworkElement) |
| IsRightTapEnabled |
Возвращает или задает значение, определяющее, может ли событие RightTapped исходить из этого элемента. (Унаследовано от UIElement) |
| IsTapEnabled |
Возвращает или задает значение, определяющее, может ли событие Tapped исходить из этого элемента. (Унаследовано от UIElement) |
| KeyboardAcceleratorPlacementMode |
Возвращает или задает значение, указывающее, отображает ли подсказка элемента управления сочетание клавиш для связанного ускорителя клавиатуры. (Унаследовано от UIElement) |
| KeyboardAcceleratorPlacementTarget |
Возвращает или задает значение, указывающее подсказку элемента управления, отображающую сочетание клавиш ускорителя. (Унаследовано от UIElement) |
| KeyboardAccelerators |
Возвращает коллекцию сочетаний клавиш, которые вызывают действие с помощью клавиатуры. Ускорители обычно назначаются кнопкам или пунктам меню.
|
| KeyTipHorizontalOffset |
Возвращает или задает значение, указывающее, насколько далеко слева или справа находится подсказка клавиши относительно UIElement. (Унаследовано от UIElement) |
| KeyTipPlacementMode |
Возвращает или задает значение, указывающее, где находится подсказка клавиши доступа относительно границы UIElement. (Унаследовано от UIElement) |
| KeyTipTarget |
Возвращает или задает значение, указывающее элемент, на который нацелена подсказка клавиши доступа. (Унаследовано от UIElement) |
| KeyTipVerticalOffset |
Возвращает или задает значение, указывающее, насколько далеко находится подсказка клавиши относительно элемента пользовательского интерфейса. (Унаследовано от UIElement) |
| Language |
Возвращает или задает сведения о языке локализации и глобализации, которые применяются к Объекту FrameworkElement, а также ко всем дочерним элементам текущего FrameworkElement в представлении объекта и в пользовательском интерфейсе. (Унаследовано от FrameworkElement) |
| Lights |
Возвращает коллекцию объектов XamlLight, присоединенных к этому элементу. (Унаследовано от UIElement) |
| ManipulationMode |
Возвращает или задает значение ManipulationModes , используемое для поведения UIElement и взаимодействия с жестами. Установка этого значения позволяет обрабатывать события манипуляции из этого элемента в коде приложения. (Унаследовано от UIElement) |
| Margin |
Возвращает или задает внешнее поле объекта FrameworkElement. (Унаследовано от FrameworkElement) |
| MaxHeight |
Возвращает или задает ограничение максимальной высоты объекта FrameworkElement. (Унаследовано от FrameworkElement) |
| MaxWidth |
Возвращает или задает ограничение максимальной ширины объекта FrameworkElement. (Унаследовано от FrameworkElement) |
| MinHeight |
Возвращает или задает ограничение минимальной высоты объекта FrameworkElement. (Унаследовано от FrameworkElement) |
| MinWidth |
Возвращает или задает ограничение минимальной ширины элемента FrameworkElement. (Унаследовано от FrameworkElement) |
| Name |
Возвращает или задает идентифицирующие имя объекта. Когда обработчик XAML создает дерево объектов из разметки XAML, код времени выполнения может ссылаться на объект, объявленный XAML, по этому имени. (Унаследовано от FrameworkElement) |
| NineGrid |
Возвращает или задает значение для метафоры с девятью сетками, которая управляет изменением размера изображения. Метафора из девяти сеток позволяет растягивать края и углы изображения иначе, чем его центр. Дополнительные сведения и иллюстрацию см. в разделе Примечания. |
| NineGridProperty |
Определяет свойство зависимости NineGrid . |
| Opacity |
Возвращает или задает степень непрозрачности объекта. (Унаследовано от UIElement) |
| OpacityTransition |
Возвращает или задает ScalarTransition, который анимирует изменения в свойстве Opacity. (Унаследовано от UIElement) |
| Parent |
Возвращает родительский объект этого объекта FrameworkElement в дереве объектов. (Унаследовано от FrameworkElement) |
| PlayToSource |
Получает сведения, передаваемые, если изображение используется для сценария воспроизведения. |
| PlayToSourceProperty |
Определяет свойство зависимости PlayToSource . |
| PointerCaptures |
Возвращает набор всех захваченных указателей, представленных в виде значений указателя . (Унаследовано от UIElement) |
| Projection |
Возвращает или задает перспективную проекцию (трехмерный эффект), применяемую при отрисовке этого элемента. (Унаследовано от UIElement) |
| RenderSize |
Возвращает окончательный размер отрисовки элемента UIElement. Использовать не рекомендуется, см. примечания. (Унаследовано от UIElement) |
| RenderTransform |
Возвращает или задает сведения о преобразовании, влияющие на положение отрисовки элемента UIElement. (Унаследовано от UIElement) |
| RenderTransformOrigin |
Возвращает или задает исходную точку любого возможного преобразования отрисовки, объявленного RenderTransform, относительно границ UIElement. (Унаследовано от UIElement) |
| RequestedTheme |
Возвращает или задает тему пользовательского интерфейса, используемую uiElement (и его дочерними элементами) для определения ресурса. Тема пользовательского интерфейса, указанная в параметре RequestedTheme, может переопределить requestedTheme на уровне приложения. (Унаследовано от FrameworkElement) |
| Resources |
Возвращает локально определенный словарь ресурсов. В XAML элементы ресурсов можно установить в качестве дочерних элементов объекта элемента свойства с помощью синтаксиса |
| Rotation |
Возвращает или задает угол поворота по часовой стрелке в градусах. Поворачивается относительно RotationAxis и CenterPoint. Влияет на позицию отрисовки элемента. (Унаследовано от UIElement) |
| RotationAxis |
Возвращает или задает ось для поворота элемента вокруг. (Унаследовано от UIElement) |
| RotationTransition |
Возвращает или задает scalarTransition, который анимирует изменения в свойстве Rotation. (Унаследовано от UIElement) |
| Scale |
Возвращает или задает масштаб элемента. Масштабируется относительно элемента CenterPoint. Влияет на позицию отрисовки элемента. (Унаследовано от UIElement) |
| ScaleTransition |
Возвращает или задает объект Vector3Transition, который анимирует изменения в свойстве Scale. (Унаследовано от UIElement) |
| Shadow |
Возвращает или задает эффект тени, отбрасываемый элементом . (Унаследовано от UIElement) |
| Source |
Возвращает или задает источник для изображения. |
| SourceProperty |
Идентифицирует свойство зависимостей Source . |
| Stretch |
Возвращает или задает значение, описывающее, как изображение должно быть растянуто для заполнения целевого прямоугольника. |
| StretchProperty |
Определяет свойство зависимости Stretch . |
| Style |
Возвращает или задает стиль экземпляра, который применяется к этому объекту во время макета и отрисовки. (Унаследовано от FrameworkElement) |
| TabFocusNavigation |
Возвращает или задает значение, изменяющее работу tabbing и TabIndex для этого элемента управления. (Унаследовано от UIElement) |
| Tag |
Возвращает или задает произвольное значение объекта, которое можно использовать для хранения пользовательских сведений об этом объекте. (Унаследовано от FrameworkElement) |
| Transform3D |
Возвращает или задает эффект трехмерного преобразования, применяемый при отрисовке этого элемента. (Унаследовано от UIElement) |
| TransformMatrix |
Возвращает или задает матрицу преобразования, применяемую к элементу . (Унаследовано от UIElement) |
| Transitions |
Возвращает или задает коллекцию элементов стиля Перехода , которые применяются к UIElement. (Унаследовано от UIElement) |
| Translation |
Возвращает или задает позицию отрисовки x, y и z элемента. (Унаследовано от UIElement) |
| TranslationTransition |
Возвращает или задает объект Vector3Transition, который анимирует изменения в свойстве Translation. (Унаследовано от UIElement) |
| Triggers |
Возвращает коллекцию триггеров для анимаций, определенных для FrameworkElement. Редко используется. См. заметки. (Унаследовано от FrameworkElement) |
| UIContext |
Возвращает идентификатор контекста для элемента . (Унаследовано от UIElement) |
| UseLayoutRounding |
Возвращает или задает значение, определяющее, должна ли отрисовка объекта и его визуального поддереви использовать поведение округления, которое выравнивает отрисовку по целым пикселям. (Унаследовано от UIElement) |
| VerticalAlignment |
Возвращает или задает характеристики вертикального выравнивания, применяемые к Объекту FrameworkElement при его создании в родительском объекте, например в элементе управления "Панель" или "Элементы". (Унаследовано от FrameworkElement) |
| Visibility |
Возвращает или задает видимость uiElement. Невидимый элемент UIElement не отображается и не передает нужный размер макету. (Унаследовано от UIElement) |
| Width |
Возвращает или задает ширину элемента FrameworkElement. (Унаследовано от FrameworkElement) |
| XamlRoot |
Возвращает или задает объект , |
| XYFocusDownNavigationStrategy |
Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента навигации вниз. (Унаследовано от UIElement) |
| XYFocusKeyboardNavigation |
Возвращает или задает значение, которое включает или отключает навигацию с помощью стрелки направления клавиатуры. (Унаследовано от UIElement) |
| XYFocusLeftNavigationStrategy |
Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента левой навигации. (Унаследовано от UIElement) |
| XYFocusRightNavigationStrategy |
Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента правильной навигации. (Унаследовано от 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) |
| GetAlphaMask() |
Возвращает маску, представляющую альфа-канал изображения в виде CompositionBrush. |
| GetAnimationBaseValue(DependencyProperty) |
Возвращает любое базовое значение, установленное для свойства зависимостей, которое применяется в случаях, когда анимация не активна. (Унаследовано от DependencyObject) |
| GetAsCastingSource() |
Возвращает изображение в виде CastingSource. |
| GetBindingExpression(DependencyProperty) |
Возвращает BindingExpression , представляющее привязку к указанному свойству. (Унаследовано от FrameworkElement) |
| GetChildrenInTabFocusOrder() |
Позволяет подклассу UIElement предоставлять дочерние элементы, которые принимают участие в фокусе tab. (Унаследовано от UIElement) |
| GetValue(DependencyProperty) |
Возвращает текущее действующее значение свойства зависимостей из DependencyObject. (Унаследовано от DependencyObject) |
| GoToElementStateCore(String, Boolean) |
При реализации в производном классе включает создание визуального дерева для каждого состояния для шаблона элемента управления в коде, а не путем загрузки XAML для всех состояний при запуске элемента управления. (Унаследовано от FrameworkElement) |
| InvalidateArrange() |
Делает недействительным состояние упорядочения (макет) для UIElement. После аннулирования макет UIElement будет обновлен, что будет происходить асинхронно. (Унаследовано от UIElement) |
| InvalidateMeasure() |
Делает недействительным состояние измерения (макет) для элемента UIElement. (Унаследовано от UIElement) |
| InvalidateViewport() |
Делает недействительным состояние окна просмотра для UIElement , используемого для вычисления действующего окна просмотра. (Унаследовано от FrameworkElement) |
| Measure(Size) |
Обновления DesiredSizeэлемента UIElement. Как правило, объекты, реализующие пользовательский макет для дочерних элементов макета, вызывают этот метод из собственных реализаций MeasureOverride , чтобы сформировать рекурсивное обновление макета. (Унаследовано от UIElement) |
| MeasureOverride(Size) |
Обеспечивает поведение для прохода "Measure" цикла макета. Классы могут переопределить этот метод, чтобы определить собственное поведение передачи "Measure". (Унаследовано от FrameworkElement) |
| OnApplyTemplate() |
Вызывается всякий раз, когда код приложения или внутренние процессы (такие как перестроение передачи макета) вызывают Метод ApplyTemplate. Проще говоря, это означает, что метод вызывается непосредственно перед отображением элемента пользовательского интерфейса в приложении. Переопределите этот метод, чтобы повлиять на логику post-template по умолчанию класса. (Унаследовано от FrameworkElement) |
| OnBringIntoViewRequested(BringIntoViewRequestedEventArgs) |
Вызывается перед событием BringIntoViewRequested . (Унаследовано от UIElement) |
| OnCreateAutomationPeer() |
При реализации в производном классе возвращает реализации AutomationPeer для конкретного класса для инфраструктуры автоматизации пользовательского интерфейса Майкрософт. (Унаследовано от UIElement) |
| OnDisconnectVisualChildren() |
Переопределите этот метод, чтобы реализовать поведение макета и логики при удалении элементов из свойства содержимого или дочерних элементов класса. (Унаследовано от UIElement) |
| OnKeyboardAcceleratorInvoked(KeyboardAcceleratorInvokedEventArgs) |
Вызывается при обработке сочетания клавиш (или ускорителя) в приложении. Переопределите этот метод для обработки реакции приложения при вызове ускорителя клавиатуры. (Унаследовано от UIElement) |
| OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs) |
Вызывается непосредственно перед обработкой сочетания клавиш (или ускорителя) в приложении. Вызывается всякий раз, когда код приложения или внутренние процессы вызывают ProcessKeyboardAccelerators. Переопределите этот метод, чтобы повлиять на обработку ускорителя по умолчанию. (Унаследовано от 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(PointerPoint) |
Инициирует операцию перетаскивания. (Унаследовано от UIElement) |
| StopAnimation(ICompositionAnimationBase) |
Останавливает указанную анимацию в элементе . (Унаследовано от UIElement) |
| TransformToVisual(UIElement) |
Возвращает объект преобразования, который можно использовать для преобразования координат из UIElement в указанный объект. (Унаследовано от UIElement) |
| TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs) |
Пытается вызвать сочетание клавиш (или ускоритель), выполнив поиск сочетания клавиш во всем визуальном дереве UIElement. (Унаследовано от UIElement) |
| UnregisterPropertyChangedCallback(DependencyProperty, Int64) |
Отменяет уведомление об изменениях, которое было ранее зарегистрировано путем вызова метода RegisterPropertyChangedCallback. (Унаследовано от DependencyObject) |
| UpdateLayout() |
Обеспечивает правильное обновление всех позиций дочерних объектов элемента UIElement для макета. (Унаследовано от UIElement) |
События
| AccessKeyDisplayDismissed |
Происходит, когда ключи доступа больше не должны отображаться. (Унаследовано от UIElement) |
| AccessKeyDisplayRequested |
Происходит, когда пользователь запрашивает отображение ключей доступа. (Унаследовано от UIElement) |
| AccessKeyInvoked |
Происходит, когда пользователь завершает последовательность ключей доступа. (Унаследовано от UIElement) |
| ActualThemeChanged |
Происходит при изменении значения свойства ActualTheme. (Унаследовано от FrameworkElement) |
| BringIntoViewRequested |
Происходит при вызове StartBringIntoView для этого элемента или одного из его потомков. (Унаследовано от UIElement) |
| CharacterReceived |
Происходит при получении одного составного символа входной очередью. (Унаследовано от UIElement) |
| 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 |
Происходит, когда указатель инициирует действие Нажатие в этом элементе. (Унаследовано от UIElement) |
| PointerReleased |
Происходит при освобождении устройства указателя, которое ранее инициировало действие нажатия , в этом элементе. Обратите внимание, что окончание действия Нажатие не гарантирует срабатывание события PointerReleased. Вместо этого могут возникать другие события. Дополнительные сведения см. в разделе Примечания. (Унаследовано от UIElement) |
| PointerWheelChanged |
Происходит при изменении значения разностного колесика указателя. (Унаследовано от UIElement) |
| PreviewKeyDown |
Происходит при нажатии клавиши клавиатуры, когда элемент UIElement находится в фокусе. (Унаследовано от UIElement) |
| PreviewKeyUp |
Происходит при освобождении клавиши клавиатуры, когда элемент UIElement находится в фокусе. (Унаследовано от UIElement) |
| ProcessKeyboardAccelerators |
Происходит при нажатии сочетания клавиш (или ускорителя ). (Унаследовано от UIElement) |
| RightTapped |
Возникает при возникновении стимула ввода правой кнопкой касания, когда указатель находится над элементом. (Унаследовано от UIElement) |
| SizeChanged |
Происходит при изменении значения свойства ActualHeight или ActualWidth в FrameworkElement. (Унаследовано от FrameworkElement) |
| Tapped |
Происходит, когда в противном случае происходит необработанное взаимодействие касания в области проверки попадания этого элемента. (Унаследовано от UIElement) |
| Unloaded |
Происходит, когда этот объект больше не подключен к дереву объектов main. (Унаследовано от FrameworkElement) |
Применяется к
См. также раздел
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по