Compartilhar via


FrameworkElement.ActualWidth Propriedade

Definição

Obtém a largura renderizada de um FrameworkElement. Consulte Observações.

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

Double

double

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

Observação

Embora tenha um campo de suporte ActualWidthProperty , ActualWidth não gera notificações de alteração de propriedade e deve ser considerado como uma propriedade CLR regular e não uma propriedade de dependência.

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 alterações relatadas ou incrementais no valor devido a 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 uma passagem 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 .

Aplica-se a

Confira também