SHAppBarMessage 함수(shellapi.h)

아티클
08/26/2023

시스템에 앱바 메시지를 보냅니다.

구문

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에 도입됨)