MFC ActiveX コントロール : ActiveX コントロールにおけるデータ連結の使用

[アーティクル]
02/21/2013

ActiveX コントロールよりも強力な使用方法の 1 つが、コントロールのプロパティがデータベースのフィールドにバインドできるようにするデータバインディングです。ユーザーがこのバインディングプロパティのデータを変更すると、コントロールは、データベースを示して、レコードフィールドを更新する必要があります。データベースは、成功のコントロールまたは要求の失敗を通知します。

この技術情報では、タスクのコントロールの横について説明します。データベースとのデータバインディングの対話を実行すると、コントロールコンテナーの役割です。コンテナーのデータベースの対話を管理するか、ここでは詳しく説明しません。どのように準備するときに、データバインディングのコントロールは、この技術情報の他に示します。

データバインドコントロールの概念図

データバインドコントロール

COleControl クラスでを実装するデータバインディングに簡単なプロセスをする 2 とおりのメンバー関数を提供します。最初の関数、 BoundPropertyRequestEditが、プロパティ値を変更できる権限を要求するために使用されます。プロパティ値が正常に変更された後BoundPropertyChangedの 2 番目の関数で呼び出されます。

ここでは、次のトピックについて説明します。

バインドできるストックプロパティの作成
バインドできる作成して取得/設定メソッド

バインドできるストックプロパティの作成

バインドできる取得/設定メソッドの対象となる可能性が高いがデータバインディングのストックプロパティを作成することは可能です。

[!メモ]

ストックプロパティに bindable と requestedit の属性が既定でになります。

バインドできるストックプロパティをプロパティの追加ウィザードを追加するには

MFC ActiveX コントロールウィザードを使用してプロジェクトを開始します。
コントロールのインターフェイスノードを右クリックします。

これは、ショートカットメニューが開きます。
ショートカットメニューのをクリック追加は、 プロパティの追加をクリックします。
プロパティ,Property名前 のドロップダウンリストからエントリの 1 種類を選択します。たとえば、 テキストを選択できます。

テキスト がストックプロパティであるため、 bindable と requestedit の属性は既にチェックされます。
IDL Attributes のタブから、次のチェックボックスをオンにします: プロジェクトの .IDL のプロパティ定義に属性を追加する displaybind と defaultbind です。これらの属性は、コントロールをユーザーに表示されるようにし、ストックプロパティに既定の連結できるプロパティについて説明します。

この時点で、コントロールは、データソースのデータを表示できますが、更新データフィールドにできません。また、コントロールにデータに更新できるようにするには、次のように確認するに OnOcmCommandOnOcmCommand の関数を変更する:

#ifdef _WIN32
   WORD wNotifyCode = HIWORD(wParam);
#else
   WORD wNotifyCode = HIWORD(lParam);
#endif

   if(wNotifyCode==EN_CHANGE)
   {
      if(!BoundPropertyRequestEdit(DISPID_TEXT))
      {
         SetNotSupported();
      }
      else
      {
         GetText();
         // Notify container of change
         BoundPropertyChanged(DISPID_TEXT);
      }
   }

   return 0;

これで、コントロールを登録するプロジェクトをビルドできます。ダイアログボックスにコントロールを挿入すると、 データフィールド と データソース のプロパティが追加され、コントロールに表示する、データソースとフィールドを選択できます。

バインドできる作成して取得/設定メソッド

データバインディングに加えて、バインドできるストックプロパティを作成できます。または、 SET メソッド。

[!メモ]

この手順では、のサブクラスで Windows 制御できる ActiveX コントロールプロジェクトがあるとします。

追加するには、バインドできるプロパティの追加ウィザードを使用して、 get または set メソッド

コントロールプロジェクトを読み込んでください。
Control Settings のページで、サブクラスにコントロールのウィンドウクラスを選択します。たとえば、サブクラスのエディットコントロールが必要になる場合があります。
コントロールプロジェクトを読み込んでください。
コントロールのインターフェイスノードを右クリックします。

