共用方式為


COleControlContainer::CreateControl

建立 ActiveX 控制項,將由指定的 COleControlSite 物件。

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
    out 表示控制項的視窗物件的指標。

  • clsid
    控制項的唯一的類別 ID。

  • lpszWindowName
    要在控制項中顯示之文字的指標。 設定控制項的標題文字或屬性的值 (如果有的話)。 如果沒有變更 NULL、控制項的標題、文字屬性。

  • dwStyle
    視窗樣式。 可用的樣式清單。 備註 區段底下。

  • rect
    指定控制項的大小和位置。 它可以是 CRect 物件或 RECT 結構。

  • nID
    指定控制項的子視窗 ID.

  • pPersist
    含有控制項的 CFile 的指標持續性 (Persistent) 狀態。 預設值為,表示控制項 NULL初始化其本身,而不會還原其從所有持續性儲存體的狀態。 如果不是 NULL,它應該是指向 CFile-以資料流或儲存的格式,其中是包含控制項的持續性資料的衍生物件。 此資料儲存在用戶端上的啟動過程可能已儲存。 CFile 包含其他資料,不過,必須將其讀取/寫入指標設定為第一個位元組持續性資料在呼叫時會 CreateControl

  • bStorage
    指示是否應該將 pPersist 資料做為 IStorageIStream 資料。 如果在 pPersist 的資料是儲存區, bStorage 應該是 。 如果在 pPersist 資料為資料流, bStorage 應該是 。 預設值為

  • bstrLicKey
    選擇性授權金鑰資料。 這項資料來建立需要的執行階段授權識別碼的控制項只需要。 如果控制項支援授權,您必須為控制項建立提供授權識別碼成功。 預設值為 NULL

  • ppNewSite
    將裝載的控制項建立的現有網站控制項之的指標。 預設值為,表示 NULL新控制項的網站會自動建立和附加至新的控制項。

  • ppt
    out 包含控制項左上角的 結構的指標。 控制項的大小是由值 psize。 ppt 和 psize 值是指定大小的選擇性控制項的方法和位置。

  • psize
    含有控制項的大小 大小 結構的指標。 左上角打取決於 ppt的值。 ppt 和 psize 值是指定大小的選擇性控制項的方法和位置。

傳回值

如果不是零,則成功,則為 0。

備註

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

  • WS_VISIBLE 建立一開始都是可見的視窗。 必要項,如果您要立即是可見的控制項,像一般的視窗。

  • WS_DISABLED 建立初始停用的視窗。 已停用的視窗不能接收使用者的輸入。 如果控制項有啟用屬性,可將設定為。

  • WS_BORDER 建立具有儲存線條框線的視窗。 如果控制項有 BorderStyle 屬性,可將設定為。

  • WS_GROUP 指定控制項群組的第一個控制項。 您可以使用方向鍵,在使用者群組方式從一個控制項將鍵盤焦點變更到下一個。 所有控制項定義為 WS_GROUP 樣式在第一個控制項之後屬於相同群組。 使用 WS_GROUP 樣式的下一個控制項的結束群組並開始下一個群組。

  • WS_TABSTOP 指定可接收鍵盤焦點的控制項,當使用者按下 TAB 鍵。 按下 TAB 鍵會將鍵盤焦點變更到 WS_TABSTOP 樣式的下一個控制項。

使用第二個多載建立預設大小的控制項。

需求

Header: afxocc.h

請參閱

參考

COleControlContainer 類別

階層架構圖表