COleInsertDialog クラス
OLE の [オブジェクトの挿入] ダイアログ ボックスで使用されます。
構文
class COleInsertDialog : public COleDialog
メンバー
パブリック コンストラクター
名前 | 説明 |
---|---|
COleInsertDialog::COleInsertDialog | COleInsertDialog オブジェクトを構築します。 |
パブリック メソッド
名前 | 説明 |
---|---|
COleInsertDialog::CreateItem | ダイアログ ボックスで選択した項目を作成します。 |
COleInsertDialog::D oModal | [OLE オブジェクトの挿入] ダイアログ ボックスを表示します。 |
COleInsertDialog::GetClassID | 選択した項目に関連付けられている CLSID を取得します。 |
COleInsertDialog::GetDrawAspect | 項目をアイコンとして描画するかどうかを示します。 |
COleInsertDialog::GetIconicMetafile | このアイテムの象徴的な形式に関連付けられているメタファイルへのハンドルを取得します。 |
COleInsertDialog::GetPathName | ダイアログ ボックスで選択したファイルへの完全なパスを取得します。 |
COleInsertDialog::GetSelectionType | 選択したオブジェクトの種類を取得します。 |
パブリック データ メンバー
名前 | 説明 |
---|---|
COleInsertDialog::m_io | ダイアログ ボックスの動作を制御する OLEUIIN Standard Edition RTOBJECT 型の構造体。 |
解説
このダイアログ ボックスを呼び出す場合は、クラス COleInsertDialog
のオブジェクトを作成します。 オブジェクトがCOleInsertDialog
構築されたら、m_io構造体を使用して、ダイアログ ボックス内のコントロールの値または状態を初期化できます。 構造体は m_io
OLEUIIN Standard Edition RTOBJECT 型です。 このダイアログ クラスの使用方法の詳細については、DoModal メンバー関数を参照してください。
Note
アプリケーション ウィザードによって生成されたコンテナー コードでは、このクラスが使用されます。
詳細については、Windows SDK の OLEUIIN Standard Edition RTOBJECT 構造体を参照してください。
OLE 固有のダイアログ ボックスの詳細については、「OLE のダイアログ ボックス」を参照してください。
継承階層
COleInsertDialog
必要条件
ヘッダー: afxodlgs.h
COleInsertDialog::COleInsertDialog
この関数は、オブジェクトのみを COleInsertDialog
構築します。
COleInsertDialog (
DWORD dwFlags = IOF_SELECTCREATENEW,
CWnd* pParentWnd = NULL);
パラメーター
dwFlags
ビットごとの OR 演算子を使用して結合する次の値の任意の数を含む作成フラグ。
IOF_SHOWHELP ダイアログ ボックスが呼び出されたときに [ヘルプ] ボタンを表示することを指定します。
IOF_Standard Edition LECTCREATENEW ダイアログ ボックスが呼び出されたときに、[新規作成] ラジオ ボタンが最初に選択されることを指定します。 これは既定値であり、IOF_Standard Edition LECTCREATEFROMFILE では使用できません。
IOF_Standard Edition LECTCREATEFROMFILE ダイアログ ボックスが呼び出されたときに、[ファイルから作成] ラジオ ボタンが最初に選択されることを指定します。 IOF_Standard Edition LECTCREATENEW では使用できません。
IOF_CHECKLINK ダイアログ ボックスが呼び出されたときに、[リンク チェック] ボックスが最初にチェックされるように指定します。
IOF_DISABLELINK ダイアログ ボックスが呼び出されたときにリンク チェック ボックスを無効にすることを指定します。
IOF_CHECKDISPLAYASICON 最初に [アイコンとして表示] チェック ボックスがチェックされ、現在のアイコンが表示され、ダイアログ ボックスが呼び出されたときに [アイコンの変更] ボタンが有効になります。
IOF_VERIFYStandard Edition RVER Standard Edition XIST ダイアログ ボックスが表示される前に登録データベースで指定されたサーバーが存在することを確認することによって、リスト ボックスに追加するクラスを検証する必要があることを指定します。 このフラグを設定すると、パフォーマンスが大幅に低下する可能性があります。
pParentWnd
ダイアログ オブジェクトが属する親または所有者ウィンドウ オブジェクト (種類 CWnd
) を指します。 NULL の場合、ダイアログ オブジェクトの親ウィンドウは メイン アプリケーション ウィンドウに設定されます。
解説
ダイアログ ボックスを表示するには、DoModal 関数を呼び出します。
COleInsertDialog::CreateItem
DoModal が IDOK を返す場合にのみ、この関数を呼び出して COleClientItem 型のオブジェクトを作成します。
BOOL CreateItem(COleClientItem* pItem);
パラメーター
pItem
作成する項目をポイントします。
戻り値
項目が作成された場合は 0 以外。それ以外の場合は 0。
解説
この関数を呼び出す前に COleClientItem
、オブジェクトを割り当てる必要があります。
COleInsertDialog::D oModal
[OLE オブジェクトの挿入] ダイアログ ボックスを表示するには、この関数を呼び出します。
virtual INT_PTR
DoModal();
INT_PTR
DoModal(DWORD dwFlags);
パラメーター
dwFlags
次のいずれかの値:
COleInsertDialog::DocObjectsOnly
は DocObject のみを挿入します。
COleInsertDialog::ControlsOnly
は ActiveX コントロールのみを挿入します。
0 は DocObject コントロールも ActiveX コントロールも挿入しません。 この値は、上記の最初のプロトタイプと同じ実装になります。
戻り値
ダイアログ ボックスの完了状態。 次のいずれかの値:
ダイアログ ボックスが正常に表示された場合は IDOK。
ユーザーがダイアログ ボックスをキャンセルした場合は IDCANCEL。
エラーが発生した場合は IDABORT。 IDABORT が返された場合は、COleDialog::GetLastError メンバー関数を呼び出して、発生したエラーの種類に関する詳細情報を取得します。 考えられるエラーの一覧については、Windows SDK の OleUIInsertObject 関数を参照してください。
解説
m_io構造体のメンバーを設定して、さまざまなダイアログ ボックス コントロールを初期化する場合は、呼び出すDoModal
前に、ダイアログ オブジェクトが構築された後にこれを行う必要があります。
IDOK が返された場合 DoModal
は、他のメンバー関数を呼び出して、ユーザーがダイアログ ボックスに入力した設定または情報を取得できます。
COleInsertDialog::GetClassID
この関数を呼び出して、DoModal が IDOK を返し、選択の種類が COleInsertDialog::createNewItem
> の場合にのみ、選択した項目に関連付けられている CLSID を取得します。
REFCLSID GetClassID() const;
戻り値
選択した項目に関連付けられている CLSID を返します。
解説
詳細については、Windows SDK の CLSID キーを参照してください。
COleInsertDialog::GetDrawAspect
この関数を呼び出して、ユーザーが選択した項目をアイコンとして表示することを選択したかどうかを判断します。
DVASPECT GetDrawAspect() const;
戻り値
オブジェクトをレンダリングするために必要なメソッド。
DVASPECT_CONTENTアイコンチェックボックスがチェックされていない場合に返されます。
DVASPECT_ICON [アイコンとして表示] チェック ボックスがチェックされた場合に返されます。
解説
DoModal が IDOK を返す場合にのみ、この関数を呼び出します。
描画の側面の詳細については、Windows SDK の FORMATETC データ構造を参照してください。
COleInsertDialog::GetIconicMetafile
選択した項目の象徴的な側面を含むメタファイルへのハンドルを取得するには、この関数を呼び出します。
HGLOBAL GetIconicMetafile() const;
戻り値
[OK] を選択してダイアログを閉じるときに [アイコンとして表示] チェック ボックスがチェックされた場合は、選択した項目のアイコンの側面を含むメタファイルのハンドル。それ以外の場合は NULL。
COleInsertDialog::GetPathName
DoModal が IDOK を返し、選択の種類が返されないCOleInsertDialog::createNewItem
場合にのみ、選択したファイルの完全なパスを取得するには、この関数を呼び出します。
CString GetPathName() const;
戻り値
ダイアログ ボックスで選択したファイルへの完全パス。 選択の種類が指定されている場合、この関数は createNewItem
リリース モードで無 CString
意味を返すか、デバッグ モードでアサーションを発生させます。
COleInsertDialog::GetSelectionType
この関数を呼び出して、[オブジェクトの挿入] ダイアログ ボックスが閉じられたときに選択した選択の種類を取得するには、[OK] を 選択します。
UINT GetSelectionType() const;
戻り値
選択した項目の種類。
解説
戻り値は、クラスで宣言されている列挙型によってSelection
COleInsertDialog
指定されます。
enum Selection {
createNewItem,
insertFromFile,
linkToFile
};
これらの値の簡単な説明は次のとおりです。
COleInsertDialog::createNewItem
[新規作成] ラジオ ボタンが選択されました。COleInsertDialog::insertFromFile
[ファイルから作成] ラジオ ボタンが選択され、[リンク チェック] ボックスがチェックされませんでした。COleInsertDialog::linkToFile
[ファイルから作成] ラジオ ボタンが選択され、[リンク チェック] ボックスがチェックされました。
COleInsertDialog::m_io
[オブジェクトの挿入] ダイアログ ボックスの動作を制御するために使用される OLEUIIN Standard Edition RTOBJECT 型の構造体。
OLEUIINSERTOBJECT m_io;
解説
この構造体のメンバーは、直接またはメンバー関数を使用して変更できます。
詳細については、Windows SDK の OLEUIIN Standard Edition RTOBJECT 構造体を参照してください。
関連項目
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示