Compartilhar via

Como renderizar um elemento de estilo visual

O namespace System.Windows.Forms.VisualStyles expõe objetos VisualStyleElement que representam os elementos da interface do usuário do Windows compatíveis com estilos visuais. Este tópico demonstra como usar a classe VisualStyleRenderer para renderizar o VisualStyleElement que representa os botões Logoff e Desligar do menu Iniciar.

Para renderizar um elemento de estilo visual

  1. Crie um VisualStyleRenderer e defina-o para o elemento que você deseja desenhar. Observe o uso da propriedade Application.RenderWithVisualStyles e do método VisualStyleRenderer.IsElementDefined; o construtor VisualStyleRenderer gerará uma exceção se os estilos visuais estiverem desabilitados ou se um elemento for indefinido.

    private:
    VisualStyleRenderer^ renderer;
    VisualStyleElement^ element;

public:
    CustomControl()
    {
        this->Location = Point(50, 50);
        this->Size = System::Drawing::Size(200, 200);
        this->BackColor = SystemColors::ActiveBorder;
        this->element = 
            VisualStyleElement::StartPanel::LogOffButtons::Normal;
        if (Application::RenderWithVisualStyles &&
            VisualStyleRenderer::IsElementDefined(element))
        {
            renderer = gcnew VisualStyleRenderer(element);
        }
    }

    private VisualStyleRenderer renderer = null;
private readonly VisualStyleElement element =
    VisualStyleElement.StartPanel.LogOffButtons.Normal;

public CustomControl()
{
    this.Location = new Point(50, 50);
    this.Size = new Size(200, 200);
    this.BackColor = SystemColors.ActiveBorder;

    if (Application.RenderWithVisualStyles &&
        VisualStyleRenderer.IsElementDefined(element))
    {
        renderer = new VisualStyleRenderer(element);
    }
}

    Private renderer As VisualStyleRenderer = Nothing
Private element As VisualStyleElement = _
    VisualStyleElement.StartPanel.LogOffButtons.Normal

Public Sub New()
    Me.Location = New Point(50, 50)
    Me.Size = New Size(200, 200)
    Me.BackColor = SystemColors.ActiveBorder

    If Application.RenderWithVisualStyles And _
        VisualStyleRenderer.IsElementDefined(element) Then
            renderer = New VisualStyleRenderer(element)
    End If
End Sub

  2. Chame o método DrawBackground para renderizar o elemento que o VisualStyleRenderer representa atualmente.

    protected:
    virtual void OnPaint(PaintEventArgs^ e) override
    {
        // Draw the element if the renderer has been set.
        if (renderer != nullptr)
        {
            renderer->DrawBackground(e->Graphics, this->ClientRectangle);
        }

        // Visual styles are disabled or the element is undefined,
        // so just draw a message.
        else
        {
            this->Text = "Visual styles are disabled.";
            TextRenderer::DrawText(e->Graphics, this->Text, this->Font,
                Point(0, 0), this->ForeColor);
        }
    }

    protected override void OnPaint(PaintEventArgs e)
{
    // Draw the element if the renderer has been set.
    if (renderer != null)
    {
        renderer.DrawBackground(e.Graphics, this.ClientRectangle);
    }

    // Visual styles are disabled or the element is undefined,
    // so just draw a message.
    else
    {
        this.Text = "Visual styles are disabled.";
        TextRenderer.DrawText(e.Graphics, this.Text, this.Font,
            new Point(0, 0), this.ForeColor);
    }
}

    Protected Overrides Sub OnPaint(ByVal e As PaintEventArgs)
    ' Draw the element if the renderer has been set.
    If (renderer IsNot Nothing) Then
        renderer.DrawBackground(e.Graphics, Me.ClientRectangle)

    ' Visual styles are disabled or the element is undefined, 
    ' so just draw a message.
    Else
        Me.Text = "Visual styles are disabled."
        TextRenderer.DrawText(e.Graphics, Me.Text, Me.Font, _
            New Point(0, 0), Me.ForeColor)
    End If
End Sub

Compilando o código

Este exemplo requer:

Consulte também