ListBox.ColumnWidth プロパティ

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

ListBox.ColumnWidth プロパティ

複数列の ListBox の列幅を取得または設定します。

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As ListBox
Dim value As Integer

value = instance.ColumnWidth

instance.ColumnWidth = value

C#

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

C++

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

J#

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

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

JScript

public function get ColumnWidth
 () : int

public function set ColumnWidth
 (value : int)

プロパティ値
コントロール内の各列の幅 (ピクセル単位)。既定値は 0 です。

例外

例外の種類	条件
ArgumentException	0 未満の値がプロパティに代入されています。

解説

値として 0 を設定すると、各列には既定の幅が割り当てられます。ListBox が複数列の ListBox である場合、このプロパティはリスト内の各列の現在の幅を返します。このプロパティを使用すると、複数列の ListBox 内の各列に項目を適切に表示できます。

使用例

ColumnWidth プロパティと MultiColumn プロパティを使用して、複数の列に項目を表示する ListBox コントロールを作成する方法を次のコード例に示します。この例では、listBox1 という名前の ListBox コントロールがフォームに追加されている必要があります。

Visual Basic

Private Sub SetupMyMultiColumn()
   Dim x As Integer
   ' Add items to the ListBox.
   For x = 0 To 50
      ListBox1.Items.Add("Items " + x.ToString())
   Next x
   ' Display items in columns.
   ListBox1.MultiColumn = True
   ' Determine the width of the items in the list to get the best column
 width setting.
   Dim width As Integer
 = CInt(ListBox1.CreateGraphics().MeasureString(ListBox1.Items(ListBox1.Items.Count
 - 1).ToString(), _
      ListBox1.Font).Width)
   ' Set the column width based on the width of each item in the list.
   ListBox1.ColumnWidth = width
End Sub

C#

private void SetupMyMultiColumn()
{
   // Add items to the ListBox.
   for (int x = 0; x < 50; x++)
   {
      listBox1.Items.Add("Items " + x.ToString());
   }
   // Display items in columns.
   listBox1.MultiColumn = true;
   // Determine the width of the items in the list to get the best column
 width setting.
   int width = (int) listBox1.CreateGraphics().MeasureString(listBox1.Items[listBox1.Items.Count
 -1].ToString(),
      listBox1.Font).Width;
   // Set the column width based on the width of each item in the list.
   listBox1.ColumnWidth = width;
}

C++

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

      }
      listBox1->MultiColumn = true;

      // Determine the width of the items in the list to get the best column
 width setting.
      int width = (int)listBox1->CreateGraphics()->MeasureString(
 listBox1->Items[ listBox1->Items->Count - 1 ]->ToString(), listBox1->Font
 ).Width;

      // Set the column width based on the width of each item in the
 list.
      listBox1->ColumnWidth = width;
   }

J#

private void SetupMyMultiColumn()
{
    // Add items to the ListBox.
    for (int x = 0; x < 50; x++) {
        listBox1.get_Items().Add("Items " + System.Convert.ToString(x));
    }

    // Display items in columns.
    listBox1.set_MultiColumn(true);

    // Determine the width of the items in the list to get the best
 column
    // width setting.
    int width = (int)(listBox1.CreateGraphics().MeasureString(listBox1.
        get_Items().get_Item((listBox1.get_Items().get_Count() - 1)).
        ToString(), listBox1.get_Font()).get_Width());

    // Set the column width based on the width of each item in the list.
    listBox1.set_ColumnWidth(width);
} //SetupMyMultiColumn

プラットフォーム

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 名前空間