COlePropertiesDialog クラス

  • [アーティクル]

Windows に共通の [OLE プロジェクト プロパティ] ダイアログ ボックスをカプセル化します。

構文

class COlePropertiesDialog : public COleDialog

メンバー

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

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

パブリック メソッド

名前 説明
COlePropertiesDialog::D oModal ダイアログ ボックスを表示し、ユーザーが選択できるようにします。
COlePropertiesDialog::OnApplyScale ドキュメントアイテムのスケーリングが変更されたときにフレームワークによって呼び出されます。

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

名前 説明
COlePropertiesDialog::m_gp オブジェクトの "全般" ページ COlePropertiesDialog を初期化するために使用される構造体。
COlePropertiesDialog::m_lp オブジェクトの "リンク" ページを初期化するために使用される COlePropertiesDialog 構造体。
COlePropertiesDialog::m_op オブジェクトの初期化に使用される COlePropertiesDialog 構造体。
COlePropertiesDialog::m_psh 追加のカスタム プロパティ ページを追加するために使用される構造体。
COlePropertiesDialog::m_vp オブジェクトの [表示] ページをカスタマイズするために使用される COlePropertiesDialog 構造体。

解説

[共通の OLE オブジェクト プロパティ] ダイアログ ボックスを使用すると、Windows 標準に準拠した方法で OLE ドキュメント アイテムのプロパティを簡単に表示および変更できます。 これらのプロパティには、ドキュメント アイテムで表されるファイルに関する情報、アイコンと画像のスケーリングを表示するためのオプション、項目のリンクに関する情報 (アイテムがリンクされている場合) などがあります。

オブジェクトを COlePropertiesDialog 使用するには、まずコンストラクターを使用してオブジェクトを COlePropertiesDialog 作成します。 ダイアログ ボックスが作成されたら、メンバー関数を DoModal 呼び出してダイアログ ボックスを表示し、ユーザーがアイテムのプロパティを変更できるようにします。 DoModal は、ユーザーが OK (IDOK) またはキャンセル (IDCANCEL) ボタンを選択したかどうかを返します。 [OK] ボタンと [キャンセル] ボタンに加えて、[適用] ボタンがあります。 ユーザーが [適用] を選択すると、ドキュメント アイテムのプロパティに加えられた変更がアイテムに適用され、そのイメージは自動的に更新されますが、再メインアクティブになります。

m_psh データ メンバーは構造体へのPROPSHEETHEADERポインターであり、ほとんどの場合、明示的にアクセスする必要はありません。 1 つの例外は、既定の [全般]、[表示]、[リンク] ページ以外に追加のプロパティ ページが必要な場合です。 この場合、メンバー関数を呼び出す前に m_psh 、カスタム ページを含むようにデータ メンバーを DoModal 変更できます。

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

継承階層

CObject

CCmdTarget

CWnd

Cdialog

CCommonDialog

COleDialog

COlePropertiesDialog

必要条件

ヘッダー: afxodlgs.h

COlePropertiesDialog::COlePropertiesDialog

COlePropertiesDialog オブジェクトを作成します。

COlePropertiesDialog(
    COleClientItem* pItem,
    UINT nScaleMin = 10,
    UINT nScaleMax = 500,
    CWnd* pParentWnd = NULL);

パラメーター

pItem
プロパティにアクセスするドキュメント アイテムへのポインター。

nScaleMin
ドキュメント項目イメージの最小スケーリング率。

nScaleMax
ドキュメント項目イメージの最大スケーリング率。

pParentWnd
ダイアログ ボックスの親または所有者へのポインター。

解説

ドキュメント アイテムのスケーリングを実装するために、共通の OLE オブジェクト プロパティ ダイアログ クラス COlePropertiesDialog を派生させます。 このクラスのインスタンスによって実装されるダイアログ ボックスは、ドキュメント アイテムのスケーリングをサポートしません。

既定では、一般的な [OLE オブジェクトのプロパティ] ダイアログ ボックスには、次の 3 つの既定のページがあります。

  • 全般

    このページには、選択したドキュメント アイテムによって表されるファイルのシステム情報が含まれています。 このページから、ユーザーは選択した項目を別の種類に変換できます。

  • ビュー

    このページには、項目の表示、アイコンの変更、イメージのスケーリングの変更に関するオプションが含まれています。

  • リンク

    このページには、リンク アイテムの場所を変更したり、リンク アイテムを更新したりするためのオプションが含まれています。 このページから、ユーザーは選択した項目のリンクを解除できます。

