WindowsのPythonでクリップボードを扱う

import win32clipboard

def set_clipboard_text(text):
    win32clipboard.OpenClipboard()
    try:
        win32clipboard.EmptyClipboard()
        win32clipboard.SetClipboardData(win32clipboard.CF_UNICODETEXT, text)
    finally:
        win32clipboard.CloseClipboard()

def get_clipboard_text():
    text = None
    win32clipboard.OpenClipboard()
    try:
        text = win32clipboard.GetClipboardData(win32clipboard.CF_UNICODETEXT)
    except TypeError:
        pass
    finally:
        win32clipboard.CloseClipboard()
    return text

# クリップボードに文字列を設定する
set_clipboard_text("abc")

# クリップボードから文字列を取得する
text = get_clipboard_text()
print(text)

win32clipboardモジュールの関数は、ほぼWindowsのクリップボード関連の関数と対応しています。（完全に対応しているわけではありませんが、ほとんど対応しています）

Windowsのクリップボード関連の関数では、クリップボードに設定するデータのためにグローバルメモリオブジェクトを割り当てるなどの処理が必要ですが、グローバルメモリオブジェクトの割り当てなどは、win32clipboardモジュールの中で行っているため気にする必要はありません。

クリップボードを使うときは、OpenClipboard関数でオープンして使い終わったらCloseClipboard関数でクローズします。

OpenClipboard関数を呼び出したあとCloseClipboard関数を呼ぶまで他のアプリケーションがクリップボードを使えません。このため、できるだけOpenClipboard関数 ～ CloseClipboard関数を呼ぶまでの間隔は短くする必要があります。クリップボードに設定するデータを準備するのに時間がかかる場合は、OpenClipboard関数を呼ぶ前にデータを準備してからOpenClipboard関数を呼び出すようにします。

import win32clipboard

data = "クリップボードに設定するテキスト"

win32clipboard.OpenClipboard()
win32clipboard.EmptyClipboard()
win32clipboard.SetClipboardData(win32clipboard.CF_UNICODETEXT, data)
win32clipboard.CloseClipboard()

クリップボードに値を設定するときEmptyClipboard関数を呼び出さなくて正しく動く場合がありますが、クリップボードに予期しないデータが残っていたり、正しく動作しなくなったりする場合があるので特別な理由がなければ呼び出すようにします。

クリップボードに複数のデータ形式の文字列を設定する

import win32clipboard

win32clipboard.OpenClipboard()
# クリップボードを空にする
win32clipboard.EmptyClipboard()

# CF_TEXT形式のデータを設定
win32clipboard.SetClipboardData(win32clipboard.CF_TEXT, b"CF_TEXT data")

# CF_UNICODETEXT形式のデータを設定
win32clipboard.SetClipboardData(win32clipboard.CF_UNICODETEXT, "CF_UNICODETEXT Data")

win32clipboard.CloseClipboard()

win32clipboard.OpenClipboard()

# 在クリップボードにあるデータ形式の数を取得する
num_of = win32clipboard.CountClipboardFormats()
print(f"現在クリップボードにあるデータ形式に数={num_of}")

for i in range(num_of):
    # GetClipboardDataの引数に指定するデータ形式を取得する
    type_code = win32clipboard.EnumClipboardFormats(i)

    # 無効なデータ形式(0)が返る場合があるため 0 を除外している
    if type_code != 0:
        data = win32clipboard.GetClipboardData(type_code)
        print(f"データ形式 {type_code} : {data}")
win32clipboard.CloseClipboard()

クリップボードのデータをGetClipboardData関数で取得するためには、引数に取得したいデータ形式を指定する必要があります。このため、最初に現在クリップボードにあるデータ形式を取得する必要があります。

現在クリップボードにあるすべてのデータ形式のデータを取得するには、最初にCountClipboardFormats関数で現在クリップボードにあるデータ形式の数を取得します。

次に、取得したデータ形式の数だけEnumClipboardFormats関数を呼び出してデータ形式を取得し、取得したデータ形式を使ってGetClipboardData関数を呼び出します。

あらかじめ期待するデータ形式がわかっている場合は、CountClipboardFormats関数やEnumClipboardFormats関数で現在クリップボードにあるデータ形式を取得しないで、直接GetClipboardData関数を期待するデータ形式を引数として呼び出すこともできます。

この場合は、期待するデータ形式がクリップボードにないと例外(TypeError)が発生するので例外を処理するようにしてください。