DesignerAttribute クラスとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

DesignerAttribute クラス

コンポーネントに対するデザイン時サービスを実装するために使用するクラスを指定します。

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

Visual Basic (宣言)

<AttributeUsageAttribute(AttributeTargets.Class Or AttributeTargets.Interface,
 AllowMultiple:=True, Inherited:=True)> _
Public NotInheritable Class
 DesignerAttribute
    Inherits Attribute

Visual Basic (使用法)

Dim instance As DesignerAttribute

[AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Interface, AllowMultiple=true,
 Inherited=true)] 
public sealed class DesignerAttribute : Attribute

C++

[AttributeUsageAttribute(AttributeTargets::Class|AttributeTargets::Interface, AllowMultiple=true,
 Inherited=true)] 
public ref class DesignerAttribute sealed :
 public Attribute

/** @attribute AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Interface,
 AllowMultiple=true, Inherited=true) */ 
public final class DesignerAttribute extends
 Attribute

JScript

AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Interface, AllowMultiple=true,
 Inherited=true) 
public final class DesignerAttribute extends
 Attribute

解説

デザイン時サービスに使用するクラスは、IDesigner インターフェイスを実装している必要があります。

デザイナの基本型を検索するには、DesignerBaseTypeName プロパティを使用します。このメンバと関連付けられたデザイナの型名を取得するには、DesignerTypeName プロパティを使用します。

詳細については、属性の概要、属性を使用したメタデータの拡張の各トピックを参照してください。

使用例

MyForm というクラスを作成する方法を次の例に示します。MyForm には、このクラスが DocumentDesigner を使用することを指定する DesignerAttribute と、Form カテゴリを指定する DesignerCategoryAttribute という 2 つの属性があります。

Visual Basic

<Designer("System.Windows.Forms.Design.DocumentDesigner, System.Windows.Forms.Design.DLL",
 _
    GetType(IRootDesigner)), DesignerCategory("Form")>
 _
Public Class MyForm
    
    Inherits ContainerControl
    ' Insert code here.
End Class 'MyForm

[Designer("System.Windows.Forms.Design.DocumentDesigner, System.Windows.Forms.Design.DLL"
,
 
    typeof(IRootDesigner)),
    DesignerCategory("Form")]
public class MyForm : ContainerControl {
    // Insert code here.
}

C++

[Designer("System.Windows.Forms.Design.DocumentDesigner, System.Windows.Forms.Design.DLL"
,
IRootDesigner::typeid),
DesignerCategory("Form")]
ref class MyForm: public ContainerControl{
   // Insert code here.
};

/** @attribute Designer("System.Windows.Forms.Design.DocumentDesigner,"+
    "System.Windows.Forms.Design.DLL", IRootDesigner.class)
    @attribute DesignerCategory("Form")
 */
public static class MyForm
 extends ContainerControl
{
    // Insert code here.
} //MyForm

MyForm のインスタンスを作成する例を次に示します。そのクラスの属性を取得し、DesignerAttribute を抽出してから、デザイナの名前を出力します。

Visual Basic

Public Shared Function Main()
 As Integer
    ' Creates a new form.
    Dim myNewForm As New
 MyForm()
    
    ' Gets the attributes for the collection.
    Dim attributes As AttributeCollection =
 TypeDescriptor.GetAttributes(myNewForm)
    
    ' Prints the name of the designer by retrieving the DesignerAttribute
    ' from the AttributeCollection. 
    Dim myAttribute As DesignerAttribute =
 _
        CType(attributes(GetType(DesignerAttribute)), DesignerAttribute)
    Console.WriteLine(("The designer for this class is: "
 & myAttribute.DesignerTypeName))
    
    Return 0
End Function 'Main

public static int Main()
 {
    // Creates a new form.
    MyForm myNewForm = new MyForm();
 
    // Gets the attributes for the collection.
    AttributeCollection attributes = TypeDescriptor.GetAttributes(myNewForm);
 
    /* Prints the name of the designer by retrieving the DesignerAttribute
     * from the AttributeCollection. */
    DesignerAttribute myAttribute = 
       (DesignerAttribute)attributes[typeof(DesignerAttribute)];
    Console.WriteLine("The designer for this
 class is: " + myAttribute.DesignerTypeName);
  
    return 0;
}

C++

int main()
{
   // Creates a new form.
   MyForm^ myNewForm = gcnew MyForm;

   // Gets the attributes for the collection.
   AttributeCollection^ attributes = TypeDescriptor::GetAttributes( myNewForm );

   /* Prints the name of the designer by retrieving the DesignerAttribute
       * from the AttributeCollection. */
   DesignerAttribute^ myAttribute = dynamic_cast<DesignerAttribute^>(attributes[
 DesignerAttribute::typeid ]);
   Console::WriteLine( "The designer for this
 class is: {0}", myAttribute->DesignerTypeName );
   return 0;
}

public static void main(String[]
 args)
{
    // Creates a new form.
    MyForm myNewForm = new MyForm();

    // Gets the attributes for the collection.
    AttributeCollection attributes = 
        TypeDescriptor.GetAttributes(myNewForm);

    /* Prints the name of the designer by retrieving the 
       DesignerAttribute from the AttributeCollection. 
     */
    DesignerAttribute myAttribute = (DesignerAttribute)(
        attributes.get_Item(DesignerAttribute.class.ToType()));

    Console.WriteLine(("The designer for this
 class is: " 
        + myAttribute.get_DesignerTypeName()));
} //main