UIElement.ClipToBounds UIElement.ClipToBounds UIElement.ClipToBounds UIElement.ClipToBounds Property

Определение

Получение или установка значения, определяющего усечение содержимого этого элемента (или содержимого, поступающего из его дочерних элементов) в соответствии с размерами содержащего его элемента.Gets or sets a value indicating whether to clip the content of this element (or content coming from the child elements of this element) to fit into the size of the containing element. Это свойство зависимостей.This is a dependency property.

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

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

Значение true, если содержимое необходимо отсечь, в противном случае — значение false.true if the content should be clipped; otherwise, false. Значение по умолчанию — false.The default value is false.

Комментарии

Для дочерних элементов ClipToBounds выполняет разные действия для расширения функциональности макета, в зависимости от того высоты и ширины родительского элемента определяются Height / Width или MaxHeight / MaxWidth.For child elements, ClipToBounds has different effects on layout behaviors depending on whether the height and width of the parent element are being determined by Height / Width or MaxHeight / MaxWidth. MaxHeight / MaxWidth родительского элемента всегда соблюдаются независимо от значения ClipToBounds и эффективной обрезки всегда отсекает содержимое на эти максимальные значения.MaxHeight / MaxWidth of the parent element are always respected regardless of the value of ClipToBounds and the effective clipping will always clip the content based on these maximums. Родительского элемента Height / Width параметры не изменяет содержимое при ClipToBoundsfalse, но отсекает содержимого if ClipToBounds является true.The parent's Height / Width settings will not clip the content when ClipToBounds is false, but will clip the content if ClipToBounds is true.

Обратите внимание, что по умолчанию принимается false — это общее поведение, реализованное в UIElement класса.Note that defaulting to false is the general behavior as implemented in the UIElement class. Это возможно для любого заданного элемента, который является производным от UIElement переопределить метаданные свойства зависимостей для этого свойства в этот экземпляр для использования по умолчанию true вместо этого.It is possible for any given element that derives from UIElement to override the dependency property metadata for this property in that instance to default to true instead. Нескольких существующих производных классов переопределить эти метаданные и/или изменить значения по умолчанию свойства зависимостей.Several existing derived classes override this metadata and/or adjust the dependency property default value.

InkCanvas, InkPresenter, и Popup каждого переопределить значение по умолчанию, чтобы быть true.InkCanvas, InkPresenter, and Popup each override the default value to be true.

FrameworkElement переопределяет метаданные для этого свойства зависимостей.FrameworkElement overrides the metadata for this dependency property. В частности FrameworkElement назначает это свойство, чтобы разрешить наследование значений свойств (Inherits является true в метаданных).Specifically, FrameworkElement designates this property to allow property value inheritance (Inherits is true in metadata). Наследование значения свойства в данном контексте означает, что если существуют дочерние элементы, имеющие отсутствует значение для ClipToBounds , присвоенное с помощью локальных значений или стилей, значение ближайшего родительского элемента с назначенным данным значением (опять же, либо в стилях, по умолчанию значения, или локального значения), то будет присвоено значение, из родительского элемента Все неназначенные дочерним элементам системой свойств.Property value inheritance in this context means that if there are child elements with no other value for ClipToBounds assigned through local values or styles, the value of the nearest parent element with this value assigned (again, either in styles, by default values, or a locally value), then the value from the parent element will be assigned to all unassigned child elements by the property system. На практике это означает, что можно указать, следует ли разрешить обрезать для границы в корневом элементе, и это значение будет распространено на все дочерние элементы, которые имеют не только назначенный как false.In practice this means that you can specify whether to allow clip to bounds at the root element, and that value will propagate to all child elements that have not specifically assigned it as false.

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

Поле идентификатораIdentifier field ClipToBoundsProperty
Значение свойства метаданных trueMetadata properties set to true НетNone

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

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