UIElement.ClipToBounds プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
この要素のコンテンツ (またはこの要素の子要素からのコンテンツ) を含む要素のサイズに収まるようにクリップするかどうかを示す値を取得または設定します。 これは依存関係プロパティです。
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。 既定値は false です。
注釈
子要素の場合、 ClipToBounds は、親要素の高さと幅が Height / Width または MaxHeight / MaxWidthによって決定されるかどうかによって、レイアウトの動作に異なる影響を与えます。
MaxHeight
/
MaxWidth 親要素の値は常に ClipToBounds の値に関係なく尊重され、有効なクリッピングは常にこれらの最大値に基づいてコンテンツをクリップします。 親の Height / Width 設定は、 ClipToBounds が falseされている場合はコンテンツをクリップしませんが、 ClipToBounds が true場合はコンテンツをクリップします。
falseの既定値は、UIElement クラスで実装される一般的な動作であることに注意してください。
UIElementから派生した特定の要素は、そのインスタンス内のこのプロパティの依存関係プロパティ メタデータをオーバーライドして、代わりに既定でtrueできます。 いくつかの既存の派生クラスがこのメタデータをオーバーライドしたり、依存関係プロパティの既定値を調整したりします。
InkCanvas、 InkPresenter、および各 Popup は、 trueされる既定値をオーバーライドします。
FrameworkElement は、この依存関係プロパティのメタデータをオーバーライドします。 具体的には、プロパティ値の継承を許可するようにこのプロパティを指定 FrameworkElement (Inherits はメタデータで true )。 このコンテキストでのプロパティ値の継承は、ローカル値またはスタイルを使用して割り当てられた ClipToBounds の他の値を持たない子要素がある場合、この値が割り当てられた最も近い親要素の値 (再び、スタイル、既定値、またはローカル値) がある場合、親要素の値がプロパティ システムによって割り当てられていないすべての子要素に割り当てられることを意味します。 これは実際には、クリップをルート要素の境界に許可するかどうかを指定できることを意味し、その値は、 falseとして明示的に割り当てまれていないすべての子要素に伝達されます。
依存関係プロパティ情報
| 品目 | 価値 |
|---|---|
| 識別子フィールド | ClipToBoundsProperty |
に設定されたメタデータ プロパティ true |
None |