Udostępnij za pośrednictwem


UIElement.ClipToBounds Właściwość

Definicja

Pobiera lub ustawia wartość wskazującą, czy należy wyciąć zawartość tego elementu (lub zawartość pochodzącą z elementów podrzędnych tego elementu) w celu dopasowania do rozmiaru elementu zawierającego. Jest to właściwość zależności.

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

Wartość właściwości

Boolean

true jeśli zawartość ma zostać obcięty; w przeciwnym razie , false. Wartość domyślna to false.

Uwagi

W przypadku elementów podrzędnych ma inny wpływ na zachowania układu w zależności od tego, ClipToBounds czy wysokość i szerokość elementu nadrzędnego są określane przezWidth / Height element lub .MaxHeight / MaxWidth MaxHeight / MaxWidth element nadrzędny jest zawsze przestrzegany niezależnie od wartości ClipToBounds , a efektywne wycinki zawsze przycinają zawartość na podstawie tych wartości maksymalnych. Ustawienia elementu nadrzędnego Height / Width nie będą wyciąć zawartości, gdy ClipToBounds jest to false, ale wycinek zawartości, jeśli ClipToBounds to true.

Należy pamiętać false , że wartością domyślną jest ogólne zachowanie zaimplementowane w UIElement klasie. Dla każdego elementu, który pochodzi z UIElement , można zastąpić metadane właściwości zależności dla tej właściwości w tym wystąpieniu domyślnie domyślnie true . Kilka istniejących klas pochodnych zastępuje te metadane i/lub dostosuj wartość domyślną właściwości zależności.

InkCanvas, InkPresenteri Popup każdy zastępuje wartość domyślną na true.

FrameworkElement zastępuje metadane tej właściwości zależności. W szczególności wyznacza tę właściwość, FrameworkElement aby zezwolić na dziedziczenie wartości właściwości (Inherits jest true w metadanych). Dziedziczenie wartości właściwości w tym kontekście oznacza, że jeśli istnieją elementy podrzędne bez innej wartości ClipToBounds przypisanej za pomocą wartości lokalnych lub stylów, wartość najbliższego elementu nadrzędnego o tej wartości przypisanej (ponownie w stylach, domyślnie wartości lub wartość lokalna), wartość z elementu nadrzędnego zostanie przypisana do wszystkich nieprzypisanych elementów podrzędnych przez system właściwości. W praktyce oznacza to, że można określić, czy zezwolić klipowi na ograniczenia w elemercie głównym, a ta wartość będzie propagowana do wszystkich elementów podrzędnych, które nie zostały specjalnie przypisane jako false.

Informacje dotyczące właściwości zależności

Pole identyfikatora ClipToBoundsProperty
Właściwości metadanych ustawione na true Brak

Dotyczy

Zobacz też