共用方式為

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 中的對話方塊一文 。

繼承階層架構

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

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 結構。

另請參閱

COleDialog 類別
階層架構圖表
COleDialog 類別