方法 : visual スタイル要素を描画する

更新 : 2007 年 11 月

System.Windows.Forms.VisualStyles 名前空間は、visual スタイルによってサポートされている Windows のユーザー インターフェイス (UI) を表す VisualStyleElement オブジェクトを公開します。このトピックでは、[スタート] メニューの [ログオフ] ボタンと [シャットダウン] ボタンを表す VisualStyleElement を描画する VisualStyleRenderer クラスの使用法を説明します。

visual スタイル要素を描画するには

1. VisualStyleRenderer を作成し、これを描画対象の要素に設定します。Application.RenderWithVisualStyles プロパティと VisualStyleRenderer.IsElementDefined メソッドの使用に注意してください。visual スタイルが無効にされている、または要素が未定義の場合、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 の各名前空間への参照。

参照

概念

visual スタイルが使用されているコントロールのレンダリング