Méthode IAccessibilityDockingService ::GetAvailableSize (shobjidl.h)

Article
03/02/2024

Récupère les dimensions disponibles sur un écran spécifique pour afficher une fenêtre d’accessibilité.

Syntaxe

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

Paramètres

[in] hMonitor

Type : HMONITOR

Handle du moniteur dont la taille d’ancrage disponible doit être récupérée. Pour plus d’informations sur la récupération d’un HMONITOR, consultez MonitorFromWindow.

[out] pcxFixed

Type : UINT*

Lorsque cette méthode retourne correctement, ce paramètre reçoit la largeur fixe, en pixels physiques, disponible pour l’ancrage sur le moniteur spécifié. Toutes les fenêtres ancrées à ce moniteur seront dimensionnées à cette largeur.

Si la méthode échoue, cette valeur est définie sur 0.

Si cette valeur est NULL, une violation d’accès se produit.

[out] pcyMax

Type : UINT*

Lorsque cette méthode retourne correctement, ce paramètre reçoit la hauteur maximale, en pixels physiques, disponible pour une fenêtre ancrée sur le moniteur spécifié.

Si la méthode échoue, cette valeur est définie sur 0.

Si cette valeur est NULL, une violation d’accès se produit.

Valeur retournée

Type : HRESULT

Retourne une valeur de retour standard, y compris les éléments suivants :

Code de retour	Description
S_OK	S_OK
HRESULT_FROM_WIN32(ERROR_INVALID_MONITOR_HANDLE)	Le moniteur spécifié par hMonitor ne prend pas en charge l’ancrage.

Remarques

Quand utiliser

Une fenêtre d’accessibilité ancrée est limitée dans l’espace qu’elle peut utiliser sur n’importe quel écran. Par conséquent, avant d’essayer d’ancrer une fenêtre d’accessibilité, appelez cette fonction pour obtenir les dimensions disponibles. Vous ne pouvez pas ancrer une fenêtre qui entraînerait l’accès d’une application du Windows Store à moins de 768 pixels d’écran verticaux.

Exemples

Cet exemple montre cette méthode en cours d’utilisation.


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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl.h

Voir aussi

IAccessibilityDockingService

Partager via