Partage via


FrameworkElement.ActualWidth Propriété

Définition

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 normale 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 de 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 cours d’itération, le système de disposition peut toujours calculer la mesure d’espace requise pour les objets enfants, les contraintes par 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 définie 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 calculée asynchrone et d’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 .

S’applique à

Voir aussi