IAccessibilityDockingService :: GetAvailableSize, méthode

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

Syntaxe

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

Paramètres

hMonitor [ dans]

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

puMaxHeight [ à]

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

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

puFixedWidth [ à]

En cas de réussite, définissez 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
_OK
Réussite.
HRESULT _ à partir de _ Win32 (handle de moniteur d’erreur _ non valide _ _ )
L’analyse spécifiée par le descripteur du moniteur ne prend pas en charge l’ancrage.

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

Remarques

Les fenêtres d’accessibilité peuvent uniquement être ancrées à une analyse qui a au moins 768 pixels d’écran verticaux. cette API n’autorise pas l’ancrage de ces fenêtres avec une hauteur qui obligerait Windows applications du Store à avoir 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