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 |
---|---|
|
Opération réussie. |
|
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);
}
}