StatusBarDrawItemEventArgs Třída

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

StatusBarDrawItemEventArgs.cs

Upozornění

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

Poskytuje data pro událost 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

Dědičnost

Object

EventArgs

DrawItemEventArgs

StatusBarDrawItemEventArgs

Atributy

BrowsableAttribute ObsoleteAttribute

Příklady

Následující příklad kódu ukazuje použití Style vlastnosti, StatusBarDrawItemEventHandler delegát, StatusBarDrawItemEventArgs třídy, StatusBarPanelStyle výčtu StatusBarDrawItemEventArgs.Panel a vlastnosti. Pokud chcete spustit příklad, vložte do formuláře následující kód. Volejte metodu InitializeStatusBarPanels v konstruktoru nebo Load metodě formuláře.

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

Poznámky

K DrawItem události dochází, když se změní vizuální aspekt nakresleného StatusBarPanel vlastníkem. Určuje StatusBarDrawItemEventArgs objekt, který Graphics se má použít k vykreslení panelu, objektu, Rectangle ve kterém chcete panel nakreslit, identifikační číslo panelu, informace o stavu panelu a panel, který chcete nakreslit. Data poskytnutá touto třídou můžete použít v obslužné rutině události události DrawItem k vytvoření vlastních nakreslených panelů v ovládacím StatusBar prvku vaší aplikace.

Konstruktory

Name	Description
StatusBarDrawItemEventArgs(Graphics, Font, Rectangle, Int32, DrawItemState, StatusBarPanel, Color, Color)	Zastaralé. Inicializuje novou instanci StatusBarDrawItemEventArgs třídy se zadaným pozadím a barvou popředí pro StatusBarPanelobjekt .
StatusBarDrawItemEventArgs(Graphics, Font, Rectangle, Int32, DrawItemState, StatusBarPanel)	Zastaralé. Inicializuje novou instanci StatusBarDrawItemEventArgs třídy bez zadání pozadí a barvy popředí pro StatusBarPanelobjekt .

Vlastnosti

Name	Description
BackColor	Zastaralé. Získá barvu pozadí položky, která je nakreslena. (Zděděno od DrawItemEventArgs)
Bounds	Zastaralé. Získá obdélník, který představuje hranice položky, která je nakreslena. (Zděděno od DrawItemEventArgs)
Font	Zastaralé. Získá písmo přiřazené k nakreslené položce. (Zděděno od DrawItemEventArgs)
ForeColor	Zastaralé. Získá barvu popředí položky, která je nakreslena. (Zděděno od DrawItemEventArgs)
Graphics	Zastaralé. Načte grafickou plochu, na kterou chcete položku nakreslit. (Zděděno od DrawItemEventArgs)
Index	Zastaralé. Získá index hodnotu položky, která je nakreslena. (Zděděno od DrawItemEventArgs)
Panel	Zastaralé. StatusBarPanel Získá kreslit.
State	Zastaralé. Získá stav nakreslené položky. (Zděděno od DrawItemEventArgs)

Metody

Name	Description
Dispose()	Zastaralé. Provádí úlohy definované aplikací související s uvolněním, uvolněním nebo resetováním nespravovaných prostředků. (Zděděno od DrawItemEventArgs)
Dispose(Boolean)	Zastaralé. Poskytuje data pro událost DrawItem. (Zděděno od DrawItemEventArgs)
DrawBackground()	Zastaralé. Nakreslí pozadí v mezích zadaných v konstruktoru DrawItemEventArgs a s příslušnou barvou. (Zděděno od DrawItemEventArgs)
DrawFocusRectangle()	Zastaralé. Nakreslí obdélník fokusu v mezích zadaných v konstruktoru DrawItemEventArgs . (Zděděno od DrawItemEventArgs)

Explicitní implementace rozhraní

Name	Description
IDeviceContext.GetHdc()	Zastaralé. Vrátí popisovač kontextu zařízení s Windows. (Zděděno od DrawItemEventArgs)
IDeviceContext.ReleaseHdc()	Zastaralé. Uvolní popisovač kontextu zařízení s Windows. (Zděděno od DrawItemEventArgs)

Viz také

• DrawItem
• StatusBarPanel
• Graphics
• Rectangle