OLEUIINSERTOBJECTA 結構 (oledlg.h)

  • 發行項

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

語法

typedef struct tagOLEUIINSERTOBJECTA {
  DWORD           cbStruct;
  DWORD           dwFlags;
  HWND            hWndOwner;
  LPCSTR          lpszCaption;
  LPFNOLEUIHOOK   lpfnHook;
  LPARAM          lCustData;
  HINSTANCE       hInstance;
  LPCSTR          lpszTemplate;
  HRSRC           hResource;
  CLSID           clsid;
  LPSTR           lpszFile;
  UINT            cchFile;
  UINT            cClsidExclude;
  LPCLSID         lpClsidExclude;
  IID             iid;
  DWORD           oleRender;
  LPFORMATETC     lpFormatEtc;
  LPOLECLIENTSITE lpIOleClientSite;
  LPSTORAGE       lpIStorage;
  LPVOID          *ppvObj;
  SCODE           sc;
  HGLOBAL         hMetaPict;
} OLEUIINSERTOBJECTA, *POLEUIINSERTOBJECTA, *LPOLEUIINSERTOBJECTA;

成員

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

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

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 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
標頭 oledlg.h

另請參閱

OleUIInsertObject