IAccessibilityDockingService::GetAvailableSize-Methode (shobjidl.h)

Artikel
03/04/2024

Ruft die Dimensionen ab, die auf einem bestimmten Bildschirm zum Anzeigen eines Barrierefreiheitsfensters verfügbar sind.

Syntax

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

Parameter

[in] hMonitor

Typ: HMONITOR

Das Handle des Monitors, dessen verfügbare Andockgröße abgerufen werden soll. Informationen zum Abrufen eines HMONITOR finden Sie unter MonitorFromWindow.

[out] pcxFixed

Typ: UINT*

Wenn diese Methode erfolgreich zurückgegeben wird, empfängt dieser Parameter die feste Breite in physischen Pixeln, die für das Andocken auf dem angegebenen Monitor verfügbar ist. Jedes Fenster, das an diesen Monitor angedockt ist, wird auf diese Breite angepasst.

Wenn die Methode fehlschlägt, wird dieser Wert auf 0 festgelegt.

Wenn dieser Wert NULL ist, tritt eine Zugriffsverletzung auf.

[out] pcyMax

Typ: UINT*

Wenn diese Methode erfolgreich zurückgegeben wird, empfängt dieser Parameter die maximale Höhe in physischen Pixeln, die für ein angedocktes Fenster auf dem angegebenen Monitor verfügbar ist.

Wenn die Methode fehlschlägt, wird dieser Wert auf 0 festgelegt.

Wenn dieser Wert NULL ist, tritt eine Zugriffsverletzung auf.

Rückgabewert

Typ: HRESULT

Gibt einen Standardrückgabewert zurück, einschließlich:

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
HRESULT_FROM_WIN32(ERROR_INVALID_MONITOR_HANDLE)	Der von hMonitor angegebene Monitor unterstützt das Andocken nicht.

Hinweise

Verwendungs-Gründe

Ein angedocktes Barrierefreiheitsfenster ist in der Menge des Platzes begrenzt, der auf jedem Bildschirm verwendet werden kann. Rufen Sie daher diese Funktion auf, bevor Sie versuchen, ein Barrierefreiheitsfenster anzudocken, um die verfügbaren Dimensionen abzurufen. Sie können kein Fenster andocken, das dazu führen würde, dass eine Windows Store-App Zugriff auf weniger als 768 vertikale Bildschirmpixel hat.

Beispiele

In diesem Beispiel wird diese Methode verwendet.


 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);
     }
 }

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl.h

Weitere Informationen

IAccessibilityDockingService

Freigeben über