ControlDesignerとは? わかりやすく解説

ControlDesigner クラス

Web サーバー コントロールのデザイン モードの動作を拡張するための基本コントロール デザイナ クラスを提供します。

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

Public Class ControlDesigner
    Inherits HtmlControlDesigner
Dim instance As ControlDesigner
public class ControlDesigner : HtmlControlDesigner
public ref class ControlDesigner : public
 HtmlControlDesigner
public class ControlDesigner extends HtmlControlDesigner
public class ControlDesigner extends
 HtmlControlDesigner
解説解説

ControlDesigner クラスは、Visual Studio 2005 などのデザイン ホストで、デザイン時に Web サーバー コントロールをサポートするために継承および拡張できる基本コントロール デザイナ クラスを提供します。

デザイン時の表示を処理するオブジェクト モデルは、以前のバージョンに比べて強化されており、簡略化されたオブジェクト モデルにアクセスできるようにするために、次の新しい基本クラスが追加されています。

オートフォーマット
アクション リスト (スマート タグ)
コントロール デザイナ領域
テンプレート
デザイン時の表示

ControlDesigner クラスには、Web サーバー コントロールのデザイン時の表示をサポートする、次のようなメソッドがあります。これらのメソッドのほとんどは、以前のバージョンと同じです。

使用例使用例

ControlDesigner クラスから派生した単純なデザイナ クラスを作成する方法のコード例を次に示します。このコントロール デザイナは、カスタム TextControl クラスをサポートし、デザイン時にコントロールのテキスト サイズを変更するコマンドを提供します。コントロール デザイナは、TextControl クラスの DesignerAttribute オブジェクト宣言でコントロール デザイナを指定することにより、コントロールと関連付けられます。コントロール デザイナから HTML マークアップへのプロパティの変更を永続化するためのキーは、カスタム ActionList クラスの ToggleTextSize メソッドにあります。

この例を実行するには、System.Design.dll アセンブリへの参照を追加し、コードをコンパイルします。

Imports Microsoft.VisualBasic
Imports System.Web.UI
Imports System.Web.UI.Design
Imports System.Web.UI.WebControls
Imports System.ComponentModel
Imports System.ComponentModel.Design

