OLE コントロールの登録

[アーティクル]
07/05/2024

OLE コントロールは、他の OLE サーバーオブジェクトと同様に、他の OLE 対応アプリケーションからアクセスできます。これは、コントロールのタイプライブラリとクラスを登録することによって実現されます。

次の関数を使用すると、Windows 登録データベースにコントロールのクラス、プロパティページ、およびタイプライブラリを追加および削除できます。

OLE コントロールの登録

名前	説明
AfxOleRegisterControlClass	登録データベースにコントロールのクラスを追加します。
AfxOleRegisterPropertyPageClass	登録データベースにコントロールプロパティページを追加します。
AfxOleRegisterTypeLib	コントロールのタイプライブラリを登録データベースに追加します。
AfxOleUnregisterClass	登録データベースからコントロールクラスまたはプロパティページクラスを削除します。
AfxOleUnregisterTypeLib	登録データベースからコントロールのタイプライブラリを削除します。

AfxOleRegisterTypeLib は、通常、 DllRegisterServerのコントロール DLL の実装で呼び出されます。同様に、 AfxOleUnregisterTypeLib は DllUnregisterServerによって呼び出されます。 AfxOleRegisterControlClass、 AfxOleRegisterPropertyPageClass、および AfxOleUnregisterClass は、通常、コントロールのクラスファクトリまたはプロパティページの UpdateRegistry メンバー関数によって呼び出されます。

AfxOleRegisterControlClass

コントロールクラスを Windows 登録データベースに登録します。

BOOL AFXAPI AfxOleRegisterControlClass(
    HINSTANCE hInstance,
    REFCLSID clsid,
    LPCTSTR pszProgID,
    UINT idTypeName,
    UINT idBitmap,
    int nRegFlags,
    DWORD dwMiscStatus,
    REFGUID tlid,
    WORD wVerMajor,
    WORD wVerMinor);

パラメーター

hinstance
コントロールクラスに関連付けられているモジュールのインスタンスハンドル。

clsid
コントロールの一意のクラス ID。

pszProgID
コントロールの一意のプログラム ID。

idTypeName
コントロールのユーザーが読み取り可能な型名を含む文字列のリソース ID。

idBitmap
ツールバーまたはパレットで OLE コントロールを表すために使用されるビットマップのリソース ID。

nRegFlags
次のフラグの 1 つ以上が含まれています。

afxRegInsertable OLE オブジェクトの [オブジェクトの挿入] ダイアログボックスにコントロールを表示できるようにします。
afxRegApartmentThreading レジストリ内のスレッドモデルを ThreadingModel=Apartment に設定します。
afxRegFreeThreading レジストリ内のスレッドモデルを ThreadingModel=Free に設定します。

2 つのフラグ afxRegApartmentThreading と afxRegFreeThreading を組み合わせて ThreadingModel=Both を設定できます。スレッドモデルの登録の詳細については、Windows SDK の InprocServer32 を参照してください。

Note

MFC 4.2 より前の MFC バージョンでは、 int nRegFlags パラメーターは BOOL パラメーター bInsertable で、[オブジェクトの挿入] ダイアログボックスからのコントロールの挿入を許可または禁止していました。

dwMiscStatus
次の 1 つ以上の状態フラグが含まれています (フラグの説明については、Windows SDK の OLEMISC 列挙型を参照してください)。

OLEMISC_RECOMPOSEONRESIZE
OLEMISC_ONLYICONIC
OLEMISC_INSERTNOTREPLACE
OLEMISC_STATIC
OLEMISC_CANTLINKINSIDE
OLEMISC_CANLINKBYOLE1
OLEMISC_ISLINKOBJECT
OLEMISC_INSIDEOUT
OLEMISC_ACTIVATEWHENVISIBLE
OLEMISC_RENDERINGISDEVICEINDEPENDENT
OLEMISC_INVISIBLEATRUNTIME
OLEMISC_ALWAYSRUN
OLEMISC_ACTSLIKEBUTTON
OLEMISC_ACTSLIKELABEL
OLEMISC_NOUIACTIVATE
OLEMISC_ALIGNABLE
OLEMISC_IMEMODE
OLEMISC_SIMPLEFRAME
OLEMISC_SETCLIENTSITEFIRST

