StatusBarDrawItemEventArgs Kelas

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Sumber:

StatusBarDrawItemEventArgs.cs

Perhatian

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

Menyediakan data untuk peristiwa tersebut DrawItem .

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

Warisan

Object

EventArgs

DrawItemEventArgs

StatusBarDrawItemEventArgs

Atribut

BrowsableAttribute ObsoleteAttribute

Contoh

Contoh kode berikut menunjukkan cara menggunakan Style properti, StatusBarDrawItemEventHandler delegasi, StatusBarDrawItemEventArgs kelas, enumerasi, StatusBarPanelStyle dan StatusBarDrawItemEventArgs.Panel properti . Untuk menjalankan contoh, tempelkan kode berikut dalam formulir. InitializeStatusBarPanels Panggil metode dalam konstruktor atau Load metode formulir.

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

Keterangan

Peristiwa terjadi DrawItem ketika aspek visual dari pemilik yang digambar StatusBarPanel berubah. menentukan StatusBarDrawItemEventArgs objek yang Graphics akan digunakan untuk menggambar panel, Rectangle objek untuk menggambar panel, nomor identifikasi panel, informasi status tentang panel, dan panel untuk menggambar. Anda dapat menggunakan data yang disediakan oleh kelas ini dalam penanganan aktivitas untuk DrawItem peristiwa guna membuat panel yang digambar khusus dalam kontrol aplikasi StatusBar Anda.

Konstruktor

Nama	Deskripsi
StatusBarDrawItemEventArgs(Graphics, Font, Rectangle, Int32, DrawItemState, StatusBarPanel, Color, Color)	Kedaluwarsa. Menginisialisasi instans StatusBarDrawItemEventArgs baru kelas dengan latar belakang dan warna latar depan tertentu untuk StatusBarPanel.
StatusBarDrawItemEventArgs(Graphics, Font, Rectangle, Int32, DrawItemState, StatusBarPanel)	Kedaluwarsa. Menginisialisasi instans StatusBarDrawItemEventArgs baru kelas tanpa menentukan warna latar belakang dan latar depan untuk StatusBarPanel.

Properti

Nama	Deskripsi
BackColor	Kedaluwarsa. Mendapatkan warna latar belakang item yang sedang digambar. (Diperoleh dari DrawItemEventArgs)
Bounds	Kedaluwarsa. Mendapatkan persegi panjang yang mewakili batas item yang sedang digambar. (Diperoleh dari DrawItemEventArgs)
Font	Kedaluwarsa. Mendapatkan font yang ditetapkan ke item yang sedang digambar. (Diperoleh dari DrawItemEventArgs)
ForeColor	Kedaluwarsa. Mendapatkan warna latar depan item yang sedang digambar. (Diperoleh dari DrawItemEventArgs)
Graphics	Kedaluwarsa. Mendapatkan permukaan grafis untuk menggambar item. (Diperoleh dari DrawItemEventArgs)
Index	Kedaluwarsa. Mendapatkan nilai indeks item yang sedang digambar. (Diperoleh dari DrawItemEventArgs)
Panel	Kedaluwarsa. StatusBarPanel Mendapatkan untuk menggambar.
State	Kedaluwarsa. Mendapatkan status item yang sedang digambar. (Diperoleh dari DrawItemEventArgs)

Metode

Nama	Deskripsi
Dispose()	Kedaluwarsa. Melakukan tugas yang ditentukan aplikasi yang terkait dengan membebaskan, merilis, atau mengatur ulang sumber daya yang tidak dikelola. (Diperoleh dari DrawItemEventArgs)
Dispose(Boolean)	Kedaluwarsa. Menyediakan data untuk peristiwa tersebut DrawItem . (Diperoleh dari DrawItemEventArgs)
DrawBackground()	Kedaluwarsa. Menggambar latar belakang dalam batas yang ditentukan dalam DrawItemEventArgs konstruktor dan dengan warna yang sesuai. (Diperoleh dari DrawItemEventArgs)
DrawFocusRectangle()	Kedaluwarsa. Menggambar persegi panjang fokus dalam batas yang ditentukan dalam DrawItemEventArgs konstruktor. (Diperoleh dari DrawItemEventArgs)

Implementasi Antarmuka Eksplisit

Nama	Deskripsi
IDeviceContext.GetHdc()	Kedaluwarsa. Mengembalikan handel ke konteks perangkat Windows. (Diperoleh dari DrawItemEventArgs)
IDeviceContext.ReleaseHdc()	Kedaluwarsa. Merilis handel konteks perangkat Windows. (Diperoleh dari DrawItemEventArgs)

Lihat juga

• DrawItem
• StatusBarPanel
• Graphics
• Rectangle