Image.Stretch Свойство

Определение

Пространство имен:

Microsoft.UI.Xaml.Controls

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

public:
 property Stretch Stretch { Stretch get(); void set(Stretch value); };

Stretch Stretch();

void Stretch(Stretch value);

public Stretch Stretch { get; set; }

var stretch = image.stretch;
image.stretch = stretch;

Public Property Stretch As Stretch

<Image Stretch="stretchValue"/>

Значение свойства

Stretch

Значение перечисления Stretch , указывающее способ отрисовки исходного изображения, если значения Height и(или ) Widthобъекта Image не указаны явным образом. Значение по умолчанию — Uniform.

Комментарии

Значение свойства Stretch имеет значение только в том случае, если экземпляр Image еще не использует явно заданные значения для свойства Height и(или ) Width , и если экземпляр Image находится внутри контейнера, который может растянуть изображение, чтобы заполнить некоторое доступное пространство в макете. Если для свойства Stretch задано значение None, образ всегда сохраняет свой естественный размер, даже если есть контейнер макета, который может растянуть его в противном случае. Дополнительные сведения о размере изображения см. в разделе Примечания на изображении.

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

Вы должны создавать источники образов в нескольких рекомендуемых размерах, чтобы ваше приложение выглядело отлично при масштабировании Windows из-за масштабирования и разрешения устройства. Это часто лучший способ обработки изменения размера изображения, а не применения значения Stretch, не являющегося стандартным. Указывая Source для Image, вы можете использовать соглашение об именовании, которое будет автоматически ссылаться на правильный ресурс для текущего масштабирования. Особенности соглашения об именовании и дополнительные сведения см. в статье Загрузка образов и ресурсов, адаптированных для масштабирования.

Примечание

Значение Stretch None не подходит для ресурсов изображений, предназначенных для поддержки масштабирования. Масштабирование будет обнаружено, и соответствующий масштабируемый ресурс будет загружен до применения решений макета, подразумеваемых значением None .