共用方式為

IAccessibilityDockingService：：GetAvailableSize 方法

  • 發行項

取得可在監視器上停駐協助工具視窗的維度。

語法

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

參數

hMonitor [in]

指定要擷取可用停駐大小的監視器。

puMaxHeight [out]

成功時，請設定為指定 hMonitor上可停駐的最大高度，以圖元為單位。

失敗時，將 設定為零。

puFixedWidth [out]

成功時，請設定為固定寬度，以圖元為單位在指定的 hMonitor上停駐。 任何停駐在此 hMonitor 的視窗都會調整為此寬度。

失敗時，將 設定為零。

傳回值

傳回碼 描述
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