UIElement.ClipToBounds Свойство

Определение

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

System.Windows

Сборка:

PresentationCore.dll

Получение или установка значения, определяющего усечение содержимого этого элемента (или содержимого, поступающего из его дочерних элементов) в соответствии с размерами содержащего его элемента. Это свойство зависимостей.

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

public bool ClipToBounds { get; set; }

member this.ClipToBounds : bool with get, set

Public Property ClipToBounds As Boolean

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

Boolean

Значение true, если содержимое необходимо отсечь, в противном случае — значение false. Значение по умолчанию — false.

Комментарии

Для дочерних элементов различные эффекты влияют на поведение макета в зависимости от того, ClipToBounds определяетсяWidth / Height ли высота и ширина родительского элемента.MaxHeight / MaxWidth MaxHeight / MaxWidth родительский элемент всегда учитывается независимо от значения ClipToBounds и эффективного обрезки всегда обрезает содержимое на основе этих максимумов. Параметры родительского Height / Width объекта не будут обрезать содержимое, ClipToBounds если оно trueестьfalse, но при этом будет вырезано содержимое.ClipToBounds

Обратите внимание, что по умолчанию false используется общее поведение, как реализовано UIElement в классе. Для любого заданного элемента, наследуемого от UIElement переопределения метаданных свойства зависимостей для этого свойства в этом экземпляре, true можно переопределить вместо этого метаданные свойства. Несколько существующих производных классов переопределяют эти метаданные и /или корректируют значение свойства зависимостей по умолчанию.

InkCanvas, InkPresenterи Popup каждое переопределение значения по умолчанию.true

FrameworkElement переопределяет метаданные для этого свойства зависимостей. В частности, указывает это свойство, FrameworkElement чтобы разрешить наследование значений свойства (Inherits находится true в метаданных). Наследование значений свойства в этом контексте означает, что если дочерние элементы не имеют других значений, ClipToBounds назначенных с помощью локальных значений или стилей, значение ближайшего родительского элемента с назначенным значением (опять же в стилях, по умолчанию или локальном значении), то значение родительского элемента будет назначено всем неназначенным дочерним элементам системы свойств. На практике это означает, что можно указать, следует ли разрешать обрезку границ в корневом элементе, и это значение будет распространяться на все дочерние элементы, которые не назначили его falseкак.

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

Поле идентификатора	ClipToBoundsProperty
Metadata properties set to true	Нет

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

• Clip