FrameworkElement.ActualWidth Propriedade
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 Doubledouble
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.
Nota
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 .
| Produto | Versões |
|---|---|
| Windows App SDK | 0.8, 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6 |