StatusBar.DrawItem 事件

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

發生於主控描繪狀態列控制項的視覺外觀變更時。

public:
 event System::Windows::Forms::StatusBarDrawItemEventHandler ^ DrawItem;

public event System.Windows.Forms.StatusBarDrawItemEventHandler DrawItem;

member this.DrawItem : System.Windows.Forms.StatusBarDrawItemEventHandler 

Public Custom Event DrawItem As StatusBarDrawItemEventHandler 

事件類型

StatusBarDrawItemEventHandler

範例

下列程式碼範例示範如何建立擁有者繪製 StatusBarPanel ，以顯示自訂背景和目前日期。 此範例會要求您已將 DrawItem 控制項的 StatusBar 事件連接到範例中所定義的事件處理常式。

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.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);
}

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

備註

您可以使用這個事件，在擁有者繪製 StatusBar 控制項中執行繪圖作業。 例如，如果您顯示顯示進度列的擁有者繪製 StatusBarPanel ，您可以使用此事件在面板上執行進度列的繪圖。 透過 StatusBarDrawItemEventArgs 傳遞做為事件處理常式參數的物件提供給事件的資料可讓您判斷需要繪製的面板，以及 Graphics 用來繪製面板的 。 只有在 控制項中的 StatusBar 屬性 StatusBarPanel 設定為 OwnerDraw 時 StatusBarPanel.Style ，才會引發這個事件。

如需處理事件的詳細資訊，請參閱 處理和引發事件。

另請參閱

• OnDrawItem(StatusBarDrawItemEventArgs)
• StatusBarDrawItemEventArgs
• StatusBarDrawItemEventHandler