次の方法で共有

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 つの例外は、既定の [全般]、[表示]、[リンク] ページ以外に追加のプロパティ ページが必要な場合です。 この場合、DoModal メンバー関数を呼び出す前に、カスタム ページを含むようにm_psh データ メンバーを変更できます。

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

継承階層

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COlePropertiesDialog

要件

Header: afxodlgs.h

COlePropertiesDialog::COlePropertiesDialog

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

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

パラメーター

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

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

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

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

解説

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

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

  • 全般

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

  • 表示

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

  • リンク

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

既定で提供されるページ以外のページを追加するには、COlePropertiesDialog派生クラスのコンストラクターを終了する前に、m_psh メンバー変数を変更します。 これは、 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

共通の OLE オブジェクト プロパティ ダイアログ ボックスを初期化するために使用 OLEUIOBJECTPROPS 型の構造体。

OLEUIOBJECTPROPS m_op;

解説

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

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

COlePropertiesDialog::m_psh

メンバーがダイアログ オブジェクトの特性を格納 PROPSHEETHEADER 型の構造体。

PROPSHEETHEADER m_psh;

解説

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

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