第４回　クリップボード　その１

ＢＴＭｅｍｏに限らず、たいていのアプリケーションはクリップボードを介して相互にデータを交換することができます。

というか、そのために用意されている仕組みがクリップボードです。

ここでは、クリップボードの使い方をお伝えします。

（１）プレーンテキストをクリップボードに登録する

まず、クリップボードへデータを登録する手順を兼ねまして、プレーンテキストをクリップボードへ登録する方法です。

//クリップボードに格納するデータです。ここでは例としてリテラル文字列を使用します。

char szSrcData[] = "この文字列をクリップボードに登録します"

//（Ａ）クリップデータへ格納するデータは共有メモリに格納する必要があります。

//　　　必要なだけの共有メモリを獲得してそこにデータをコピーします

int len = strlen(szSrcData)+1;

HGLOBAL hData = (HGLOBAL)::GlobalAlloc(GHND, (DWORD)len);

char *pData = (char *)::GlobalLock(hData);

strcpy(pData, szSrcData);

::GlobalUnlock(hData);

//（Ｂ）クリップボードをオープンします。

::OpenClipboard(NULL);

//（Ｃ）今クリップボードに入っているデータを廃棄します。

::EmptyClipboard();

//（Ｄ）クリップボードへグローバルメモリを登録する

if (::SetClipboardData(CF_TEXT, hData) == NULL) {

// 登録失敗の場合は、自分で共有メモリを開放する必要があります。

::GlobalFree(hData);

}

//（Ｅ）クリップボードをクローズする

::CloseClipboard();

−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−

（Ｂ）（Ｃ）（Ｅ）は、おまじないみたいなものですので説明は省きます。

私が思うに、クリップボードを扱う際の主題は（Ａ）と（Ｄ）です。

まず（Ｄ）ですが、クリップボードに登録するデータを格納した共有メモリのハンドルと、

その共有メモリ内に入っているデータの種類を示すクリップボードフォーマットをを指定します。

上記例では、クリップボードフォーマットに CF_TEXT を使用していますがこれは、

・共有メモリにはプレーンテキスト（シフトＪＩＳ）が格納されている

・共有メモリの先頭から文字列が始まりヌル文字で終わる

と言うことを意味しています。

なお、登録が成功した場合、登録したハンドルの所有権はクリップボードに移ります。

プログラムでハンドルを廃棄したり、データを変更するような事は厳禁です。

次に（Ａ）ですが、（Ｄ）で CF_TEXT を指定するために、それに合致したデータを作りこんでいるわけです。

（２）クリップボードフォーマット

クリップボードフォーマットには、CF_TEXTの様にあらかじめ用途の決められているものがあります。

ＢＴＭｅｍｏでは他にCF_HDROPやCF_BITMAPというクリップボードフォーマットを使用しています。

CF_HDROPは、エクスプローラ等でファイルをコピーした際に使用されているフォーマットです。

CF_BITMAPは、ペイントブラシなどで、画像をコピーした際に使用されているフォーマットです。

さらに、プログラムが自分専用のクリップボードフォーマット（番号）をＯＳから割り当ててもらうことができます。

// ＢＴＭｅｍｏ用のクリップボードフォーマットの割り当てを得る

int CF_TAD = ::RegisterClipboardFormat("CF_BURUTURI_DATA_BUS");

　　　−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−

プログラムに固有の文字列をキーワードとします。キーワードが最初に使われたとき、本当に割り当てが行われ、

キーワードにが既に使われていれば、最初に割り当てられたのと同じものが返却されます。

したがって、誰が最初かなんて事は気にしなくても良いのです。

ＢＴＭｅｍｏ以外のプログラムでも上記と同じキーワードを指定してクリップボードフォーマットの割り当てを得れば、

ＢＴＭｅｍｏとクリップボードを介してデータを交換することができます。

共有メモリ内のデータフォーマットは、ＢＴＭｅｍｏのファイルフォーマットとほとんど同じです。

（カレンダーのソースにサンプルがあります。興味があればそちらをご覧下さい）

上記と同じ事がＢＴＭｅｍｏ以外のプログラムにも当てはまります。

// インターネットエクスプローラがＵＲＬをクリップボードへ格納する際のクリップボードフォーマットを得るには

int CF_URL = ::RegisterClipboardFormat(CFSTR_SHELLURL); // CFSTR_SHELLURLはマクロで、文字列定数が宣言されてます

　　　−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−

このクリップボードフォーマットを使用すれば、インターネットエクスプローラが登録したＵＲＬをクリップボードから取得できます。

共有メモリ内のデータフォーマットはCF_TEXTと同じで単なる文字列です。

正確にいうと、このクリップボードフォーマットでクリップボードからデータを得れるかどうか未確認です。

しかしドラッグ＆ドロップ（クリップボードと同じようにクリップボードフォーマットと共有メモリを使用してデータ交換します）では

データ交換できます。

（３）クリップボードフォーマットが異なるデータを同時にクリップボードに登録する

//（Ａ）さまざまなクリップボードフォーマット用のデータを用意します。

HGLOBAL hText = GetTextData(); // プレーンテキストのデータを共有メモリに格納し、そのハンドルを返却する関数を仮定

HGLOBAL hMemo = GetBTMemoData(); // ＢＴＭｅｍｏ独自形式のデータを共有メモリに格納し、そのハンドルを返却する関数を仮定

//（Ｂ）クリップボードをオープンします。

::OpenClipboard(NULL);

//（Ｃ）今クリップボードに入っているデータを廃棄します。

::EmptyClipboard();

//（Ｄ）クリップボードへグローバルメモリを登録する

::SetClipboardData(CF_TEXT, hText) ; // プレーンテキストのデータを登録します

::SetClipboardData(CF_TAD , hMemo) ; // ＢＴＭｅｍｏ独自形式のデータを登録します。

//（Ｅ）クリップボードをクローズする

::CloseClipboard();

　　　−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−

クリップボードからデータを取り出すプログラムが、登録されているクリップボードフォーマットを見て、自分が扱えるデータだけを持っていくことになります。

ＢＴＭｅｍｏ以外のプログラムはＢＴＭｅｍｏ独自形式のデータは使用せず、プレーンテキストだけを持っていくでしょう。

ＢＴＭｅｍｏは、まずＢＴＭｅｍｏ独自形式の有無を調べ、有ればそれを最優先して取り出します。それが無ければプレーンテキストを処理します。

（４）CF_HDROP形式でクリップボードに登録するデータを作成する

カレンダーからドラッグ＆ドロップでＢＴＭｅｍｏにリンクを作成するときに使用してます。

// パス名からCF_HDROP形式のデータを得る

HGLOBAL GetClipData_HDROP(char *pszPathName)

{

// メモリを獲得しクリップボードデータを作成

HGLOBAL hData = (HGLOBAL)::GlobalAlloc(GHND, (DWORD)sizeof(DRAGDATA));

if (hData == NULL) {

return NULL;

}

DRAGDATA *pData = (DRAGDATA *)::GlobalLock(hData);

pData->df.pFiles = sizeof(DROPFILES); // 変数名はポインタですが、メモリの先頭からのバイト位置です

strcpy(pData->szPathName, pszPathName); // 複数のファイルを登録したい場合は、続けてパス名を登録すればよかったと思うのですが…

// 正確なところは失念してしまいました

::GlobalUnlock(hData);

return hData;

}

　　　−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−

カレンダーのソースから抜粋してきました。

クリップボードの処理でもドラッグ＆ドロップの処理でもデータの作り方は同じです。