ActualWidth-Eigenschaft

FrameworkElement.ActualWidth Property

Ruft die gerenderte Breite eines FrameworkElement ab.

Syntax


public double ActualWidth { get; }

Eigenschaftswert

Typ: System.Double [.NET] | float64 [C++]

Die Breite des Objekts in Pixel. Der Standardwert ist 0. Den Standardwert könnten Sie erhalten, wenn das Objekt nicht geladen und keine Layoutübergabe ausgeführt wurde.

Hinweise

ActualWidth ist eine berechnete Eigenschaft. Die Berechnungen sind das Ergebnis einer Layoutübergabe, in der das Objekt im Layout entsprechend der Logik der aufeinander folgenden übergeordneten Layoutelemente in der Größe angepasst wird. Weitere Informationen finden Sie unter Schnellstart: Definieren von Layouts.

ActualWidth kann mehrere oder inkrementelle gemeldete Änderungen dieses Werts haben, die das Ergebnis verschiedener Vorgänge des Layoutsystems sind. Wenn Sie den Wert abrufen, während das Layout noch abgearbeitet wird, könnte das Layoutsystem die erforderliche Berechnung des Platzes für untergeordnete Objekte, Einschränkungen durch das übergeordnete Objekt usw. eventuell noch nicht abgeschlossen haben. Da der Wert auf einem tatsächlichen Renderingdurchlauf basiert, bleibt er möglicherweise leicht hinter dem festgelegten Wert von Eigenschaften wie Width zurück, die die Grundlage der Eingabeänderung sein können.

Zum Zwecke der ElementName-Bindung stellt ActualWidth bei Änderungen keine Updates bereit (da der Wert asynchron ist und zur Laufzeit berechnet wird). Versuchen Sie nicht, ActualWidth als Bindungsquelle für eine ElementName-Bindung zu verwenden. Wenn Ihr Szenario Aktualisierungen auf Grundlage der ActualWidth erfordert, verwenden Sie einen SizeChanged-Handler.

Anforderungen

Mindestens unterstützter Client

Windows 8

Mindestens unterstützter Server

Windows Server 2012

Namespace

Windows.UI.Xaml
Windows::UI::Xaml [C++]

Metadaten

Windows.winmd

Siehe auch

FrameworkElement

 

 

Anzeigen:
© 2017 Microsoft