FrameworkElement.Width Propiedad

Definición

Obtiene o establece el ancho del elemento.

public:
 property double Width { double get(); void set(double value); };
[System.ComponentModel.TypeConverter(typeof(System.Windows.LengthConverter))]
[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public double Width { get; set; }
[<System.ComponentModel.TypeConverter(typeof(System.Windows.LengthConverter))>]
[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
member this.Width : double with get, set
Public Property Width As Double

Valor de propiedad

Ancho del elemento, en unidades independientes del dispositivo (1/96 pulgadas por unidad). El valor predeterminado es NaN. Este valor debe ser igual o mayor que 0,0. Vea Comentarios para obtener información sobre el límite superior.

Atributos

Comentarios

Se trata de una de las tres propiedades de FrameworkElement que especifican información de ancho. Los otros dos son MinWidth y MaxWidth. Si hay un conflicto entre estos valores, primero MinWidth se debe respetar el orden de aplicación para la determinación de ancho real, y MaxWidth, por último, si cada uno de ellos está dentro de los límites, Width.

El valor devuelto de esta propiedad siempre es el mismo que cualquier valor establecido en ella. En cambio, el valor de ActualWidth puede variar. El diseño puede haber rechazado el tamaño sugerido por algún motivo. Además, el propio sistema de diseño funciona de forma asincrónica en relación con el conjunto de sistemas de propiedades de Width y es posible que aún no haya procesado ese cambio de propiedad de ajuste de tamaño determinado.

Además de los valores aceptables Double , esta propiedad también puede ser Double.NaN. Así es como se especifica el comportamiento de ajuste de tamaño automático. En XAML, estableces el valor en la cadena "Auto" (sin distinción entre mayúsculas y minúsculas) para habilitar el comportamiento de ajuste de tamaño automático. El comportamiento de ajuste automático de tamaño implica que el elemento rellenará el ancho disponible. Sin embargo, tenga en cuenta que los controles específicos proporcionan con frecuencia valores predeterminados en sus estilos predeterminados que deshabilitarán el comportamiento de ajuste de tamaño automático a menos que se vuelva a habilitar específicamente.

Además de la comprobación de validación, hay un valor superior no determinista enlazado a Width que aplica el sistema de diseño (se trata de un número muy grande, mayor que pero menor que Single.MaxValueDouble.MaxValue). Si supera este límite, el elemento no se representará y no se producirá ninguna excepción. No establezca en Width un valor que sea significativamente mayor que el tamaño máximo de cualquier presentación visual posible, o puede superar este límite superior no determinista.

Uso de atributos XAML

<object Width="double"/>  

o bien

<object Width ="qualifiedDouble"/>  

o bien

<object Width ="Auto"/>  

Valores XAML

double
Double

Representación de cadena de un Double valor igual o mayor que 0,0. Vea Comentarios para obtener información sobre el límite superior. Este valor se interpreta como una medida de unidad independiente del dispositivo (1/96 pulgadas). Las cadenas no necesitan incluir explícitamente puntos decimales. Por ejemplo, un valor de 1 es aceptable.

qualifiedDouble
Valor doble como se ha descrito anteriormente, seguido de una de las siguientes cadenas de declaración de unidad: px, in, cm, pt.

px (valor predeterminado) es unidades independientes del dispositivo (1/96 pulgadas por unidad)

in es pulgadas; 1in==96px

cm es centímetros; 1cm==(96/2.54) px

pt es puntos; 1pt==(96/72) px

Auto
Habilita el comportamiento de ajuste automático. Vea la sección Comentarios.

Información sobre propiedades de dependencia

Campo identificador WidthProperty
Propiedades de metadatos establecidas en true AffectsMeasure

Se aplica a