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 |
|---|---|
|
Réussite. |
|
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);
}
}