UIElement.ClipToBounds プロパティ
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
親要素のサイズに合わせるために、この要素の内容 (またはこの要素の子要素の内容) を切り取るかどうかを示す値を取得または設定します。 これは依存関係プロパティです。
public:
property bool ClipToBounds { bool get(); void set(bool value); };public bool ClipToBounds { get; set; }member this.ClipToBounds : bool with get, setPublic Property ClipToBounds As Booleanコンテンツをクリップする必要がある場合は、true。それ以外の場合は、false。 既定値は false です。
子要素の場合、ClipToBounds親要素の高さと幅が決定MaxHeightMaxWidthHeight / Width / されるかどうかに応じて、レイアウトの動作に異なる効果があります。 MaxHeight / MaxWidth 親要素の値 ClipToBounds に関係なく常に尊重され、有効なクリッピングは常にこれらの最大値に基づいてコンテンツをクリップします。 親の Height / Width 設定では、コンテンツがクリップされる場合 ClipToBounds は falseクリップされませんが、ある場合 ClipToBounds は trueコンテンツがクリップされます。
既定値 false は、クラスに UIElement 実装される一般的な動作であることに注意してください。 派生 UIElement 元の特定の要素は、そのインスタンス内のこのプロパティの依存関係プロパティ メタデータをオーバーライドして、代わりに既定値に true することもできます。 いくつかの既存の派生クラスがこのメタデータをオーバーライドしたり、依存関係プロパティの既定値を調整したりします。
InkCanvasをクリック InkPresenterして、 Popup 既定値をオーバーライドします true。
FrameworkElement は、この依存関係プロパティのメタデータをオーバーライドします。 具体的には、FrameworkElementプロパティ値の継承を許可するようにこのプロパティを指定します (Inheritstrueメタデータ内にあります)。 このコンテキストでのプロパティ値の継承は、ローカル値またはスタイルを介して割り当てられた他の値 ClipToBounds を持たない子要素がある場合、この値が割り当てられた最も近い親要素の値 (スタイル、既定値、またはローカル値のいずれか) が存在する場合、親要素の値がプロパティ システムによって割り当てられていないすべての子要素に割り当てられることを意味します。 実際には、これは、ルート要素でクリップの境界を許可するかどうかを指定することができ、その値が、明示的に割り当てられないすべての子要素に false反映されることを意味します。
| 識別子フィールド | ClipToBoundsProperty |
メタデータのプロパティが次に設定されている true |
なし |
| 製品 | バージョン |
|---|---|
| .NET Framework | 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7 |