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。それ以外の場合は、falsetrue if the content should be clipped; otherwise, false. 既定値は false です。The default value is false.

注釈

子要素の場合ClipToBounds 、親要素の高さと幅がMaxHeight / によってHeight / Width 決定されているかどうかによって、レイアウトの動作に異なる効果がありますMaxWidthFor 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 true ClipToBoundsの場合、ClipToBounds親の / 設定はコンテンツをクリップしませんが、がの場合はコンテンツをクリップします。 falseThe parent's Height / Width settings will not clip the content when ClipToBounds is false, but will clip the content if ClipToBounds is true.

既定では、 falseUIElementクラスに実装されている一般的な動作であることに注意してください。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.

InkCanvasInkPresenter、およびPopuptrue、それぞれ既定値をにオーバーライドします。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 NoneNone

適用対象

こちらもご覧ください