COleChangeSourceDialog 類別
用於 OLE 的 [變更來源] 對話方塊。
語法
class COleChangeSourceDialog : public COleDialog
成員
公用建構函式
| 名稱 | 描述 |
|---|---|
| COleChangeSourceDialog：：COleChangeSourceDialog | 建構 COleChangeSourceDialog 物件。 |
公用方法
| 名稱 | 描述 |
|---|---|
| COleChangeSourceDialog：:D oModal | 顯示 [OLE 變更來源] 對話框。 |
| COleChangeSourceDialog：：GetDisplayName | 取得完整的來源顯示名稱。 |
| COleChangeSourceDialog：：GetFileName | 從來源名稱取得檔名。 |
| COleChangeSourceDialog：：GetFromPrefix | 取得上一個來源的前置詞。 |
| COleChangeSourceDialog：：GetItemName | 從來源名稱取得項目名稱。 |
| COleChangeSourceDialog：：GetToPrefix | 取得新來源的前置詞 |
| COleChangeSourceDialog：：IsValidSource | 指出來源是否有效。 |
公用資料成員
| 名稱 | 描述 |
|---|---|
| COleChangeSourceDialog：：m_cs | 結構，控制對話框的行為。 |
備註
當您要呼叫此對話框時，請建立 類別 COleChangeSourceDialog 的物件。 COleChangeSourceDialog建構 物件之後，您可以使用 m_cs 結構來初始化對話框中控件的值或狀態。 結構 m_cs 的類型為 OLEUICHANGESOURCE。 如需使用此對話框類別的詳細資訊，請參閱 DoModal 成員函式。
如需詳細資訊，請參閱 Windows SDK 中的 OLEUICHANGESOURCE 結構。
如需 OLE 特定對話框的詳細資訊，請參閱 OLE 中的對話框一文。
繼承階層架構
COleChangeSourceDialog
需求
標頭： afxodlgs.h
COleChangeSourceDialog：：COleChangeSourceDialog
此函式會 COleChangeSourceDialog 建構物件。
explicit COleChangeSourceDialog(
COleClientItem* pItem,
CWnd* pParentWnd = NULL);
參數
pItem
要更新來源的連結 COleClientItem 指標。
pParentWnd
指向對話框物件所屬的父視窗對象或擁有者視窗物件（屬於類型 CWnd）。 如果是 NULL，對話框的父視窗將會設定為主要應用程式視窗。
備註
若要顯示對話框，請呼叫 DoModal 函 式。
如需詳細資訊，請參閱 Windows SDK 中的 OLEUICHANGESOURCE 結構和 OleUIChangeSource 函式。
COleChangeSourceDialog：:D oModal
呼叫此函式以顯示 [OLE 變更來源] 對話框。
virtual INT_PTR DoModal();
傳回值
對話框的完成狀態。 下列其中一個值：
如果對話框已成功顯示，則為IDOK。
如果使用者取消對話框，IDCANCEL。
如果發生錯誤，則為IDABORT。 如果傳回IDABORT，請呼叫 COleDialog：：GetLastError 成員函式，以取得所發生錯誤類型的詳細資訊。 如需可能錯誤的清單，請參閱 Windows SDK 中的 OleUIChangeSource 函式。
備註
如果您要藉由設定 m_cs 結構的成員來初始化各種對話框控制件，您應該先執行此動作，再呼叫 DoModal，但在建構對話框對象之後。
如果 DoModal 傳回 IDOK，您可以呼叫成員函式，從對話框中擷取使用者輸入的設定或資訊。 下列清單會命名一般查詢函式：
COleChangeSourceDialog：：GetDisplayName
呼叫此函式以擷取連結客戶端專案的完整顯示名稱。
CString GetDisplayName();
傳回值
建構函式中指定的 COleClientItem 的完整來源顯示名稱 （moniker）。
COleChangeSourceDialog：：GetFileName
呼叫此函式，以擷取連結客戶端項目顯示名稱的檔案Moniker部分。
CString GetFileName();
傳回值
建構函式中所指定 COleClientItem 之來源顯示名稱的檔案 Moniker 部分。
備註
檔案Moniker與專案Moniker一起提供完整的顯示名稱。
COleChangeSourceDialog：：GetFromPrefix
呼叫此函式以取得來源的上一個前置詞字串。
CString GetFromPrefix();
傳回值
來源的上一個前置詞字串。
備註
只有在 DoModal 傳回 IDOK 之後，才呼叫此函式。
此值直接來自 lpszFrom OLEUICHANGESOURCE 結構的成員。
如需詳細資訊，請參閱 Windows SDK 中的 OLEUICHANGESOURCE 結構。
COleChangeSourceDialog：：GetItemName
呼叫此函式，以擷取連結客戶端項目顯示名稱的專案Moniker部分。
CString GetItemName();
傳回值
建構函式中指定的 COleClientItem 來源顯示名稱的專案 Moniker 部分。
備註
檔案Moniker與專案Moniker一起提供完整的顯示名稱。
COleChangeSourceDialog：：GetToPrefix
呼叫此函式以取得來源的新前置詞字串。
CString GetToPrefix();
傳回值
來源的新前置詞字串。
備註
只有在 DoModal 傳回 IDOK 之後，才呼叫此函式。
此值直接來自 lpszTo OLEUICHANGESOURCE 結構的成員。
如需詳細資訊，請參閱 Windows SDK 中的 OLEUICHANGESOURCE 結構。
COleChangeSourceDialog：：m_cs
此數據成員是 OLEUICHANGESOURCE 類型的結構。
OLEUICHANGESOURCE m_cs;
備註
OLEUICHANGESOURCE 用來控制 [OLE 變更來源] 對話框的行為。 您可以直接修改此結構的成員。
如需詳細資訊，請參閱 Windows SDK 中的 OLEUICHANGESOURCE 結構。
COleChangeSourceDialog：：IsValidSource
呼叫此函式來判斷新來源是否有效。
BOOL IsValidSource();
傳回值
如果新來源有效，則為非零，否則為 0。
備註
只有在 DoModal 傳回 IDOK 之後，才呼叫此函式。
如需詳細資訊，請參閱 Windows SDK 中的 OLEUICHANGESOURCE 結構。