IDesignerOptionService インターフェイス

.NET Framework クラス ライブラリ リファレンス

IDesignerOptionService インターフェイス

Visual Studio .NET 開発環境で [ツール] メニューの [オプション] コマンドにある各デザイナ オプションへのアクセスを提供します。

名前空間: System.ComponentModel.Design
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Interface IDesignerOptionService

Visual Basic (使用法)

Dim instance As IDesignerOptionService

C#

public interface IDesignerOptionService

C++

public interface class IDesignerOptionService

J#

public interface IDesignerOptionService

JScript

public interface IDesignerOptionService

解説

IDesignerOptionService が提供するインターフェイスを使用して、Windows フォーム デザイナ オプションの値を取得して更新できます。これらのオプションは、Visual Studio 開発環境の [ツール] メニューの [オプション] コマンドで表示されるダイアログ内に表示されます。GetOptionValue メソッドは、指定したオプションの値を取得します。SetOptionValue メソッドは、指定したオプションの指定した値を設定します。

使用例

IDesignerOptionService にアクセスして標準オプションの現在の値を表示するコード例を次に示します。

Visual Basic

Imports System
Imports System.Collections
Imports System.ComponentModel
Imports System.ComponentModel.Design
Imports System.Drawing
Imports System.Data
Imports System.Windows.Forms
Imports System.Windows.Forms.Design

' This control demonstrates retrieving the standard 
' designer option service values in design mode.
Public Class IDesignerOptionServiceControl
    Inherits System.Windows.Forms.UserControl
    Private designerOptionService As IDesignerOptionService

    Public Sub New()
        Me.BackColor = Color.Beige
        Me.Size = New Size(404, 135)
    End Sub

    Public Overrides Property
 Site() As System.ComponentModel.ISite
        Get
            Return MyBase.Site
        End Get
        Set(ByVal Value As
 System.ComponentModel.ISite)
            MyBase.Site = Value

            ' If siting component, attempt to obtain an IDesignerOptionService.
            If Not (MyBase.Site
 Is Nothing) Then
                designerOptionService = CType(Me.GetService(GetType(IDesignerOptionService)),
 IDesignerOptionService)
            End If
        End Set
    End Property

    ' Displays control information and current IDesignerOptionService
 
    ' values, if available.
    Protected Overrides Sub
 OnPaint(ByVal e As System.Windows.Forms.PaintEventArgs)
        e.Graphics.DrawString("IDesignerOptionServiceControl",
 New Font("Arial", 9), New
 SolidBrush(Color.Blue), 4, 4)
        If Me.DesignMode Then
            e.Graphics.DrawString("Currently in design mode",
 New Font("Arial", 8), New
 SolidBrush(Color.Black), 4, 18)
        Else
            e.Graphics.DrawString("Not in design mode. Cannot
 access IDesignerOptionService.", New Font("Arial",
 8), New SolidBrush(Color.Red), 4, 18)
        End If
        If Not (MyBase.Site
 Is Nothing) AndAlso Not
 (designerOptionService Is Nothing) Then
            e.Graphics.DrawString("IDesignerOptionService provides
 access to the table of option values listed when", New
 Font("Arial", 8), New SolidBrush(Color.Black), 4, 38)
            e.Graphics.DrawString("the Windows Forms Designer\General
 tab of the Tools\Options menu is selected.", New
 Font("Arial", 8), New SolidBrush(Color.Black), 4, 50)

            e.Graphics.DrawString("Table of standard value names
 and current values", New Font("Arial",
 8), New SolidBrush(Color.Red), 4, 76)

            ' Displays a table of the standard value names and current
 values.
            Dim ypos As Integer
 = 90

            ' Obtains and shows the size of the standard design-mode
 grid square.
            Dim size As Size = CType(designerOptionService.GetOptionValue("WindowsFormsDesigner\General",
 "GridSize"), Size)
            e.Graphics.DrawString("GridSize", New
 Font("Arial", 8), New SolidBrush(Color.Black),
 4, ypos)
            e.Graphics.DrawString(size.ToString(), New Font("Arial",
 8), New SolidBrush(Color.Black), 100, ypos)
            ypos += 12

            ' Obtaisn and shows whether the design mode surface grid
 is enabled.
            Dim showGrid As Boolean
 = CBool(designerOptionService.GetOptionValue("WindowsFormsDesigner\General",
 "ShowGrid"))
            e.Graphics.DrawString("ShowGrid", New
 Font("Arial", 8), New SolidBrush(Color.Black),
 4, ypos)
            e.Graphics.DrawString(showGrid.ToString(), New Font("Arial",
 8), New SolidBrush(Color.Black), 100, ypos)
            ypos += 12

            ' Obtains and shows whether components should be aligned
 with the surface grid.
            Dim snapToGrid As Boolean
 = CBool(designerOptionService.GetOptionValue("WindowsFormsDesigner\General",
 "SnapToGrid"))
            e.Graphics.DrawString("SnapToGrid", New
 Font("Arial", 8), New SolidBrush(Color.Black),
 4, ypos)
            e.Graphics.DrawString(snapToGrid.ToString(), New Font("Arial",
 8), New SolidBrush(Color.Black), 100, ypos)
        End If
    End Sub

