FrameworkElement.ActualWidth Propriété

Définition

Espace de noms:

Microsoft.UI.Xaml

Obtient la largeur rendue d’un FrameworkElement. Consultez la section Notes.

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

double ActualWidth();

public double ActualWidth { get; }

var double = frameworkElement.actualWidth;

Public ReadOnly Property ActualWidth As Double

Valeur de propriété

Double

double

Largeur, en pixels, de l’objet. La valeur par défaut est 0. La valeur par défaut peut être rencontrée si l’objet n’a pas été chargé et n’a pas encore été impliqué dans une passe de disposition qui restitue l’interface utilisateur.

Remarques

Notes

Bien qu’il ait un champ de sauvegarde ActualWidthProperty , ActualWidth ne déclenche pas de notifications de modification de propriété et doit être considéré comme une propriété CLR standard et non comme une propriété de dépendance.

ActualWidth est une propriété calculée. Les calculs sont le résultat d’une passe de disposition, où l’objet est dimensionné dans la disposition en fonction de la logique de ses parents de disposition successifs. Pour plus d’informations, consultez Définir des dispositions avec XAML.

ActualWidth peut avoir plusieurs modifications signalées ou incrémentielles à la valeur en raison d’opérations effectuées par le système de disposition. Si vous obtenez la valeur alors que la disposition est toujours en itération, le système de disposition peut toujours calculer la mesure d’espace requise pour les objets enfants, les contraintes de l’objet parent, etc. Étant donné que la valeur est basée sur une passe de rendu réelle, elle peut être légèrement en retard par rapport à la valeur de jeu de propriétés telles que Width, qui peut être la base de la modification d’entrée.

Pour les besoins de la liaison ElementName , ActualWidth ne publie pas de mises à jour lorsqu’il change (en raison de sa nature asynchrone et calculée au moment de l’exécution). N’essayez pas d’utiliser ActualWidth comme source de liaison pour une liaison ElementName . Si vous avez un scénario qui nécessite des mises à jour basées sur ActualWidth, utilisez un gestionnaire SizeChanged .

Voir aussi

• ActualHeight
• Width
• SizeChanged