Namespace ASPNet.Design.Samples.VB

    ' Simple text Web control renders a text string.
    ' This control is associated with the TextSizeWebControlDesigner.
    <DesignerAttribute(GetType(TextSizeWebControlDesigner)),
 _
        ToolboxData("<{0}:TextControl runat='server'></{0}:TextControl>")>
 _
    Public Class TextControl
        Inherits Label

        Private _largeText As Boolean
 = True

        ' Constructor
        Public Sub New()
            Text = "Test Phrase"
            SetSize()
        End Sub

        ' Determines whether the text is large or small
        <Bindable(True), Category("Appearance"),
 DefaultValue(True)> _
        Public Property LargeText() As
 Boolean
            Get
                Return _largeText
            End Get
            Set(ByVal value As
 Boolean)
                _largeText = value
                SetSize()
            End Set
        End Property

        ' Applies the LargeText property to the control
        Private Sub SetSize()
            If LargeText Then
                Me.Font.Size = FontUnit.XLarge
            Else
                Me.Font.Size = FontUnit.Small
            End If
        End Sub
    End Class


    ' This control designer offers DesignerActionList commands
    ' that can alter the design time html of the associated control.
    Public Class TextSizeWebControlDesigner
        Inherits ControlDesigner

        Private _actionLists As DesignerActionListCollection

        ' Do not allow direct resizing of the control
        Public Overrides ReadOnly
 Property AllowResize() As Boolean
            Get
                Return False
            End Get
        End Property

        ' Return a custom ActionList collection
        Public Overrides ReadOnly
 Property ActionLists() As System.ComponentModel.Design.DesignerActionListCollection
            Get
                If IsNothing(_actionLists) Then
                    _actionLists = New DesignerActionListCollection()
                    _actionLists.AddRange(MyBase.ActionLists)

                    ' Add a custom DesignerActionList
                    _actionLists.Add(New ActionList(Me))
                End If

                Return _actionLists
            End Get
        End Property

        ' Create a custom class of DesignerActionList
        Public Class ActionList
            Inherits DesignerActionList
            Private _parent As TextSizeWebControlDesigner
            Private _items As DesignerActionItemCollection

            ' Constructor
            Public Sub New(ByRef
 parent As TextSizeWebControlDesigner)
                MyBase.New(parent.Component)
                _parent = parent
            End Sub

            ' Create the ActionItem collection and add one command
            Public Overrides Function
 GetSortedActionItems() As DesignerActionItemCollection
                If IsNothing(_items) Then
                    _items = New DesignerActionItemCollection()
                    _items.Add(New DesignerActionMethodItem(Me,
 "ToggleLargeText", "Toggle Text
 Size", True))
                End If

                Return _items
            End Function

            ' ActionList command to change the text size
            Private Sub ToggleLargeText()
                ' Get a reference to the parent designer's associated
 control
                Dim ctl As TextControl = CType(_parent.Component,
 TextControl)

                ' Get a reference to the control's LargeText property
                Dim propDesc As PropertyDescriptor
 = TypeDescriptor.GetProperties(ctl)("LargeText")

                ' Get the current value of the property
                Dim v As Boolean
 = CType(propDesc.GetValue(ctl), Boolean)
                ' Toggle the property value
                propDesc.SetValue(ctl, (Not v))
            End Sub
        End Class
    End Class
End Namespace
<br /><span space="preserve">...</span><br
 /><%@ Page Language="VB" %>
<%@ Register TagPrefix="aspSample" 
    Namespace="ASPNet.Design.Samples.VB"
 %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML
 1.0 Transitional//EN" 
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html  >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
    
        <aspSample:TextControl ID=TextControl1 runat="server">
        </aspSample:TextControl>
    
    </div>
    </form>
</body>
</html>
using System;
using System.Web.UI;
using System.Drawing;
using System.Web.UI.Design;
using System.Web.UI.WebControls;
using System.ComponentModel;
using System.ComponentModel.Design;

namespace ASPNet.Design.Samples.CS
{
    // Simple text Web control renders a text string.
    // This control is associated with the TextSizeWebControlDesigner.
    [DesignerAttribute(typeof(TextSizeWebControlDesigner)),
    ToolboxData("<{0}:TextControl runat=\"server\"></{0}:TextControl>")]
    public class TextControl : Label
    {
        private bool _largeText = true;

        // Constructor
        public TextControl()
        {
            Text = "Test Phrase";
            SetSize();
        }

        // Determines whether the text is large or small
        [Bindable(true), Category("Appearance"), DefaultValue("true")]
        public bool LargeText
        {
            get { return _largeText; }
            set
            {
                _largeText = value;
                SetSize();
            }
        }

        // Applies the LargeText property to the control
        private void SetSize()
        {
            if (LargeText)
                this.Font.Size = FontUnit.XLarge;
            else
                this.Font.Size = FontUnit.Small;
        }
    }

    // This control designer offers DesignerActionList commands
    // that can alter the design time html of the associated control.
    public class TextSizeWebControlDesigner
 : ControlDesigner
    {
        private DesignerActionListCollection _actionLists = null;

        // Do not allow direct resizing of the control
        public override bool AllowResize
        {
            get { return false;
 }
        }

        // Return a custom ActionList collection
        public override DesignerActionListCollection ActionLists
        {
            get
            {
                if (_actionLists == null)
                {
                    _actionLists = new DesignerActionListCollection();
                    _actionLists.AddRange(base.ActionLists);

                    // Add a custom DesignerActionList
                    _actionLists.Add(new ActionList(this));
                }
                return _actionLists;
            }
        }

        public class ActionList : DesignerActionList
        {
            private TextSizeWebControlDesigner _parent;
            private DesignerActionItemCollection _items;

            // Constructor
            public ActionList(TextSizeWebControlDesigner parent)
                : base(parent.Component)
            {
                _parent = parent;

            }

            // Create the ActionItem collection and add one command
            public override DesignerActionItemCollection GetSortedActionItems()
            {
                if (_items == null)
                {
                    _items = new DesignerActionItemCollection();
                    _items.Add(new DesignerActionMethodItem(this,
 "ToggleLargeText", "Toggle Text Size", true));
                }
                return _items;
            }

            // ActionList command to change the text size
            private void ToggleLargeText()
            {
                // Get a reference to the parent designer's associated
 control
                TextControl ctl = (TextControl)_parent.Component;

                // Get a reference to the control's LargeText property
                PropertyDescriptor propDesc = TypeDescriptor.GetProperties(ctl)["LargeText"];

                // Get the current value of the property
                bool v = (bool)propDesc.GetValue(ctl);

                // Toggle the property value
                propDesc.SetValue(ctl, !v);
            }
        }
    }
}
<br /><span space="preserve">...</span><br /><%@
 Page Language="C#" %>
<%@ Register TagPrefix="aspSample" 
    Namespace="ASPNet.Design.Samples.CS" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

</script>

<html  >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
    
    <aspSample:TextControl ID=TextControl1 runat="server">
    </aspSample:TextControl>

    
    </div>
    </form>
</body>
</html>
.NET Framework のセキュリティ.NET Framework のセキュリティ
継承階層継承階層
System.Object
   System.ComponentModel.Design.ComponentDesigner
     System.Web.UI.Design.HtmlControlDesigner
      System.Web.UI.Design.ControlDesigner
         派生クラス
スレッド セーフスレッド セーフ
この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

ControlDesigner クラス

Control のデザイン モードの動作を拡張します。

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

Public Class ControlDesigner
    Inherits ComponentDesigner
Dim instance As ControlDesigner
public class ControlDesigner : ComponentDesigner
public ref class ControlDesigner : public
 ComponentDesigner
public class ControlDesigner extends ComponentDesigner
public class ControlDesigner extends
 ComponentDesigner
解説解説
使用例使用例

MouseEnter イベントおよび MouseLeave イベントを処理し、デザイナ コードからコントロール上に描画し、IDesignerFilter インターフェイスの一部を使用してデザイン時にコントロールのプロパティを追加する、ControlDesigner 実装の例を次に示します。このサンプル コードには、デザイナおよびそのデザイナに関連付けられたサンプル ユーザー コントロールが含まれます。このサンプルをビルドするには、サンプルをコンパイルしてクラス ライブラリを作成し、このライブラリへの参照を Windows フォーム プロジェクトに追加します。次に、このコントロールをツールボックスに追加し、コントロールのインスタンスをフォームに追加します。このコントロールをポイントすると、コントロールを囲んでいる内側のアウトラインが強調表示されます。アウトラインには、デザイナがコントロールのプロパティのリストに追加した OutlineColor プロパティに対応した色が使用されます。

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

Namespace ControlDesignerExample
    _
    ' ExampleControlDesigner is an example control designer that 
    ' demonstrates basic functions of a ControlDesigner.
    <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand,
 Name:="FullTrust")> _
    Public Class TestControlDesigner
        Inherits System.Windows.Forms.Design.ControlDesigner

        ' This boolean state reflects whether the mouse is over the
 control.
        Private mouseover As Boolean
 = False
        ' This color is a private field for the OutlineColor property.
        Private lineColor As Color = Color.White

        ' This color is used to outline the control when the mouse is
 
        ' over the control.
        Public Property OutlineColor() As
 Color
            Get
                Return lineColor
            End Get
            Set(ByVal Value As
 Color)
                lineColor = Value
            End Set
        End Property

        Public Sub New()
        End Sub

        ' Sets a value and refreshes the control's display when the
 
        ' mouse position enters the area of the control.
        Protected Overrides Sub
 OnMouseEnter()
            Me.mouseover = True
            Me.Control.Refresh()
        End Sub

        ' Sets a value and refreshes the control's display when the
 
        ' mouse position enters the area of the control.        
        Protected Overrides Sub
 OnMouseLeave()
            Me.mouseover = False
            Me.Control.Refresh()
        End Sub

        ' Draws an outline around the control when the mouse is 
        ' over the control.    
        Protected Overrides Sub
 OnPaintAdornments(ByVal pe As System.Windows.Forms.PaintEventArgs)
            If Me.mouseover Then
                pe.Graphics.DrawRectangle(New Pen(New
 SolidBrush(Me.lineColor), 6), 0, 0, Me.Control.Size.Width,
 Me.Control.Size.Height)
            End If
        End Sub

        ' Adds a property to this designer's control at design time
 
        ' that indicates the outline color to use.
        Protected Overrides Sub
 PreFilterProperties(ByVal properties As System.Collections.IDictionary)
            properties.Add("OutlineColor", TypeDescriptor.CreateProperty(GetType(TestControlDesigner),
 "OutlineColor", GetType(System.Drawing.Color),
 Nothing))
        End Sub
    End Class

    ' This example control demonstrates the ExampleControlDesigner.
    <DesignerAttribute(GetType(TestControlDesigner))> _
     Public Class TestControl
        Inherits System.Windows.Forms.UserControl
        Private components As System.ComponentModel.Container
 = Nothing

        Public Sub New()
            components = New System.ComponentModel.Container()
        End Sub 

        Protected Overloads Sub
 Dispose(ByVal disposing As Boolean)
            If disposing Then
                If Not (components Is
 Nothing) Then
                    components.Dispose()
                End If
            End If
            MyBase.Dispose(disposing)
        End Sub 
    End Class 

End Namespace
using System;
using System.ComponentModel;
using System.ComponentModel.Design;
using System.Collections;
using System.Drawing;
using System.Windows.Forms;
using System.Windows.Forms.Design;

namespace ControlDesignerExample
{
    // ExampleControlDesigner is an example control designer that 
    // demonstrates basic functions of a ControlDesigner.
    [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand,
 Name = "FullTrust")] 
    public class ExampleControlDesigner  :
 System.Windows.Forms.Design.ControlDesigner
    {
        // This boolean state reflects whether the mouse is over the
 control.
        private bool mouseover = false;
        // This color is a private field for the OutlineColor property.
        private Color lineColor = Color.White;

        // This color is used to outline the control when the mouse
 is 
        // over the control.
        public Color OutlineColor
        {
            get
            {
                return lineColor;
            }
            set
            {
                lineColor = value;
            }
        }

        public ExampleControlDesigner()
        {
        }

        // Sets a value and refreshes the control's display when the
 
        // mouse position enters the area of the control.
        protected override void OnMouseEnter()
        {
            this.mouseover = true;
            this.Control.Refresh();
        }    

        // Sets a value and refreshes the control's display when the
 
        // mouse position enters the area of the control.        
        protected override void OnMouseLeave()
        {
            this.mouseover = false;       
     
            this.Control.Refresh();
        }        
        
        // Draws an outline around the control when the mouse is 
        // over the control.    
        protected override void OnPaintAdornments(System.Windows.Forms.PaintEventArgs
 pe)
        {
            if(this.mouseover)
                pe.Graphics.DrawRectangle(new Pen(new
 SolidBrush(this.lineColor), 6), 0, 0, this.Control.Size.Width,
 this.Control.Size.Height);        
        }

        // Adds a property to this designer's control at design time
 
        // that indicates the outline color to use.
        protected override void PreFilterProperties(System.Collections.IDictionary
 properties)
        {
            properties.Add("OutlineColor", TypeDescriptor.CreateProperty(typeof(ExampleControlDesigner),
 "OutlineColor", typeof(System.Drawing.Color), null));
        }
    }

    // This example control demonstrates the ExampleControlDesigner.
    [DesignerAttribute(typeof(ExampleControlDesigner))]
    public class ExampleControl : System.Windows.Forms.UserControl
    {        
        private System.ComponentModel.Container components = null;

        public ExampleControl()
        {
            components = new System.ComponentModel.Container();
        }

        protected override void Dispose( bool
 disposing )
        {
            if( disposing )
            {
                if( components != null )
                components.Dispose();
            }
            base.Dispose( disposing );
        }
    }
}
using namespace System;
using namespace System::ComponentModel;
using namespace System::ComponentModel::Design;
using namespace System::Collections;
using namespace System::Drawing;
using namespace System::Windows::Forms;
using namespace System::Windows::Forms::Design;
using namespace System::Security::Permissions;

   public ref class TestControlDesigner: public
 System::Windows::Forms::Design::ControlDesigner
   {
   private:
      bool mouseover;
      Color lineColor;

   public:

      property Color OutlineColor 
      {
         Color get()
         {
            return lineColor;
         }

         void set( Color value )
         {
            lineColor = value;
         }

      }
      TestControlDesigner()
      {
         mouseover = false;
         lineColor = Color::White;
      }

   protected:
      virtual void OnMouseEnter() override
      {
         this->mouseover = true;
         this->Control->Refresh();
      }

      virtual void OnMouseLeave() override
      {
         this->mouseover = false;
         this->Control->Refresh();
      }

      virtual void OnPaintAdornments( System::Windows::Forms::PaintEventArgs^
 pe ) override
      {
         if ( this->mouseover )
                  pe->Graphics->DrawRectangle( gcnew Pen( gcnew SolidBrush(
 this->lineColor ),6 ), 0, 0, this->Control->Size.Width,
 this->Control->Size.Height );
      }

   protected:
      [ReflectionPermission(SecurityAction::Demand, Flags=ReflectionPermissionFlag::MemberAccess)]
      virtual void PreFilterProperties( System::Collections::IDictionary^
 properties ) override
      {
         properties->Add( "OutlineColor", TypeDescriptor::CreateProperty(
 TestControlDesigner::typeid, "OutlineColor", System::Drawing::Color::typeid,
 nullptr ) );
      }
   };

   [DesignerAttribute(TestControlDesigner::typeid)]
   public ref class TestControl: public
 System::Windows::Forms::UserControl
   {
   private:
      System::ComponentModel::Container^ components;

   public:
      TestControl()
      {
         components = gcnew System::ComponentModel::Container;
      }

   protected:
      ~TestControl()
      {
         if ( components != nullptr )
         {
            delete components;
         }
      }
   };
