ListBox.HorizontalExtent Properti

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Sumber:

ListBox.cs

Mendapatkan atau mengatur lebar di mana bilah ListBox gulir horizontal dapat menggulir.

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

Nilai Properti

Int32

Lebar, dalam piksel, bahwa bilah gulir horizontal dapat menggulir kontrol. Defaultnya adalah nol.

Contoh

Contoh kode berikut menunjukkan cara menggunakan HorizontalScrollbar properti dan HorizontalExtent untuk menampilkan bilah gulir horizontal yang memperlihatkan semua teks item dalam ListBox kontrol. Contoh ini juga menggunakan IntegralHeight properti untuk memastikan bahwa item tidak ditampilkan sebagian karena ukuran ListBox kontrol. Contoh ini mengharuskan ListBox kontrol, bernama listBox1, telah ditambahkan ke formulir.

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

Keterangan

Properti ini hanya melaporkan nilai yang berguna jika HorizontalScrollbar properti diatur ke true. Jika lebarnya ListBox lebih kecil dari nilai properti ini, bilah gulir horizontal menggulir item secara horizontal di ListBox. Jika lebar ListBox sama dengan atau lebih besar dari nilai ini, bilah gulir horizontal disembunyikan. Nilai properti ini tidak diperbarui secara dinamis oleh ListBox. Properti ini berguna ketika item ListBox digambar pemilik. Misalnya, jika item ListBox yang digambar pemilik memiliki lebar 200 piksel, tetapi ListBox lebarnya 60 piksel, HorizontalExtent properti harus diatur ke 200 untuk menggulir tepi kanan item ke wilayah kontrol yang terlihat.

Lihat juga

• HorizontalScrollbar