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. 既定値は 0 です。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 、がHorizontalExtent 60 ピクセル幅の場合、項目の右端をコントロールの表示領域にスクロールするために、プロパティを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.

適用対象

こちらもご覧ください