継承階層継承階層
System.Object
   System.ComponentModel.Design.ComponentDesigner
    System.Windows.Forms.Design.ControlDesigner
       System.Windows.Forms.Design.ParentControlDesigner
スレッド セーフスレッド セーフ
この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
ControlDesigner メンバ
System.Windows.Forms.Design 名前空間
ComponentDesigner
IDesigner
DesignerAttribute
その他の技術情報
デザイン時サポートの拡張

ControlDesigner コンストラクタ


ControlDesigner コンストラクタ


ControlDesigner フィールド


プロテクト フィールドプロテクト フィールド

  名前 説明
プロテクト フィールド InvalidPoint 無効な Point の値を表すローカルの Point を定義します。
参照参照

関連項目

ControlDesigner クラス
System.Windows.Forms.Design 名前空間
ComponentDesigner
IDesigner
DesignerAttribute

その他の技術情報

デザイン時サポートの拡張

ControlDesigner プロパティ


パブリック プロパティパブリック プロパティ

( プロテクト プロパティ も参照)
  名前 説明
パブリック プロパティ ActionLists オーバーライドされます。 コントロール デザイナのアクション リスト コレクションを取得します。
パブリック プロパティ AllowResize デザイン時環境でコントロールのサイズを変更できるかどうかを示す値を取得します。
パブリック プロパティ AssociatedComponents  デザイナで管理されているコンポーネントに関連付けられているコンポーネントのコレクションを取得します。 ( ComponentDesigner から継承されます。)
パブリック プロパティ AutoFormats 関連付けられているコントロールについてデザイン時に [オートフォーマット] ダイアログ ボックスに表示する定義済みのオートフォーマット スキームのコレクションを取得します。
パブリック プロパティ Behavior  デザイナに関連付けられている DHTML 動作を取得または設定します。 ( HtmlControlDesigner から継承されます。)
パブリック プロパティ Component  デザイナがデザインするコンポーネントを取得します。 ( ComponentDesigner から継承されます。)
パブリック プロパティ DataBindings  現在のコントロールのデータ バインディング コレクションを取得します。 ( HtmlControlDesigner から継承されます。)
パブリック プロパティ DesignTimeHtmlRequiresLoadComplete デザイン ホストが読み込みを完了しないと GetDesignTimeHtml メソッドを呼び出すことができないかどうかを示す値を取得します。
パブリック プロパティ Expressions  現在のコントロールの式バインディングをデザイン時に取得します。 ( HtmlControlDesigner から継承されます。)
パブリック プロパティ ID コントロールの ID 文字列を取得または設定します。
パブリック プロパティ IsDirty Web サーバー コントロールが変更済みとしてマークされているかどうかを示す値を取得または設定します。
パブリック プロパティ ReadOnly コントロールのプロパティがデザイン時に読み取り専用かどうかを示す値を取得または設定します。
パブリック プロパティ ShouldCodeSerialize  シリアル化中に、現在のデザイン ドキュメントの分離コード ファイル内でコントロールのフィールド宣言を作成するかどうかを示す値を取得または設定します。 ( HtmlControlDesigner から継承されます。)
パブリック プロパティ TemplateGroups それぞれが 1 つまたは複数のテンプレート定義を含むテンプレート グループのコレクションを取得します。
パブリック プロパティ Verbs  デサイナに関連付けられているコンポーネントがサポートしているデザイン時の動詞を取得します。 ( ComponentDesigner から継承されます。)
パブリック プロパティ ViewControl デザイン時 HTML マークアップのプレビュー用に使用できる Web サーバー コントロールを取得または設定します。
パブリック プロパティ ViewControlCreated View コントロールがデザイン サーフェイスでの表示用に作成されているかどうかを示す値を取得または設定します。
プロテクト プロパティプロテクト プロパティ
  名前 説明
プロテクト プロパティ DataBindingsEnabled 関連付けられているコントロールの格納先の領域がデータ バインディングをサポートするかどうかを示す値を取得します。
プロテクト プロパティ DesignerState デザイン時に関連付けられているコントロールのデータを永続化するために使用するオブジェクトを取得します。
プロテクト プロパティ DesignTimeElement  デザイン サーフェイスの HtmlControlDesigner オブジェクトと関連付けられているコントロールを表すデザイン時オブジェクトを取得します。 ( HtmlControlDesigner から継承されます。)
プロテクト プロパティ DesignTimeElementView コントロール デザイナのビュー コントロール オブジェクトを取得します。
プロテクト プロパティ HidePropertiesInTemplateMode コントロールがテンプレート モードのときに関連付けられているコントロールのプロパティが非表示に設定されるかどうかを示す値を取得します。
プロテクト プロパティ InheritanceAttribute  関連付けられているコンポーネントの継承の種類を示す属性を取得します。 ( ComponentDesigner から継承されます。)
プロテクト プロパティ Inherited  コンポーネントが継承されているかどうかを示す値を取得します。 ( ComponentDesigner から継承されます。)
プロテクト プロパティ InTemplateMode デザイン ホストでコントロールがテンプレート表示モードまたは編集モードのいずれかであるかどうかを示す値を取得します。InTemplateMode プロパティは読み取り専用です。
プロテクト プロパティ ParentComponent  このデザイナの親コンポーネントを取得します。 ( ComponentDesigner から継承されます。)
プロテクト プロパティ RootDesigner 関連付けられているコントロールを含む Web フォーム ページのコントロール デザイナを取得します。
プロテクト プロパティ ShadowProperties  ユーザー設定値をオーバーライドするプロパティ値のコレクションを取得します。 ( ComponentDesigner から継承されます。)
プロテクト プロパティ Tag 関連付けられているコントロールの HTML マークアップ要素を表すオブジェクトを取得します。
プロテクト プロパティ UsePreviewControl コントロール デザイナが一時プレビュー コントロールを使用してデザイン時 HTML マークアップを生成するかどうかを示す値を取得します。
参照参照

関連項目

ControlDesigner クラス
System.Web.UI.Design 名前空間
TemplateGroup
DesignerAutoFormat
DesignerActionList
DesignerRegion
ContainerControlDesigner クラス
CompositeControlDesigner

その他の技術情報

ASP.NET コントロール デザイナの概要
デザイン時アーキテクチャ
Web フォームのデザイン時サポート
アクション リストとサービスを使用したサンプル コントロール デザイナ

ControlDesigner プロパティ


パブリック プロパティパブリック プロパティ

( プロテクト プロパティ も参照)
  名前 説明
パブリック プロパティ AccessibilityObject コントロールに割り当てられた AccessibleObject を取得します。
パブリック プロパティ ActionLists  デザイナに関連付けられているコンポーネントでサポートされているデザイン時アクション リストを取得します。 ( ComponentDesigner から継承されます。)
パブリック プロパティ AssociatedComponents オーバーライドされます。 デザイナで管理されているコンポーネントに関連付けられているコンポーネントのコレクションを取得します。
パブリック プロパティ AutoResizeHandles AutoSize プロパティの値に基づいてサイズ変更ハンドルを割り当てるかどうかを示す値を取得または設定します。
パブリック プロパティ Component  デザイナがデザインするコンポーネントを取得します。 ( ComponentDesigner から継承されます。)
パブリック プロパティ Control デザイナがデザインするコントロールを取得します。
パブリック プロパティ ParticipatesWithSnapLines ドラッグ操作中に ControlDesigner でスナップ線を配置できるかどうかを示す値を取得します。
パブリック プロパティ SelectionRules コンポーネントの移動機能を示す選択規則を取得します。
パブリック プロパティ SnapLines このコントロールの有効な配置ポイントを表す SnapLine オブジェクトの一覧を取得します。
パブリック プロパティ Verbs  デサイナに関連付けられているコンポーネントがサポートしているデザイン時の動詞を取得します。 ( ComponentDesigner から継承されます。)
プロテクト プロパティプロテクト プロパティ
  名前 説明
