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
。
備註
對於子專案,根據父元素的高度和寬度是否由 / WidthHeight 或 MaxHeightMaxWidth / 決定, ClipToBounds 對版面配置行為有不同的影響。
MaxHeight
/
MaxWidth 不論 的值 ClipToBounds 為何,父元素的一律都會受到尊重,且有效的裁剪一律會根據這些最大值來裁剪內容。 當 是 時,父系的 HeightWidth / 設定不會裁剪內容,但如果 是 true
,則會裁剪內容 ClipToBounds 。 ClipToBoundsfalse
請注意,預設 false
為 的是 類別中實作的 UIElement 一般行為。 任何衍生自 UIElement 的指定專案,都可能會覆寫該實例中此屬性的相依性屬性中繼資料,改為預設 true
為 。 數個現有的衍生類別會覆寫此中繼資料和/或調整相依性屬性預設值。
InkCanvas、 InkPresenter 和 Popup 都會覆寫預設值為 true
。
FrameworkElement 會覆寫這個相依性屬性的中繼資料。 具體而言, FrameworkElement 指定此屬性以允許屬性值繼承 (Inherits 位於 true
中繼資料) 中。 在此內容中的屬性值繼承表示,如果沒有透過本機值或樣式指派其他值的子項目,則會再次 (指派這個值之最接近父元素的值,例如樣式、預設值或本機值 ClipToBounds) ,則父元素的值將會指派給屬性系統的所有未指派子項目。 實際上,這表示您可以指定是否允許裁剪到根項目的界限,而且該值會傳播到尚未特別指派為 false
的所有子專案。
相依性屬性資訊
識別碼欄位 | ClipToBoundsProperty |
設定為 的中繼資料屬性 true |
無 |