Proprietà ListBox.HorizontalExtent

Questa proprietà riporta un valore utile solo se la proprietà HorizontalScrollbar è impostata su true. Se la larghezza del controllo ListBox è minore del valore di questa proprietà, lo scorrimento degli elementi all'interno del controllo ListBox sarà lungo la barra orizzontale. Se la larghezza del controllo ListBox è uguale o maggiore di questo valore, la barra di scorrimento orizzontale è nascosta. Il valore di questa proprietà non viene dinamicamente aggiornato da ListBox. Questa proprietà è utile quando gli elementi del controllo ListBox sono creati dal proprietario. Se, ad esempio, la larghezza degli elementi del controllo ListBox con disegno personalizzato è 200 pixel, mentre la larghezza del controllo ListBox è 60 pixel, la proprietà HorizontalExtent deve essere impostata su 200 per poter scorrere il bordo destro degli elementi nell'area visibile del controllo.

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare le proprietà HorizontalScrollbar e HorizontalExtent per visualizzare una barra di scorrimento orizzontale che mostri il testo di tutti gli elementi del controllo ListBox. Viene inoltre utilizzata la proprietà IntegralHeight per evitare che gli elementi siano visualizzati solo parzialmente a causa delle dimensioni del controllo ListBox. In questo esempio si presuppone di aver aggiunto a un form un controllo ListBox denominato listBox1.

private void DisplayHScroll()
{
   // Make no partial items are displayed vertically.
   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;
}

.NET Framework

.NET Framework Client Profile

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

Riferimenti