ListBox.HorizontalExtent プロパティ

.NET Framework クラス ライブラリ リファレンス

ListBox.HorizontalExtent プロパティ

ListBox の水平スクロール バーでスクロールできる幅を取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

<LocalizableAttribute(True)> _
Public Property HorizontalExtent As
 Integer

Visual Basic (使用法)

Dim instance As ListBox
Dim value As Integer

value = instance.HorizontalExtent

instance.HorizontalExtent = value

C#

[LocalizableAttribute(true)] 
public int HorizontalExtent { get;
 set; }

C++

[LocalizableAttribute(true)] 
public:
property int HorizontalExtent {
    int get ();
    void set (int value);
}

J#

/** @property */
public int get_HorizontalExtent ()

/** @property */
public void set_HorizontalExtent (int
 value)

JScript

public function get HorizontalExtent
 () : int

public function set HorizontalExtent
 (value : int)

プロパティ値
水平スクロール バーでコントロールをスクロールできる幅 (ピクセル単位)。既定値は 0 です。

解説

このプロパティは、HorizontalScrollbar プロパティが true に設定されている場合にだけ有効な値を報告します。ListBox の幅がこのプロパティの値よりも小さい場合は、水平スクロール バーを使用して ListBox 内の項目を水平方向にスクロールできます。ListBox の幅がこの値以上の場合は、水平スクロール バーは表示されません。このプロパティの値は、ListBox によって動的には更新されません。このプロパティは、ListBox の項目がオーナー描画である場合に役立ちます。たとえば、ListBox のオーナー描画項目の幅が 200 ピクセルで、ListBox の幅が 60 ピクセルの場合は、コントロールをスクロールして項目の右端を表示できるようにするためには、HorizontalExtent プロパティを 200 に設定する必要があります。

使用例

HorizontalScrollbar プロパティと HorizontalExtent プロパティを使用して、ListBox コントロールのすべての項目のテキストを表示するための水平スクロール バーを表示する方法を次のコード例に示します。また、この例では、IntegralHeight プロパティを使用して、ListBox コントロールのサイズにかかわらず、項目の全部が表示されることを保証します。この例では、listBox1 という名前の ListBox コントロールがフォームに追加されている必要があります。

Visual Basic

Private Sub DisplayHScroll()
   ' Make no partial items are displayed vertically.
   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

C#

private void DisplayHScroll()
{
   // Make no partial items are displayed vertically.
   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;
}

C++

private:
   void DisplayHScroll()
   {
      // Make no partial items are displayed vertically.
      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;
   }

J#

private void DisplayHScroll()
{
    // Make no partial items are displayed vertically.
    listBox1.set_IntegralHeight(true);

    // Add items that are wide to the ListBox.
    for (int x = 0; x < 10; x++) {
        listBox1.get_Items().Add("Item  " + Convert.ToString(x) 
            + " is a very large value that requires scroll bars");
    }

    // Display a horizontal scroll bar.
    listBox1.set_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.get_Items().
        get_Item(listBox1.get_Items().get_Count() - 1).ToString(), 
        listBox1.get_Font()).get_Width());

    // Set the HorizontalExtent property.
    listBox1.set_HorizontalExtent(hzSize);
} //DisplayHScroll

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ListBox クラス
ListBox メンバ
System.Windows.Forms 名前空間
HorizontalScrollbar