FrameworkElement.ActualWidth 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 die gerenderte Breite eines FrameworkElements ab. Siehe Anmerkungen.
public:
property double ActualWidth { double get(); };double ActualWidth();public double ActualWidth { get; }var double = frameworkElement.actualWidth;Public ReadOnly Property ActualWidth As DoubleEigenschaftswert
double
Die Breite des Objekts in Pixel. Der Standardwert lautet 0. Die Standardeinstellung kann auftreten, wenn das Objekt noch nicht geladen wurde und noch nicht an einem Layoutdurchlauf beteiligt war, der die Benutzeroberfläche rendert.
Hinweise
Hinweis
Obwohl es über ein ActualWidthProperty-Sicherungsfeld verfügt, löst ActualWidth keine Eigenschaftsänderungsbenachrichtigungen aus und sollte als normale CLR-Eigenschaft und nicht als Abhängigkeitseigenschaft betrachtet werden.
ActualWidth ist eine berechnete Eigenschaft. Die Berechnungen sind ein Ergebnis eines Layoutdurchlaufs, bei dem das Objekt in der Layoutgröße entsprechend der Logik der aufeinanderfolgenden Layout-übergeordneten Elemente angepasst wird. Weitere Informationen finden Sie unter Definieren von Layouts mit XAML.
ActualWidth kann mehrere oder inkrementelle gemeldete Änderungen am Wert aufgrund von Vorgängen durch das Layoutsystem aufweisen. Wenn Sie den Wert erhalten, während das Layout noch durchlaufen wird, berechnet das Layoutsystem möglicherweise trotzdem 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 geringfügig hinter dem festgelegten Wert von Eigenschaften wie Width, was die Grundlage der Eingabeänderung sein kann.
Für die ElementName-Bindung stellt ActualWidth keine Aktualisierungen bereit, wenn sie sich ändert (aufgrund der asynchronen und laufzeitbasierten berechneten Natur). Versuchen Sie nicht, ActualWidth als Bindungsquelle für eine ElementName-Bindung zu verwenden. Wenn Sie über ein Szenario verfügen, für das Updates basierend auf ActualWidth erforderlich sind, verwenden Sie einen SizeChanged-Handler .