FrameworkElement.Height Propriedade

public:
 property double Height { double get(); void set(double value); };

double Height();

void Height(double value);

public double Height { get; set; }

var double = frameworkElement.height;
frameworkElement.height = double;

Public Property Height As Double

<frameworkElement Height="double"/>
-or-
<frameworkElement Height="Auto"/>
 

Valor da propriedade

A altura, em pixels, do objeto. O padrão é NaN. Com exceção do valor naN especial, esse valor deve ser igual ou maior que 0.

Exemplos

Este exemplo mostra um conjunto de propriedades simples de um elemento de interface do usuário que é criado em tempo de execução e precisa de inicialização de seu conteúdo e propriedades básicas de exibição, como Heightlargura e plano de fundo. (Background é, na verdade, uma propriedade Control , não definida por FrameworkElement.)

Button button2 = new Button();
button2.Height = 50;
button2.Width = 100;
button2.Background = new SolidColorBrush(Colors.Blue);
button2.Content = "Click Me";

Comentários

Height é uma das três propriedades graváveis no FrameworkElement que especificam informações de altura. Os outros dois são MinHeight e MaxHeight. Se houver um conflito entre esses valores, a ordem de aplicação para determinação de altura real é que primeiro MinHeight deve ser respeitada e, MaxHeightpor fim, se estiver dentro dos limites. Height

Vários dos tipos derivados de FrameworkElement também são derivados de Shape. Nem todas as Shape classes usam Height ou Largura para especificar sua aparência e, em vez disso, usam propriedades específicas que podem definir um conjunto de pontos. Nesse caso, um Height ou Width é calculado, mas normalmente não é definido diretamente.

Classes personalizadas podem ter considerações semelhantes em que a classe pode ter propriedades mais significativas para especificar dimensões que são Height ou Largura. Height ou Width ambos ainda estão disponíveis como membros e são configuráveis.

O objeto em que as Height propriedades ou Largura são definidas é quase sempre um objeto filho na coleção filho de outro pai, e definir Height ou Width para um valor é apenas um valor sugerido para o processo de layout. O sistema de layout, bem como a lógica de layout específica da classe pai, usarão o valor como uma entrada não vinculante durante o processo de layout e talvez precisem recortar, redimensionar o objeto, redimensionar o contêiner ou alguma combinação desses comportamentos que abrange vários objetos participantes no layout. A margem e o preenchimento também influenciam o tamanho disponível. Para obter mais informações, consulte Alinhamento, margem e preenchimento.

O valor retornado dessa propriedade é sempre o mesmo que qualquer valor que foi definido para ela. Por outro lado, o valor da propriedade ActualHeight pode variar. A variação pode ocorrer estaticamente, porque o layout rejeitou o tamanho sugerido ou momentaneamente. O sistema de layout em si funciona de forma assíncrona em relação ao conjunto de Altura do sistema de propriedades, e o sistema de layout pode ainda não ter processado essa alteração de propriedade de dimensionamento.

Valores negativos para Height os quais não são permitidos.

Além disso, não defina Height como um valor significativamente maior que o tamanho máximo de qualquer exibição visual possível.

"Auto" e NaN

O valor padrão de Height e Width é "Auto", representado por NaN. Na marcação XAML, você pode usar a cadeia de caracteres "Auto" para definir o valor como NaN.

Confira também

• Width
• ActualHeight
• MinHeight
• MaxHeight
• Definir layouts com XAML
• Alinhamento, margem e preenchimento