UIElement.ClipToBounds Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví hodnotu označující, zda chcete vystřihot obsah tohoto prvku (nebo obsah pocházející z podřízených elementů tohoto elementu), aby se vešel do velikosti obsahujícího elementu. Toto je vlastnost závislosti.
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
Hodnota vlastnosti
true
pokud by měl být obsah oříznut; v opačném případě . false
Výchozí hodnota je false
.
Poznámky
U podřízených elementů má různé vlivy na chování rozložení v závislosti na tom, ClipToBounds jestli výšku a šířku nadřazeného prvku určujeWidth / Height nebo .MaxHeight / MaxWidth
MaxHeight
/
MaxWidth nadřazeného prvku jsou vždy respektovány bez ohledu na hodnotu ClipToBounds a efektivní oříznutí vždy vystřihne obsah na základě těchto maximálních hodnot. Nastavení nadřazeného Height / Width objektu neoříze obsah, pokud ClipToBounds je false
, ale vystřihovne obsah, pokud ClipToBounds je .true
Všimněte si, že výchozí hodnota false
je obecné chování, jak je implementováno UIElement ve třídě. Je možné, aby jakýkoli prvek, který se odvozuje od UIElement , přepsat metadata vlastnosti závislostí pro tuto vlastnost v dané instanci výchozí na true
místo. Několik existujících odvozených tříd přepíše tato metadata nebo upraví výchozí hodnotu vlastnosti závislosti.
InkCanvas, InkPresentera Popup každá z nich přepíše výchozí hodnotu na true
.
FrameworkElement přepíše metadata pro tuto vlastnost závislosti. Konkrétně určuje tuto vlastnost tak, FrameworkElement aby umožňovala dědičnost hodnot vlastností (Inherits je true
v metadatech). Dědičnost hodnot vlastností v tomto kontextu znamená, že pokud existují podřízené elementy bez jiné hodnoty ClipToBounds přiřazené prostřednictvím místních hodnot nebo stylů, hodnota nejbližšího nadřazeného elementu s přiřazenou touto hodnotou (opět buď ve stylech, ve výchozím nastavení hodnoty, nebo místně), pak bude hodnota z nadřazeného elementu přiřazena všem nepřiřazeným podřízeným elementům systémem vlastností. V praxi to znamená, že můžete určit, jestli chcete povolit ohraničení klipu v kořenovém elementu a tato hodnota se rozšíří do všech podřízených elementů, které ji nemají konkrétně přiřazené jako false
.
Informace o vlastnosti závislosti
Pole Identifikátor | ClipToBoundsProperty |
Vlastnosti metadat nastavené na true |
Žádné |