共用方式為

OLEUIINSERTOBJECTA 結構 （oledlg.h）

  • 發行項

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

語法

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
 當使用者選取 [確定] 來關閉對話框時，應該建立新的連結物件，然後使用者核取 [Link] 複選框。
IOF_DISABLELINK
 初始化時將會停用 [Link] 複選框。
IOF_VERIFYSERVERSEXIST
 對話框應該藉由確保註冊資料庫中指定的伺服器存在，來驗證它新增至清單框的類別。 這是一個顯著的效能因素。
IOF_DISABLEDISPLAYASICON
 [顯示為圖示] 複選框將會在初始化時停用。
IOF_HIDECHANGEICON
 [變更圖示] 按鈕將會隱藏 在 [插入物件] 對話框中。
IOF_SHOWINSERTCONTROL
 顯示 [插入控件] 單選按鈕 。
IOF_SELECTCREATECONTROL
 顯示 [建立控件] 單選按鈕 。

hWndOwner

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

lpszCaption

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

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

另請參閱

OleUIInsertObject