다음을 통해 공유

IAccessibilityDockingService::GetAvailableSize 메서드

  • 아티클

모니터에 접근성 창을 도킹하는 데 사용할 수 있는 차원을 가져옵니다.

구문

HRESULT GetAvailableSize(
  [in]  HMONITOR hMonitor,
  [out] UINT     *puMaxHeight,
  [out] UINT     *puFixedWidth
);

매개 변수

hMonitor [in]

사용 가능한 도킹 크기를 검색할 모니터를 지정합니다.

puMaxHeight [out]

성공 시 지정된 hMonitor의 도킹에 사용할 수 있는 최대 높이(픽셀)로 설정합니다.

실패 시 를 0으로 설정합니다.

puFixedWidth [out]

성공 시 지정된 hMonitor에서 도킹에 사용할 수 있는 고정 너비(픽셀)로 설정합니다. 이 hMonitor 에 고정된 모든 창의 크기는 이 너비로 조정됩니다.

실패 시 를 0으로 설정합니다.

반환 값

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

puMaxHeight 또는 puFixedWidth가 null이면 액세스 위반이 발생합니다.

설명

접근성 창은 세로 화면 픽셀이 768개 이상인 모니터에만 도킹할 수 있습니다. 이 API에서는 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);
    }
}

참고 항목

IAccessibilityDockingService