Freigeben über


FrameworkElement.ActualWidth Eigenschaft

Definition

Ruft die gerenderte Breite eines FrameworkElements ab. Siehe Hinweise.

public:
 property double ActualWidth { double get(); };
double ActualWidth();
public double ActualWidth { get; }
var double = frameworkElement.actualWidth;
Public ReadOnly Property ActualWidth As Double

Eigenschaftswert

Double

double

Die Breite des Objekts in Pixel. Die Standardeinstellung ist 0. Die Standardeinstellung kann auftreten, wenn das Objekt nicht geladen wurde und noch nicht an einem Layoutdurchlauf beteiligt war, der die Benutzeroberfläche rendert.

Hinweise

Hinweis

Obwohl es über ein ActualWidthProperty-Backingfeld verfügt, löst ActualWidth keine Benachrichtigungen über Eigenschaftsänderungen aus und sollte als reguläre CLR-Eigenschaft und nicht als Abhängigkeitseigenschaft betrachtet werden.

ActualWidth ist eine berechnete Eigenschaft. Die Berechnungen sind das Ergebnis eines Layoutdurchlaufs, bei dem das Objekt im Layout entsprechend der Logik seiner aufeinander folgenden layoutbasierten Übergeordneten dimensioniert wird. Weitere Informationen finden Sie unter Definieren von Layouts mit XAML.

ActualWidth kann mehrere oder inkrementelle Änderungen am Wert aufgrund von Vorgängen durch das Layoutsystem aufweisen. Wenn Sie den Wert erhalten, während das Layout noch iteriert wird, berechnet das Layoutsystem möglicherweise weiterhin das erforderliche Maß an Platz für untergeordnete Objekte, Einschränkungen durch das übergeordnete Objekt usw. Da der Wert auf einem tatsächlichen Renderingdurchlauf basiert, liegt er möglicherweise etwas hinter dem festgelegten Wert von Eigenschaften wie Width zurück, der die Grundlage der Eingabeänderung sein kann.

Für Die ElementName-Bindung stellt ActualWidth keine Aktualisierungen bereit, wenn es sich ändert (aufgrund seiner asynchronen und berechneten Laufzeit). Versuchen Sie nicht, ActualWidth als Bindungsquelle für eine ElementName-Bindung zu verwenden. Wenn Sie ein Szenario haben, das Updates basierend auf ActualWidth erfordert, verwenden Sie einen SizeChanged-Handler .

Gilt für:

Weitere Informationen