StatusBarDrawItemEventArgs Sınıf

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

StatusBarDrawItemEventArgs.cs

Dikkat

StatusBar is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use StatusStrip instead.

DrawItem olayı için veriler sağlar.

public ref class StatusBarDrawItemEventArgs : System::Windows::Forms::DrawItemEventArgs

[System.ComponentModel.Browsable(false)]
[System.Obsolete("`StatusBar` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `StatusStrip` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public class StatusBarDrawItemEventArgs : System.Windows.Forms.DrawItemEventArgs

[<System.ComponentModel.Browsable(false)>]
[<System.Obsolete("`StatusBar` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `StatusStrip` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
type StatusBarDrawItemEventArgs = class
    inherit DrawItemEventArgs

Public Class StatusBarDrawItemEventArgs
Inherits DrawItemEventArgs

Devralma

Object

EventArgs

DrawItemEventArgs

StatusBarDrawItemEventArgs

Öznitelikler

BrowsableAttribute ObsoleteAttribute

Örnekler

Aşağıdaki kod örneğinde özelliğin, temsilcininStatusBarDrawItemEventHandler, sınıfın, numaralandırmanın StatusBarDrawItemEventArgs ve özelliğin StatusBarPanelStyle nasıl kullanılacağı Style gösterilmektedirStatusBarDrawItemEventArgs.Panel. Örneği çalıştırmak için aşağıdaki kodu bir forma yapıştırın. Formun InitializeStatusBarPanels oluşturucusunda veya Load yönteminde yöntemini çağırın.

StatusBar^ StatusBar1;
void InitializeStatusBarPanels()
{
   StatusBar1 = gcnew StatusBar;
   
   // Create two StatusBarPanel objects.
   StatusBarPanel^ panel1 = gcnew StatusBarPanel;
   StatusBarPanel^ panel2 = gcnew StatusBarPanel;
   
   // Set the style of the panels.  
   // panel1 will be owner-drawn.
   panel1->Style = StatusBarPanelStyle::OwnerDraw;
   
   // The panel2 object will be drawn by the operating system.
   panel2->Style = StatusBarPanelStyle::Text;
   
   // Set the text of both panels to the same date string.
   panel1->Text = System::DateTime::Today.ToShortDateString();
   panel2->Text = System::DateTime::Today.ToShortDateString();
   
   // Add both panels to the StatusBar.
   StatusBar1->Panels->Add( panel1 );
   StatusBar1->Panels->Add( panel2 );
   
   // Make panels visible by setting the ShowPanels 
   // property to True.
   StatusBar1->ShowPanels = true;
   
   // Associate the event-handling method with the DrawItem event 
   // for the owner-drawn panel.
   StatusBar1->DrawItem += gcnew StatusBarDrawItemEventHandler( this, &Form1::DrawCustomStatusBarPanel );
   this->Controls->Add( StatusBar1 );
}


// Draw the panel.
void DrawCustomStatusBarPanel( Object^ sender, StatusBarDrawItemEventArgs^ e )
{
   
   // Draw a blue background in the owner-drawn panel.
   e->Graphics->FillRectangle( Brushes::AliceBlue, e->Bounds );
   
   // Create a StringFormat object to align text in the panel.
   StringFormat^ textFormat = gcnew StringFormat;
   
   // Center the text in the middle of the line.
   textFormat->LineAlignment = StringAlignment::Center;
   
   // Align the text to the left.
   textFormat->Alignment = StringAlignment::Far;
   
   // Draw the panel's text in dark blue using the Panel 
   // and Bounds properties of the StatusBarEventArgs object 
   // and the StringFormat object.
   e->Graphics->DrawString( e->Panel->Text, StatusBar1->Font, Brushes::DarkBlue, RectangleF(e->Bounds.X,e->Bounds.Y,e->Bounds.Width,e->Bounds.Height), textFormat );
}

private StatusBar StatusBar1;

private void InitializeStatusBarPanels()
{
    StatusBar1 = new StatusBar();

    // Create two StatusBarPanel objects.
    StatusBarPanel panel1 = new StatusBarPanel();
    StatusBarPanel panel2 = new StatusBarPanel();

    // Set the style of the panels.  
    // panel1 will be owner-drawn.
    panel1.Style = StatusBarPanelStyle.OwnerDraw;

    // The panel2 object will be drawn by the operating system.
    panel2.Style = StatusBarPanelStyle.Text;

    // Set the text of both panels to the same date string.
    panel1.Text = System.DateTime.Today.ToShortDateString();
    panel2.Text = System.DateTime.Today.ToShortDateString();

    // Add both panels to the StatusBar.
    StatusBar1.Panels.Add(panel1);
    StatusBar1.Panels.Add(panel2);

    // Make panels visible by setting the ShowPanels 
    // property to True.
    StatusBar1.ShowPanels = true;

    // Associate the event-handling method with the DrawItem event 
    // for the owner-drawn panel.
    StatusBar1.DrawItem += 
        new StatusBarDrawItemEventHandler(DrawCustomStatusBarPanel);
        
    this.Controls.Add(StatusBar1);
}

// Draw the panel.
private void DrawCustomStatusBarPanel(object sender, 
    StatusBarDrawItemEventArgs e)
{

    // Draw a blue background in the owner-drawn panel.
    e.Graphics.FillRectangle(Brushes.AliceBlue, e.Bounds);

    // Create a StringFormat object to align text in the panel.
    StringFormat textFormat = new StringFormat();

    // Center the text in the middle of the line.
    textFormat.LineAlignment = StringAlignment.Center;

    // Align the text to the left.
    textFormat.Alignment = StringAlignment.Far;

    // Draw the panel's text in dark blue using the Panel 
    // and Bounds properties of the StatusBarEventArgs object 
    // and the StringFormat object.
    e.Graphics.DrawString(e.Panel.Text, StatusBar1.Font, 
        Brushes.DarkBlue, new RectangleF(e.Bounds.X, 
        e.Bounds.Y, e.Bounds.Width, e.Bounds.Height), textFormat);
}

Private StatusBar1 As StatusBar

Private Sub InitializeStatusBarPanels()
    StatusBar1 = New StatusBar

    ' Create two StatusBarPanel objects.
    Dim panel1 As New StatusBarPanel
    Dim panel2 As New StatusBarPanel

    ' Set the style of the panels.  
    ' panel1 will be owner-drawn.
    panel1.Style = StatusBarPanelStyle.OwnerDraw

    ' The panel2 object will be drawn by the operating system.
    panel2.Style = StatusBarPanelStyle.Text

    ' Set the text of both panels to the same date string.
    panel1.Text = DateTime.Today.ToShortDateString()
    panel2.Text = DateTime.Today.ToShortDateString()

    ' Add both panels to the StatusBar.
    StatusBar1.Panels.Add(panel1)
    StatusBar1.Panels.Add(panel2)

    ' Make panels visible by setting the ShowPanels 
    ' property to True.
    StatusBar1.ShowPanels = True

    ' Use the AddHandler syntax to handle the DrawItem event
    ' for the owner-drawn panel.
    AddHandler StatusBar1.DrawItem, _
        New StatusBarDrawItemEventHandler( _
        AddressOf DrawCustomStatusBarPanel)
    Me.Controls.Add(StatusBar1)
End Sub

' Draw the panel.
Private Sub DrawCustomStatusBarPanel(ByVal sender As Object, _
    ByVal e As StatusBarDrawItemEventArgs)

    ' Draw a blue background in the owner-drawn panel.
    e.Graphics.FillRectangle(Brushes.AliceBlue, e.Bounds)

    ' Create a StringFormat object to align text in the panel.
    Dim textFormat As New StringFormat

    ' Center the text in the middle of the line.
    textFormat.LineAlignment = StringAlignment.Center

    ' Align the text to the left.
    textFormat.Alignment = StringAlignment.Far

    ' Draw the panel's text in dark blue using the Panel 
    ' and Bounds properties of the StatusBarEventArgs object 
    ' and the StringFormat object.
    e.Graphics.DrawString(e.Panel.Text, StatusBar1.Font, _
          Brushes.DarkBlue, New RectangleF(e.Bounds.X, e.Bounds.Y, _
          e.Bounds.Width, e.Bounds.Height), textFormat)

End Sub

Açıklamalar

Olay, DrawItem sahip tarafından çizilmiş StatusBarPanel bir görsel yönü değiştiğinde gerçekleşir. AStatusBarDrawItemEventArgs, paneli çizmek için kullanılacak nesneyi, panelin Rectangle çizildiği nesneyi, panel tanımlama numarasını, panel hakkındaki durum bilgilerini ve çizilen paneli belirtirGraphics. Uygulamanızın StatusBar denetiminde özel olarak çizilmiş paneller oluşturmak için olay işleyicisinde DrawItem bu sınıf tarafından sağlanan verileri kullanabilirsiniz.

Oluşturucular

Name	Description
StatusBarDrawItemEventArgs(Graphics, Font, Rectangle, Int32, DrawItemState, StatusBarPanel, Color, Color)	Geçersiz. için belirtilen arka plan ve ön plan rengiyle sınıfının yeni bir örneğini StatusBarDrawItemEventArgsStatusBarPanelbaşlatır.
StatusBarDrawItemEventArgs(Graphics, Font, Rectangle, Int32, DrawItemState, StatusBarPanel)	Geçersiz. için bir arka plan ve ön plan rengi belirtmeden sınıfının yeni bir örneğini StatusBarDrawItemEventArgsStatusBarPanelbaşlatır.

Özellikler

Name	Description
BackColor	Geçersiz. Çizilmekte olan öğenin arka plan rengini alır. (Devralındığı yer: DrawItemEventArgs)
Bounds	Geçersiz. Çizilmekte olan öğenin sınırlarını temsil eden dikdörtgeni alır. (Devralındığı yer: DrawItemEventArgs)
Font	Geçersiz. Çizilmekte olan öğeye atanan yazı tipini alır. (Devralındığı yer: DrawItemEventArgs)
ForeColor	Geçersiz. Çizilmekte olan öğenin ön plan rengini alır. (Devralındığı yer: DrawItemEventArgs)
Graphics	Geçersiz. Öğeyi çizmek için grafik yüzeyini alır. (Devralındığı yer: DrawItemEventArgs)
Index	Geçersiz. Çizilmekte olan öğenin dizin değerini alır. (Devralındığı yer: DrawItemEventArgs)
Panel	Geçersiz. StatusBarPanel Çizimini alır.
State	Geçersiz. Çizilmekte olan öğenin durumunu alır. (Devralındığı yer: DrawItemEventArgs)

Yöntemler

Name	Description
Dispose()	Geçersiz. Yönetilmeyen kaynakları serbest bırakma, serbest bırakma veya sıfırlama ile ilişkili uygulama tanımlı görevleri gerçekleştirir. (Devralındığı yer: DrawItemEventArgs)
Dispose(Boolean)	Geçersiz. DrawItem olayı için veriler sağlar. (Devralındığı yer: DrawItemEventArgs)
DrawBackground()	Geçersiz. Oluşturucuda DrawItemEventArgs belirtilen sınırların içinde ve uygun renkle arka planı çizer. (Devralındığı yer: DrawItemEventArgs)
DrawFocusRectangle()	Geçersiz. Oluşturucuda belirtilen sınırlar içinde bir odak dikdörtgeni DrawItemEventArgs çizer. (Devralındığı yer: DrawItemEventArgs)

Belirtik Arabirim Kullanımları

Name	Description
IDeviceContext.GetHdc()	Geçersiz. Tanıtıcıyı bir Windows cihaz bağlamı olarak döndürür. (Devralındığı yer: DrawItemEventArgs)
IDeviceContext.ReleaseHdc()	Geçersiz. Windows cihaz bağlamının tutamacını serbest bırakır. (Devralındığı yer: DrawItemEventArgs)

Ayrıca bkz.

• DrawItem
• StatusBarPanel
• Graphics
• Rectangle