これは、ショートカットメニューが開きます。
ショートカットメニューのをクリック追加は、 プロパティの追加をクリックします。
プロパティ名(O),プロパティ名 ボックスのプロパティ名を入力します。この例では、 MyProp を使用します。
プロパティの型,プロパティの種類,プロパティの種類(Y),プロパティ型 のボックスの一覧からデータ型を選択します。この例では、 short を使用します。
Implementation Typeでは、をクリック Get/Set Methods。
IDL 属性のタブから、次のチェックボックスをオンにします: bindable、 requestedit、プロジェクトの .IDL のプロパティ定義に属性を追加する displaybindと defaultbind です。これらの属性は、コントロールをユーザーに表示されるようにし、ストックプロパティに既定の連結できるプロパティについて説明します。
[完了] をクリックします。

次のコードを含むように SetMyProp 関数本体を変更する:

if(!BoundPropertyRequestEdit(1))
{
   SetNotSupported();
   return;
}
else
{
   if(AmbientUserMode()) // SendMessage only at run-time
   {
      _stprintf_s(m_strText.GetBuffer(10), 10, _T("%d"), newVal);
      SetWindowText(m_strText);
      m_strText.ReleaseBuffer();
   }
   else
   {
      InvalidateControl();
   }

   // Signal a property change
   // This is the MFC equivalent of OnChanged()
   BoundPropertyChanged(1);
   SetModifiedFlag();
}

BoundPropertyChanged と BoundPropertyRequestEdit 関数に渡されるパラメーターは .IDL ファイルのプロパティの ID （）属性に渡されるパラメーターのプロパティの dispid です。

OnOcmCommand の関数を変更して、次のコードが含まれています:

#ifdef _WIN32
   WORD wNotifyCode = HIWORD(wParam);
#else
   WORD wNotifyCode = HIWORD(lParam);
#endif

   if(wNotifyCode==EN_CHANGE)
   {
      if(!BoundPropertyRequestEdit(DISPID_TEXT))
      {
         SetNotSupported();
      }
      else
      {
         GetText();
         // Notify container of change
         BoundPropertyChanged(DISPID_TEXT);
      }
   }

   return 0;

次のコードを含むように OnDraw の関数を変更する:

if(!AmbientUserMode())
{
   // Draw the Text property at design-time
   pdc->FillRect(rcBounds, 
      CBrush::FromHandle((HBRUSH)GetStockObject(WHITE_BRUSH)));
   pdc->DrawText(m_strText, -1, (LPRECT)&rcBounds, 
      DT_LEFT | DT_TOP | DT_SINGLELINE);
}
else
{
   DoSuperclassPaint(pdc, rcBounds);
}

ヘッダーファイルのパブリックセクションにコントロールクラスのヘッダーファイルは、メンバー変数の次の定義（コンストラクター）を追加します:
```
CString m_strText;
short m_nMyNum;
```
次の行に DoPropExchange の最後の行を機能する:
```
PX_String(pPX, _T("MyProp"), m_strText);
```

次のコードを含むように OnResetState の関数を変更する:

    COleControl::OnResetState();  // Resets defaults found in DoPropExchange
   m_strText = AmbientDisplayName();

次のコードを含むように GetMyProp の関数を変更する:

if(AmbientUserMode())
{
   GetWindowText(m_strText);
   m_nMyNum = (short)_ttoi(m_strText);
}
return m_nMyNum;

参照

概念

MFC ActiveX コントロール

次の方法で共有

MFC ActiveX コントロール : ActiveX コントロールにおけるデータ連結の使用

バインドできるストックプロパティの作成

バインドできるストックプロパティをプロパティの追加ウィザードを追加するには

バインドできる作成して取得/設定メソッド

追加するには、バインドできるプロパティの追加ウィザードを使用して、 get または set メソッド

参照

関連項目

概念

その他のリソース

次の方法で共有

MFC ActiveX コントロール : ActiveX コントロールにおけるデータ連結の使用

バインドできるストック プロパティの作成

バインドできるストック プロパティをプロパティの追加ウィザードを追加するには

バインドできる作成して取得/設定メソッド

追加するには、バインドできるプロパティの追加ウィザードを使用して、 get または set メソッド

参照

関連項目

概念

その他のリソース

バインドできるストックプロパティの作成

バインドできるストックプロパティをプロパティの追加ウィザードを追加するには