COleUpdateDialog クラス

OLE の [リンクの編集] ダイアログ ボックスを使って、ドキュメント内の既存のリンク オブジェクトや埋め込みオブジェクトの更新のみを行います。これは、OLE の [リンクの編集] ダイアログ ボックスの特別な使い方です。

構文

class COleUpdateDialog : public COleLinksDialog

メンバー

パブリック コンストラクター

名前	説明
COleUpdateDialog::COleUpdateDialog	COleUpdateDialog オブジェクトを構築します。

パブリック メソッド

名前	説明
COleUpdateDialog::D oModal	更新モードで [リンクの編集] ダイアログ ボックスを表示します。

解説

OLE 固有のダイアログ ボックスの詳細については、「OLE のダイアログ ボックス」を参照してください。

継承階層

CObject

CCmdTarget

CWnd

Cdialog

CCommonDialog

COleDialog

COleLinksDialog

COleUpdateDialog

必要条件

ヘッダー: afxodlgs.h

COleUpdateDialog::COleUpdateDialog

COleUpdateDialog オブジェクトを構築します。

explicit COleUpdateDialog(
    COleDocument* pDoc,
    BOOL bUpdateLinks = TRUE,
    BOOL bUpdateEmbeddings = FALSE,
    CWnd* pParentWnd = NULL);

パラメーター

pDoc
更新が必要になる可能性があるリンクを含むドキュメントを指します。

bUpdateLinks
リンク オブジェクトを更新するかどうかを決定するフラグ。

bUpdateEmbeddings
埋め込みオブジェクトを更新するかどうかを決定するフラグ。

pParentWnd
ダイアログ オブジェクトが属する親または所有者ウィンドウ オブジェクト (種類 CWnd) を指します。 NULL の場合、ダイアログ ボックスの親ウィンドウは メイン アプリケーション ウィンドウに設定されます。

解説

この関数は、オブジェクトのみを COleUpdateDialog 構築します。 ダイアログ ボックスを表示するには、DoModal を呼び出します。 このクラスは、既存の COleLinksDialog リンクまたは埋め込みアイテムのみを更新する場合ではなく使用する必要があります。

COleUpdateDialog::D oModal

[リンクの編集] ダイアログ ボックスを更新モードで表示します。

virtual INT_PTR DoModal();

戻り値

ダイアログ ボックスの完了状態。 次のいずれかの値:

• ダイアログ ボックスが正常に返された場合は IDOK。

• 現在のドキュメント内のリンクされた項目または埋め込みアイテムのいずれも更新する必要がない場合は IDCANCEL。

• エラーが発生した場合は IDABORT。 IDABORT が返された場合は、COleDialog::GetLastError メンバー関数を呼び出して、発生したエラーの種類に関する詳細情報を取得します。 考えられるエラーの一覧については、Windows SDK の OleUIEditLinks 関数を参照してください。

解説

ユーザーが [キャンセル] ボタンを選択しない限り、リンクや埋め込みはすべて更新されます。

関連項目

MFC サンプル OCLIENT
COleLinksDialog クラス
階層図
COleLinksDialog クラス