OLEUIPASTEENTRYA 構造体 (oledlg.h)

[貼り付け] ダイアログ ボックスの OLEUIPASTESPECIAL 構造体で指定するエントリの配列。 各エントリには、使用できる形式を指定する FORMATETC 構造体、ダイアログ ボックスのリスト ボックスの形式を表す文字列、ダイアログ ボックスの結果テキストをカスタマイズするための文字列、 および OLEUIPASTEFLAG 列挙体のフラグのセットが含まれます。 フラグは、エントリが貼り付け専用、リンクのみ、または貼り付けとリンクの両方で有効かどうかを示します。 エントリがリンクに対して有効な場合、フラグは適切なOLEUIPASTE_LINKTYPEn の値をまとめて OR'ing で許容されるリンクの種類を示します。

構文

typedef struct tagOLEUIPASTEENTRYA {
  FORMATETC fmtetc;
  LPCSTR    lpstrFormatName;
  LPCSTR    lpstrResultText;
  DWORD     dwFlags;
  DWORD     dwScratchSpace;
} OLEUIPASTEENTRYA, *POLEUIPASTEENTRYA, *LPOLEUIPASTEENTRYA;

メンバー

fmtetc

許容される形式。 [ 特殊な貼り付け ] ダイアログ ボックスでは、この形式がクリップボード上のオブジェクトによって提供されているかどうかを確認し、その場合はユーザーに選択を提供します。

lpstrFormatName

ユーザーへの形式を表す文字列へのポインター。 この文字列内の %s はクリップボードのオブジェクトの FullUserTypeName に置き換えられ、結果の文字列はダイアログ ボックスのリスト ボックスに配置されます。 %s は 1 つだけ許可されます。 %s の有無は、結果テキストがデータの貼り付け中か、アプリケーションによってアクティブ化できるオブジェクトが貼り付け中であることを示すかを指定します。 %s が存在する場合、結果のテキストにはオブジェクトが貼り付け中であることが示されます。 それ以外の場合は、データが貼り付け中であることを示します。

lpstrResultText

ユーザーがこのエントリに対応する形式を選択したときに、ダイアログ ボックスの結果のテキストをカスタマイズするために使用される文字列へのポインター。 この文字列内の %s は、クリップボードのオブジェクトのアプリケーション名または FullUserTypeName に置き換えられます。 %s は 1 つだけ許可されます。

dwFlags

OLEUIPASTEFLAG 列挙からの値。

dwScratchSpace

IEnumFORMATETC をループ処理して PasteEntry 形式が使用可能かどうかをマークするルーチンで使用できるスクラッチ領域。 このフィールドは初期化されていないままにすることができます。

注釈

注意

oledlg.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして OLEUIPASTEENTRY を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
Header	oledlg.h

こちらもご覧ください

OLEUIPASTEFLAG

OLEUIPASTESPECIAL

OleUIPasteSpecial