ListBox.HorizontalScrollbar プロパティとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

ListBox.HorizontalScrollbar プロパティ

水平スクロールバーをコントロールに表示するかどうかを示す値を取得または設定します。

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

Visual Basic (宣言)

<LocalizableAttribute(True)> _
Public Property HorizontalScrollbar As
 Boolean

Visual Basic (使用法)

Dim instance As ListBox
Dim value As Boolean

value = instance.HorizontalScrollbar

instance.HorizontalScrollbar = value

[LocalizableAttribute(true)] 
public bool HorizontalScrollbar { get;
 set; }

C++

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

/** @property */
public boolean get_HorizontalScrollbar ()

/** @property */
public void set_HorizontalScrollbar (boolean
 value)

JScript

public function get HorizontalScrollbar
 () : boolean

public function set HorizontalScrollbar
 (value : boolean)

プロパティ値
水平スクロールバーをコントロールに表示する場合は true。それ以外の場合は false。既定値は false です。

解説

HorizontalScrollbar プロパティは、ListBox 内の項目の幅がコントロールの右端を超える場合に、水平スクロールバーを ListBox に表示するかどうかを決定します。このプロパティが true に設定されると、スクロールバーは ListBox 内の項目の幅に基づいて自動的に表示されます。ListBox がオーナー描画 ListBox である場合、水平スクロールバーを適切に表示するためには、HorizontalExtent プロパティを設定する必要があります。

使用例

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

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;
   }

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