ListBox.HorizontalExtent Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Získá nebo nastaví šířku, o kterou lze vodorovný ListBox posuvník posouvání.

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 posouvat. Výchozí hodnota je nula.

Příklady

Následující příklad kódu ukazuje, jak použít HorizontalScrollbar vlastnosti a HorizontalExtent k zobrazení vodorovného posuvníku, který zobrazuje veškerý text položky v ovládacím ListBox prvku. V příkladu IntegralHeight se také používá vlastnost k zajištění toho, aby se položky kvůli velikosti ListBox ovládacího prvku nezobrazovat částečně. Tento příklad vyžaduje, aby ListBox byl do formuláře přidán ovládací prvek s názvem listBox1.

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í užitečnou hodnotu pouze v HorizontalScrollbar případě, že je vlastnost nastavená na truehodnotu . Pokud je šířka objektu ListBox menší než hodnota této vlastnosti, vodorovný posuvník vodorovně posunuje položky v objektu ListBox. Pokud je šířka prvku ListBox stejná nebo větší než tato hodnota, je vodorovný posuvník skrytý. Hodnota této vlastnosti není dynamicky aktualizována objektem ListBox. Tato vlastnost je užitečná, když jsou položky objektu ListBox vylosovány vlastníkem. Pokud například vlastník nakreslel položky objektu ListBox 200 pixelů na šířku, ale ListBox má šířku 60 pixelů, HorizontalExtent bude nutné nastavit vlastnost na hodnotu 200, aby bylo možné posunout pravý okraj položek do viditelné oblasti ovládacího prvku.

Viz také

• HorizontalScrollbar