FrameworkElement.Width Propriedade

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 Propriedade

A largura do elemento, em unidades independentes do dispositivo (1/96 de polegada por unidade). O valor predefinido é NaN. Este valor deve ser igual ou superior a 0,0. Consulte Observações para informações sobre o limite superior.

Atributos

TypeConverterAttribute LocalizabilityAttribute

Observações

Esta é uma das três propriedades que FrameworkElement especificam a informação de largura. Os outros dois são MinWidth e MaxWidth. Se houver um conflito entre estes valores, a ordem de aplicação para a determinação da largura real deve MinWidth primeiro ser respeitada, então MaxWidth, e finalmente, se cada uma delas estiver dentro de limites, Width.

O valor de retorno desta propriedade é sempre o mesmo que qualquer valor que lhe foi atribuído. Em contraste, 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 assíncronamente em relação ao conjunto de propriedades e Width pode ainda não ter processado essa alteração específica de propriedade de dimensionamento.

Para além dos valores aceitáveis Double , esta propriedade também pode ser Double.NaN. É assim que se especifica o comportamento de dimensionamento automático. No XAML, defines o valor para a string "Auto" (indistinto a maiúsculas minúsculas) para ativar o comportamento de autodimensionamento. O comportamento de autodimensionamento implica que o elemento irá preencher a largura disponível. Note-se, no entanto, que controlos específicos frequentemente fornecem valores por defeito nos seus estilos predefinidos, o que desativa o comportamento de autodimensionamento, a menos que seja especificamente reativado.

Além da verificação de validação, existe um limite superior de valor não determinístico para Width que é imposto pelo sistema de layout (este é um número muito grande, maior que Single.MaxValue mas menor que Double.MaxValue). Se ultrapassar este limite, o elemento não será renderizado, e não é feita nenhuma exceção. Não defina Width um valor significativamente maior do que o tamanho máximo de qualquer possível exibição visual, ou poderá exceder este limite superior não determinístico.

Uso de atributos XAML

<object Width="double"/>

-ou-

<object Width ="qualifiedDouble"/>

-ou-

<object Width ="Auto"/>

Valores XAML

DuploDouble

Representação de cadeias de valor Double igual ou superior a 0,0. Consulte Observações para informações sobre o limite superior. Este valor é interpretado como uma medição unitária independente do dispositivo (1/96 de polegada). As cadeias não precisam de incluir explicitamente pontos decimais. Por exemplo, um valor de 1 é aceitável.

Duplo qualificado Um valor duplo como descrito acima, seguido de uma das seguintes cadeias de declaração unitária: px, in, cm, pt.

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

in é de polegadas; 1in==96px

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

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

Auto Permite o comportamento de autodimensionamento. Ver Observações.

Informação de Propriedade de Dependência