Compartilhar via


ListBox.PreferredHeight Propriedade

Definição

Obtém a altura combinada de todos os itens no ListBox.

public:
 property int PreferredHeight { int get(); };
[System.ComponentModel.Browsable(false)]
public int PreferredHeight { get; }
[<System.ComponentModel.Browsable(false)>]
member this.PreferredHeight : int
Public ReadOnly Property PreferredHeight As Integer

Valor da propriedade

A altura combinada, em pixels, de todos os itens no controle.

Atributos

Exemplos

O exemplo de código a seguir demonstra como definir a Size propriedade de um ListBox com base no valor da PreferredHeight propriedade para exibir todos os itens no ListBox sem uso de barras de rolagem. Este exemplo exige que um ListBox controle, chamado listBox1, tenha sido adicionado a um formulário.

private:
   void SizeMyListBox()
   {
      // Add items to the ListBox.
      for ( int x = 0; x < 20; x++ )
      {
         listBox1->Items->Add( String::Format( "Item {0}", x ) );
      }
      listBox1->Height = listBox1->PreferredHeight;
   }
private void SizeMyListBox()
{
   // Add items to the ListBox.
   for(int x = 0; x < 20; x++)
   {
      listBox1.Items.Add("Item " + x.ToString());
   }
   // Set the height of the ListBox to the preferred height to display all items.
   listBox1.Height = listBox1.PreferredHeight;
}
Private Sub SizeMyListBox()
   ' Add items to the ListBox.
   Dim x As Integer
   For x = 0 To 19
      listBox1.Items.Add(("Item " + x.ToString()))
   Next x
   ' Set the height of the ListBox to the preferred height to display all items.
   listBox1.Height = listBox1.PreferredHeight
End Sub

Comentários

Essa propriedade permite determinar a altura para a qual o ListBox precisa ser dimensionado para exibir todos os itens disponíveis na lista e evitar a exibição de barras de rolagem verticais. Se a quantidade de itens no ListBox for grande, dimensionar o controle usando o valor da PreferredHeight propriedade poderá fazer com que o ListBox seja dimensionado fora da área do cliente do formulário ou do ListBox contêiner.

Aplica-se a

Confira também