ListBox.PreferredHeight プロパティ

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

ListBox.PreferredHeight プロパティ

ListBox 内のすべての項目を組み合わせた高さを取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 PreferredHeight As Integer

Visual Basic (使用法)

Dim instance As ListBox
Dim value As Integer

value = instance.PreferredHeight

C#

public int PreferredHeight { get;
 }

C++

public:
property int PreferredHeight {
    int get ();
}

J#

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

JScript

public function get PreferredHeight
 () : int

プロパティ値
コントロール内のすべての項目を組み合わせた高さ (ピクセル単位)。

解説

このプロパティを使用すると、利用できるすべての項目をリストに表示し、垂直スクロール バーを表示しないようにするために、ListBox に必要とされる高さを確認できます。ListBox 内の項目数が多い場合に、PreferredHeight プロパティの値を使用してコントロールのサイズを設定すると、ListBox が、フォームや ListBox のコンテナのクライアント領域の外にはみ出すサイズになる可能性があります。

使用例

ListBox のすべての項目をスクロール バーを使用せずに表示する目的で、PreferredHeight プロパティの値に基づいて ListBox の Size プロパティを設定する方法を次のコード例に示します。この例では、listBox1 という名前の ListBox コントロールがフォームに追加されている必要があります。

Visual Basic

Private Sub SizeMyListBox()
   ' Add items to the ListBox.
   Dim x As Integer
   For x = 0 To 19
      listBox1.Items.Add(("Item " + x.ToString()))
   Next x
   ' Set the height of the ListBox to the preferred height to display
 all items.
   listBox1.Height = listBox1.PreferredHeight
End Sub 'SizeMyListBox

C#

private void SizeMyListBox()
{
   // Add items to the ListBox.
   for(int x = 0; x < 20; x++)
   {
      listBox1.Items.Add("Item " + x.ToString());
   }
   // Set the height of the ListBox to the preferred height to display
 all items.
   listBox1.Height = listBox1.PreferredHeight;
}

C++

private:
   void SizeMyListBox()
   {
      // Add items to the ListBox.
      for ( int x = 0; x < 20; x++ )
      {
         listBox1->Items->Add( String::Format( "Item {0}", x ) );
      }
      listBox1->Height = listBox1->PreferredHeight;
   }

J#

private void SizeMyListBox()
{
    // Add items to the ListBox.
    for (int x = 0; x < 20; x++) {
        listBox1.get_Items().Add("Item " + Convert.ToString(x));
    }
    // Set the height of the ListBox to the preferred height 
    // to display all items.
    listBox1.set_Height(listBox1.get_PreferredHeight());
} //SizeMyListBox

プラットフォーム

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 名前空間
Control.Height プロパティ