TileBrush.Stretch Свойство

Определение

Получает или задает значение, указывающее, как содержимое этого TileBrush растягивается в соответствии с размером плиток.Gets or sets a value that specifies how the content of this TileBrush stretches to fit its tiles.

public:
 property System::Windows::Media::Stretch Stretch { System::Windows::Media::Stretch get(); void set(System::Windows::Media::Stretch value); };
public System.Windows.Media.Stretch Stretch { get; set; }
member this.Stretch : System.Windows.Media.Stretch with get, set
Public Property Stretch As Stretch

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

Значение, определяющее, как содержимое данного TileBrush проецируется на его базовый мозаичный элемент.A value that specifies how this TileBrush content is projected onto its base tile. Значение по умолчанию — Fill.The default value is Fill.

Комментарии

Свойство Stretch принимает следующие значения, которые перечисление Stretch определяет:The Stretch property accepts the following values, which the Stretch enumeration defines:

  • None. Содержимое TileBrush не растягивается для заполнения плитки.None: The TileBrush content does not stretch to fill the tile.

  • Uniform. Содержимое TileBrush масштабируется в соответствии с размерами мозаики.Uniform: The TileBrush content is scaled to fit the tile dimensions. Однако пропорции содержимого сохраняются.However, the aspect ratio of the content is preserved.

  • UniformToFill. Содержимое TileBrush масштабируется таким образом, что оно полностью заполняет область вывода, но сохраняет исходные пропорции.UniformToFill: The TileBrush content is scaled so that it completely fills the output area but preserves its original aspect ratio.

  • Fill. Содержимое TileBrush масштабируется в соответствии с плиткой.Fill: The TileBrush content is scaled to fit the tile. Поскольку высота и ширина содержимого масштабируются независимо друг от друга, исходные пропорции содержимого могут не сохраняться.Because the content's height and width are scaled independently, the original aspect ratio of the content might not be preserved. Это значит, что содержимое TileBrush может быть искажено, чтобы полностью заполнить плитку вывода.That is, the TileBrush content might be distorted in order to completely fill the output tile.

На следующем рисунке показаны различные параметры Stretch.The following image illustrates the different Stretch settings.

Различные параметры растяжения TileBrushDifferent TileBrush Stretch settings
Различные параметры растяженияDifferent stretch settings

Обратите внимание, что размеры TileBrush содержимого задаются с помощью свойства Viewbox. Вы указываете расположение и размер основной плитки TileBrush с помощью свойства Viewport.Note that you specify the dimensions of TileBrush content by using the Viewbox property; you specify the position and size of the TileBrush base tile by using the Viewport property.

Viewbox обрезкаViewbox Clipping

содержимое TileBrush никогда не обрезается в Viewbox.TileBrush contents are never clipped to the Viewbox. Однако *содержимое @no__t* -0 обрезается по краям Viewport, который задает размеры для базового элемента TileBrush.However, TileBrush contents are clipped to the edges of the Viewport, which sets the dimensions for the TileBrush base tile.

На следующем рисунке показано воздействие различных параметров Stretch на TileBrush с Viewbox, размер которого меньше Viewport.The following illustration shows the effect of different Stretch settings on a TileBrush that has a Viewbox that is smaller than its Viewport. Части изображения, находящиеся за пределами Viewbox, оттенки серого.The parts of the image that are outside the Viewbox are tinted gray.

TileBrush с различными параметрами StretchTileBrush with different Stretch settings
TileBrush с различными параметрами растяженияTileBrush with different Stretch settings

Сведения о свойстве зависимостейDependency Property Information

Поле идентификатораIdentifier field StretchProperty
Для свойств метаданных задано значение trueMetadata properties set to true ОтсутствуютNone

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

Дополнительно