既定で提供されるページ以外のページを追加するには、-derived クラスの コンストラクターを終了する前に、m_psh メンバー変数を COlePropertiesDialog変更します。 これは、コンストラクターの COlePropertiesDialog 高度な実装です。

COlePropertiesDialog::D oModal

このメンバー関数を呼び出して、Windows の一般的な [OLE オブジェクトのプロパティ] ダイアログ ボックスを表示し、ユーザーがドキュメント アイテムのさまざまなプロパティを表示または変更できるようにします。

virtual INT_PTR DoModal();

戻り値

成功した場合は IDOK または IDCANCEL。それ以外の場合は 0。 IDOK と IDCANCEL は、ユーザーが [OK] または [キャンセル] ボタンを選択したかどうかを示す定数です。

IDCANCEL が返された場合は、Windows CommDlgExtendedError 関数を呼び出して、 エラーが発生したかどうかを判断できます。

COlePropertiesDialog::m_gp

OLE オブジェクトのプロパティ] ダイアログ ボックスの [全般] ページを初期化するために使用される OLEUIGNRLPROPS 型の構造体。

OLEUIGNRLPROPS m_gp;

解説

このページには、埋め込みの種類とサイズが表示され、ユーザーは [変換] ダイアログ ボックスにアクセスできます。 このページには、オブジェクトがリンクである場合のリンク先も表示されます。

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

COlePropertiesDialog::m_lp

OLE オブジェクトのプロパティ] ダイアログ ボックスの [リンク] ページを初期化するために使用される OLEUILINKPROPS 型の構造体。

OLEUILINKPROPS m_lp;

解説

このページには、リンクされたアイテムの場所が表示され、ユーザーはアイテムへのリンクを更新または中断できます。

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

COlePropertiesDialog::m_op

OLEUIOBJECTPROPS 型の構造体。一般的な [OLE オブジェクトのプロパティ] ダイアログ ボックスを初期化するために使用されます。

OLEUIOBJECTPROPS m_op;

解説

この構造体には、全般、リンク、およびビューの各ページの初期化に使用されるメンバーが含まれています。

詳細については、Windows SDK の OLEUIOBJECTPROPS および OLEUILINKPROPS 構造体を参照してください。

COlePropertiesDialog::m_psh

メンバーがダイアログ オブジェクトの特性を格納する PROPSH Enterprise Edition THEADER 型の構造体。

PROPSHEETHEADER m_psh;

解説

オブジェクトをCOlePropertiesDialog構築した後、メンバー関数を呼び出す前に、ダイアログ ボックスのさまざまな側面をDoModal設定するために使用m_pshできます。

データ メンバーを m_psh 直接変更する場合は、既定の動作をオーバーライドします。

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

COlePropertiesDialog::m_vp

OLE オブジェクトのプロパティ] ダイアログ ボックスの [表示] ページを初期化するために使用される OLEUIVIEWPROPS 型の構造体。

OLEUIVIEWPROPS m_vp;

解説

このページを使用すると、ユーザーはオブジェクトの "コンテンツ" ビューと "アイコンビュー" を切り替え、コンテナー内でそのスケーリングを変更できます。 また、オブジェクトがアイコンとして表示されているときに、ユーザーが [アイコンの変更] ダイアログ ボックスにアクセスすることもできます。

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

COlePropertiesDialog::OnApplyScale

スケーリング値が変更され、[OK] または [適用] が選択されたときにフレームワークによって呼び出されます。

virtual BOOL OnApplyScale(
    COleClientItem* pItem,
    int nCurrentScale,
    BOOL bRelativeToOrig);

パラメーター

pItem
プロパティにアクセスするドキュメント アイテムへのポインター。

nCurrentScale
ダイアログ スケールの数値。

bRelativeToOrig
スケーリングがドキュメント アイテムの元のサイズに適用されるかどうかを示します。

戻り値

処理された場合は 0 以外。それ以外の場合は 0。

解説

既定の実装では、何も行われません。 スケーリング コントロールを有効にするには、この関数をオーバーライドする必要があります。

Note

共通の OLE オブジェクトプロパティダイアログ ボックスが表示される前に、フレームワークは pItem の場合は NULL、nCurrentScale の場合は - 1 でこの関数を呼び出します。 これは、スケーリング コントロールを有効にする必要があるかどうかを判断するために行われます。

関連項目

MFC サンプル CIRC
COleDialog クラス
階層図
COleDialog クラス
CPropertyPage クラス