サードパーティ互換性

Developer Guide

Seer は、WM_COPYDATA メッセージを介した Win32 IPC を使用して、サードパーティ製アプリケーションおよびカスタムファイルマネージャーとの統合をサポートしています。

カスタムアプリの統合 (ACustomApp)

カスタムアプリケーションから、特定のファイルパスのプレビューを表示するように Seer をトリガーできます。

ステップ 1: Seer のウィンドウハンドルを取得する

FindWindowW を使用してウィンドウハンドルを検索します：

HWND seer = FindWindowW(L"SeerWindowClass", nullptr);

ステップ 2: 選択したファイルの絶対パスを送信する

ファイルの絶対パスを Seer のウィンドウハンドルに送信します：

void sendPath2Seer(HWND seer, LPCWSTR path)
{
    COPYDATASTRUCT cd;
    cd.cbData = (wcslen(path) + 1) * sizeof(wchar_t);
    cd.lpData = (LPVOID)path;
    cd.dwData = SEER_INVOKE_W32; // 5000
    SendMessageW(seer, WM_COPYDATA, 0, (LPARAM)&cd);
}

カスタムファイルマネージャーの統合 (ACustomExplorer)

カスタムファイルマネージャーはウィンドウのクラス名（classname）を登録することで、Seer にそのウィンドウ内でのスペースキー（Spacebar）の入力を監視させ、現在選択されているファイルのパスを要求してプレビューを表示させることができます。

ステップ 1: クラス名を登録する

%USERPROFILE%/Documents/Seer/explorers/ の下に JSON ファイルを作成します。Seer の起動時に、このディレクトリ内のすべての JSON ファイルが読み込まれます。JSON には対象となるウィンドウのクラス名を含める必要があります：

{
  "classname": "YourCustomExplorerClass",
  "windowtext": "OptionalWindowTextToMatch",
  "appname": "YourAppName"
}

ステップ 2: スペースキーの入力を処理する

ユーザーがファイルマネージャーのウィンドウでスペースキーを押すと、Seer はそのキー入力をフックし、GetForegroundWindow を呼び出してクラス名を照合します。一致した場合、Seer は dwData に SEER_REQUEST_PATH (4000)、cbData = 0、lpData = nullptr を設定した WM_COPYDATA メッセージを対象のウィンドウハンドルに送信します。

ステップ 3: 選択されたパスを返信する

アプリケーションは WM_COPYDATA メッセージを処理し、dwData が SEER_REQUEST_PATH であることを確認した上で、選択されたファイルのフルパスを null 終端のワイド文字列として格納した WM_COPYDATA メッセージ（dwData に SEER_RESPONSE_PATH (4001) を設定）を Seer に返信する必要があります。

ステップ 4: プレビューの表示

Seer がパスを受信すると、プレビューウィンドウが表示され、処理が完了します。

IPC コマンドリファレンス (SeerCommand)

Seer との通信用に、seer/ipc.h で以下のコマンドが定義されています：

現在プレビューされているファイルの要求

WM_COPYDATA は可変長の文字列を直接返せないため、現在プレビューされているファイル（SEER_GET_CURRENT_FILE）の問い合わせには、命名されたファイルマッピング（共有メモリ）プロトコルを使用します。

C++ 実装例

#include <windows.h>
#include <string>

std::wstring getSeerCurrentFile(HWND seer_hwnd)
{
    if (!seer_hwnd) return L"";

    // ファイルマッピング用の一意の名前を作成する
    wchar_t map_name[MAX_PATH] = {0};
    swprintf_s(map_name, L"SeerCurFile_%u_%llu", GetCurrentProcessId(), GetTickCount64());

    constexpr size_t buf_bytes = MAX_PATH * sizeof(wchar_t);
    HANDLE map = CreateFileMappingW(INVALID_HANDLE_VALUE, nullptr, PAGE_READWRITE, 0, buf_bytes, map_name);
    if (!map) return L"";

    auto view = static_cast<wchar_t*>(MapViewOfFile(map, FILE_MAP_ALL_ACCESS, 0, 0, buf_bytes));
    if (!view) {
        CloseHandle(map);
        return L"";
    }
    view[0] = L'\0';

    // 一意の共有マッピング名をペイロードとして Seer にコマンドを送信する
    COPYDATASTRUCT cds;
    cds.dwData = 5006; // SEER_GET_CURRENT_FILE
    cds.cbData = buf_bytes;
    cds.lpData = map_name;

    SendMessageW(seer_hwnd, WM_COPYDATA, 0, reinterpret_cast<LPARAM>(&cds));

    std::wstring current_file;
    if (view[0] != L'\0') {
        current_file = view;
    }

    UnmapViewOfFile(view);
    CloseHandle(map);
    return current_file;
}