ListBox.HorizontalExtent Özellik

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Bir öğesinin yatay kaydırma çubuğunun ListBox kaydırabileceği genişliği alır veya ayarlar.

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

Özellik Değeri

Int32

Yatay kaydırma çubuğunun denetimi kaydırabileceği piksel cinsinden genişlik. Varsayılan değer sıfırdır.

Örnekler

Aşağıdaki kod örneği, denetimdeki HorizontalScrollbar tüm öğe metnini ListBox gösteren yatay bir kaydırma çubuğu görüntülemek için ve HorizontalExtent özelliklerinin nasıl kullanılacağını gösterir. Örnek ayrıca denetimin IntegralHeight boyutu ListBox nedeniyle öğelerin kısmen görüntülenmemesini sağlamak için özelliğini kullanır. Bu örnek, adlı listBox1bir ListBox denetimin forma eklenmesini gerektirir.

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

Açıklamalar

Bu özellik yalnızca özelliği olarak ayarlandıysa HorizontalScrollbar trueyararlı bir değer bildirir. öğesinin ListBox genişliği bu özelliğin değerinden küçükse, yatay kaydırma çubuğu içindeki ListBoxöğeleri yatay olarak kaydırıyor. öğesinin ListBox genişliği bu değere eşit veya bundan büyükse, yatay kaydırma çubuğu gizlenir. Bu özelliğin değeri tarafından ListBoxdinamik olarak güncelleştirilmez. Öğeleri sahip tarafından çizildiğinde bu özellik yararlıdır ListBox . Örneğin, öğesinin sahibi tarafından çizilen öğeler ListBox 200 piksel genişliğindeyse ancak ListBox 60 piksel genişliğindeyse, HorizontalExtent öğelerin sağ kenarını denetimin görünür bölgesine kaydırmak için özelliğin 200 olarak ayarlanması gerekir.

Ayrıca bkz.

• HorizontalScrollbar