ListBox.HorizontalExtent Właściwość

Definicja

Pobiera lub ustawia szerokość, za pomocą której można przewijać poziomy pasek przewijania ListBox .

public int HorizontalExtent { get; set; }

Wartość właściwości

Szerokość, w pikselach, którą poziomy pasek przewijania może przewijać kontrolkę. Wartością domyślną jest zero.

Przykłady

Poniższy przykład kodu pokazuje, jak używać HorizontalScrollbar właściwości i HorizontalExtent do wyświetlania poziomego paska przewijania, który pokazuje cały tekst elementu w kontrolce ListBox . W przykładzie IntegralHeight użyto również właściwości , aby upewnić się, że elementy nie są częściowo wyświetlane z powodu rozmiaru kontrolki ListBox . Ten przykład wymaga dodania ListBox kontrolki o nazwie listBox1, do formularza.

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;
}

Uwagi

Ta właściwość zgłasza tylko przydatną wartość, jeśli właściwość jest ustawiona HorizontalScrollbar na true. Jeśli szerokość ListBox właściwości jest mniejsza niż wartość tej właściwości, poziomy pasek przewijania w poziomie przewija elementy w obiekcie ListBox. Jeśli szerokość elementu ListBox jest równa lub większa niż ta wartość, poziomy pasek przewijania jest ukryty. Wartość tej właściwości nie jest dynamicznie aktualizowana przez ListBoxobiekt . Ta właściwość jest przydatna, gdy elementy ListBox elementu są rysowane przez właściciela. Jeśli na przykład właściciel rysuje elementy ListBox o szerokości 200 pikseli, ale ListBox ma szerokość 60 pikseli, właściwość musi być ustawiona na 200, HorizontalExtent aby przewinąć prawą krawędź elementów do widocznego regionu kontrolki.

Dotyczy

Produkt Wersje
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Zobacz też