ColumnDefinition.Width Propriedade

Definição

Namespace:
Microsoft.UI.Xaml.Controls
Editar

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

GridLength

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 Largura poderá ser restringido 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 um 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 da 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 XAML. 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