UIElement.ClipToBounds Vlastnost

Definice

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

truepokud 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é

Platí pro

Viz také