共用方式為

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
 當使用者按下 [確定]時，停用連結來源的自動驗證。 如果您指定此旗標，當對話框傳回 OK時，您應該驗證來源。

hWndOwner

擁有對話框的視窗。

lpszCaption

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

lpfnHook

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

lCustData

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

hInstance

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

lpszTemplate

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

hResource

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

lpOFN

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

dwReserved1[4]

此成員已保留。

lpOleUILinkContainer

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

dwLink

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

lpszDisplayName

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

nFileLength

lpszDisplayName的檔案 moniker 部分。

lpszFrom

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

lpszTo

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

言論

注意

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

要求

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

另請參閱

IOleUILinkContainer

OleUIChangeSource