StatusBar.DrawItem イベントとは何？わかりやすく解説 Weblio辞書

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

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

StatusBar.DrawItem イベント

オーナー描画ステータスバーコントロールの視覚的要素が変更された場合に発生します。

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

Visual Basic (宣言)

Public Event DrawItem As
 StatusBarDrawItemEventHandler

Visual Basic (使用法)

Dim instance As StatusBar
Dim handler As StatusBarDrawItemEventHandler

AddHandler instance.DrawItem, handler

public event StatusBarDrawItemEventHandler DrawItem

C++

public:
event StatusBarDrawItemEventHandler^ DrawItem {
    void add (StatusBarDrawItemEventHandler^ value);
    void remove (StatusBarDrawItemEventHandler^ value);
}

/** @event */
public void add_DrawItem (StatusBarDrawItemEventHandler
 value)

/** @event */
public void remove_DrawItem (StatusBarDrawItemEventHandler
 value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

このイベントを使用すると、オーナー描画 StatusBar コントロールで描画操作を実行できます。たとえば、プログレスバーを表示するオーナー描画 StatusBarPanel を表示する場合は、このイベントを使用してパネル上にプログレスバーの描画を実行できます。パラメータとしてイベントハンドラに渡された StatusBarDrawItemEventArgs オブジェクトを通じてイベントに提供されたデータを使用すると、描画する必要があるパネルとパネルを描画するために使用する Graphics を確認できます。このイベントは、StatusBar コントロール内の StatusBarPanel の StatusBarPanel.Style プロパティが OwnerDraw に設定されている場合にだけ発生します。

イベント処理の詳細については、「イベントの利用」を参照してください。

使用例

カスタム背景と現在の日付を表示するオーナー描画 StatusBarPanel を作成する方法を次のコード例に示します。この例は、StatusBar コントロールの DrawItem イベントが、この例で定義されているイベントハンドラに接続されていることを前提にしています。

Visual Basic

Private Sub StatusBar1_DrawItem(ByVal
 sender As Object, ByVal
 sbdevent As System.Windows.Forms.StatusBarDrawItemEventArgs) Handles StatusBar1.DrawItem

   ' Create a StringFormat object to align text in the panel.
   Dim sf As New StringFormat()
   ' Format the String of the StatusBarPanel to be centered.
   sf.Alignment = StringAlignment.Center
   sf.LineAlignment = StringAlignment.Center

   ' Draw a black background in owner-drawn panel.
   sbdevent.Graphics.FillRectangle(Brushes.Black, sbdevent.Bounds)
   ' Draw the current date (short date format) with white text in the
 control's font.
   sbdevent.Graphics.DrawString(DateTime.Today.ToShortDateString(), StatusBar1.Font,
 Brushes.White, _
         New RectangleF(sbdevent.Bounds.X, sbdevent.Bounds.Y,
 _
         sbdevent.Bounds.Width, sbdevent.Bounds.Height), sf)
End Sub

private void DrawMyPanel(object sender, System.Windows.Forms.StatusBarDrawItemEventArgs
 sbdevent)
{
   // Create a StringFormat object to align text in the panel.
   StringFormat sf = new StringFormat();
   // Format the String of the StatusBarPanel to be centered.
   sf.Alignment = StringAlignment.Center;
   sf.LineAlignment = StringAlignment.Center;

   // Draw a black background in owner-drawn panel.
   sbdevent.Graphics.FillRectangle(Brushes.Black, sbdevent.Bounds);
   // Draw the current date (short date format) with white text in the
 control's font.
   sbdevent.Graphics.DrawString(DateTime.Today.ToShortDateString(), 
      statusBar1.Font,Brushes.White,sbdevent.Bounds,sf);
}

C++

private:
   void DrawMyPanel( Object^ /*sender*/, System::Windows::Forms::StatusBarDrawItemEventArgs^
 sbdevent )
   {
      // Create a StringFormat object to align text in the panel.
      StringFormat^ sf = gcnew StringFormat;

      // Format the String of the StatusBarPanel to be centered.
      sf->Alignment = StringAlignment::Center;
      sf->LineAlignment = StringAlignment::Center;

      // Draw a back blackground in owner-drawn panel.
      sbdevent->Graphics->FillRectangle( Brushes::Black, sbdevent->Bounds
 );

      // Draw the current date (short date format) with white text in the
 control's font.
      sbdevent->Graphics->DrawString( DateTime::Today.ToShortDateString(),
 statusBar1->Font, Brushes::White, sbdevent->Bounds, sf );
   }

private void DrawMyPanel(Object sender, 
    System.Windows.Forms.StatusBarDrawItemEventArgs sbdEvent)
{
    // Create a StringFormat object to align text in the panel.
    StringFormat sf = new StringFormat();
    // Format the String of the StatusBarPanel to be centered.
    sf.set_Alignment(StringAlignment.Center);
    sf.set_LineAlignment(StringAlignment.Center);
    // Draw a back blackground in owner-drawn panel.
    sbdEvent.get_Graphics().FillRectangle(Brushes.get_Black(), 
        sbdEvent.get_Bounds());
    // Draw the current date (short date format) with white text 
    // in the control's font.
    sbdEvent.get_Graphics().DrawString(DateTime.get_Today().
        ToShortDateString(), statusBar1.get_Font(), Brushes.get_White(),
        RectangleF.op_Implicit(sbdEvent.get_Bounds()), sf);
} //DrawMyPanel