COlePasteSpecialDialog クラス
OLE の [形式を選択して貼り付け] ダイアログ ボックス用に使用されます。
構文
class COlePasteSpecialDialog : public COleDialog
メンバー
パブリック コンストラクター
名前 | 説明 |
---|---|
COlePasteSpecialDialog::COlePasteSpecialDialog | COlePasteSpecialDialog オブジェクトを構築します。 |
パブリック メソッド
名前 | 説明 |
---|---|
COlePasteSpecialDialog::AddFormat | アプリケーションで貼り付けることができる形式の一覧にカスタム形式を追加します。 |
COlePasteSpecialDialog::AddLinkEntry | サポートされているクリップボード形式の一覧に新しいエントリを追加します。 |
COlePasteSpecialDialog::AddStandardFormats | アプリケーションで貼り付けることができる形式の一覧に、CF_BITMAP、CF_DIB、CF_METAFILEPICT、および必要に応じてCF_LINKSOURCEを追加します。 |
COlePasteSpecialDialog::CreateItem | 指定した形式を使用して、コンテナー ドキュメント内に項目を作成します。 |
COlePasteSpecialDialog::D oModal | [OLE 形式の貼り付け] ダイアログ ボックスを表示します。 |
COlePasteSpecialDialog::GetDrawAspect | 項目をアイコンとして描画するかどうかを指定します。 |
COlePasteSpecialDialog::GetIconicMetafile | このアイテムの象徴的な形式に関連付けられているメタファイルへのハンドルを取得します。 |
COlePasteSpecialDialog::GetPasteIndex | ユーザーが選択した使用可能な貼り付けオプションのインデックスを取得します。 |
COlePasteSpecialDialog::GetSelectionType | 選択した選択の種類を取得します。 |
パブリック データ メンバー
名前 | 説明 |
---|---|
COlePasteSpecialDialog::m_ps | ダイアログ ボックスの関数を制御する OLEUIPASTESPECIAL 型の構造体。 |
解説
このダイアログ ボックスを呼び出す場合は、クラス COlePasteSpecialDialog
のオブジェクトを作成します。 オブジェクトがCOlePasteSpecialDialog
作成されたら、AddFormat および AddStandardFormats メンバー関数を使用して、クリップボード形式をダイアログ ボックスに追加できます。 m_ps構造体を使用して、ダイアログ ボックスのコントロールの値または状態を初期化することもできます。 構造体は m_ps
OLEUIPASTESPECIAL 型です。
詳細については、Windows SDK の OLEUIPASTESPECIAL 構造体を参照してください。
OLE 固有のダイアログ ボックスの詳細については、「OLE のダイアログ ボックス」を参照してください。
継承階層
COlePasteSpecialDialog
要件
ヘッダー: afxodlgs.h
COlePasteSpecialDialog::AddFormat
この関数を呼び出して、特殊な貼り付け操作でアプリケーションでサポートできる形式の一覧に新しい形式を追加します。
void AddFormat(
const FORMATETC& formatEtc,
LPTSTR lpszFormat,
LPTSTR lpszResult,
DWORD flags);
void AddFormat(
UINT cf,
DWORD tymed,
UINT nFormatID,
BOOL bEnableIcon,
BOOL bLink);
パラメーター
fmt
追加するデータ型への参照。
lpszFormat
ユーザーの書式を表す文字列。
lpszResult
ダイアログ ボックスでこの形式を選択した場合の結果を表す文字列。
flags
この形式で使用できるさまざまなリンクと埋め込みオプション。 このフラグは、OLEUIPASTEFLAG 列挙型の 1 つ以上の異なる値のビットごとの組み合わせです。
cf
追加するクリップボードの形式。
Tymed
この形式で使用できるメディアの種類。 これは、TYMED 列挙型の 1 つ以上の値のビットごとの組み合わせです。
nFormatID
この書式を識別する文字列の ID。 この文字列の形式は、'\n' 文字で区切られた 2 つの個別の文字列です。 最初の文字列は lpstrFormat パラメーターで渡される文字列と同じで、2 番目の文字列は lpstrResult パラメーターと同じです。
bEnableIcon
リスト ボックスでこの形式を選択したときに、[アイコンチェックとして表示] ボックスを有効にするかどうかを決定するフラグ。
点滅
リスト ボックスでこの形式を選択したときに、[リンクの貼り付け] ラジオ ボタンが有効かどうかを決定するフラグ。
解説
この関数を呼び出して、CF_TEXTやCF_TIFFなどの標準形式、またはアプリケーションがシステムに登録したカスタム形式を追加できます。 データ オブジェクトをアプリケーションに貼り付ける方法の詳細については、「データ オブジェクトとデータ ソース: 操作」を参照してください。
詳細については、Windows SDK の TYMED 列挙型と FORMATETC 構造体を参照してください。
詳細については、Windows SDK の OLEUIPASTEFLAG 列挙型を参照してください。
COlePasteSpecialDialog::AddLinkEntry
サポートされているクリップボード形式の一覧に新しいエントリを追加します。
OLEUIPASTEFLAG AddLinkEntry(UINT cf);
パラメーター
cf
追加するクリップボードの形式。
戻り値
新しいリンク 項目の情報を含む OLEUIPASTEFLAG 構造体。
COlePasteSpecialDialog::AddStandardFormats
この関数を呼び出して、アプリケーションでサポートできる形式の一覧に次のクリップボード形式を追加する、特殊な貼り付け操作。
void AddStandardFormats(BOOL bEnableLink = TRUE);
パラメーター
bEnableLink
アプリケーションで貼り付けることができる形式の一覧にCF_LINKSOURCEを追加するかどうかを決定するフラグ。
解説
CF_BITMAP
CF_DIB
CF_METAFILEPICT
"埋め込みオブジェクト"
(必要に応じて) "リンク ソース"
これらの形式は、埋め込みとリンクをサポートするために使用されます。
COlePasteSpecialDialog::COlePasteSpecialDialog
COlePasteSpecialDialog
オブジェクトを構築します。
COlePasteSpecialDialog(
DWORD dwFlags = PSF_SELECTPASTE,
COleDataObject* pDataObject = NULL,
CWnd* pParentWnd = NULL);
パラメーター
dwFlags
作成フラグには、ビットごとの OR 演算子を使用して結合された次のフラグの任意の数が含まれます。
PSF_Standard Edition LECTPASTE ダイアログ ボックスが呼び出されたときに、[貼り付け] ラジオ ボタンが最初にチェックされるように指定します。 PSF_Standard Edition LECTPASTELINK と組み合わせて使用することはできません。 これが既定です。
PSF_Standard Edition LECTPASTELINK ダイアログ ボックスが呼び出されたときに、最初に [リンクの貼り付け] ラジオ ボタンがチェックされるように指定します。 PSF_Standard Edition LECTPASTE と組み合わせて使用することはできません。
PSF_CHECKDISPLAYASICON ダイアログ ボックスが呼び出されたときに、[アイコンチェックとして表示] ボックスが最初にチェックされるように指定します。
PSF_SHOWHELP ダイアログ ボックスが呼び出されたときに [ヘルプ] ボタンを表示することを指定します。
pDataObject
貼り付け用の COleDataObject をポイントします。 この値が NULL の場合は、クリップボードから取得 COleDataObject
されます。
pParentWnd
ダイアログ オブジェクトが属する親または所有者ウィンドウ オブジェクト (種類 CWnd
) を指します。 NULL の場合、ダイアログ ボックスの親ウィンドウは メイン アプリケーション ウィンドウに設定されます。
解説
この関数は、オブジェクトのみを構築 COlePasteSpecialDialog
します。 ダイアログ ボックスを表示するには、DoModal 関数を呼び出します。
詳細については、Windows SDK の OLEUIPASTEFLAG 列挙型を参照してください。
COlePasteSpecialDialog::CreateItem
[貼り付け] ダイアログ ボックスで選択した新しい項目を作成します。
BOOL CreateItem(COleClientItem* pNewItem);
パラメーター
pNewItem
インスタンスを COleClientItem
指します。 Nll は指定できません。
戻り値
項目が正常に作成された場合は 0 以外。それ以外の場合は 0。
解説
この関数は、DoModal が IDOK を返した後にのみ呼び出す必要があります。
COlePasteSpecialDialog::D oModal
[OLE 形式の貼り付け] ダイアログ ボックスを表示します。
virtual INT_PTR DoModal();
戻り値
ダイアログ ボックスの完了状態。 次のいずれかの値です。
ダイアログ ボックスが正常に表示された場合は IDOK。
ユーザーがダイアログ ボックスをキャンセルした場合は IDCANCEL。
エラーが発生した場合は IDABORT。 IDABORT が返された場合は、メンバー関数を
COleDialog::GetLastError
呼び出して、発生したエラーの種類に関する詳細情報を取得します。 考えられるエラーの一覧については、Windows SDK の OleUIPasteSpecial 関数を参照してください。
解説
m_ps構造体のメンバーを設定して、さまざまなダイアログ ボックス コントロールを初期化する場合は、呼び出すDoModal
前に、ダイアログ オブジェクトが構築された後にこれを行う必要があります。
IDOK が返された場合 DoModal
は、他のメンバー関数を呼び出して、ユーザーがダイアログ ボックスに入力した設定または情報を取得できます。
COlePasteSpecialDialog::GetDrawAspect
ユーザーが選択した項目をアイコンとして表示することを選択したかどうかを決定します。
DVASPECT GetDrawAspect() const;
戻り値
オブジェクトをレンダリングするために必要なメソッド。
DVASPECT_CONTENTダイアログ ボックスが閉じられたとき、[アイコンチェックとして表示] ボックスがチェックされなかった場合に返されます。
DVASPECT_ICONダイアログ ボックスを閉じるときに [アイコンチェックとして表示] ボックスがチェックされた場合に返されます。
解説
DoModal が IDOK を返した後でのみ、この関数を呼び出します。
描画の側面の詳細については、Windows SDK の FORMATETC 構造体を参照してください。
COlePasteSpecialDialog::GetIconicMetafile
ユーザーが選択した項目に関連付けられているメタファイルを取得します。
HGLOBAL GetIconicMetafile() const;
戻り値
[OK] を選択してダイアログ ボックスを閉じるときに [アイコンとして表示] チェック ボックスが選択されている場合は、選択した項目のアイコンの側面を含むメタファイルのハンドル。それ以外の場合は NULL。
COlePasteSpecialDialog::GetPasteIndex
ユーザーが選択したエントリに関連付けられているインデックス値を取得します。
int GetPasteIndex() const;
戻り値
ユーザーが選択した構造体の OLEUIPASTEENTRY
配列へのインデックス。 選択したインデックスに対応する形式は、貼り付け操作を実行するときに使用する必要があります。
解説
詳細については、Windows SDK の OLEUIPAST Enterprise Edition NTRY 構造体を参照してください。
COlePasteSpecialDialog::GetSelectionType
ユーザーが行った選択の種類を決定します。
UINT GetSelectionType() const;
戻り値
選択範囲の種類を返します。
解説
戻り値は、クラスで宣言されている列挙型によってSelection
COlePasteSpecialDialog
指定されます。
enum Selection {
pasteLink,
pasteNormal,
pasteOther,
pasteStatic
};
これらの値の簡単な説明は次のとおりです。
COlePasteSpecialDialog::pasteLink
[リンクの貼り付け] ラジオ ボタンがチェックされ、選択した形式は標準の OLE 形式でした。COlePasteSpecialDialog::pasteNormal
[貼り付け] ラジオ ボタンがチェックされ、選択した形式が標準の OLE 形式でした。COlePasteSpecialDialog::pasteOther
選択した書式が標準の OLE 形式ではありません。COlePasteSpecialDialog::pasteStatic
選択した形式はメタファイルでした。
COlePasteSpecialDialog::m_ps
[貼り付け] ダイアログ ボックスの動作を制御するために使用される OLEUIPASTESPECIAL 型の構造。
OLEUIPASTESPECIAL m_ps;
解説
この構造体のメンバーは、直接またはメンバー関数を使用して変更できます。
詳細については、Windows SDK の OLEUIPASTESPECIAL 構造体を参照してください。
関連項目
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示