End Class

C#

using System;
using System.Collections;
using System.ComponentModel;
using System.ComponentModel.Design;
using System.Drawing;
using System.Data;
using System.Windows.Forms;
using System.Windows.Forms.Design;

namespace IDesignerOptionServiceExample
{
    // This control demonstrates retrieving the standard 
    // designer option service values in design mode.
    public class IDesignerOptionServiceControl
 : System.Windows.Forms.UserControl
    {        
        private IDesignerOptionService designerOptionService;

        public IDesignerOptionServiceControl()
        {
            this.BackColor = Color.Beige;
                    this.Size = new Size(404,
 135);
        }
        
        public override System.ComponentModel.ISite Site
        {
            get
            {
                return base.Site;
            }
            set
            {
                base.Site = value;

                // If siting component, attempt to obtain an IDesignerOptionService.
                if( base.Site != null
 )                            
                    designerOptionService = (IDesignerOptionService)this.GetService(typeof(IDesignerOptionService));
                                   
            }
        }

        // Displays control information and current IDesignerOptionService
 
        // values, if available.
        protected override void OnPaint(System.Windows.Forms.PaintEventArgs
 e)
        {
            e.Graphics.DrawString("IDesignerOptionServiceControl", new
 Font("Arial", 9), new SolidBrush(Color.Blue), 4, 4);
            if( this.DesignMode )
                e.Graphics.DrawString("Currently in design
 mode", new Font("Arial", 8), new
 SolidBrush(Color.Black), 4, 18);
            else
                e.Graphics.DrawString("Not in design mode.
 Cannot access IDesignerOptionService.", new Font("Arial",
 8), new SolidBrush(Color.Red), 4, 18);
            
            if( base.Site != null
 && designerOptionService != null )
            {
                e.Graphics.DrawString("IDesignerOptionService provides access
 to the table of option values listed when", new Font("Arial",
 8), new SolidBrush(Color.Black), 4, 38);
                e.Graphics.DrawString("the Windows Forms Designer\\General tab
 of the Tools\\Options menu is selected.", new Font("Arial",
 8), new SolidBrush(Color.Black), 4, 50);                
                
                e.Graphics.DrawString("Table of standard value names and current
 values", new Font("Arial", 8), new
 SolidBrush(Color.Red), 4, 76);
                
                // Displays a table of the standard value names and
 current values.
                int ypos = 90;

                // Obtains and shows the size of the standard design-mode
 grid square.
                Size size = (Size)designerOptionService.GetOptionValue("WindowsFormsDesigner\\General",
 "GridSize");
                e.Graphics.DrawString("GridSize", new
 Font("Arial", 8), new SolidBrush(Color.Black), 4,
 ypos);
                e.Graphics.DrawString(size.ToString(), new Font("Arial",
 8), new SolidBrush(Color.Black), 100, ypos);
                ypos+=12;
                
                // Obtains and shows whether the design mode surface
 grid is enabled.
                bool showGrid = (bool)designerOptionService.GetOptionValue("WindowsFormsDesigner\\General",
 "ShowGrid");
                e.Graphics.DrawString("ShowGrid", new
 Font("Arial", 8), new SolidBrush(Color.Black), 4,
 ypos);
                e.Graphics.DrawString(showGrid.ToString(), new
 Font("Arial", 8), new SolidBrush(Color.Black), 100,
 ypos);
                ypos+=12;
                
                // Obtains and shows whether components should be aligned
 with the surface grid.
                bool snapToGrid = (bool)designerOptionService.GetOptionValue("WindowsFormsDesigner\\General",
 "SnapToGrid");
                e.Graphics.DrawString("SnapToGrid", new
 Font("Arial", 8), new SolidBrush(Color.Black), 4,
 ypos);
                e.Graphics.DrawString(snapToGrid.ToString(), new
 Font("Arial", 8), new SolidBrush(Color.Black), 100,
 ypos);                
            }
        }
    }
}

C++

#using <System.Windows.Forms.dll>
#using <System.Data.dll>
#using <System.Drawing.dll>
#using <System.dll>

using namespace System;
using namespace System::Collections;
using namespace System::ComponentModel;
using namespace System::ComponentModel::Design;
using namespace System::Drawing;
using namespace System::Data;
using namespace System::Windows::Forms;
using namespace System::Windows::Forms::Design;

