ListBox.PreferredHeight Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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

Int32

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

Atributos

BrowsableAttribute

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.

Confira também

• Height