tlid
コントロールクラスの一意の ID。

wVerMajor
コントロールクラスのメジャーバージョン番号。

wVerMinor
コントロールクラスのマイナーバージョン番号。

戻り値

コントロールクラスが登録されている場合は 0 以外。それ以外の場合は 0。

解説

これにより、OLE コントロールに対応するコンテナーでコントロールを使用できます。 AfxOleRegisterControlClass は、システム上のコントロールの名前と場所を使用してレジストリを更新し、コントロールがレジストリでサポートするスレッドモデルも設定します。詳細については、Windows SDK の「テクニカルノート 64、「OLE コントロールのアパートメントモデルスレッド」、および「プロセスとスレッド」を参照してください。

例

// Member function implementation of class COleObjectFactory::UpdateRegistry
//
BOOL CMyAxCtrl::CMyAxCtrlFactory::UpdateRegistry(BOOL bRegister)
{
   // TODO: Verify that your control follows apartment-model threading rules.
   // Refer to MFC TechNote 64 for more information.
   // If your control does not conform to the apartment-model rules, then
   // you must modify the code below, changing the 6th parameter from
   // afxRegInsertable | afxRegApartmentThreading to afxRegInsertable.

   if (bRegister)
      return AfxOleRegisterControlClass(
          AfxGetInstanceHandle(),
          m_clsid,
          m_lpszProgID,
          IDS_NVC_MFCAXCTL,
          IDB_NVC_MFCAXCTL,
          afxRegInsertable | afxRegApartmentThreading,
          _dwMyOleMisc,
          _tlid,
          _wVerMajor,
          _wVerMinor);
   else
      return AfxOleUnregisterClass(m_clsid, m_lpszProgID);
}

上の例では、挿入可能なフラグとアパートメントモデルの ORed のフラグを一緒に使用して 6 番目のパラメーターを作成する AfxOleRegisterControlClass を呼び出す方法を示します。

afxRegInsertable | afxRegApartmentThreading,

このコントロールは、有効なコンテナーの [オブジェクトの挿入] ダイアログボックスに表示され、アパートメントモデルに対応します。アパートメントモデル対応コントロールでは、静的クラスデータがロックによって保護されていることを確認する必要があります。そのため、あるアパートメントのコントロールが静的データにアクセスしている間は、スケジューラによって無効にされず、同じクラスの別のインスタンスが同じ静的データの使用を開始します。静的データへのアクセスはすべて、重要なセクションコードで囲まれます。

要件

Header afxctl.h

AfxOleRegisterPropertyPageClass

プロパティページクラスを Windows 登録データベースに登録します。

BOOL AFXAPI AfxOleRegisterPropertyPageClass(
   HINSTANCE hInstance,
   REFCLSID  clsid,
   UINT idTypeName,
   int nRegFlags);

パラメーター

hinstance
プロパティページクラスに関連付けられているモジュールのインスタンスハンドル。

clsid
プロパティページの一意のクラス ID。

idTypeName
プロパティページのユーザーが読み取り可能な名前を含む文字列のリソース ID。

nRegFlags
フラグを含む場合があります。

afxRegApartmentThreading レジストリ内のスレッドモデルを ThreadingModel = Apartment に設定します。

Note

MFC 4.2 より前のバージョンの MFC では、 int nRegFlags パラメーターを使用できませんでした。また、 afxRegInsertable フラグはプロパティページの有効なオプションではなく、設定されている場合は MFC で ASSERT が発生します。

戻り値

コントロールクラスが登録されている場合は 0 以外。それ以外の場合は 0。

解説

これにより、OLE コントロール対応のコンテナーでプロパティページを使用できます。 AfxOleRegisterPropertyPageClass は、プロパティページ名とシステム上の場所を使用してレジストリを更新し、コントロールがレジストリでサポートするスレッドモデルも設定します。詳細については、Windows SDK の「テクニカルノート 64、「OLE コントロールのアパートメントモデルスレッド」、および「プロセスとスレッド」を参照してください。

要件

Header afxctl.h

AfxOleRegisterTypeLib

タイプライブラリを Windows 登録データベースに登録し、OLE コントロール対応の他のコンテナーでタイプライブラリを使用できるようにします。

