UIElement.ClipToBounds Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 ClipToBoundsfalse
ist, 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 false
zugewiesen haben.
Informationen zur Abhängigkeitseigenschaft
Bezeichnerfeld | ClipToBoundsProperty |
Metadateneigenschaften auf true festgelegt |
Keine |