Partilhar via


ColumnDefinition.Width Propriedade

Definição

Obtém a largura calculada de um elemento ColumnDefinition ou define o valor GridLength de uma coluna definida pela ColumnDefinition. Essa é a propriedade de conteúdo de ColumnDefinition.

public:
 property GridLength Width { GridLength get(); void set(GridLength value); };
GridLength Width();

void Width(GridLength value);
public GridLength Width { get; set; }
var gridLength = columnDefinition.width;
columnDefinition.width = gridLength;
Public Property Width As GridLength
<ColumnDefinition Width="doubleValue"/>
- or -
<ColumnDefinition Width="starSizing"/>
-or-
<ColumnDefinition Width="Auto"/>

Valor da propriedade

O GridLength que representa a largura da coluna. O valor padrão é um GridLength que representa um dimensionamento "1*".

Comentários

O valor padrão de Width é um GridLength que representa um dimensionamento "1*". Esse valor de estrutura tem um valor de dados Value de 1,0 e um valor de dados GridUnitType de Star. Com esse padrão, cada nova ColumnDefinition que você definir para uma Grade terá o dimensionamento "1*" e cada uma será alocada em um número igual de pixels para largura de seu conteúdo no tratamento de layout. Não é incomum definir ColumnDefinition como um elemento de objeto em XAML sem nenhum atributo definido e apenas usar esse comportamento padrão. O mesmo vale para RowDefinition.

O valor definido para Width poderá ser restrito se você também definir um valor para MinWidth ou MaxWidth. Cada uma dessas propriedades pode usar apenas medidas de pixel , não dimensionamento de estrela. Se uma ColumnDefinition usa o dimensionamento Star ou Auto , mas também tem restrições MinWidth ou MaxWidth , o MinWidth ou MaxWidth deve ser respeitado pelo comportamento de layout de grade, mesmo que isso signifique dar ou tirar espaço de layout de outras colunas de dimensionamento star definidas na Grade que não têm restrições.

É mais comum usar o dimensionamento star do que valores de pixel absolutos para uma definição de Grade em um aplicativo UWP usando C++, C#ou Visual Basic. O dimensionamento de estrelas dá suporte ao conceito de layout dinâmico, que ajuda seu aplicativo a ficar ótimo em telas com diferentes tamanhos, densidades de pixel e orientações. Para obter mais informações, consulte Definir layouts com XAML.

Aplica-se a

Confira também