次の方法で共有

IDL MFC プロパティを追加する

  • [アーティクル]

IDL MFC プロパティの追加 ウィザードは、Microsoft Framework クラス (MFC) プロジェクトで定義されているインターフェイス定義ライブラリ (IDL) インターフェイスにプロパティを追加します。

このウィザードを使用するには、MFC プロジェクト、ActiveX プロジェクト、または MFC をサポートする ATL プロジェクトに存在する必要があります。 たとえば、Microsoft ActiveX コントロール プロジェクトがある場合は、次の手順を使用して、ソリューションの IDL インターフェイスにプロパティを追加できます。

IDL MFC プロパティをインターフェイスに追加する

  1. [表示] メニューの [クラス ビュー] を選択します。

  2. クラス ビュー ペインで、プロパティを追加するインターフェイスの名前を右クリックします。

    Note

    プロジェクトに属性が設定されていない限り、ライブラリ ノード内で入れ子にされるディスパッチ インターフェイスに、プロパティを追加することもできます。

  3. ショートカット メニューの [追加>プロパティを選択します。

  4. IDL MFC プロパティの追加 ウィザードで、プロパティを作成するための情報を指定します。

  5. [OK] を選んで、プロパティを追加します。

MFC ディスパッチインターフェイスの場合:

  • 実装型として Member 変数 を選択すると、それを実装するクラスにメソッドと変数が追加されます。
  • 実装型として Get/Set メソッドを選択した場合、2 つのメソッドが実装するクラスに追加されます。

ユーザー インターフェイス要素の一覧

次のセクションでは、 IDL MFC プロパティの追加 ウィザードについて説明します。

2 つのパラメーターを持つ IDL MFC プロパティの追加のスクリーンショット: int i と char c。プロパティの種類がOLE_COLOR。

  • プロパティ名

    プロパティの名前を設定します。

    ActiveX コントロールに関連付けられている MFC ディスパッチ インターフェイスの場合、独自の名前を指定するか、定義済みのリストからストック プロパティの名前を選択できます。 独自のプロパティ名を指定すると、ストック実装の型は使用できません。

    リスト内のストック プロパティの説明の詳細については、「 stock プロパティを参照してください。

    インターフェイスの型 プロパティ名のオプション
    ATL デュアル インターフェイス、カスタム インターフェイス、およびローカル カスタム インターフェイス プロパティ名を指定します。
    MFC ディスパッチ インターフェイス、MFC ActiveX コントロールのディスパッチ インターフェイス プロパティ名を指定するか、リストからストック プロパティを選択します。

    リストからプロパティを選択すると、[プロパティの型] ボックスに適切な値が表示されます。 この型は、 実装の種類 選択内容に応じて変更できます。

  • プロパティの種類

    追加するプロパティの型を設定します。

    MFC ディスパッチ インターフェイスの場合、独自の型を指定するか、定義済みのリストから選択します。 プロパティのストック実装を指定する場合、 Property 型 は在庫の種類であり、変更することはできません。

  • 変数名

    プロパティが関連付けられているメンバー変数の名前を設定します。

    既定では、変数名は m_PropertyName です。 この名前は編集できます。

    このフィールドは MFC ディスパッチ インターフェイスでのみ表示され、実装の種類で Member 変数を指定した場合。

  • 通知関数

    プロパティが変更された場合に呼び出される通知関数の名前を設定します。

    既定では、通知関数の名前は OnPropertyNameChanged です。 この名前は編集できます。

    このフィールドは MFC ディスパッチ インターフェイスでのみ表示され、実装の種類で Member 変数を指定した場合。

  • Get 関数

    プロパティを取得する関数の名前を設定します。

    Get 関数の既定の名前は GetPropertyName です。 この名前は編集できます。

    名前を削除すると、関数 GetNotSupported がインターフェイス ディスパッチ マップに挿入されます。

    このフィールドは MFC ディスパッチインターフェイスでのみ表示され、Get/Set メソッドを指定した場合は実装の種類。

  • Set 関数

    プロパティを設定する関数の名前を設定します。

    Set 関数の既定の名前は SetPropertyName です。 この名前は編集できます。

    名前を削除すると、関数 SetNotSupported がインターフェイス ディスパッチ マップに挿入されます。

    このフィールドは MFC ディスパッチインターフェイスでのみ表示され、Get/Set メソッドを指定した場合は実装の種類。

  • 実装型

    追加するプロパティを実装する方法を指定します。

    MFC ディスパッチ インターフェイスでのみ使用できます。

    実装の種類 説明
    ストック Property 名で選択したプロパティの既定の実装を指定します。 詳細については、「ストック プロパティ」を参照してください。
    [ストック] を指定すると、[プロパティの型]、[パラメーターの型]、および [パラメーター名] が淡色表示になります。
    メンバー変数 プロパティをメンバー変数として追加します。
    カスタム プロパティやほとんどのストック プロパティをメンバー変数として追加することができます。
    [変数名] と [通知関数] の下に既定の名前を提供します。 この名前は編集できます。
    Caption、hWnd、またはTextプロパティにMember 変数を指定することはできません。
    Get/Set メソッド プロパティが既定で GetPropertyName および SetPropertyName 関数として追加されるように指定します。 これらの名前は、[Get 関数] および [Set 関数] の下に表示されます。
    Get 関数の値を渡す既定のプロパティの型は変更できます。
    Get 関数および Set 関数のパラメーターを指定することができます。

  • 既定のプロパティ

    インターフェイスの既定値としてプロパティを設定します。

    インターフェイスは、既定のプロパティを 1 つだけ持つことができます。

    既定のプロパティを指定すると、このチェック ボックスは、インターフェイスに追加するその他のプロパティでは使用できません。 MFC ディスパッチ インターフェイスでのみ使用できます。

  • パラメーター

    メソッドのパラメーターとその型を表示します。

  • +

    パラメーターを追加します。 Parametersで、パラメーターの種類と名前を入力し、OKを選択します。 たとえば、int x のように指定します。

  • x

    [パラメーター] の一覧から、選択したパラメーターを削除します。

  • 鉛筆アイコン

    選択したパラメーターを編集します。

  • id

    プロパティを識別する数値 ID を設定します。

    このオプションは、カスタム インターフェイスのプロパティでは使用できません。 詳細については、「MIDL リファレンスのidを参照してください。

  • helpcontext

    コンテキスト ID を指定します。ユーザーはヘルプ ファイルでこのプロパティに関する情報を参照できます。

    詳細については、「MIDL リファレンスのhelpcontextを参照してください。

  • helpstring

    適用先となる要素を記述するために使用される文字列を指定します。 既定では、 propertyProperty name です。

    詳細については、「MIDL リファレンスのhelpstringを参照してください。

ストック プロパティ

MFC ディスパッチ インターフェイスにプロパティを追加する場合は、 Property 名 ドロップダウン リストから次のいずれかのストック プロパティを選択できます。

プロパティ名 説明
Appearance コントロールの外観を決定する値を返すか設定します。
コントロールの Appearance プロパティには、3D 表示効果を含めることも省略することもできます。 このプロパティはアンビエント読み取り/書き込みプロパティです。
BackColor コントロールのアンビエント BackColor プロパティを返すか、パレット (RGB) 色か定義済みのシステム色に設定します。
既定では、その値はコントロールのコンテナーの前景色に一致します。
このプロパティはアンビエント読み取り/書き込みプロパティです。
BorderStyle コントロールの境界線スタイルを返すか設定します。
このプロパティは読み取り/書き込みプロパティです。
Caption コントロールの Caption プロパティを返すか設定します。
このキャプションはウィンドウのタイトルです。 Caption には、メンバー変数実装型がありません。
Enabled コントロールの Enabled プロパティを返すか設定します。
有効コントロールは、ユーザー生成イベントに応答できます。
Font コントロールのアンビエント フォントを返すか設定します。
Null コントロールにフォントがない場合は 。
ForeColor コントロールのアンビエント ForeColor プロパティを返すか設定します。
hWnd コントロールの hWnd プロパティを返すか設定します。
Member 変数実装型がありません。
ReadyState コントロールの ReadyState プロパティを返すか設定します。
コントロールの状態には、「初期化されていません」、「初期化されています」、「読み込んでいます」、「インタラクティブ」、「完了」があります。
詳細については、インターネット SDK の READYSTATE に関するページを参照してください。
Text コントロールに格納されているテキストを返すか設定します。
Member 変数実装型がありません。

参照

プロパティを追加する

IDL プロパティの追加