SHAppBarMessage 함수(shellapi.h)
시스템에 앱바 메시지를 보냅니다.
구문
UINT_PTR SHAppBarMessage(
[in] DWORD dwMessage,
[in, out] PAPPBARDATA pData
);
매개 변수
[in] dwMessage
형식:DWORD
보낼 Appbar 메시지 값입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.
ABM_NEW(0x00000000)
새 앱바를 등록하고 시스템에서 앱바에 알림 메시지를 보내는 데 사용해야 하는 메시지 식별자를 지정합니다.
ABM_REMOVE(0x00000001)
앱바의 등록을 취소하고 시스템의 내부 목록에서 막대를 제거합니다.
ABM_QUERYPOS(0x00000002)
앱바의 크기 및 화면 위치를 요청합니다.
ABM_SETPOS(0x00000003)
앱바의 크기와 화면 위치를 설정합니다.
ABM_GETSTATE(0x00000004)
Windows 작업 표시줄의 자동 숨기기 및 항상 켜기 상태를 검색합니다.
ABM_GETTASKBARPOS(0x00000005)
Windows 작업 표시줄의 경계 사각형을 검색합니다. 이는 시스템 작업 표시줄에만 적용됩니다. 다른 개체, 특히 타사 소프트웨어와 함께 제공되는 도구 모음도 존재할 수 있습니다. 따라서 Windows 작업 표시줄에서 다루지 않는 일부 화면 영역이 사용자에게 표시되지 않을 수 있습니다. 작업 표시줄과 다른 앱 바(애플리케이션에서 사용할 수 있는 작업 영역)가 적용되지 않는 화면 영역을 검색하려면 GetMonitorInfo 함수를 사용합니다.
ABM_ACTIVATE(0x00000006)
앱바를 활성화하거나 비활성화하도록 시스템에 알합니다. pData가 가리키는 APPBARDATA의 lParam 멤버는 활성화하려면 TRUE로 설정되고 비활성화하려면 FALSE로 설정됩니다.
ABM_GETAUTOHIDEBAR(0x00000007)
화면의 특정 가장자리와 연결된 자동 숨기기 앱바에 대한 핸들을 검색합니다.
ABM_SETAUTOHIDEBAR(0x00000008)
화면 가장자리에 대한 자동 숨기기 앱바를 등록하거나 등록 취소합니다.
ABM_WINDOWPOSCHANGED(0x00000009)
앱바의 위치가 변경되면 시스템에 알합니다.
ABM_SETSTATE(0x0000000A)
Windows XP 이상: appbar의 자동 숨기기 및 항상 위쪽 특성의 상태를 설정합니다.
ABM_GETAUTOHIDEBAREX(0x0000000B)
Windows XP 이상: 특정 모니터의 특정 가장자리와 연결된 자동 숨기기 앱바에 대한 핸들을 검색합니다.
ABM_SETAUTOHIDEBAREX(0x0000000C)
Windows XP 이상: 특정 모니터의 가장자리에 대한 자동 숨기기 앱바를 등록하거나 등록 취소합니다.
[in, out] pData
형식: PAPPBARDATA
APPBARDATA 구조체에 대한 포인터입니다. 진입 및 종료 시 구조체의 내용은 dwMessage 매개 변수에 설정된 값에 따라 달라집니다. 자세한 내용은 개별 메시지 페이지를 참조하세요.
반환 값
형식: UINT_PTR
이 함수는 메시지 종속 값을 반환합니다. 자세한 내용은 전송된 특정 appbar 메시지에 대한 Windows SDK 설명서를 참조하세요. 해당 문서에 대한 링크는 참고 섹션에 제공됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | shellapi.h |
| 라이브러리 | Shell32.lib |
| DLL | Shell32.dll(버전 4.0 이상) |
| API 세트 | ext-ms-win-shell-shell32-l1-2-1(Windows 10 버전 10.0.10240에 도입됨) |