FrameworkElement.ActualWidth Proprietà

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml

Ottiene la larghezza sottoposta a rendering di un oggetto FrameworkElement. Vedere la sezione Osservazioni.

public:
 property double ActualWidth { double get(); };

double ActualWidth();

public double ActualWidth { get; }

var double = frameworkElement.actualWidth;

Public ReadOnly Property ActualWidth As Double

Valore della proprietà

Double

double

Larghezza, in pixel, dell'oggetto . Il valore predefinito è 0. L'impostazione predefinita potrebbe essere rilevata se l'oggetto non è stato caricato e non è ancora stato coinvolto in un passaggio di layout che esegue il rendering dell'interfaccia utente.

Commenti

Nota

Sebbene abbia un campo sottostante ActualWidthProperty , ActualWidth non genera notifiche di modifica delle proprietà e deve essere considerato come una normale proprietà CLR e non una proprietà di dipendenza.

ActualWidth è una proprietà calcolata. I calcoli sono il risultato di un passaggio di layout, in cui l'oggetto viene ridimensionato nel layout in base alla logica degli elementi padre del layout successivi. Per altre info, vedi Definire i layout con XAML.

ActualWidth può avere modifiche multiple o incrementali segnalate al valore a causa delle operazioni eseguite dal sistema di layout. Se si ottiene il valore durante l'iterazione del layout, il sistema di layout potrebbe comunque calcolare la misura necessaria di spazio per gli oggetti figlio, i vincoli dell'oggetto padre e così via. Poiché il valore è basato su un passaggio di rendering effettivo, può essere leggermente indietro rispetto al valore impostato di proprietà come Width, che può essere la base della modifica di input.

Ai fini dell'associazione ElementName , ActualWidth non pubblica gli aggiornamenti quando cambia (a causa della sua natura calcolata asincrona e in fase di esecuzione). Non tentare di usare ActualWidth come origine di associazione per un'associazione ElementName . Se si dispone di uno scenario che richiede aggiornamenti basati su ActualWidth, usare un gestore SizeChanged .

Vedi anche

• ActualHeight
• Width
• SizeChanged