プロテクト プロパティ BehaviorService デザイン環境から BehaviorService を取得します。
プロテクト プロパティ EnableDragRect ドラッグ四角形をこのデザイナ コンポーネントに描画できるかどうかを示す値を取得します。
プロテクト プロパティ InheritanceAttribute オーバーライドされます。 デザイナの System.ComponentModel.InheritanceAttribute を取得します。
プロテクト プロパティ Inherited  コンポーネントが継承されているかどうかを示す値を取得します。 ( ComponentDesigner から継承されます。)
プロテクト プロパティ ParentComponent オーバーライドされます。 ControlDesigner の親コンポーネントを取得します。
プロテクト プロパティ ShadowProperties  ユーザー設定値をオーバーライドするプロパティ値のコレクションを取得します。 ( ComponentDesigner から継承されます。)
参照参照

関連項目

ControlDesigner クラス
System.Windows.Forms.Design 名前空間
ComponentDesigner
IDesigner
DesignerAttribute

その他の技術情報

デザイン時サポートの拡張

ControlDesigner メソッド


パブリック メソッドパブリック メソッド

( プロテクト メソッド も参照)
  名前 説明
パブリック メソッド Dispose  オーバーロードされます。 HtmlControlDesigner オブジェクトによって使用されているアンマネージ リソースを解放します。オプションでマネージ リソースも解放できます。 ( HtmlControlDesigner から継承されます。)
パブリック メソッド DoDefaultAction  コンポーネントの既定イベントに対するメソッド シグネチャをソース コード ファイル内に作成し、コード内のその位置にカーソルを移動します。 ( ComponentDesigner から継承されます。)
パブリック メソッド Equals  オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
パブリック メソッド GetBounds デザイン サーフェイスに表示されるコントロールの境界を表す四角形の座標を取得します。
パブリック メソッド GetDesignTimeHtml オーバーロードされます。 デザイン時にコントロールを表すために使用する HTML マークアップを取得します。
パブリック メソッド GetDesignTimeResourceProviderFactory サイトの構成ファイル内のグローバリゼーション設定に応じて、適切なリソース プロバイダ ファクトリを返します。
パブリック メソッド GetEditableDesignerRegionContent 関連付けられたコントロールのデザイン時ビューの編集可能領域の内容を返します。
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
パブリック メソッド GetPersistenceContent コントロールの永続化できる内部 HTML マークアップをデザイン時に取得します。
パブリック メソッド GetPersistInnerHtml コントロールの永続化できる内部 HTML マークアップを取得します。
パブリック メソッド GetType  現在のインスタンスの Type を取得します。 ( Object から継承されます。)
パブリック メソッド GetViewRendering オーバーロードされます。 関連付けられているコントロールの内容および領域のデザイン時マークアップを格納しているオブジェクトを取得します。
パブリック メソッド Initialize オーバーライドされます。 コントロール デザイナを初期化し、指定されたコンポーネントを読み込みます。
パブリック メソッド InitializeExistingComponent  既存のコンポーネントを再初期化します。 ( ComponentDesigner から継承されます。)
パブリック メソッド InitializeNewComponent  新規作成したコンポーネントを初期化します。 ( ComponentDesigner から継承されます。)
パブリック メソッド InitializeNonDefault  既定値以外の値に既に初期化されている、インポートされたコンポーネントの設定値を初期化します。 ( ComponentDesigner から継承されます。)
パブリック メソッド Invalidate オーバーロードされます。 デザイン サーフェイスに表示されたコントロールを無効化し、デザイン ホストによって OnPaint メソッドが呼び出されるようにします。
パブリック メソッド InvokeTransactedChange オーバーロードされます。 一連の変更を、指定されたパラメータを使用して、デザイン ホストが持つ元に戻す機能によってまとめてロールバックできるトランザクションに、ラップします。
パブリック メソッド IsPropertyBound 関連付けられているコントロールの指定されたプロパティがデータ バインドされているかどうかを示す値を取得します。
パブリック メソッド Localize 提供されたリソース ライタを使用して、関連付けられているコントロールのローカライズ可能なプロパティをデザイン ホストのリソースに永続化します。
パブリック メソッド OnAutoFormatApplied 定義済みのオートフォーマット スキームが関連付けられているコントロールに適用されているときに呼び出されます。
パブリック メソッド OnComponentChanged 関連付けられているコントロールが変更されたときに呼び出されます。
パブリック メソッド OnComponentChanging 関連付けられているコントロールの ComponentChanging イベントを処理するメソッドを表します。
パブリック メソッド OnSetComponentDefaults  コンポーネントの既定のプロパティを設定します。 ( ComponentDesigner から継承されます。)
パブリック メソッド OnSetParent  関連付けられたコントロールが親コントロールに結び付けられている場合に追加処理を実行する手段を提供します。 ( HtmlControlDesigner から継承されます。)
パブリック メソッド RaiseResizeEvent OnControlResize イベントを発生させます。
パブリック メソッド ReferenceEquals  指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
パブリック メソッド RegisterClone 複製が作成されたコントロールの内部データを登録します。
パブリック メソッド SetEditableDesignerRegionContent デザイン時にコントロールの編集可能領域の内容を指定します。
パブリック メソッド ToString  現在の Object を表す String を返します。 ( Object から継承されます。)
パブリック メソッド UpdateDesignTimeHtml GetDesignTimeHtml メソッドを呼び出して、関連付けられている Web サーバー コントロールのデザイン時 HTML マークアップを更新します。
プロテクト メソッドプロテクト メソッド
  名前 説明
プロテクト メソッド CreateErrorDesignTimeHtml オーバーロードされます。 デザイン時にエラー メッセージを表示するための HTML マークアップを作成します。
プロテクト メソッド CreatePlaceHolderDesignTimeHtml オーバーロードされます。 コントロールの種類と ID を表示する単純な四角形のプレースホルダ表示を提供します。
プロテクト メソッド CreateViewControl デザイン サーフェイスで表示または描画するために関連付けられているコントロールのコピーを返します。
プロテクト メソッド Dispose  オーバーロードされます。 HtmlControlDesigner オブジェクトによって使用されているアンマネージ リソースを解放します。オプションでマネージ リソースも解放できます。 ( HtmlControlDesigner から継承されます。)
プロテクト メソッド Finalize  ガベージ コレクションでオブジェクトがクリアされる前に、Dispose(false) を呼び出して、リソースの解放を試みます。 ( ComponentDesigner から継承されます。)
プロテクト メソッド GetEmptyDesignTimeHtml 実行時にビジュアルな表示が存在しない Web サーバー コントロールをデザイン時に表すための HTML マークアップを取得します。
プロテクト メソッド GetErrorDesignTimeHtml 指定された例外に関する情報を提供する HTML マークアップを取得します。
プロテクト メソッド GetService  デザイナのコンポーネントのデザイン モード サイトから、指定した型のサービスの取得を試みます。 ( ComponentDesigner から継承されます。)
プロテクト メソッド InvokeGetInheritanceAttribute  指定した ComponentDesigner の InheritanceAttribute を取得します。 ( ComponentDesigner から継承されます。)
プロテクト メソッド MemberwiseClone  現在の Object の簡易コピーを作成します。 ( Object から継承されます。)
プロテクト メソッド OnBehaviorAttached  動作が要素に関連付けられたときに呼び出されます。 ( HtmlControlDesigner から継承されます。)
プロテクト メソッド OnBehaviorDetaching  動作と要素の関連付けが解除されたときに呼び出されます。 ( HtmlControlDesigner から継承されます。)
プロテクト メソッド OnBindingsCollectionChanged オーバーライドされます。 データ バインディング コレクションが変更されると、呼び出されます。
プロテクト メソッド OnClick 関連付けられているコントロールをデザイン時にユーザーがクリックすると、デザイン ホストによって呼び出されます。
プロテクト メソッド OnControlResize 関連付けられている Web サーバー コントロールのサイズがデザイン時にデザイン ホストで変更された場合に呼び出されます。
プロテクト メソッド OnPaint CustomPaint 値が true の場合に、コントロール デザイナが関連付けられているコントロールをデザイン サーフェイスに描画すると呼び出されます。
プロテクト メソッド PostFilterAttributes  デザイナが、TypeDescriptor を通じて公開する一連の属性から、項目を変更または削除できるようにします。 ( ComponentDesigner から継承されます。)
プロテクト メソッド PostFilterEvents  デザイナが、TypeDescriptor を通じて公開する一連のイベントから、項目を変更または削除できるようにします。 ( ComponentDesigner から継承されます。)
プロテクト メソッド PostFilterProperties  デザイナが、TypeDescriptor を通じて公開する一連のプロパティから、項目を変更または削除できるようにします。 ( ComponentDesigner から継承されます。)
プロテクト メソッド PreFilterAttributes  デザイナが、TypeDescriptor を通じて公開する一連の属性に項目を追加できるようにします。 ( ComponentDesigner から継承されます。)
プロテクト メソッド PreFilterEvents  デザイン時にコンポーネントの TypeDescriptor オブジェクトに公開されているイベントのリストを設定します。 ( HtmlControlDesigner から継承されます。)
プロテクト メソッド PreFilterProperties オーバーライドされます。 デザイン時にデザイン ホストのプロパティ グリッドを対象にプロパティの追加や削除を行ったり、関連付けられたコントロール上のプロパティに対応する新しいデザイン時プロパティを提供したりします。
プロテクト メソッド RaiseComponentChanged  コンポーネントが変更されたことを IComponentChangeService に通知します。 ( ComponentDesigner から継承されます。)
プロテクト メソッド RaiseComponentChanging  コンポーネントが変更されようとしていることを IComponentChangeService に通知します。 ( ComponentDesigner から継承されます。)
プロテクト メソッド SetRegionContent コントロールのデザイン時ビューの編集可能領域の内容を指定します。
プロテクト メソッド SetViewFlags 指定したビットごとの ViewFlags 列挙体を指定したフラグ値に割り当てます。
参照参照

