ListBox.ColumnWidth プロパティ

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

Public Property ColumnWidth As Integer
[C#]
public int ColumnWidth {get; set;}
[C++]
public: __property int get_ColumnWidth();public: __property void set_ColumnWidth(int);
[JScript]
public function get ColumnWidth() : int;public function set ColumnWidth(int);

プロパティ値

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

例外

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

解説

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

使用例

[Visual Basic, C#, C++] ColumnWidth プロパティと MultiColumn プロパティを使用して、複数の列に項目を表示する ListBox コントロールを作成する方法を次の例に示します。この例は、listBox1 という名前の ListBox コントロールがフォームに追加されていることを前提にしています。

 
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( S"Items {0}", __box(x)));
      }
      // 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->Item[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;
   }

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

ListBox クラス | ListBox メンバ | System.Windows.Forms 名前空間