COleConvertDialog クラス

  • [アーティクル]

詳細については、Windows SDK の OLEUICONVERT 構造体を参照してください。

構文

class COleConvertDialog : public COleDialog

メンバー

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

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

パブリック メソッド

名前 説明
COleConvertDialog::D oConvert ダイアログ ボックスで指定された変換を実行します。
COleConvertDialog::D oModal [OLE アイテムの変更] ダイアログ ボックスを表示します。
COleConvertDialog::GetClassID 選択した項目に関連付けられている CLSID を取得します。
COleConvertDialog::GetDrawAspect 項目をアイコンとして描画するかどうかを指定します。
COleConvertDialog::GetIconicMetafile このアイテムの象徴的な形式に関連付けられているメタファイルへのハンドルを取得します。
COleConvertDialog::GetSelectionType 選択した選択の種類を取得します。

パブリック データ メンバー

名前 説明
COleConvertDialog::m_cv ダイアログ ボックスの動作を制御する構造体。

解説

Note

アプリケーション ウィザードによって生成されたコンテナー コードでは、このクラスが使用されます。

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

継承階層

CObject

CCmdTarget

CWnd

Cdialog

CCommonDialog

COleDialog

COleConvertDialog

必要条件

ヘッダー: afxodlgs.h

COleConvertDialog::COleConvertDialog

オブジェクトのみを COleConvertDialog 構築します。

explicit COleConvertDialog (
    COleClientItem* pItem,
    DWORD dwFlags = CF_SELECTCONVERTTO,
    CLSID* pClassID = NULL,
    CWnd* pParentWnd = NULL);

パラメーター

pItem
変換またはアクティブ化する項目をポイントします。

dwFlags
作成フラグ。ビットごとの演算子または演算子を使用して組み合わせた次の値の任意の数が含まれます。

  • CF_Standard Edition LECTCONVERTTO ダイアログ ボックスが呼び出されたときに、最初に [変換] ラジオ ボタンが選択されることを指定します。 これが既定です。

  • CF_Standard Edition LECTACTIVATEAS ダイアログ ボックスが呼び出されたときに、最初に [アクティブ化] ラジオ ボタンが選択されることを指定します。

  • CF_Standard Edition TCONVERTDEFAULT 構造体のメンバーm_cvによって clsidConvertDefault CLSID が指定されているクラスが、[変換] ラジオ ボタンを選択したときに、クラス リスト ボックスの既定の選択として使用されるように指定します。

  • CF_Standard Edition TACTIVATEDEFAULT 構造体のメンバーm_cvによって clsidActivateDefault CLSID が指定されているクラスは、[アクティブ化] ラジオ ボタンが選択されているときに、クラス リスト ボックスの既定の選択として使用されるように指定します。

  • CF_SHOWHELPBUTTON ダイアログ ボックスが呼び出されたときに [ヘルプ] ボタンを表示することを指定します。

pClassID
変換またはアクティブ化する項目の CLSID を指します。 NULL の場合、pItem に関連付けられている CLSID が使用されます。

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

解説

ダイアログ ボックスを表示するには、DoModal 関数を呼び出します。

詳細については、CLSID キーと OLEUICONVERT 構造体を参照してください。

COleConvertDialog::D oConvert

DoModal から正常に返された後、この関数を呼び出して、COleClientItem 型のオブジェクトを変換またはアクティブ化します。

BOOL DoConvert(COleClientItem* pItem);

パラメーター

pItem
変換またはアクティブ化する項目をポイントします。 Nll は指定できません。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

アイテムは、[変換] ダイアログ ボックスでユーザーが選択した情報に従って変換またはアクティブ化されます。

COleConvertDialog::D oModal

OLE 変換ダイアログ ボックスを表示するには、この関数を呼び出します。

virtual INT_PTR DoModal();

戻り値

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

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

  • ユーザーがダイアログ ボックスをキャンセルした場合は IDCANCEL。

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

解説

m_cv構造体のメンバーを設定して、さまざまなダイアログ ボックス コントロールを初期化する場合は、呼び出すDoModal前に、ダイアログ オブジェクトが構築された後に行う必要があります。

IDOK が返された場合 DoModal は、他のメンバー関数を呼び出して、ユーザーがダイアログ ボックスに入力した設定または情報を取得できます。

COleConvertDialog::GetClassID

この関数を呼び出して、[変換] ダイアログ ボックスでユーザーが選択した項目に関連付けられている CLSID を取得します。

REFCLSID GetClassID() const;

戻り値

[変換] ダイアログ ボックスで選択した項目に関連付けられている CLSID。

解説

DoModal が IDOK を返した後にのみ、この関数を呼び出します。

詳細については、Windows SDK の CLSID キーを参照してください。

COleConvertDialog::GetDrawAspect

この関数を呼び出して、選択した項目をアイコンとして表示することをユーザーが選択したかどうかを判断します。

DVASPECT GetDrawAspect() const;

戻り値

オブジェクトをレンダリングするために必要なメソッド。

  • DVASPECT_CONTENTアイコンチェックボックスがチェックされていない場合に返されます。

  • DVASPECT_ICON [アイコンとして表示] チェック ボックスがチェックされた場合に返されます。

解説

DoModal が IDOK を返した後にのみ、この関数を呼び出します。

描画の側面の詳細については、Windows SDK の FORMATETC データ構造を参照してください。

COleConvertDialog::GetIconicMetafile

選択した項目の象徴的な側面を含むメタファイルへのハンドルを取得するには、この関数を呼び出します。

HGLOBAL GetIconicMetafile() const;

戻り値

[OK] を選択してダイアログを閉じるときに [アイコンとして表示] チェック ボックスがチェックされた場合は、選択した項目のアイコンの側面を含むメタファイルのハンドル。それ以外の場合は NULL。

COleConvertDialog::GetSelectionType

この関数を呼び出して、[変換] ダイアログ ボックスで選択した変換の種類を決定します。

UINT GetSelectionType() const;

戻り値

選択した項目の種類。

解説

戻り値は、クラスで宣言されている列挙型によってSelectionCOleConvertDialog指定されます。

enum Selection {
    noConversion,
    convertItem,
    activateAs
    };

これらの値の簡単な説明は次のとおりです。

  • COleConvertDialog::noConversion ダイアログ ボックスが取り消されたか、ユーザーが変換を選択しなかった場合に返されます。 IDOK が返された場合 COleConvertDialog::DoModal 、ユーザーが以前に選択したアイコンとは異なるアイコンを選択した可能性があります。

  • COleConvertDialog::convertItem[変換] ラジオ ボタンがチェックされた場合に返され、ユーザーは変換する別の項目を選択しDoModal、IDOK を返しました。

  • COleConvertDialog::activateAs[アクティブ化] ラジオ ボタンがチェックされた場合に返され、ユーザーがアクティブ化する別の項目を選択しDoModal、IDOK を返しました。

COleConvertDialog::m_cv

[変換] ダイアログ ボックスの動作を制御するために使用される OLEUICONVERT 型の構造体。

OLEUICONVERT m_cv;

解説

この構造体のメンバーは、直接またはメンバー関数を使用して変更できます。

詳細については、Windows SDK の OLEUICONVERT 構造体を参照してください。

関連項目

COleDialog クラス
階層図
COleDialog クラス