共用方式為

IAccessibilityDockingService：：GetAvailableSize 方法 (shobjidl.h)

  • 發行項

擷取特定畫面上可用的維度，以顯示輔助功能視窗。

語法

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

傳回標準傳回值，包括下列專案：

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