namespace IDesignerOptionServiceExample
{
   // This control demonstrates retrieving the standard 
   // designer option service values in design mode.
   public ref class IDesignerOptionServiceControl:
 public System::Windows::Forms::UserControl
   {
   private:
      IDesignerOptionService^ designerOptionService;

   public:
      IDesignerOptionServiceControl()
      {
         this->BackColor = Color::Beige;
         this->Size = System::Drawing::Size( 404, 135 );
      }

      property System::ComponentModel::ISite^ Site 
      {
         virtual System::ComponentModel::ISite^ get() override
         {
            return __super::Site;
         }

         virtual void set( System::ComponentModel::ISite^
 value ) override
         {
            __super::Site = value;
            
            // If siting component, attempt to obtain an IDesignerOptionService.
            if ( __super::Site != nullptr )
                        designerOptionService = dynamic_cast<IDesignerOptionService^>(this->GetService(
 IDesignerOptionService::typeid ));
         }
      }

   protected:

      // Displays control information and current IDesignerOptionService
 
      // values, if available.

      virtual void OnPaint( System::Windows::Forms::PaintEventArgs^
 e ) override
      {
         e->Graphics->DrawString( "IDesignerOptionServiceControl",
 gcnew System::Drawing::Font( "Arial",9 ), gcnew SolidBrush( Color::Blue
 ), 4, 4 );
         if ( this->DesignMode )
                  e->Graphics->DrawString( "Currently in
 design mode", gcnew System::Drawing::Font( "Arial",8 ), gcnew SolidBrush(
 Color::Black ), 4, 18 );
         else
                  e->Graphics->DrawString( "Not in
 design mode. Cannot access IDesignerOptionService.", gcnew System::Drawing::Font(
 "Arial",8 ), gcnew SolidBrush( Color::Red ), 4, 18 );

         if ( __super::Site != nullptr && designerOptionService
 != nullptr )
         {
            e->Graphics->DrawString( "IDesignerOptionService provides
 access to the table of option values listed when", gcnew System::Drawing::Font(
 "Arial",8 ), gcnew SolidBrush( Color::Black ), 4, 38 );
            e->Graphics->DrawString( "the Windows Forms Designer\\General
 tab of the Tools\\Options menu is selected.", gcnew System::Drawing::Font(
 "Arial",8 ), gcnew SolidBrush( Color::Black ), 4, 50 );
            e->Graphics->DrawString( "Table of standard value names and
 current values", gcnew System::Drawing::Font( "Arial",8 ), gcnew
 SolidBrush( Color::Red ), 4, 76 );
            
            // Displays a table of the standard value names and current
 values.
            int ypos = 90;
            
            // Obtains and shows the size of the standard design-mode
 grid square.
            System::Drawing::Size size =  *dynamic_cast<System::Drawing::Size^>(designerOptionService->GetOptionValue(
 "WindowsFormsDesigner\\General", "GridSize" ));
            e->Graphics->DrawString( "GridSize", gcnew System::Drawing::Font(
 "Arial",8 ), gcnew SolidBrush( Color::Black ), 4, (float)ypos
 );
            e->Graphics->DrawString( size.ToString(), gcnew System::Drawing::Font(
 "Arial",8 ), gcnew SolidBrush( Color::Black ), 100, (float)ypos
 );
            ypos += 12;

            // Obtains and shows whether the design mode surface grid
 is enabled.
            bool showGrid =  *dynamic_cast<bool^>(designerOptionService->GetOptionValue(
 "WindowsFormsDesigner\\General", "ShowGrid" ));
            e->Graphics->DrawString( "ShowGrid", gcnew System::Drawing::Font(
 "Arial",8 ), gcnew SolidBrush( Color::Black ), 4, (float)ypos
 );
            e->Graphics->DrawString( showGrid.ToString(), gcnew System::Drawing::Font(
 "Arial",8 ), gcnew SolidBrush( Color::Black ), 100, (float)ypos
 );
            ypos += 12;

            // Obtains and shows whether components should be aligned
 with the surface grid.
            bool snapToGrid =  *dynamic_cast<bool^>(designerOptionService->GetOptionValue(
 "WindowsFormsDesigner\\General", "SnapToGrid" ));
            e->Graphics->DrawString( "SnapToGrid", gcnew System::Drawing::Font(
 "Arial",8 ), gcnew SolidBrush( Color::Black ), 4, (float)ypos
 );
            e->Graphics->DrawString( snapToGrid.ToString(), gcnew System::Drawing::Font(
 "Arial",8 ), gcnew SolidBrush( Color::Black ), 100, (float)ypos
 );
         }
      }
   };
}