BOOL AfxOleRegisterTypeLib(
    HINSTANCE hInstance,
    REFGUID tlid,
    LPCTSTR pszFileName = NULL,
    LPCTSTR pszHelpDir  = NULL);

パラメーター

hinstance
タイプライブラリに関連付けられているアプリケーションのインスタンスハンドル。

tlid
タイプライブラリの一意の ID。

pszFileName
ローカライズされたタイプライブラリ (.コントロールの TLB) ファイル。

pszHelpDir
タイプライブラリのヘルプファイルが見つかるディレクトリの名前。 NULL の場合、ヘルプファイルはタイプライブラリ自体と同じディレクトリ内にあると見なされます。

戻り値

タイプライブラリが登録されている場合は 0 以外。それ以外の場合は 0。

解説

この関数は、タイプライブラリ名とシステム上の場所を使用してレジストリを更新します。

例

// Type library guid definition.
const GUID CDECL BASED_CODE _tlid =
{ 0x77E58ED8, 0xA2C0, 0x4C13, { 0xB6, 0xC1, 0xBA, 0xD1, 0x19, 0xAF, 0xE3, 0xF1 } };

// Registers type library and the interfaces
// in it, afxctl.h needs to be included
if (!AfxOleRegisterTypeLib(AfxGetInstanceHandle(), _tlid))
return ResultFromScode(SELFREG_E_TYPELIB);


// CMFCAutomation.tlb should be in the same directory as exe module.
// last param can be null if help file associated w/ tlb is in same dir as .tlb
if (!AfxOleRegisterTypeLib(AfxGetInstanceHandle(), _tlid,
   _T("CMFCAutomation.tlb"), NULL))
{
   return ResultFromScode(SELFREG_E_TYPELIB);
}

要件

Header afxdisp.h

AfxOleUnregisterClass

Windows 登録データベースからコントロールまたはプロパティページクラスエントリを削除します。

BOOL AFXAPI AfxOleUnregisterClass(REFCLSID clsID, LPCSTR pszProgID);

パラメーター

clsID
コントロールまたはプロパティページの一意のクラス ID。

pszProgID
コントロールまたはプロパティページの一意のプログラム ID。

戻り値

コントロールまたはプロパティページクラスが正常に登録解除された場合は 0 以外。それ以外の場合は 0。

要件

Header afxctl.h

AfxOleUnregisterTypeLib

この関数を呼び出して、Windows 登録データベースからタイプライブラリエントリを削除します。

BOOL AFXAPI AfxOleUnregisterTypeLib(REFGUID tlID);

パラメーター

tlID
タイプライブラリの一意の ID。

戻り値

タイプライブラリの登録が正常に解除された場合は 0 以外。それ以外の場合は 0。

例

// Type library GUID, corresponds to the uuid attribute of the library
// section in the .odl file.
const GUID CDECL BASED_CODE _tlid =
    {0xA44774E8, 0xAE00, 0x451F, {0x96, 0x1D, 0xC7, 0xD2, 0xD2, 0x58, 0xA0, 0x75}};

// Type library major version number, number on the left of decimal
// point, in version attribute of the library section in .odl file.
const WORD _wVerMajor = 1;

// Type library minor version number, number on the right of decimal
// point, in version attribute of the library section in .odl file.
const WORD _wVerMinor = 0;

STDAPI DllUnregisterServer(void)
{
   AFX_MANAGE_STATE(_afxModuleAddrThis);

   if (!AfxOleUnregisterTypeLib(_tlid, _wVerMajor, _wVerMinor))
      return ResultFromScode(SELFREG_E_TYPELIB);

   if (!COleObjectFactoryEx::UpdateRegistryAll(FALSE))
      return ResultFromScode(SELFREG_E_CLASS);

   return NOERROR;
}

要件

Header afxdisp.h

次の方法で共有

OLE コントロールの登録

OLE コントロールの登録

AfxOleRegisterControlClass

パラメーター

戻り値

解説

例

要件

AfxOleRegisterPropertyPageClass

パラメーター

戻り値

解説

要件

AfxOleRegisterTypeLib

パラメーター

戻り値

解説

例

要件

AfxOleUnregisterClass

パラメーター

戻り値

要件

AfxOleUnregisterTypeLib

パラメーター

戻り値

例

要件

関連項目

フィードバック

その他のリソース