ListBox.HorizontalExtent ListBox.HorizontalExtent ListBox.HorizontalExtent ListBox.HorizontalExtent Property

Определение

Получает или задает ширину прокрутки для горизонтальной полосы прокрутки в составе ListBox.Gets or sets the width by which the horizontal scroll bar of a ListBox can scroll.

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

Значение свойства

Ширина прокрутки для горизонтальной полосы прокрутки в составе элемента управления (в пикселях).The width, in pixels, that the horizontal scroll bar can scroll the control. По умолчанию используется значение ноль.The default is zero.

Примеры

В следующем примере кода демонстрируется использование HorizontalScrollbar и HorizontalExtent свойства для отображения горизонтальной полосы прокрутки, показывающий весь текст элемента в ListBox элемента управления.The following code example demonstrates how to use the HorizontalScrollbar and HorizontalExtent properties to display a horizontal scroll bar that shows all item text in the ListBox control. В примере также используется IntegralHeight свойство, чтобы убедиться, что элементы не отображаются частично из-за размера ListBox элемента управления.The example also uses the IntegralHeight property to ensure that items are not partially displayed due to the size of the ListBox control. В этом примере требуется, ListBox управления с именем listBox1, был добавлен в форму.This example requires that a ListBox control, named listBox1, has been added to a form.

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

Комментарии

Это свойство сообщает полезное значение, только если HorizontalScrollbar свойству true.This property only reports a useful value if the HorizontalScrollbar property is set to true. Если ширина ListBox меньше, чем значение этого свойства горизонтальную полосу прокрутки, горизонтально прокручивает позиции ListBox.If the width of the ListBox is smaller than the value of this property, the horizontal scroll bar horizontally scrolls items in the ListBox. Если ширина ListBox становится равным или больше, чем это значение является скрытым горизонтальной полосы прокрутки.If the width of the ListBox is equal to or greater than this value, the horizontal scroll bar is hidden. Значение этого свойства не обновляется динамически ListBox.The value of this property is not dynamically updated by the ListBox. Это свойство полезно, когда элементы ListBox : пользователем.This property is useful when the items of the ListBox are owner-drawn. Например если рисование владельцем элементы ListBox 200 пикселов в ширину, но ListBox 60 пикселей, HorizontalExtent свойства необходимо задать до 200, чтобы прокрутить правого края элементы в видимой области элемента управления.For example, if the owner drawn items of the ListBox are 200 pixels wide, but the ListBox is 60 pixels wide, the HorizontalExtent property would need to be set to 200 in order to scroll the right edge of the items into the visible region of the control.

Применяется к

Дополнительно