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 por defecto es NaN. Este valor debe ser igual o mayor que 0,0. Vea Comentarios para obtener información de límite superior.

Atributos

Comentarios

Se trata de una de las tres propiedades de que especifican información de FrameworkElement ancho. Los otros dos son MinWidth y MaxWidth. Si hay un conflicto entre estos valores, primero se MinWidth 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 es siempre el mismo que cualquier valor que se estableció 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 con respecto al conjunto de sistemas de propiedades de y es posible que aún no haya procesado ese cambio de propiedad de ajuste de Width 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 de tamaño automático implica que el elemento rellenará el ancho disponible para él. 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 pantalla 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

doubleDouble

Representación de cadena de un Double valor igual o mayor que 0,0. Vea Comentarios para obtener información de 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 de la propiedad dependency

Elemento Value
Campo identificador WidthProperty
Propiedades de metadatos establecidas en true AffectsMeasure

Se aplica a