関連項目

ControlDesigner クラス
System.Web.UI.Design 名前空間
TemplateGroup
DesignerAutoFormat
DesignerActionList
DesignerRegion
ContainerControlDesigner クラス
CompositeControlDesigner

その他の技術情報

ASP.NET コントロール デザイナの概要
デザイン時アーキテクチャ
Web フォームのデザイン時サポート
アクション リストとサービスを使用したサンプル コントロール デザイナ

ControlDesigner メソッド


パブリック メソッドパブリック メソッド

( プロテクト メソッド も参照)
  名前 説明
パブリック メソッド CanBeParentedTo このデザイナのコントロールが、指定したデザイナのコントロールを親として持つことができるかどうかを示します。
パブリック メソッド Dispose オーバーロードされます。 ControlDesigner によって使用されているアンマネージ リソースを解放し、オプションでマネージ リソースも解放します。
パブリック メソッド DoDefaultAction  コンポーネントの既定イベントに対するメソッド シグネチャをソース コード ファイル内に作成し、コード内のその位置にカーソルを移動します。 ( ComponentDesigner から継承されます。)
パブリック メソッド Equals  オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
パブリック メソッド GetGlyphs 標準コントロールの選択境界線とグラブ ハンドルを表す Glyph オブジェクトのコレクションを取得します。
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
パブリック メソッド GetType  現在のインスタンスの Type を取得します。 ( Object から継承されます。)
パブリック メソッド Initialize オーバーライドされます。 コンポーネントを指定して、デザイナを初期化します。
パブリック メソッド InitializeExistingComponent オーバーライドされます。 既存のコンポーネントを再初期化します。
パブリック メソッド InitializeNewComponent オーバーライドされます。 新しく作成したコンポーネントを初期化します。
パブリック メソッド InitializeNonDefault  既定値以外の値に既に初期化されている、インポートされたコンポーネントの設定値を初期化します。 ( ComponentDesigner から継承されます。)
パブリック メソッド InternalControlDesigner ControlDesigner の指定されたインデックス位置の内部コントロール デザイナを返します。
パブリック メソッド NumberOfInternalControlDesigners ControlDesigner 内の内部コントロール デザイナの数を返します。
パブリック メソッド OnSetComponentDefaults オーバーライドされます。 デザイナが初期化されるときに呼び出されます。
パブリック メソッド ReferenceEquals  指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
パブリック メソッド ToString  現在の Object を表す String を返します。 ( Object から継承されます。)
プロテクト メソッドプロテクト メソッド
  名前 説明
プロテクト メソッド BaseWndProc Windows メッセージを処理します。
プロテクト メソッド DefWndProc Windows メッセージの既定の処理を提供します。
プロテクト メソッド DisplayError 指定した例外に関する情報をユーザーに表示します。
プロテクト メソッド Dispose オーバーロードされます。 オーバーライドされます。 ControlDesigner によって使用されているアンマネージ リソースを解放し、オプションでマネージ リソースも解放します。
プロテクト メソッド EnableDesignMode 子コントロールに対するデザイン時の機能を有効にします。
プロテクト メソッド EnableDragDrop デザイン中のコントロールに対して、ドラッグ アンド ドロップのサポートを有効または無効にします。
プロテクト メソッド Finalize  ガベージ コレクションでオブジェクトがクリアされる前に、Dispose(false) を呼び出して、リソースの解放を試みます。 ( ComponentDesigner から継承されます。)
プロテクト メソッド GetControlGlyph このコントロールのバインドを表す ControlBodyGlyph を返します。
プロテクト メソッド GetHitTest 指定した点でのマウス クリックがコントロールによって処理されるかどうかを示します。
プロテクト メソッド GetService  デザイナのコンポーネントのデザイン モード サイトから、指定した型のサービスの取得を試みます。 ( ComponentDesigner から継承されます。)
プロテクト メソッド HookChildControls 指定したコントロールの子コントロールからのメッセージをデザイナにルーティングします。
プロテクト メソッド InvokeGetInheritanceAttribute  指定した ComponentDesigner の InheritanceAttribute を取得します。 ( ComponentDesigner から継承されます。)
プロテクト メソッド MemberwiseClone  現在の Object の簡易コピーを作成します。 ( Object から継承されます。)
プロテクト メソッド OnContextMenu コンテキスト メニューを表示し、コンテキスト メニューが表示される直前に追加処理を実行する機会を提供します。
プロテクト メソッド OnCreateHandle 制御ハンドルが作成された直後に、追加処理を実行する機会を提供します。
プロテクト メソッド OnDragComplete ドラッグ アンド ドロップ操作をクリーンアップするための呼び出しを受信します。
プロテクト メソッド OnDragDrop ドラッグ アンド ドロップ オブジェクトがコントロールのデザイナ ビューにドロップされると呼び出しを受信します。
プロテクト メソッド OnDragEnter ドラッグ アンド ドロップ操作がコントロールのデザイナ ビューに入ると呼び出しを受信します。
プロテクト メソッド OnDragLeave ドラッグ アンド ドロップ操作がコントロールのデザイナ ビューを離れると呼び出しを受信します。
プロテクト メソッド OnDragOver ドラッグ アンド ドロップ オブジェクトがコントロールのデザイナ ビュー上にドラッグされると呼び出しを受信します。
プロテクト メソッド OnGiveFeedback ドラッグ アンド ドロップの操作中に呼び出しを受信し、ドラッグ操作のマウスの位置に基づいてビジュアル キューを提供します。
プロテクト メソッド OnMouseDragBegin コンポーネント上でマウスの左ボタンをしばらく押したままにすると応答して呼び出しを受信します。
プロテクト メソッド OnMouseDragEnd ドラッグ アンド ドロップ操作の終了時に呼び出しを受信し、操作を完了またはキャンセルします。
プロテクト メソッド OnMouseDragMove ドラッグ アンド ドロップ操作中にマウスが移動するたびに呼び出しを受信します。
プロテクト メソッド OnMouseEnter マウスが最初にコントロールに入ると呼び出しを受信します。
プロテクト メソッド OnMouseHover マウスがコントロールの上にあるときに呼び出しを受信します。
プロテクト メソッド OnMouseLeave マウスが最初にコントロールに入ると呼び出しを受信します。
プロテクト メソッド OnPaintAdornments デザイナが管理しているコントロールが表面を描画したときに呼び出しを受信し、デザイナがコントロールの一番上に追加の表示要素を描画できるようにします。
プロテクト メソッド OnSetCursor カーソルを設定する必要があるたびに呼び出しを受信します。
プロテクト メソッド PostFilterAttributes  デザイナが、TypeDescriptor を通じて公開する一連の属性から、項目を変更または削除できるようにします。 ( ComponentDesigner から継承されます。)
プロテクト メソッド PostFilterEvents  デザイナが、TypeDescriptor を通じて公開する一連のイベントから、項目を変更または削除できるようにします。 ( ComponentDesigner から継承されます。)
プロテクト メソッド PostFilterProperties  デザイナが、TypeDescriptor を通じて公開する一連のプロパティから、項目を変更または削除できるようにします。 ( ComponentDesigner から継承されます。)
プロテクト メソッド PreFilterAttributes  デザイナが、TypeDescriptor を通じて公開する一連の属性に項目を追加できるようにします。 ( ComponentDesigner から継承されます。)
プロテクト メソッド PreFilterEvents  デザイナが、TypeDescriptor を通じて公開する一連のイベントに項目を追加できるようにします。 ( ComponentDesigner から継承されます。)
プロテクト メソッド PreFilterProperties オーバーライドされます。 TypeDescriptor を通じてコンポーネントが公開するプロパティのセットを調整します。
プロテクト メソッド RaiseComponentChanged  コンポーネントが変更されたことを IComponentChangeService に通知します。 ( ComponentDesigner から継承されます。)
プロテクト メソッド RaiseComponentChanging  コンポーネントが変更されようとしていることを IComponentChangeService に通知します。 ( ComponentDesigner から継承されます。)
プロテクト メソッド UnhookChildControls 指定したコントロールの子に対するメッセージを親デザイナではなく各コントロールにルーティングします。
プロテクト メソッド WndProc Windows メッセージを処理し、必要に応じてコントロールにルーティングします。
参照参照

