FrameworkElement.ActualWidth Propriedade

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

double ActualWidth();

public double ActualWidth { get; }

var double = frameworkElement.actualWidth;

Public ReadOnly Property ActualWidth As Double

Valor da propriedade

A largura, em pixels, do objeto. O padrão é 0. O padrão poderá ser encontrado se o objeto não tiver sido carregado e ainda não estiver envolvido em uma passagem de layout que renderize a interface do usuário.

Comentários

ActualWidth é uma propriedade calculada. Os cálculos são resultado de uma passagem de layout, em que o objeto é dimensionado no layout de acordo com a lógica de seus pais de layout sucessivos. Para obter mais informações, consulte Definir layouts com XAML.

ActualWidth pode ter várias ou incrementais alterações relatadas no valor devido às operações do sistema de layout. Se você receber o valor enquanto o layout ainda estiver iterando, o sistema de layout ainda poderá estar calculando a medida necessária de espaço para objetos filho, restrições pelo objeto pai e assim por diante. Como o valor é baseado em um passe de renderização real, ele pode ficar um pouco atrás do valor definido de propriedades como Width, que pode ser a base da alteração de entrada.

Para fins de associação ElementName , ActualWidth não publica atualizações quando é alterado (devido à sua natureza calculada assíncrona e em tempo de execução). Não tente usar ActualWidth como uma origem de associação para uma associação ElementName . Se você tiver um cenário que exija atualizações com base em ActualWidth, use um manipulador SizeChanged .

Confira também

• ActualHeight
• Width
• SizeChanged