COleControlSite::CreateControl

發行項
02/28/2013

建立 ActiveX 控制項，將由 COleControlSite 物件。

virtual HRESULT CreateControl(
   CWnd* pWndCtrl,
   REFCLSID clsid,
   LPCTSTR lpszWindowName,
   DWORD dwStyle,
   const RECT& rect,
   UINT nID,
   CFile* pPersist = NULL,
   BOOL bStorage = FALSE,
   BSTR bstrLicKey = NULL 
);
virtual HRESULT 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 
);

參數

pWndCtrl
out 表示控制項的視窗物件的指標。
clsid
控制項的唯一的類別 ID。
lpszWindowName
要在控制項中顯示之文字的指標。設定 winodw 標頭或文字屬性的值 (如果有的話)。
dwStyle
視窗樣式。可用的樣式清單。備註區段底下。
rect
指定控制項的大小和位置。它可以是 CRect 物件或 RECT 結構。
nID
指定控制項的子視窗 ID.
pPersist
含有控制項的 CFile 的指標持續性 (Persistent) 狀態。預設值為，表示控制項 NULL初始化其本身，而不會還原其從所有持續性儲存體的狀態。如果不是 NULL，它應該是指向 CFile-以資料流或儲存的格式，其中是包含控制項的持續性資料的衍生物件。此資料儲存在用戶端上的啟動過程可能已儲存。 CFile 包含其他資料，不過，必須將其讀取/寫入指標設定為第一個位元組持續性資料在呼叫時會 CreateControl。
bStorage
指示是否應該將 pPersist 資料做為 IStorage 或 IStream 資料。如果在 pPersist 的資料是儲存區， bStorage 應該是是。如果在 pPersist 資料為資料流， bStorage 應該是否。預設值為否。
bstrLicKey
選擇性授權金鑰資料。這項資料來建立需要的執行階段授權識別碼的控制項只需要。如果控制項支援授權，您必須為控制項建立提供授權識別碼成功。預設值為 NULL。
ppt
out 包含控制項左上角的點結構的指標。控制項的大小是由值 psize。 ppt 和 psize 值是指定大小選擇性方法並將 opf 控制項。
psize
含有控制項的大小大小結構的指標。左上角打取決於 ppt的值。 ppt 和 psize 值是指定大小選擇性方法並將 opf 控制項。

傳回值

標準 HRESULT 值。

備註

視窗 dwStyle 旗標的子集。 CreateControl支援:

WS_VISIBLE 建立一開始都是可見的視窗。必要項，如果您要立即是可見的控制項，像一般的視窗。
WS_DISABLED 建立初始停用的視窗。已停用的視窗不能接收使用者的輸入。如果控制項有啟用屬性，可將設定為。
WS_BORDER 建立具有儲存線條框線的視窗。如果控制項有 BorderStyle 屬性，可將設定為。
WS_GROUP 指定控制項群組的第一個控制項。您可以使用方向鍵，在使用者群組方式從一個控制項將鍵盤焦點變更到下一個。所有控制項定義為 WS_GROUP 樣式在第一個控制項之後屬於相同群組。使用 WS_GROUP 樣式的下一個控制項的結束群組並開始下一個群組。
WS_TABSTOP 指定可接收鍵盤焦點的控制項，當使用者按下 TAB 鍵。按下 TAB 鍵會將鍵盤焦點變更到 WS_TABSTOP 樣式的下一個控制項。