StatusBar.DrawItem Evento
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Ocorre quando um aspeto visual de um controlo de barra de estado desenhado pelo proprietário muda.
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 Tipo de Evento
Exemplos
O exemplo de código seguinte demonstra como criar um desenho StatusBarPanel feito pelo proprietário que exibe um fundo personalizado e a data atual. Este exemplo exige que tenha ligado o DrawItem evento de um StatusBar controlo ao gestor de eventos definido no exemplo.
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
Observações
Pode usar este evento para realizar operações de desenho num controlo desenhado StatusBar pelo proprietário. Por exemplo, se mostrar um desenho StatusBarPanel desenhado pelo proprietário que mostra uma barra de progresso, pode usar este evento para realizar o desenho da barra de progresso no painel. Os dados fornecidos ao evento através do StatusBarDrawItemEventArgs objeto passados como parâmetro para o gestor de eventos permitem-lhe determinar o painel que precisa de ser desenhado e o Graphics que deve ser usado para desenhar para o painel. Este evento só surge quando a StatusBarPanel.Style propriedade de a StatusBarPanel num StatusBar controlo é definida como OwnerDraw.
Para obter mais informações sobre como manipular eventos, consulte Manipulando e gerando eventos.
