UIElement.ClipToBounds Eigenschaft

Definition

Ruft einen Wert ab bzw. legt einen Wert fest, der angibt, ob der Inhalt dieses Elements (oder Inhalt aus seinen untergeordneten Elementen) abgeschnitten wird, sodass er in das enthaltende Element passt. Hierbei handelt es sich um eine Abhängigkeitseigenschaft.

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

Eigenschaftswert

true, wenn der Inhalt abgeschnitten werden soll, andernfalls false. Der Standardwert ist false.

Hinweise

Für untergeordnete Elemente hat unterschiedliche Auswirkungen auf das Layoutverhalten, je nachdem, ClipToBounds ob die Höhe und Breite des übergeordneten Elements durch / WidthHeightoder MaxHeight / MaxWidthbestimmt werden. MaxHeight / MaxWidth des übergeordneten Elements werden unabhängig vom Wert von ClipToBounds immer berücksichtigt, und der effektive Clipping schneidet den Inhalt immer basierend auf diesen Höchstwerten ab. Die Einstellungen des HeightWidth / übergeordneten Elements schneiden den Inhalt nicht ab, wenn ClipToBoundsfalseist, sondern beschneiden den Inhalt, wenn ClipToBounds ist.true

Beachten Sie, dass die Standardeinstellung das false allgemeine Verhalten ist, das in der UIElement -Klasse implementiert ist. Es ist möglich, dass jedes element, das von UIElement abgeleitet wird, die Metadaten der Abhängigkeitseigenschaft für diese Eigenschaft in dieser Instanz standardmäßig auf außer Kraft setzen true . Mehrere vorhandene abgeleitete Klassen überschreiben diese Metadaten und/oder passen den Standardwert der Abhängigkeitseigenschaft an.

InkCanvas, InkPresenterund Popup setzen jeweils den Standardwert auf true.

FrameworkElement überschreibt die Metadaten für diese Abhängigkeitseigenschaft. Legt insbesondere diese Eigenschaft fest, FrameworkElement um die Vererbung von Eigenschaftswerten zuzulassen (Inherits ist true in Metadaten enthalten). Die Vererbung von Eigenschaftswerten bedeutet in diesem Kontext, dass der Wert des nächsten übergeordneten Elements, dem dieser Wert zugewiesen ist ClipToBounds (wiederum in Formatvorlagen, Standardwerten oder lokal), der Wert aus dem übergeordneten Element vom Eigenschaftensystem allen nicht zugewiesenen untergeordneten Elementen zugewiesen wird. In der Praxis bedeutet dies, dass Sie angeben können, ob clip to bounds am Stammelement zugelassen werden soll, und dass dieser Wert an alle untergeordneten Elemente weitergegeben wird, die ihm nicht ausdrücklich als falsezugewiesen haben.

Informationen zur Abhängigkeitseigenschaft

Bezeichnerfeld ClipToBoundsProperty
Metadateneigenschaften auf true festgelegt Keine

Gilt für:

Weitere Informationen