Partager via


Méthode IAccessibilityDockingService::GetAvailableSize

Obtient les dimensions disponibles pour l’ancrage d’une fenêtre d’accessibilité sur un moniteur.

Syntaxe

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

Paramètres

hMonitor [in]

Spécifie le moniteur pour lequel la taille d’ancrage disponible sera récupérée.

puMaxHeight [out]

En cas de réussite, définissez sur la hauteur maximale disponible pour l’ancrage sur le hMonitor spécifié, en pixels.

En cas d’échec, définissez sur zéro.

puFixedWidth [out]

En cas de réussite, définissez sur la largeur fixe disponible pour l’ancrage sur le hMonitor spécifié, en pixels. Toute fenêtre ancrée à ce hMonitor sera dimensionnée à cette largeur.

En cas d’échec, définissez sur zéro.

Valeur retournée

Code de retour Description
S_OK
Opération réussie.
HRESULT_FROM_WIN32(ERROR_INVALID_MONITOR_HANDLE)
Le moniteur spécifié par le handle de moniteur ne prend pas en charge l’ancrage.

Si puMaxHeight ou puFixedWidth ont la valeur Null, une violation d’accès se produit.

Notes

Les fenêtres d’accessibilité ne peuvent être ancrées qu’à un moniteur avec au moins 768 pixels d’écran verticaux. Cette API n’autorise pas l’ancrage de ces fenêtres avec une hauteur qui aurait pour effet que les applications du Windows Store ont moins de 768 pixels d’écran verticaux.

Exemples

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

Voir aussi

IAccessibilityDockingService