COleControlContainer::CreateControl

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

COleControlSite の指定したオブジェクトがホストする ActiveX コントロールを作成します。

BOOL CreateControl(
   CWnd* pWndCtrl,
   REFCLSID clsid,
   LPCTSTR lpszWindowName,
   DWORD dwStyle,
   const RECT& rect,
   UINT nID,
   CFile* pPersist=NULL,
   BOOL bStorage=FALSE,
   BSTR bstrLicKey=NULL,
   COleControlSite** ppNewSite=NULL 
);
BOOL CreateControl(
   CWnd* pWndCtrl,
   REFCLSID clsid,
   LPCTSTR lpszWindowName,
   DWORD dwStyle,
   const POINT* ppt,
   const SIZE* psize,
   UINT nID,
   CFile* pPersist=NULL,
   BOOL bStorage=FALSE,
   BSTR bstrLicKey=NULL,
   COleControlSite** ppNewSite=NULL 
);

パラメーター

pWndCtrl
コントロールウィンドウを表すオブジェクトへのポインター。
clsid
コントロール固有のクラス ID。
lpszWindowName
コントロールに表示するテキストへのポインター。コントロールのキャプションまたはテキストプロパティの値を設定します (存在する場合)。null、コントロールのキャプションまたはテキストプロパティを変更する。
dwStyle
Windows のスタイル。使用できるスタイルは [コメント] のセクションに表示されます。
rect
コントロールのサイズと位置を指定します。これは CRect のオブジェクトまたは RECT の構造体のいずれかです。
nID
コントロールの子ウィンドウ ID を指定します。
pPersist
コントロールの永続的な状態を含む CFile へのポインター。既定では、コントロールを永続ストレージで状態を復元せずに、自身を初期化することを示す nullです。nullない場合は CFileへのポインター。コントロールの永続データを含む派生オブジェクトの場合、ストリームやストレージの形式で。このデータは、クライアントの前にアクティブ化に保存されている可能性があります。CFile そのほかのデータを含めることができますが、読み取り/書き込みポインターを CreateControlに呼び出し時の永続データの最初のバイトに設定されている必要があります。
bStorage
pPersist のデータが IStorage か IStream のデータとして解釈する必要があるかどうかを示します。pPersist のデータストレージがの場合、bStorage は **[真]**必要があります。pPersist のデータストリームがの場合、bStorage は FALSE必要があります。既定値は FALSEです。
bstrLicKey
省略可能なライセンスキーデータ。このデータは、ランタイムライセンスキーを必要とするコントロールを作成する場合にのみ必要です。コントロールがライセンス処理をサポートする場合、コントロールの作成に成功するライセンスキーを提供する必要があります。既定値は NULL です。
ppNewSite
作成されるコントロールをホストする既存のコントロールへのポインター。既定値は新しいコントロールサイトが新しいコントロールに自動的に作成され、アタッチされていることを示す nullです。
ppt
コントロールの左上隅を含む [ポイント] の構造体へのポインター。コントロールのサイズは、の値によって決まります。psizeppt は値とのサイズを指定するオプションのメソッドとコントロールの位置 psize。
psize
コントロールのサイズを含む サイズ変更 の構造体へのポインター。左上隅は pptの値によって決定されます。ppt は値とのサイズを指定するオプションのメソッドとコントロールの位置 psize。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

Windows dwStyle のフラグのサブセットのみ CreateControlによってサポートされます:

WS_VISIBLE は最初に表示するウィンドウを作成します。コントロールには表示されませんが、すぐに場合は、通常のウィンドウと同様に、必ず指定します。
WS_DISABLED は、最初に無効にするウィンドウを作成します。無効なウィンドウは、ユーザーから入力を受け取ることができません。コントロールが有効なプロパティを設定して設定できます。
WS_BORDER は薄型の境界線を表示するウィンドウを作成します。コントロールが BorderStyle のプロパティを設定して設定できます。
WS_GROUP は、コントロールのグループの最初のコントロールを指定します。ユーザーは方向キーを使用してグループの 1 種類のコントロールから次がキーボードフォーカスを変更できます。最初のコントロールの後に WS_GROUP のスタイルに定義されているすべてのコントロールは、同じグループに属しています。WS_GROUP のスタイルの次のコントロールは、のグループを終了し、次のグループを開始します。
WS_TABSTOP、ユーザーが Tab キーを押すとキーボードフォーカスを取得できるコントロールを指定します。Tab キーを押すと、WS_TABSTOP のスタイルの次のコントロールにキーボードフォーカスを変更します。

既定のサイズのコントロールを作成するには、2 番目のオーバーロードを使用します。

必要条件

ヘッダー : afxocc.h

次の方法で共有

COleControlContainer::CreateControl

パラメーター

戻り値

解説

必要条件

参照

関連項目

その他のリソース