FrameworkElement.Width Propriedade

Definição

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Obtém ou define a largura do 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 da propriedade

Double

A largura do elemento, em unidades independentes do dispositivo (1/96 polegada por unidade). O valor padrão é NaN. Este valor deve ser igual ou maior que 0,0. Consulte os Comentários para ver informações sobre o limite superior.

Atributos

TypeConverterAttribute LocalizabilityAttribute

Comentários

Essa é uma das três propriedades em FrameworkElement que especificam informações de largura. Os outros dois são MinWidth e MaxWidth. Se houver um conflito entre esses valores, a ordem de aplicação para a determinação de largura real deverá ser respeitada, MinWidth em seguida MaxWidth, e, por fim, se cada um deles estiver dentro dos limites, Width.

O valor retornado dessa propriedade é sempre o mesmo que qualquer valor que foi definido para ela. Por outro lado, o valor do ActualWidth pode variar. O layout pode ter rejeitado o tamanho sugerido por algum motivo. Além disso, o próprio sistema de layout funciona de forma assíncrona em relação ao conjunto de sistemas de propriedades de Width e pode não ter processado essa alteração de propriedade de dimensionamento específica ainda.

Além dos valores aceitáveis Double , essa propriedade também pode ser Double.NaN. É assim que você especifica o comportamento de dimensionamento automático. No XAML, você define o valor como a cadeia de caracteres "Auto" (não diferencia maiúsculas de minúsculas) para habilitar o comportamento de dimensionamento automático. O comportamento de dimensionamento automático implica que o elemento preencherá a largura disponível para ele. Observe, no entanto, que controles específicos frequentemente fornecem valores padrão em seus estilos padrão que desabilitam o comportamento de dimensionamento automático, a menos que ele seja especificamente reabilitado.

Além da validação marcar, há um valor superior não determinístico associado a Width que é imposto pelo sistema de layout (esse é um número muito grande, maior queSingle.MaxValue, mas menor que Double.MaxValue). Se você exceder esse limite, o elemento não será renderizado e nenhuma exceção será gerada. Não defina Width como um valor significativamente maior que o tamanho máximo de qualquer exibição visual possível ou você pode exceder esse limite superior não determinístico.

Uso do Atributo XAML

<object Width="double"/>  

- ou -

<object Width ="qualifiedDouble"/>  

- ou -

<object Width ="Auto"/>  

Valores XAML

double
Double

Representação de cadeia de caracteres de um Double valor igual ou maior que 0,0. Consulte os Comentários para ver informações sobre o limite superior. Esse valor é interpretado como uma medida de unidade independente do dispositivo (1/96 polegada). As cadeias de caracteres não precisam incluir explicitamente pontos decimais. Por exemplo, um valor de 1 é aceitável.

Qualifieddouble
Um valor duplo, conforme descrito acima, seguido por uma das seguintes cadeias de caracteres de declaração de unidade: px, in, cm, . pt

px (padrão) são unidades independentes do dispositivo (1/96 polegada por unidade)

in é polegadas; 1in==96px

cm é centímetro; 1cm==(96/2,54) px

pt é pontos; 1pt==(96/72) px

Auto
Habilita o comportamento de dimensionamento automático. Consulte Observações.

Informações da propriedade de dependência

Campo Identificador	WidthProperty
Propriedades de metadados definidas como true	AffectsMeasure