다음을 통해 공유


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가 가리키는 APPBARDATAlParam 멤버는 활성화하려면 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에 도입됨)

추가 정보

ABM_ACTIVATE

ABM_GETAUTOHIDEBAR

ABM_GETAUTOHIDEBAREX

ABM_GETSTATE

ABM_GETTASKBARPOS

ABM_NEW

ABM_QUERYPOS

ABM_REMOVE

ABM_SETAUTOHIDEBAR

ABM_SETAUTOHIDEBAREX

ABM_SETPOS

ABM_SETSTATE

ABM_WINDOWPOSCHANGED