ChangeClipboardChain 関数 (winuser.h)

[アーティクル]
03/04/2024

クリップボードビューアーのチェーンから指定したウィンドウを削除します。

構文

BOOL ChangeClipboardChain(
  [in] HWND hWndRemove,
  [in] HWND hWndNewNext
);

パラメーター

[in] hWndRemove

型: HWND

チェーンから削除するウィンドウへのハンドル。ハンドルは SetClipboardViewer 関数に渡されている必要があります。

[in] hWndNewNext

型: HWND

クリップボードビューアーチェーンの hWndRemove ウィンドウに続くウィンドウへのハンドル。 (これは、WM_CHANGECBCHAIN メッセージに応答してシーケンスが変更されていない限り、SetClipboardViewer によって返されるハンドルです)。

戻り値

種類: BOOL

戻り値は、 WM_CHANGECBCHAIN メッセージをクリップボードビューアーチェーン内のウィンドウに渡した結果を示します。チェーン内のウィンドウは通常、WM_CHANGECBCHAIN処理するときに FALSE を返します。ChangeClipboardChain からの戻り値は通常 FALSE です。チェーンに 1 つのウィンドウしかない場合、戻り値は通常 TRUE になります。

注釈

hWndNewNext によって識別されるウィンドウは、チェーン内の hWndRemove ウィンドウを置き換えます。 SetClipboardViewer 関数は、クリップボードビューアーチェーンの最初のウィンドウにWM_CHANGECBCHAINメッセージを送信します。

例については、「クリップボードビューアーチェーンからのウィンドウの削除」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	winuser.h (Windows.h を含む)
Library	User32.lib
[DLL]	User32.dll
API セット	ext-ms-win-ntuser-misc-l1-5-1 (Windows 10 バージョン 10.0.14393 で導入)