J#

package IDesignerOptionServiceExample;

import System.*;
import System.Collections.*;
import System.ComponentModel.*;
import System.ComponentModel.Design.*;
import System.Drawing.*;
import System.Data.*;
import System.Windows.Forms.*;
import System.Windows.Forms.Design.*;

// This control demonstrates retrieving the standard 
// designer option service values in design mode.
public class IDesignerOptionServiceControl
 extends 
    System.Windows.Forms.UserControl
{
    private IDesignerOptionService designerOptionService;

    public IDesignerOptionServiceControl()
    {
        this.set_BackColor(Color.get_Beige());
        this.set_Size(new Size(404, 135));
    } //IDesignerOptionServiceControl

    /** @property 
     */
    public System.ComponentModel.ISite get_Site()
    {
        return super.get_Site();
    } //get_Site

    /** @property 
     */
    public void set_Site(System.ComponentModel.ISite
 value)
    {
        super.set_Site(value);
        // If siting component, attempt to obtain an IDesignerOptionService.
        if (super.get_Site() != null) {
            designerOptionService = ((IDesignerOptionService)
                (this.GetService(IDesignerOptionService.class.ToType())));
        }
    } //set_Site

    // Displays control information and current IDesignerOptionService
 
    // values, if available.
    protected void OnPaint(System.Windows.Forms.PaintEventArgs
 e)
    {
        e.get_Graphics().DrawString("IDesignerOptionServiceControl", new
 
            Font("Arial", 9), new SolidBrush(Color.get_Blue()),
 4, 4);
        if (this.get_DesignMode()) {
            e.get_Graphics().DrawString("Currently in design
 mode", 
                new Font("Arial", 8), new
 SolidBrush(Color.get_Black()), 4, 18);
        }
        else {
            e.get_Graphics().DrawString("Not in design mode.
 Cannot access"
                + " IDesignerOptionService.", new Font("Arial",
 8), 
                new SolidBrush(Color.get_Red()), 4, 18);
        }
        if (super.get_Site() != null &&
 designerOptionService != null) {
            e.get_Graphics().DrawString("IDesignerOptionService provides "
                + " access to the table of option values listed when",
 
                new Font("Arial", 8), new
 SolidBrush(Color.get_Black()),4,38);
            e.get_Graphics().DrawString("the Windows Forms Designer\\General"
                + " tab of the Tools\\Options menu is selected.", 
                new Font("Arial", 8), new
 SolidBrush(Color.get_Black()), 4, 50);
            e.get_Graphics().DrawString("Table of standard value names and "
                + " current values", new Font("Arial",
 8), new SolidBrush(
                Color.get_Red()), 4, 76);
            // Displays a table of the standard value names and current
 values.
            int ypos = 90;

            // Obtains and shows the size of the standard design-mode
 
            // grid square.
            Size size = ((Size)(designerOptionService.GetOptionValue(
                "WindowsFormsDesigner\\General", "GridSize")));
            e.get_Graphics().DrawString("GridSize", new
 Font("Arial", 8),
                new SolidBrush(Color.get_Black()), 4, ypos);
            e.get_Graphics().DrawString(size.ToString(), new Font("Arial",
 8),
                new SolidBrush(Color.get_Black()), 100, ypos);
            ypos += 12;
            // Obtains and shows whether the design mode surface
            // grid is enabled.
            boolean showGrid = (System.Convert.ToBoolean((designerOptionService.
                GetOptionValue("WindowsFormsDesigner\\General", "ShowGrid"))));
            e.get_Graphics().DrawString("ShowGrid", new
 Font("Arial", 8), 
                new SolidBrush(Color.get_Black()), 4, ypos);
            e.get_Graphics().DrawString(System.Convert.ToString(showGrid), 
                new Font("Arial", 8), new
 SolidBrush(Color.get_Black()), 
                100, ypos);
            ypos += 12;

            // Obtains and shows whether components should be aligned
 with the
            // surface grid.
            boolean snapToGrid = System.Convert.ToBoolean(
                (designerOptionService.GetOptionValue(
                "WindowsFormsDesigner\\General", "SnapToGrid")));
            e.get_Graphics().DrawString("SnapToGrid", new
 Font("Arial", 8),
                new SolidBrush(Color.get_Black()), 4, ypos);
            e.get_Graphics().DrawString(System.Convert.ToString(snapToGrid),
                new Font("Arial", 8), new
 SolidBrush(Color.get_Black()), 
                100, ypos);
        }
    } //OnPaint
} //IDesignerOptionServiceControl

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
IDesignerOptionService メンバ
System.ComponentModel.Design 名前空間
IDesigner インターフェイス
DesignerOptionService クラス