IAccessibilityDockingService::GetAvailableSize 메서드(shobjidl.h)

아티클
08/26/2023

접근성 창을 표시하기 위해 특정 화면에서 사용할 수 있는 차원을 검색합니다.

구문

HRESULT GetAvailableSize(
  [in]  HMONITOR hMonitor,
  [out] UINT     *pcxFixed,
  [out] UINT     *pcyMax
);

매개 변수

[in] hMonitor

형식: HMONITOR

사용 가능한 도킹 크기를 검색할 모니터의 핸들입니다. HMONITOR를 검색하는 방법에 대한 자세한 내용은 MonitorFromWindow를 참조하세요.

[out] pcxFixed

형식: UINT*

이 메서드가 성공적으로 반환되면 이 매개 변수는 지정된 모니터에서 도킹에 사용할 수 있는 고정 너비(실제 픽셀)를 받습니다. 이 모니터에 고정된 모든 창의 크기는 이 너비로 조정됩니다.

메서드가 실패하면 이 값은 0으로 설정됩니다.

이 값이 NULL이면 액세스 위반이 발생합니다.

[out] pcyMax

형식: UINT*

이 메서드가 성공적으로 반환되면 이 매개 변수는 지정된 모니터의 도킹된 창에 사용할 수 있는 최대 높이(물리적 픽셀)를 받습니다.

메서드가 실패하면 이 값은 0으로 설정됩니다.

이 값이 NULL이면 액세스 위반이 발생합니다.

반환 값

형식: HRESULT

다음을 포함하여 표준 반환 값을 반환합니다.

반환 코드	Description
S_OK	메서드가 성공했습니다.
HRESULT_FROM_WIN32(ERROR_INVALID_MONITOR_HANDLE)	hMonitor에서 지정한 모니터는 도킹을 지원하지 않습니다.

설명

사용해야 하는 경우

도킹된 접근성 창은 화면에서 사용할 수 있는 공간의 양이 제한됩니다. 따라서 접근성 창을 도킹하기 전에 이 함수를 호출하여 사용 가능한 차원을 가져옵니다. Windows 스토어 앱이 768개 미만의 세로 화면 픽셀에 액세스할 수 있도록 하는 창을 도킹할 수 없습니다.

예제

이 예제에서는 사용 중인 이 메서드를 보여줍니다.


 IAccessibilityDockingService *pDockingService;
 
 HRESULT hr = CoCreateInstance(CLSID_AccessibilityDockingService, CLSCTX_INPROV_SERVER, nullptr, IID_PPV_ARGS(&pDockingService));
 if (SUCCEEDED(hr)) 
 {
     UINT uMaxHeight;
     UINT uFixedWidth;

     HMONITOR hMonitor = MonitorFromWindow(_hwndMyApplication, MONITOR_DEFAULTTONULL);
     if (hMonitor != nullptr)
     {
         hr = pDockingService->GetAvailableSize(hMonitor, &uMaxHeight, &uFixedWidth);
     }
 }

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shobjidl.h

추가 정보

IAccessibilityDockingService

다음을 통해 공유