共用方式為

OLEUIINSERTOBJECTW 結構 (oledlg.h)

  • 發行項

包含 OLE 使用者介面連結庫用來初始化 [插入物件 ] 對話框的資訊，以及當對話框關閉時，連結庫傳回資訊的空間。

語法

typedef struct tagOLEUIINSERTOBJECTW {
  DWORD           cbStruct;
  DWORD           dwFlags;
  HWND            hWndOwner;
  LPCWSTR         lpszCaption;
  LPFNOLEUIHOOK   lpfnHook;
  LPARAM          lCustData;
  HINSTANCE       hInstance;
  LPCWSTR         lpszTemplate;
  HRSRC           hResource;
  CLSID           clsid;
  LPWSTR          lpszFile;
  UINT            cchFile;
  UINT            cClsidExclude;
  LPCLSID         lpClsidExclude;
  IID             iid;
  DWORD           oleRender;
  LPFORMATETC     lpFormatEtc;
  LPOLECLIENTSITE lpIOleClientSite;
  LPSTORAGE       lpIStorage;
  LPVOID          *ppvObj;
  SCODE           sc;
  HGLOBAL         hMetaPict;
} OLEUIINSERTOBJECTW, *POLEUIINSERTOBJECTW, *LPOLEUIINSERTOBJECTW;

成員

cbStruct

結構的大小，以位元組為單位。 此欄位必須在輸入時填入。

dwFlags

在輸入上，指定初始化和建立旗標。 結束時，指定用戶的選擇。 它可以是下列旗標的組合。

值 意義
IOF_SHOWHELP
 對話框會顯示 [ 說明 ] 按鈕。
IOF_SELECTCREATENEW
 一開始會核取 [ 建立新] 單選按鈕。 這無法與IOF_SELECTCREATEFROMFILE搭配使用。
IOF_SELECTCREATEFROMFILE
 一開始會核取 [ 從檔案建立 ] 單選按鈕。 這無法與IOF_SELECTCREATENEW搭配使用。
IOF_CHECKLINK
 一開始會核取 [ 鏈接 ] 複選框。
IOF_CHECKDISPLAYASICON
 一開始會核取 [ 顯示為圖示 ] 複選框、顯示目前的圖示，並啟用 [變更圖示 ] 按鈕。
IOF_CREATENEWOBJECT
 當使用者選取 [ 確定 ] 以關閉對話框並選取 [ 建立新 ] 單選按鈕時，應該建立新的 物件。
IOF_CREATEFILEOBJECT
 當使用者選取 [ 確定 ] 以關閉對話框並選取 [ 從檔案 建立] 單選按鈕時，應該從指定的檔案建立新的 物件。
IOF_CREATELINKOBJECT
 當使用者選取 [ 確定 ] 以關閉對話框，且使用者已核取 [ 連結 ] 複選框時，應該建立新的鏈接物件。
IOF_DISABLELINK
 初始化時將會停用 [連結 ] 複選框。
IOF_VERIFYSERVERSEXIST
 對話框應該藉由確保註冊資料庫中指定的伺服器存在，來驗證它新增至 listbox 的類別。 這是顯著的效能因素。
IOF_DISABLEDISPLAYASICON
 初始化時將會停用 [ 顯示為圖示 ] 複選框。
IOF_HIDECHANGEICON
 [ 變更圖示] 按鈕將會隱藏在 [ 插入物件 ] 對話框中。
IOF_SHOWINSERTCONTROL
 顯示 [ 插入控件] 單選按鈕。
IOF_SELECTCREATECONTROL
 顯示 [ 建立控件] 單選按鈕。

hWndOwner

擁有對話框的視窗。 此成員不應為 NULL。

lpszCaption

要當做對話框標題之字串的指標。 如果 為 NULL，則連結庫會使用 Insert 物件。

lpfnHook

攔截函式的指標，此函式會處理用於對話框的訊息。 攔截函式必須傳回零，才能將它未處理的訊息傳回連結庫中的對話框程式。 攔截函式必須傳回非零值，以防止連結庫的對話框程式處理已經處理的訊息。

lCustData

連結庫傳遞給 lpfnHook 成員所指向之攔截函式的應用程式定義數據。 連結庫會在WM_INITDIALOG訊息的 lParam 參數中傳遞 OLEUIINSERTOBJECT 結構的指標;這個指標可用來擷取 lCustData 成員。

hInstance

實例，其中包含 由 lpTemplateName 成員指定的對話框範本。

lpszTemplate

Null 終止字串的指標，指定要取代連結庫之 [插入物件 ] 對話框範本之對話框範本之資源檔的名稱。

hResource

自定義範本句柄。

clsid

要插入之物件的類別 CLSID。 在輸出上填滿。

lpszFile

要連結或內嵌之檔名的指標。 在輸出上填滿。

cchFile

lpszFile 緩衝區的大小;不會超過MAX_PATH。

cClsidExclude

包含在 lpClsidExclude 清單中的 CLSID 數目。 填入輸入。

lpClsidExclude

要從清單中排除之 CLID 清單的指標。

iid

要求的介面標識碼。 如果 OleUIInsertObject 建立物件，則會傳回這個介面的指標。 如果 OleUIInsertObject 未建立物件，則會忽略此參數。

oleRender

轉譯選項。 如果 OleUIInsertObject 建立物件，則會在建立物件時選取轉譯選項。 如果 OleUIInsertObject 未建立物件，則會忽略此參數。

lpFormatEtc

所需的格式。 如果 OleUIInsertObject 建立物件，則會在建立物件時選取格式。 如果 OleUIInsertObject 未建立物件，則會忽略此參數。

lpIOleClientSite

要用於物件的用戶端月臺指標。 如果 OleUIInsertObject 未建立物件，則會忽略此參數。

lpIStorage

要用於物件的記憶體指標。 如果 OleUIInsertObject 未建立物件，則會忽略此參數。

ppvObj

輸出指標變數的位址，其中包含要插入之物件的介面指標。 如果 OleUIInsertObject 未建立物件，則會忽略此參數。

sc

建立呼叫的結果。 如果 OleUIInsertObject 未建立物件，則會忽略此參數。

hMetaPict

包含圖示層面的元檔Pict 結構，如果未放在物件的快取中。

備註

注意

oledlg.h 標頭會根據 UNICODE 預處理器常數的定義，將 OLEUIINSERTOBJECT 定義為別名，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
標頭 oledlg.h

另請參閱

OleUIInsertObject