共用方式為

OLEUICHANGESOURCEA 結構 (oledlg.h)

  • 發行項

包含用來初始化標準 [變更來源 ] 對話框的資訊。 它可讓使用者修改連結的目的地或來源。 這可能只需要為連結選取不同的檔名，或可能變更檔案內的項目參考，例如變更連結所要之電子表格內單元格的目的地範圍。

語法

typedef struct tagOLEUICHANGESOURCEA {
  DWORD                 cbStruct;
  DWORD                 dwFlags;
  HWND                  hWndOwner;
  LPCSTR                lpszCaption;
  LPFNOLEUIHOOK         lpfnHook;
  LPARAM                lCustData;
  HINSTANCE             hInstance;
  LPCSTR                lpszTemplate;
  HRSRC                 hResource;
  OPENFILENAMEA         *lpOFN;
  DWORD                 dwReserved1[4];
  LPOLEUILINKCONTAINERA lpOleUILinkContainer;
  DWORD                 dwLink;
  LPSTR                 lpszDisplayName;
  ULONG                 nFileLength;
  LPSTR                 lpszFrom;
  LPSTR                 lpszTo;
} OLEUICHANGESOURCEA, *POLEUICHANGESOURCEA, *LPOLEUICHANGESOURCEA;

成員

cbStruct

結構的大小，以位元組為單位。

dwFlags

在輸入時，此欄位會指定初始化和建立旗標。 結束時，它會指定用戶的選項。 這可能是下列旗標的組合。

值 意義
CSF_SHOWHELP
 啟用或顯示 [說明] 按鈕。
CSF_VALIDSOURCE
 指出已驗證連結。
CSF_ONLYGETSOURCE
 當使用者按下 [確定] 時，停用連結來源的自動驗證。 如果您指定此旗標，則當對話框傳回 [確定] 時，應該驗證來源。

hWndOwner

擁有對話框的視窗。

lpszCaption

要作為對話框標題的字串指標。 如果 為 NULL，則連結庫會使用 變更來源。

lpfnHook

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

lCustData

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

hInstance

實例，其中包含 lpszTemplate 成員所指定的對話框範本。 如果 lpszTemplate 成員為 NULL 或無效，則會忽略這個成員。

lpszTemplate

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

hResource

自訂對話框的資源句柄。 如果這個成員是 NULL，則連結庫會使用標準 [轉換 ] 對話框範本，如果它是有效的，則連結庫是由 lpszTemplate 成員命名的範本。

lpOFN

OPENFILENAME 結構的指標，其中包含作業系統用來初始化系統定義的 [開啟] 或 [另存新檔] 對話框的資訊。

dwReserved1[4]

此成員已保留。

lpOleUILinkContainer

用來驗證連結來源之 IOleUILinkContainer 介面之容器實作的指標。 [ 編輯連結 ] 對話框會使用此對話框來允許容器操作其連結。

dwLink

用來驗證連結來源的容器定義唯一鏈接標識碼。 由 lpOleUILinkContainer 使用。

lpszDisplayName

完整來源顯示名稱的指標。

nFileLength

lpszDisplayName 的檔案 Moniker 部分。

lpszFrom

已變更來源前置詞的指標。

lpszTo

要變更之來源前置詞的指標。

備註

注意

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

規格需求

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

另請參閱

IOleUILinkContainer

OleUIChangeSource