COleUpdateDialog クラス

  • [アーティクル]

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

構文

class COleUpdateDialog : public COleLinksDialog

メンバー

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

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

パブリック メソッド

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

解説

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

継承階層

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COleLinksDialog

COleUpdateDialog

要件

Header: 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 クラス