<Return[G]><Top>

GetClipboardData

Declare Function Api_GetClipboardData& Lib "user32" Alias "GetClipboardData" (ByVal wFormat&)

Declare Function GetClipboardData Lib "user32" Alias "GetClipboardDataA" (ByVal wFormat As Long) As Long

クリップボードから、指定された形式のデータを取得する。

パラメータ
uFormat
    [入力]クリップボードのデータ形式を指定する。


戻り値
    関数が成功すると、指定したデータ形式のクリップボードオブジェクトのハンドルが返る。
    関数が失敗すると、NULL が返る。拡張エラー情報を取得するには、GetLastError 関数を使う。

解説
    EnumClipboardFormats 関数を使うと、利用可能なデータ形式をあらかじめ列挙できる。
    GetClipboardData 関数が返すハンドルは、アプリケーションではなくクリップボードが管理している。

    アプリケーションはデータを即座にコピーすべきでり、また、ハンドルを解放することや、ロックし続けることを避けなければならない。

    さらにアプリケーションは、EmptyClipboard または CloseClipboard を呼び出した後にハンドルを使うことや、SetClipboardData を呼び出し

    た後にクリップボードの同じデータ形式を指定することを避けなければならない。
    アプリケーションが GetClipboardData 関数を呼び出したとき、オペレーティングシステムがデータ形式の暗黙的な変換を行う。

    たとえば、CF_OEMTEXT のデータがクリップボードにある場合、アプリケーションはそのデータを CF_TEXT 形式のデータとして取り出すこ

    ともできる。クリップボード内のデータ形式は、必要に応じて、要求されたデータ形式へ変換される。