ListBox.DrawMode プロパティ

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

ListBox.DrawMode プロパティ

コントロールの描画モードを取得または設定します。

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

Visual Basic (宣言)

Public Overridable Property
 DrawMode As DrawMode

Visual Basic (使用法)

Dim instance As ListBox
Dim value As DrawMode

value = instance.DrawMode

instance.DrawMode = value

C#

public virtual DrawMode DrawMode { get; set;
 }

C++

public:
virtual property DrawMode DrawMode {
    DrawMode get ();
    void set (DrawMode value);
}

J#

/** @property */
public DrawMode get_DrawMode ()

/** @property */
public void set_DrawMode (DrawMode value)

JScript

public function get DrawMode
 () : DrawMode

public function set DrawMode
 (value : DrawMode)

プロパティ値
コントロールの項目を描画するときのモードを表す DrawMode 値の 1 つ。既定値は DrawMode.Normal です。

例外

例外の種類	条件
InvalidEnumArgumentException	プロパティに代入された値が DrawMode 列挙体のメンバではありません。
ArgumentException	複数列の ListBox の高さは可変にできません。

使用例

オーナー描画の ListBox 項目を作成する方法を次のコード例に示します。このコードでは、DrawMode プロパティを使用して、描画する項目が固定サイズであることを示し、DrawItem イベントを使用して、ListBox への各項目の描画を実行しています。この例のコードでは、イベント ハンドラへのパラメータとして渡された DrawItemEventArgs クラスのプロパティとメソッドを使用して項目を描画しています。この例では、listBox1 という名前の ListBox コントロールがフォームに追加されており、DrawItem イベントがこの例のコードに定義されているイベント ハンドラで処理される必要があります。またこの例では、"Apple"、"Orange"、および "Plum" という 3 つのテキストを持つ項目が、この順序で ListBox に追加されている必要もあります。

Visual Basic

Private Sub listBox1_DrawItem(ByVal
 sender As System.Object, ByVal e As
 System.Windows.Forms.DrawItemEventArgs) Handles ListBox1.DrawItem
   ' Set the DrawMode property to draw fixed sized items.
   ListBox1.DrawMode = DrawMode.OwnerDrawFixed
   ' Draw the background of the ListBox control for each item.
   e.DrawBackground()
   ' Define the default color of the brush as black.
   Dim myBrush As Brush

   ' Determine the color of the brush to draw each item based on the
 index of the item to draw.
   Select Case (e.Index)
      Case 0
         myBrush = Brushes.Red
      Case 1
         myBrush = Brushes.Orange
      Case 2
         myBrush = Brushes.Purple
   End Select

   ' Draw the current item text based on the current Font and the custom
 brush settings.
   e.Graphics.DrawString(ListBox1.Items(e.Index), e.Font, myBrush, New
 RectangleF(e.Bounds.X, e.Bounds.Y, e.Bounds.Width, e.Bounds.Height))
   ' If the ListBox has focus, draw a focus rectangle around the selected
 item.
   e.DrawFocusRectangle()
End Sub

C#

private void listBox1_DrawItem(object sender,
 System.Windows.Forms.DrawItemEventArgs e)
{
   // Set the DrawMode property to draw fixed sized items.
   listBox1.DrawMode = DrawMode.OwnerDrawFixed;
   // Draw the background of the ListBox control for each item.
   e.DrawBackground();
   // Define the default color of the brush as black.
   Brush myBrush = Brushes.Black;

   // Determine the color of the brush to draw each item based on the
 index of the item to draw.
   switch (e.Index)
   {
      case 0:
         myBrush = Brushes.Red;
         break;
      case 1:
         myBrush = Brushes.Orange;
         break;
      case 2:
         myBrush = Brushes.Purple;
         break;
   }

   // Draw the current item text based on the current Font and the custom
 brush settings.
   e.Graphics.DrawString(listBox1.Items[e.Index].ToString(), e.Font, myBrush,e.Bounds
,StringFormat.GenericDefault);
   // If the ListBox has focus, draw a focus rectangle around the selected
 item.
   e.DrawFocusRectangle();
}

C++

private:
   void listBox1_DrawItem( Object^ /*sender*/, System::Windows::Forms::DrawItemEventArgs^
 e )
   {
      // Set the DrawMode property to draw fixed sized items.
      listBox1->DrawMode = DrawMode::OwnerDrawFixed;

      // Draw the background of the ListBox control for each item.
      e->DrawBackground();

      // Define the default color of the brush as black.
      Brush^ myBrush = Brushes::Black;

      // Determine the color of the brush to draw each item based on the
 index of the item to draw.
      switch ( e->Index )
      {
         case 0:
            myBrush = Brushes::Red;
            break;

         case 1:
            myBrush = Brushes::Orange;
            break;

         case 2:
            myBrush = Brushes::Purple;
            break;
      }

      // Draw the current item text based on the current Font and the custom
 brush settings.
      e->Graphics->DrawString( listBox1->Items[ e->Index ]->ToString(),
 e->Font, myBrush, e->Bounds, StringFormat::GenericDefault );

      // If the ListBox has focus, draw a focus rectangle around the selected
 item.
      e->DrawFocusRectangle();
   }

J#

private void listBox1_DrawItem(Object sender
,
    System.Windows.Forms.DrawItemEventArgs e)
{
    // Set the DrawMode property to draw fixed sized items.
    listBox1.set_DrawMode(DrawMode.OwnerDrawFixed);
    // Draw the background of the ListBox control for each item.
    e.DrawBackground();
    // Create a new Brush and initialize to a Black colored brush
    // by default.
    Brush myBrush = Brushes.get_Black();
    // Determine the color of the brush to draw each item based on the
    // index of the item to draw.
    switch (e.get_Index()) {
        case 0 :
            myBrush = Brushes.get_Red();
            break;
        case 1 :
            myBrush = Brushes.get_Orange();
            break;
        case 2 :
            myBrush = Brushes.get_Purple();
            break;
    }

    // Draw the current item text based on the current Font and the
 custom
    // brush settings.
    e.get_Graphics().DrawString(System.Convert.ToString(listBox1.
        get_Items().get_Item(e.get_Index())), e.get_Font(), myBrush,
        RectangleF.op_Implicit(e.get_Bounds()), StringFormat.
        get_GenericDefault());
    // If the ListBox has focus, draw a focus rectangle around the selected
    // item.
    e.DrawFocusRectangle();
} //listBox1_DrawItem

プラットフォーム

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 名前空間
DrawMode 列挙体
DrawItem