RegisterClipboardFormatA 関数 (winuser.h)
新しいクリップボード形式を登録します。 この形式は、有効なクリップボード形式として使用できます。
構文
UINT RegisterClipboardFormatA(
[in] LPCSTR lpszFormat
);
パラメーター
[in] lpszFormat
型: LPCTSTR
新しい形式の名前。
戻り値
型: UINT
関数が成功した場合、戻り値は登録済みのクリップボード形式を識別します。
関数が失敗した場合、戻り値は 0 です。 拡張エラー情報を取得するには、GetLastError
備考
指定した名前の登録済み形式が既に存在する場合、新しい形式は登録されず、戻り値によって既存の形式が識別されます。 これにより、複数のアプリケーションで、同じ登録済みクリップボード形式を使用してデータをコピーして貼り付けることができます。 形式名の比較では大文字と小文字が区別されません。
登録済みのクリップボード形式は、0xFFFF 0xC000範囲内の値によって識別されます。
登録済みのクリップボード形式をクリップボードに配置またはクリップボードから取得する場合は、HGLOBAL 値の形式である必要があります。
例
例については、「クリップボード形式の登録」を参照してください。
手記
winuser.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして RegisterClipboardFormat を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
ターゲット プラットフォーム の |
ウィンドウズ |
ヘッダー | winuser.h (Windows.h を含む) |
ライブラリ | User32.lib |
DLL | User32.dll |
API セットの | ext-ms-win-ntuser-misc-l1-2-0 (Windows 8.1 で導入) |
関連項目
概念
EnumClipboardFormats の
GetClipboardFormatName の
リファレンス