ListBox.IntegralHeight Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origine:

ListBox.cs

Ottiene o imposta un valore che indica se il controllo deve essere ridimensionato per evitare di visualizzare elementi parziali.

public:
 property bool IntegralHeight { bool get(); void set(bool value); };

public bool IntegralHeight { get; set; }

member this.IntegralHeight : bool with get, set

Public Property IntegralHeight As Boolean

Valore della proprietà

Boolean

true se il controllo viene ridimensionato in modo che non visualizzi elementi parziali; in caso contrario, false. Il valore predefinito è true.

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare le HorizontalScrollbar proprietà e HorizontalExtent per visualizzare una barra di scorrimento orizzontale che mostra tutto il testo dell'elemento nel ListBox controllo . Nell'esempio viene inoltre utilizzata la IntegralHeight proprietà per assicurarsi che gli elementi non vengano visualizzati parzialmente a causa delle dimensioni del ListBox controllo. In questo esempio è necessario che un ListBox controllo denominato listBox1sia stato aggiunto a un modulo.

private:
   void DisplayHScroll()
   {
      // Make sure no items are displayed partially.
      listBox1->IntegralHeight = true;

      // Add items that are wide to the ListBox.
      for ( int x = 0; x < 10; x++ )
      {
         listBox1->Items->Add( String::Format( "Item {0} is a very large value that requires scroll bars", x ) );

      }

      // Display a horizontal scroll bar.
      listBox1->HorizontalScrollbar = true;

      // Create a Graphics object to use when determining the size of the largest item in the ListBox.
      Graphics^ g = listBox1->CreateGraphics();

      // Determine the size for HorizontalExtent using the MeasureString method using the last item in the list.
      int hzSize = (int)g->MeasureString( dynamic_cast<String^>(listBox1->Items[ listBox1->Items->Count - 1 ]), listBox1->Font ).Width;

      // Set the HorizontalExtent property.
      listBox1->HorizontalExtent = hzSize;
   }

private void DisplayHScroll()
{
   // Make sure no items are displayed partially.
   listBox1.IntegralHeight = true;

   // Add items that are wide to the ListBox.
   for (int x = 0; x < 10; x++)
   {
      listBox1.Items.Add("Item  " + x.ToString() + " is a very large value that requires scroll bars");
   }

   // Display a horizontal scroll bar.
   listBox1.HorizontalScrollbar = true;

   // Create a Graphics object to use when determining the size of the largest item in the ListBox.
   Graphics g = listBox1.CreateGraphics();

   // Determine the size for HorizontalExtent using the MeasureString method using the last item in the list.
   int hzSize = (int) g.MeasureString(listBox1.Items[listBox1.Items.Count -1].ToString(),listBox1.Font).Width;
   // Set the HorizontalExtent property.
   listBox1.HorizontalExtent = hzSize;
}

Private Sub DisplayHScroll()
     ' Make sure no items are displayed partially.
   listBox1.IntegralHeight = True
   Dim x As Integer

   ' Add items that are wide to the ListBox.
   For x = 0 To 10
      listBox1.Items.Add("Item  " + x.ToString() + " is a very large value that requires scroll bars")
   Next x

   ' Display a horizontal scroll bar.
   listBox1.HorizontalScrollbar = True

   ' Create a Graphics object to use when determining the size of the largest item in the ListBox.
   Dim g As System.Drawing.Graphics = listBox1.CreateGraphics()


   ' Determine the size for HorizontalExtent using the MeasureString method using the last item in the list.
   Dim hzSize As Integer = g.MeasureString(listBox1.Items(listBox1.Items.Count - 1).ToString(), listBox1.Font).Width
   ' Set the HorizontalExtent property.
   listBox1.HorizontalExtent = hzSize
End Sub

Commenti

Quando questa proprietà è impostata su true, il controllo viene ridimensionato automaticamente per assicurarsi che un elemento non venga visualizzato parzialmente. Se si desidera mantenere le dimensioni originali di in ListBox base ai requisiti di spazio del modulo, impostare questa proprietà su false.

Per impostazione predefinita, e ListBox le CheckedListBox dimensioni sono tali che mostrano solo gli elementi interi. Se si desidera che l'oggetto o riempia completamente un'area ListBox ancorata, impostare su IntegralHeightfalse.CheckedListBox In questo modo il controllo riempie completamente l'area, ma l'ultimo elemento non viene visualizzato completamente.

Se l'oggetto ListBox non contiene elementi, questa proprietà non ha alcun effetto.

Annotazioni

L'altezza integrale si basa sull'altezza di ListBox, anziché sull'altezza dell'area client. Di conseguenza, quando la IntegralHeight proprietà è impostata true, gli elementi possono comunque essere visualizzati parzialmente se vengono visualizzate le barre di scorrimento.

Annotazioni

Se la DrawMode proprietà è impostata su DrawMode.OwnerDrawVariable, questa proprietà non ha alcun effetto.

Vedi anche

• DrawMode