関連項目

ControlDesigner クラス
System.Windows.Forms.Design 名前空間
ComponentDesigner
IDesigner
DesignerAttribute

その他の技術情報

デザイン時サポートの拡張

ControlDesigner メンバ

Web サーバー コントロールのデザイン モードの動作を拡張するための基本コントロール デザイナ クラスを提供します。

ControlDesigner データ型で公開されるメンバを以下の表に示します。


パブリック コンストラクタパブリック コンストラクタ
  名前 説明
パブリック メソッド ControlDesigner ControlDesigner クラスの新しいインスタンスを初期化します。
パブリック プロパティパブリック プロパティ
( プロテクト プロパティ も参照)
  名前 説明
パブリック プロパティ ActionLists オーバーライドされます。 コントロール デザイナのアクション リスト コレクションを取得します。
パブリック プロパティ AllowResize デザイン時環境でコントロールのサイズを変更できるかどうかを示す値を取得します。
パブリック プロパティ AssociatedComponents  デザイナで管理されているコンポーネントに関連付けられているコンポーネントのコレクションを取得します。(ComponentDesigner から継承されます。)
パブリック プロパティ AutoFormats 関連付けられているコントロールについてデザイン時に [オートフォーマット] ダイアログ ボックスに表示する定義済みのオートフォーマット スキームのコレクションを取得します。
パブリック プロパティ Behavior  デザイナに関連付けられている DHTML 動作を取得または設定します。(HtmlControlDesigner から継承されます。)
パブリック プロパティ Component  デザイナがデザインするコンポーネントを取得します。(ComponentDesigner から継承されます。)
パブリック プロパティ DataBindings  現在のコントロールのデータ バインディング コレクションを取得します。(HtmlControlDesigner から継承されます。)
パブリック プロパティ DesignTimeHtmlRequiresLoadComplete デザイン ホストが読み込みを完了しないと GetDesignTimeHtml メソッドを呼び出すことができないかどうかを示す値を取得します。
パブリック プロパティ Expressions  現在のコントロールの式バインディングをデザイン時に取得します。(HtmlControlDesigner から継承されます。)
パブリック プロパティ ID コントロールの ID 文字列を取得または設定します。
パブリック プロパティ IsDirty Web サーバー コントロールが変更済みとしてマークされているかどうかを示す値を取得または設定します。
パブリック プロパティ ReadOnly コントロールのプロパティがデザイン時に読み取り専用かどうかを示す値を取得または設定します。
パブリック プロパティ ShouldCodeSerialize  シリアル化中に、現在のデザイン ドキュメントの分離コード ファイル内でコントロールのフィールド宣言を作成するかどうかを示す値を取得または設定します。(HtmlControlDesigner から継承されます。)
パブリック プロパティ TemplateGroups それぞれが 1 つまたは複数のテンプレート定義を含むテンプレート グループのコレクションを取得します。
パブリック プロパティ Verbs  デサイナに関連付けられているコンポーネントがサポートしているデザイン時の動詞を取得します。(ComponentDesigner から継承されます。)
パブリック プロパティ ViewControl デザイン時 HTML マークアップのプレビュー用に使用できる Web サーバー コントロールを取得または設定します。
パブリック プロパティ ViewControlCreated View コントロールがデザイン サーフェイスでの表示用に作成されているかどうかを示す値を取得または設定します。
プロテクト プロパティプロテクト プロパティ
  名前 説明
プロテクト プロパティ DataBindingsEnabled 関連付けられているコントロールの格納先の領域がデータ バインディングをサポートするかどうかを示す値を取得します。
プロテクト プロパティ DesignerState デザイン時に関連付けられているコントロールのデータを永続化するために使用するオブジェクトを取得します。
プロテクト プロパティ DesignTimeElement  デザイン サーフェイスの HtmlControlDesigner オブジェクトと関連付けられているコントロールを表すデザイン時オブジェクトを取得します。(HtmlControlDesigner から継承されます。)
プロテクト プロパティ DesignTimeElementView コントロール デザイナのビュー コントロール オブジェクトを取得します。
プロテクト プロパティ HidePropertiesInTemplateMode コントロールがテンプレート モードのときに関連付けられているコントロールのプロパティが非表示に設定されるかどうかを示す値を取得します。
プロテクト プロパティ InheritanceAttribute  関連付けられているコンポーネントの継承の種類を示す属性を取得します。(ComponentDesigner から継承されます。)
プロテクト プロパティ Inherited  コンポーネントが継承されているかどうかを示す値を取得します。(ComponentDesigner から継承されます。)
プロテクト プロパティ InTemplateMode デザイン ホストでコントロールがテンプレート表示モードまたは編集モードのいずれかであるかどうかを示す値を取得します。InTemplateMode プロパティは読み取り専用です。
プロテクト プロパティ ParentComponent  このデザイナの親コンポーネントを取得します。(ComponentDesigner から継承されます。)
プロテクト プロパティ RootDesigner 関連付けられているコントロールを含む Web フォーム ページのコントロール デザイナを取得します。
プロテクト プロパティ ShadowProperties  ユーザー設定値をオーバーライドするプロパティ値のコレクションを取得します。(ComponentDesigner から継承されます。)
プロテクト プロパティ Tag 関連付けられているコントロールの HTML マークアップ要素を表すオブジェクトを取得します。
プロテクト プロパティ UsePreviewControl コントロール デザイナが一時プレビュー コントロールを使用してデザイン時 HTML マークアップを生成するかどうかを示す値を取得します。
パブリック メソッドパブリック メソッド
( プロテクト メソッド も参照)
  名前 説明
パブリック メソッド Dispose  オーバーロードされます。 HtmlControlDesigner オブジェクトによって使用されているアンマネージ リソースを解放します。オプションでマネージ リソースも解放できます。 (HtmlControlDesigner から継承されます。)
パブリック メソッド DoDefaultAction  コンポーネントの既定イベントに対するメソッド シグネチャをソース コード ファイル内に作成し、コード内のその位置にカーソルを移動します。 (ComponentDesigner から継承されます。)
パブリック メソッド Equals  オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
パブリック メソッド GetBounds デザイン サーフェイスに表示されるコントロールの境界を表す四角形の座標を取得します。
パブリック メソッド GetDesignTimeHtml オーバーロードされます。 デザイン時にコントロールを表すために使用する HTML マークアップを取得します。
パブリック メソッド GetDesignTimeResourceProviderFactory サイトの構成ファイル内のグローバリゼーション設定に応じて、適切なリソース プロバイダ ファクトリを返します。
パブリック メソッド GetEditableDesignerRegionContent 関連付けられたコントロールのデザイン時ビューの編集可能領域の内容を返します。
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
パブリック メソッド GetPersistenceContent コントロールの永続化できる内部 HTML マークアップをデザイン時に取得します。
パブリック メソッド GetPersistInnerHtml コントロールの永続化できる内部 HTML マークアップを取得します。
パブリック メソッド GetType  現在のインスタンスの Type を取得します。 (Object から継承されます。)
パブリック メソッド GetViewRendering オーバーロードされます。 関連付けられているコントロールの内容および領域のデザイン時マークアップを格納しているオブジェクトを取得します。
パブリック メソッド Initialize オーバーライドされます。 コントロール デザイナを初期化し、指定されたコンポーネントを読み込みます。
パブリック メソッド InitializeExistingComponent  既存のコンポーネントを再初期化します。 (ComponentDesigner から継承されます。)
パブリック メソッド InitializeNewComponent  新規作成したコンポーネントを初期化します。 (ComponentDesigner から継承されます。)
パブリック メソッド InitializeNonDefault  既定値以外の値に既に初期化されている、インポートされたコンポーネントの設定値を初期化します。 (ComponentDesigner から継承されます。)
パブリック メソッド Invalidate オーバーロードされます。 デザイン サーフェイスに表示されたコントロールを無効化し、デザイン ホストによって OnPaint メソッドが呼び出されるようにします。
パブリック メソッド InvokeTransactedChange オーバーロードされます。 一連の変更を、指定されたパラメータを使用して、デザイン ホストが持つ元に戻す機能によってまとめてロールバックできるトランザクションに、ラップします。
パブリック メソッド IsPropertyBound 関連付けられているコントロールの指定されたプロパティがデータ バインドされているかどうかを示す値を取得します。
パブリック メソッド Localize 提供されたリソース ライタを使用して、関連付けられているコントロールのローカライズ可能なプロパティをデザイン ホストのリソースに永続化します。
パブリック メソッド OnAutoFormatApplied 定義済みのオートフォーマット スキームが関連付けられているコントロールに適用されているときに呼び出されます。
パブリック メソッド OnComponentChanged 関連付けられているコントロールが変更されたときに呼び出されます。
パブリック メソッド OnComponentChanging 関連付けられているコントロールの ComponentChanging イベントを処理するメソッドを表します。
パブリック メソッド OnSetComponentDefaults  コンポーネントの既定のプロパティを設定します。 (ComponentDesigner から継承されます。)
パブリック メソッド OnSetParent  関連付けられたコントロールが親コントロールに結び付けられている場合に追加処理を実行する手段を提供します。 (HtmlControlDesigner から継承されます。)
パブリック メソッド RaiseResizeEvent OnControlResize イベントを発生させます。
パブリック メソッド ReferenceEquals  指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
パブリック メソッド RegisterClone 複製が作成されたコントロールの内部データを登録します。
パブリック メソッド SetEditableDesignerRegionContent デザイン時にコントロールの編集可能領域の内容を指定します。
パブリック メソッド ToString  現在の Object を表す String を返します。 (Object から継承されます。)
パブリック メソッド UpdateDesignTimeHtml GetDesignTimeHtml メソッドを呼び出して、関連付けられている Web サーバー コントロールのデザイン時 HTML マークアップを更新します。
プロテクト メソッドプロテクト メソッド
  名前 説明
