StatusBar.OnDrawItem メソッドとは何？わかりやすく解説 Weblio辞書

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

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

StatusBar.OnDrawItem メソッド

OnDrawItem イベントを発生させます。

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

Visual Basic (宣言)

Protected Overridable Sub
 OnDrawItem ( _
    sbdievent As StatusBarDrawItemEventArgs _
)

Visual Basic (使用法)

Dim sbdievent As StatusBarDrawItemEventArgs

Me.OnDrawItem(sbdievent)

protected virtual void OnDrawItem (
    StatusBarDrawItemEventArgs sbdievent
)

C++

protected:
virtual void OnDrawItem (
    StatusBarDrawItemEventArgs^ sbdievent
)

protected void OnDrawItem (
    StatusBarDrawItemEventArgs sbdievent
)

JScript

protected function OnDrawItem (
    sbdievent : StatusBarDrawItemEventArgs
)

パラメータ

sbdievent: イベントデータを格納している StatusBarDrawItemEventArgs。

解説

イベントが発生すると、デリゲートを使用してイベントハンドラが呼び出されます。詳細については、「イベントの発生」を参照してください。

OnDrawItem メソッドを使用すると、デリゲートを結び付けずに、派生クラスでイベントを処理することもできます。派生クラスでイベントを処理する場合は、この手法をお勧めします。

継承時の注意 派生クラスで OnDrawItem をオーバーライドする場合は、登録されているデリゲートがイベントを受け取ることができるように、基本クラスの OnDrawItem メソッドを呼び出してください。

使用例

カスタム背景と現在の日付を表示するオーナー描画 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