SetClipboardViewer 함수(winuser.h)

아티클
08/28/2023

클립보드 뷰어 체인에 지정된 창을 추가합니다. 클립보드 뷰어 창은 클립보드의 콘텐츠가 변경될 때마다 WM_DRAWCLIPBOARD 메시지를 받습니다. 이 함수는 이전 버전의 Windows와 이전 버전과의 호환성을 위해 사용됩니다.

구문

HWND SetClipboardViewer(
  [in] HWND hWndNewViewer
);

매개 변수

[in] hWndNewViewer

형식: HWND

클립보드 체인에 추가할 창에 대한 핸들입니다.

반환 값

형식: HWND

함수가 성공하면 반환 값은 클립보드 뷰어 체인의 다음 창을 식별합니다. 오류가 발생하거나 클립보드 뷰어 체인에 다른 창이 없는 경우 반환 값은 NULL입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

클립보드 뷰어 창이라고 하는 클립보드 뷰어 체인의 일부인 창은 WM_CHANGECBCHAIN 클립보드 메시지를 처리하고 WM_DRAWCLIPBOARD 합니다. 각 클립보드 뷰어 창은 SendMessage 함수를 호출하여 이러한 메시지를 클립보드 뷰어 체인의 다음 창으로 전달합니다.

예를 들어 WM_DESTROY 메시지에 대한 응답으로 ChangeClipboardChain 함수를 호출하여 클립보드 뷰어 창이 클립보드 뷰어 체인에서 제거되어야 합니다.

SetClipboardViewer 함수는 이전 버전의 Windows와 이전 버전과의 호환성을 제공하기 위해 존재합니다. 클립보드 뷰어 체인은 클립보드 체인 메시지를 제대로 처리하지 못하는 애플리케이션에 의해 끊어질 수 있습니다. 새 애플리케이션은 클립보드 시퀀스 번호 또는 클립보드 형식 수신기 등록과 같은 보다 강력한 기술을 사용해야 합니다. 이러한 대체 기술에 대한 자세한 내용은 클립보드 콘텐츠 모니터링을 참조하세요.

예제

예를 들어 클립보드 뷰어 체인에 창 추가를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll
API 세트	ext-ms-win-ntuser-misc-l1-5-1(Windows 10 버전 10.0.14393에 도입됨)