IAccessibilityDockingService::GetAvailableSize-Methode
Ruft die verfügbaren Dimensionen zum Andocken eines Barrierefreiheitsfensters auf einem Monitor ab.
Syntax
HRESULT GetAvailableSize(
[in] HMONITOR hMonitor,
[out] UINT *puMaxHeight,
[out] UINT *puFixedWidth
);
Parameter
-
hMonitor [in]
-
Gibt den Monitor an, für den die verfügbare Andockgröße abgerufen wird.
-
puMaxHeight [out]
-
Legen Sie bei Erfolg auf die maximale Höhe fest, die für das Andocken am angegebenen hMonitor in Pixel verfügbar ist.
Legen Sie bei Einem Fehler auf 0 (Null) fest.
-
puFixedWidth [out]
-
Legen Sie bei Erfolg auf die feste Breite fest, die für das Andocken am angegebenen hMonitor in Pixel verfügbar ist. Jedes Fenster, das an diesen hMonitor angedockt ist, wird auf diese Breite angepasst.
Legen Sie bei Einem Fehler auf 0 (Null) fest.
Rückgabewert
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Erfolg. |
|
Der vom Monitorhandle angegebene Monitor unterstützt das Andocken nicht. |
Wenn entweder puMaxHeight oder puFixedWidth NULL sind, tritt eine Zugriffsverletzung auf.
Bemerkungen
Barrierefreiheitsfenster können nur an einen Monitor angedockt werden, der mindestens 768 vertikale Bildschirmpixel aufweist. Diese API lässt nicht zu, dass solche Fenster mit einer Höhe angedockt werden, die dazu führt, dass Windows Store-Apps weniger als 768 vertikale Bildschirmpixel aufweisen.
Beispiele
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);
}
}