HOW TO：呈現視覺化樣式項目

更新：2007 年 11 月

System.Windows.Forms.VisualStyles 命名空間會公開 (Expose) VisualStyleElement 物件，此物件表示由視覺樣式所支援的 Windows 使用者介面 (UI) 項目。這個主題示範如何使用 VisualStyleRenderer 類別呈現表示 [開始] 功能表的 [登出] 和 [關閉] 按鈕的 VisualStyleElement。

若要呈現視覺樣式項目

1. 建立 VisualStyleRenderer 並將它設定為要繪製的項目。請注意使用 Application.RenderWithVisualStyles 屬性和 VisualStyleRenderer.IsElementDefined 方法；如果停用了視覺樣式或未定義項目，VisualStyleRenderer 建構函式便會擲出例外狀況。

   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
   

   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:
       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);
           }
       }
   

2. 請呼叫 DrawBackground 方法以呈現 VisualStyleRenderer 目前所表示的項目。

   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
   

   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:
       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);
           }
       }
   

編譯程式碼

這項範例需要：

• 衍生自 Control 類別的自訂控制項。

• 裝載自訂控制項的 Form。

• System、System.Drawing、System.Windows.Forms 和 System.Windows.Forms.VisualStyles 命名空間的參考。

請參閱

概念

使用視覺化樣式呈現控制項