プロテクト メソッド CreateErrorDesignTimeHtml オーバーロードされます。 デザイン時にエラー メッセージを表示するための HTML マークアップを作成します。
プロテクト メソッド CreatePlaceHolderDesignTimeHtml オーバーロードされます。 コントロールの種類と ID を表示する単純な四角形のプレースホルダ表示を提供します。
プロテクト メソッド CreateViewControl デザイン サーフェイスで表示または描画するために関連付けられているコントロールのコピーを返します。
プロテクト メソッド Dispose  オーバーロードされます。 HtmlControlDesigner オブジェクトによって使用されているアンマネージ リソースを解放します。オプションでマネージ リソースも解放できます。 (HtmlControlDesigner から継承されます。)
プロテクト メソッド Finalize  ガベージ コレクションでオブジェクトがクリアされる前に、Dispose(false) を呼び出して、リソースの解放を試みます。 (ComponentDesigner から継承されます。)
プロテクト メソッド GetEmptyDesignTimeHtml 実行時にビジュアルな表示が存在しない Web サーバー コントロールをデザイン時に表すための HTML マークアップを取得します。
プロテクト メソッド GetErrorDesignTimeHtml 指定された例外に関する情報を提供する HTML マークアップを取得します。
プロテクト メソッド GetService  デザイナのコンポーネントのデザイン モード サイトから、指定した型のサービスの取得を試みます。 (ComponentDesigner から継承されます。)
プロテクト メソッド InvokeGetInheritanceAttribute  指定した ComponentDesigner の InheritanceAttribute を取得します。 (ComponentDesigner から継承されます。)
プロテクト メソッド MemberwiseClone  現在の Object の簡易コピーを作成します。 (Object から継承されます。)
プロテクト メソッド OnBehaviorAttached  動作が要素に関連付けられたときに呼び出されます。 (HtmlControlDesigner から継承されます。)
プロテクト メソッド OnBehaviorDetaching  動作と要素の関連付けが解除されたときに呼び出されます。 (HtmlControlDesigner から継承されます。)
プロテクト メソッド OnBindingsCollectionChanged オーバーライドされます。 データ バインディング コレクションが変更されると、呼び出されます。
プロテクト メソッド OnClick 関連付けられているコントロールをデザイン時にユーザーがクリックすると、デザイン ホストによって呼び出されます。
プロテクト メソッド OnControlResize 関連付けられている Web サーバー コントロールのサイズがデザイン時にデザイン ホストで変更された場合に呼び出されます。
プロテクト メソッド OnPaint CustomPaint 値が true の場合に、コントロール デザイナが関連付けられているコントロールをデザイン サーフェイスに描画すると呼び出されます。
プロテクト メソッド PostFilterAttributes  デザイナが、TypeDescriptor を通じて公開する一連の属性から、項目を変更または削除できるようにします。 (ComponentDesigner から継承されます。)
プロテクト メソッド PostFilterEvents  デザイナが、TypeDescriptor を通じて公開する一連のイベントから、項目を変更または削除できるようにします。 (ComponentDesigner から継承されます。)
プロテクト メソッド PostFilterProperties  デザイナが、TypeDescriptor を通じて公開する一連のプロパティから、項目を変更または削除できるようにします。 (ComponentDesigner から継承されます。)
プロテクト メソッド PreFilterAttributes  デザイナが、TypeDescriptor を通じて公開する一連の属性に項目を追加できるようにします。 (ComponentDesigner から継承されます。)
プロテクト メソッド PreFilterEvents  デザイン時にコンポーネントの TypeDescriptor オブジェクトに公開されているイベントのリストを設定します。 (HtmlControlDesigner から継承されます。)
プロテクト メソッド PreFilterProperties オーバーライドされます。 デザイン時にデザイン ホストのプロパティ グリッドを対象にプロパティの追加や削除を行ったり、関連付けられたコントロール上のプロパティに対応する新しいデザイン時プロパティを提供したりします。
プロテクト メソッド RaiseComponentChanged  コンポーネントが変更されたことを IComponentChangeService に通知します。 (ComponentDesigner から継承されます。)
プロテクト メソッド RaiseComponentChanging  コンポーネントが変更されようとしていることを IComponentChangeService に通知します。 (ComponentDesigner から継承されます。)
プロテクト メソッド SetRegionContent コントロールのデザイン時ビューの編集可能領域の内容を指定します。
プロテクト メソッド SetViewFlags 指定したビットごとの ViewFlags 列挙体を指定したフラグ値に割り当てます。
参照参照

関連項目

ControlDesigner クラス
System.Web.UI.Design 名前空間
TemplateGroup
DesignerAutoFormat
DesignerActionList
DesignerRegion
ContainerControlDesigner クラス
CompositeControlDesigner

その他の技術情報

ASP.NET コントロール デザイナの概要
デザイン時アーキテクチャ
Web フォームのデザイン時サポート
アクション リストとサービスを使用したサンプル コントロール デザイナ

ControlDesigner メンバ

Control のデザイン モードの動作を拡張します。

ControlDesigner データ型で公開されるメンバを以下の表に示します。


パブリック コンストラクタパブリック コンストラクタ
  名前 説明
パブリック メソッド ControlDesigner ControlDesigner クラスの新しいインスタンスを初期化します。
プロテクト フィールドプロテクト フィールド
  名前 説明
プロテクト フィールド InvalidPoint 無効な Point の値を表すローカルの Point を定義します。
パブリック プロパティパブリック プロパティ
( プロテクト プロパティ も参照)
  名前 説明
パブリック プロパティ AccessibilityObject コントロールに割り当てられた AccessibleObject を取得します。
パブリック プロパティ ActionLists  デザイナに関連付けられているコンポーネントでサポートされているデザイン時アクション リストを取得します。(ComponentDesigner から継承されます。)
パブリック プロパティ AssociatedComponents オーバーライドされます。 デザイナで管理されているコンポーネントに関連付けられているコンポーネントのコレクションを取得します。
パブリック プロパティ AutoResizeHandles AutoSize プロパティの値に基づいてサイズ変更ハンドルを割り当てるかどうかを示す値を取得または設定します。
パブリック プロパティ Component  デザイナがデザインするコンポーネントを取得します。(ComponentDesigner から継承されます。)
パブリック プロパティ Control デザイナがデザインするコントロールを取得します。
パブリック プロパティ ParticipatesWithSnapLines ドラッグ操作中に ControlDesigner でスナップ線を配置できるかどうかを示す値を取得します。
パブリック プロパティ SelectionRules コンポーネントの移動機能を示す選択規則を取得します。
パブリック プロパティ SnapLines このコントロールの有効な配置ポイントを表す SnapLine オブジェクトの一覧を取得します。
パブリック プロパティ Verbs  デサイナに関連付けられているコンポーネントがサポートしているデザイン時の動詞を取得します。(ComponentDesigner から継承されます。)
プロテクト プロパティプロテクト プロパティ
  名前 説明
