UIElement.ClipToBounds Właściwość
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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, setPublic Property ClipToBounds As Booleantrue jeśli zawartość ma zostać obcięty; w przeciwnym razie , false. Wartość domyślna to false.
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.
| Pole identyfikatora | ClipToBoundsProperty |
Właściwości metadanych ustawione na true |
Brak |
| Produkt | Wersje |
|---|---|
| .NET Framework | 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7 |