FrameworkElement.ActualWidth Propiedad

Definición

Obtiene el ancho representado de un frameworkElement. Vea la sección Comentarios.

public:
 property double ActualWidth { double get(); };
double ActualWidth();
public double ActualWidth { get; }
var double = frameworkElement.actualWidth;
Public ReadOnly Property ActualWidth As Double

Valor de propiedad

Double

double

La anchura, en píxeles del objeto . El valor predeterminado es 0. Es posible que se encuentre el valor predeterminado si el objeto no se ha cargado y aún no ha participado en un pase de diseño que representa la interfaz de usuario.

Comentarios

Nota

Aunque tiene un campo de respaldo ActualWidthProperty , ActualWidth no genera notificaciones de cambio de propiedad y debe considerarse como una propiedad CLR normal y no una propiedad de dependencia.

ActualWidth es una propiedad calculada. Los cálculos son el resultado de un paso de diseño, donde el objeto tiene el tamaño en el diseño según la lógica de sus elementos primarios de diseño sucesivos. Para obtener más información, consulta Definir diseños con XAML.

ActualWidth puede tener varios cambios notificados o incrementales en el valor debido a las operaciones del sistema de diseño. Si obtiene el valor mientras el diseño sigue iterando, es posible que el sistema de diseño siga calculando la medida de espacio necesaria para los objetos secundarios, las restricciones del objeto primario, etc. Dado que el valor se basa en un paso de representación real, puede retardar ligeramente detrás del valor establecido de propiedades como Width, que puede ser la base del cambio de entrada.

Para los fines del enlace ElementName , ActualWidth no publica actualizaciones cuando cambia (debido a su naturaleza calculada asincrónica y en tiempo de ejecución). No intente usar ActualWidth como origen de enlace para un enlace ElementName . Si tiene un escenario que requiere actualizaciones basadas en ActualWidth, use un controlador SizeChanged .

Se aplica a

Consulte también