プロテクト プロパティ BehaviorService デザイン環境から BehaviorService を取得します。
プロテクト プロパティ EnableDragRect ドラッグ四角形をこのデザイナ コンポーネントに描画できるかどうかを示す値を取得します。
プロテクト プロパティ InheritanceAttribute オーバーライドされます。 デザイナの System.ComponentModel.InheritanceAttribute を取得します。
プロテクト プロパティ Inherited  コンポーネントが継承されているかどうかを示す値を取得します。(ComponentDesigner から継承されます。)
プロテクト プロパティ ParentComponent オーバーライドされます。 ControlDesigner の親コンポーネントを取得します。
プロテクト プロパティ ShadowProperties  ユーザー設定値をオーバーライドするプロパティ値のコレクションを取得します。(ComponentDesigner から継承されます。)
パブリック メソッドパブリック メソッド
( プロテクト メソッド も参照)
  名前 説明
パブリック メソッド CanBeParentedTo このデザイナのコントロールが、指定したデザイナのコントロールを親として持つことができるかどうかを示します。
パブリック メソッド Dispose オーバーロードされます。 ControlDesigner によって使用されているアンマネージ リソースを解放し、オプションでマネージ リソースも解放します。
パブリック メソッド DoDefaultAction  コンポーネントの既定イベントに対するメソッド シグネチャをソース コード ファイル内に作成し、コード内のその位置にカーソルを移動します。 (ComponentDesigner から継承されます。)
パブリック メソッド Equals  オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
パブリック メソッド GetGlyphs 標準コントロールの選択境界線とグラブ ハンドルを表す Glyph オブジェクトのコレクションを取得します。
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
パブリック メソッド GetType  現在のインスタンスの Type を取得します。 (Object から継承されます。)
パブリック メソッド Initialize オーバーライドされます。 コンポーネントを指定して、デザイナを初期化します。
パブリック メソッド InitializeExistingComponent オーバーライドされます。 既存のコンポーネントを再初期化します。
パブリック メソッド InitializeNewComponent オーバーライドされます。 新しく作成したコンポーネントを初期化します。
パブリック メソッド InitializeNonDefault  既定値以外の値に既に初期化されている、インポートされたコンポーネントの設定値を初期化します。 (ComponentDesigner から継承されます。)
パブリック メソッド InternalControlDesigner ControlDesigner の指定されたインデックス位置の内部コントロール デザイナを返します。
パブリック メソッド NumberOfInternalControlDesigners ControlDesigner 内の内部コントロール デザイナの数を返します。
パブリック メソッド OnSetComponentDefaults オーバーライドされます。 デザイナが初期化されるときに呼び出されます。
パブリック メソッド ReferenceEquals  指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
パブリック メソッド ToString  現在の Object を表す String を返します。 (Object から継承されます。)
プロテクト メソッドプロテクト メソッド
  名前 説明
プロテクト メソッド BaseWndProc Windows メッセージを処理します。
プロテクト メソッド DefWndProc Windows メッセージの既定の処理を提供します。
プロテクト メソッド DisplayError 指定した例外に関する情報をユーザーに表示します。
プロテクト メソッド Dispose オーバーロードされます。 オーバーライドされます。 ControlDesigner によって使用されているアンマネージ リソースを解放し、オプションでマネージ リソースも解放します。
プロテクト メソッド EnableDesignMode 子コントロールに対するデザイン時の機能を有効にします。
プロテクト メソッド EnableDragDrop デザイン中のコントロールに対して、ドラッグ アンド ドロップのサポートを有効または無効にします。
プロテクト メソッド Finalize  ガベージ コレクションでオブジェクトがクリアされる前に、Dispose(false) を呼び出して、リソースの解放を試みます。 (ComponentDesigner から継承されます。)
プロテクト メソッド GetControlGlyph このコントロールのバインドを表す ControlBodyGlyph を返します。
プロテクト メソッド GetHitTest 指定した点でのマウス クリックがコントロールによって処理されるかどうかを示します。
プロテクト メソッド GetService  デザイナのコンポーネントのデザイン モード サイトから、指定した型のサービスの取得を試みます。 (ComponentDesigner から継承されます。)
プロテクト メソッド HookChildControls 指定したコントロールの子コントロールからのメッセージをデザイナにルーティングします。
プロテクト メソッド InvokeGetInheritanceAttribute  指定した ComponentDesigner の InheritanceAttribute を取得します。 (ComponentDesigner から継承されます。)
プロテクト メソッド MemberwiseClone  現在の Object の簡易コピーを作成します。 (Object から継承されます。)
プロテクト メソッド OnContextMenu コンテキスト メニューを表示し、コンテキスト メニューが表示される直前に追加処理を実行する機会を提供します。
プロテクト メソッド OnCreateHandle 制御ハンドルが作成された直後に、追加処理を実行する機会を提供します。
プロテクト メソッド OnDragComplete ドラッグ アンド ドロップ操作をクリーンアップするための呼び出しを受信します。
プロテクト メソッド OnDragDrop ドラッグ アンド ドロップ オブジェクトがコントロールのデザイナ ビューにドロップされると呼び出しを受信します。
プロテクト メソッド OnDragEnter ドラッグ アンド ドロップ操作がコントロールのデザイナ ビューに入ると呼び出しを受信します。
プロテクト メソッド OnDragLeave ドラッグ アンド ドロップ操作がコントロールのデザイナ ビューを離れると呼び出しを受信します。
プロテクト メソッド OnDragOver ドラッグ アンド ドロップ オブジェクトがコントロールのデザイナ ビュー上にドラッグされると呼び出しを受信します。
プロテクト メソッド OnGiveFeedback ドラッグ アンド ドロップの操作中に呼び出しを受信し、ドラッグ操作のマウスの位置に基づいてビジュアル キューを提供します。
プロテクト メソッド OnMouseDragBegin コンポーネント上でマウスの左ボタンをしばらく押したままにすると応答して呼び出しを受信します。
プロテクト メソッド OnMouseDragEnd ドラッグ アンド ドロップ操作の終了時に呼び出しを受信し、操作を完了またはキャンセルします。
プロテクト メソッド OnMouseDragMove ドラッグ アンド ドロップ操作中にマウスが移動するたびに呼び出しを受信します。
プロテクト メソッド OnMouseEnter マウスが最初にコントロールに入ると呼び出しを受信します。
プロテクト メソッド OnMouseHover マウスがコントロールの上にあるときに呼び出しを受信します。
プロテクト メソッド OnMouseLeave マウスが最初にコントロールに入ると呼び出しを受信します。
プロテクト メソッド OnPaintAdornments デザイナが管理しているコントロールが表面を描画したときに呼び出しを受信し、デザイナがコントロールの一番上に追加の表示要素を描画できるようにします。
プロテクト メソッド OnSetCursor カーソルを設定する必要があるたびに呼び出しを受信します。
プロテクト メソッド PostFilterAttributes  デザイナが、TypeDescriptor を通じて公開する一連の属性から、項目を変更または削除できるようにします。 (ComponentDesigner から継承されます。)
プロテクト メソッド PostFilterEvents  デザイナが、TypeDescriptor を通じて公開する一連のイベントから、項目を変更または削除できるようにします。 (ComponentDesigner から継承されます。)
プロテクト メソッド PostFilterProperties  デザイナが、TypeDescriptor を通じて公開する一連のプロパティから、項目を変更または削除できるようにします。 (ComponentDesigner から継承されます。)
プロテクト メソッド PreFilterAttributes  デザイナが、TypeDescriptor を通じて公開する一連の属性に項目を追加できるようにします。 (ComponentDesigner から継承されます。)
プロテクト メソッド PreFilterEvents  デザイナが、TypeDescriptor を通じて公開する一連のイベントに項目を追加できるようにします。 (ComponentDesigner から継承されます。)
プロテクト メソッド PreFilterProperties オーバーライドされます。 TypeDescriptor を通じてコンポーネントが公開するプロパティのセットを調整します。
プロテクト メソッド RaiseComponentChanged  コンポーネントが変更されたことを IComponentChangeService に通知します。 (ComponentDesigner から継承されます。)
プロテクト メソッド RaiseComponentChanging  コンポーネントが変更されようとしていることを IComponentChangeService に通知します。 (ComponentDesigner から継承されます。)
プロテクト メソッド UnhookChildControls 指定したコントロールの子に対するメッセージを親デザイナではなく各コントロールにルーティングします。
プロテクト メソッド WndProc Windows メッセージを処理し、必要に応じてコントロールにルーティングします。
参照参照

関連項目

ControlDesigner クラス
System.Windows.Forms.Design 名前空間
ComponentDesigner
IDesigner
DesignerAttribute

その他の技術情報

デザイン時サポートの拡張



英和和英テキスト翻訳

英語⇒日本語日本語⇒英語

辞書ショートカット

すべての辞書の索引

「ControlDesigner」の関連用語

ControlDesignerのお隣キーワード

   

英語⇒日本語
日本語⇒英語
   



ControlDesignerのページの著作権

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2026 Microsoft.All rights reserved.

©2026 GRAS Group, Inc.RSS