FrameworkElement.ActualWidth Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 DoubleValeur de propriété
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 .