COleChangeIconDialog クラス

  • [アーティクル]

OLE の [アイコンの変更] ダイアログ ボックスに使用します。

構文

class COleChangeIconDialog : public COleDialog

メンバー

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

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

パブリック メソッド

名前 説明
COleChangeIconDialog::D oChangeIcon ダイアログ ボックスで指定された変更を実行します。
COleChangeIconDialog::D oModal [OLE 2 変更アイコン] ダイアログ ボックスを表示します。
COleChangeIconDialog::GetIconicMetafile このアイテムの象徴的な形式に関連付けられているメタファイルへのハンドルを取得します。

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

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

解説

このダイアログ ボックスを呼び出す場合は、クラス COleChangeIconDialog のオブジェクトを作成します。 オブジェクトがCOleChangeIconDialog構築されたら、m_ci構造体を使用して、ダイアログ ボックス内のコントロールの値または状態を初期化できます。 構造体は m_ci OLEUICHANGEICON 型です。 このダイアログ クラスの使用方法の詳細については、DoModal メンバー関数を参照してください。

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

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

継承階層

CObject

CCmdTarget

CWnd

Cdialog

CCommonDialog

COleDialog

COleChangeIconDialog

必要条件

ヘッダー: afxodlgs.h

COleChangeIconDialog::COleChangeIconDialog

この関数は、オブジェクトのみを COleChangeIconDialog 構築します。

explicit COleChangeIconDialog(
    COleClientItem* pItem,
    DWORD dwFlags = CIF_SELECTCURRENT,
    CWnd* pParentWnd = NULL);

パラメーター

pItem
変換する項目をポイントします。

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

  • CIF_Standard Edition LECTCURRENT ダイアログ ボックスが呼び出されたときに、現在のラジオ ボタンが最初に選択されることを指定します。 これが既定です。

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

  • CIF_Standard Edition LECTFROMFILE ダイアログ ボックスが呼び出されたときに、ファイルからラジオ ボタンが最初に選択されることを指定します。

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

  • CIF_UStandard Edition ICONEXE 型から取得するのではなく、m_ciのフィールドでszIconExe指定された実行可能ファイルからアイコンを抽出することを指定します。 これは、OLE 以外のファイルを埋め込んだりリンクしたりする場合に便利です。

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

解説

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

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

COleChangeIconDialog::D oChangeIcon

DoModal が IDOK を返した後、この関数を呼び出して、項目を表すアイコンをダイアログ ボックスで選択したアイコンに変更します。

BOOL DoChangeIcon(COleClientItem* pItem);

パラメーター

pItem
アイコンが変更されている項目をポイントします。

戻り値

変更が成功した場合は 0 以外。それ以外の場合は 0。

COleChangeIconDialog::D oModal

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

virtual INT_PTR DoModal();

戻り値

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

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

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

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

解説

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

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

COleChangeIconDialog::GetIconicMetafile

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

HGLOBAL GetIconicMetafile() const;

戻り値

ダイアログ ボックスが [OK] を選択して閉じられた場合は、新しいアイコンのアイコンを含むメタファイルへのハンドル。それ以外の場合は、ダイアログが表示される前のアイコン。

COleChangeIconDialog::m_ci

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

OLEUICHANGEICON m_ci;

解説

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

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

関連項目

COleDialog クラス
階層図
COleDialog クラス