ListBox.HorizontalExtent Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

ListBox.cs

Získá nebo nastaví šířku, o kterou se vodorovný posuvník ListBox může posunout.

public:
 property int HorizontalExtent { int get(); void set(int value); };

public int HorizontalExtent { get; set; }

member this.HorizontalExtent : int with get, set

Public Property HorizontalExtent As Integer

Hodnota vlastnosti

Int32

Šířka v pixelech, kterou může vodorovný posuvník posunout. Výchozí hodnota je nula.

Příklady

Následující příklad kódu ukazuje použití HorizontalScrollbar a HorizontalExtent vlastnosti k zobrazení vodorovného posuvníku, který zobrazuje veškerý text položky v ovládacím ListBox prvku. Příklad také používá IntegralHeight vlastnost k zajištění, že položky nejsou částečně zobrazeny kvůli velikosti ListBox ovládacího prvku. Tento příklad vyžaduje přidání ListBox ovládacího prvku s názvem listBox1do formuláře.

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

Poznámky

Tato vlastnost hlásí pouze užitečnou hodnotu, pokud je vlastnost nastavena HorizontalScrollbar na true. Pokud je šířka ListBox této vlastnosti menší než hodnota této vlastnosti, vodorovný posuvník vodorovně posouvá položky v objektu ListBox. Pokud je šířka ListBox rovna nebo větší než tato hodnota, vodorovný posuvník je skrytý. Hodnota této vlastnosti není dynamicky aktualizována ListBox. Tato vlastnost je užitečná, když jsou položky ListBox vykreslíny vlastníkem. Pokud by například vlastník nakreslil položky ListBox o šířce 200 pixelů, ale ListBox má šířku 60 pixelů, HorizontalExtent musí být vlastnost nastavena na 200, aby bylo možné posunout pravý okraj položek do viditelné oblasti ovládacího prvku.

Viz také

• HorizontalScrollbar