Méthode IAccessibilityDockingService ::D ockWindow (shobjidl.h)

Article
03/02/2024

Ancre le handle de fenêtre spécifié au handle de moniteur spécifié.

Syntaxe

HRESULT DockWindow(
  [in] HWND                                 hwnd,
  [in] HMONITOR                             hMonitor,
       UINT                                 cyRequested,
  [in] IAccessibilityDockingServiceCallback *pCallback
);

Paramètres

[in] hwnd

Fenêtre d’application d’accessibilité qui sera ancrée sur le handle de moniteur passé.

[in] hMonitor

Moniteur sur lequel la fenêtre d’application d’accessibilité sera ancrée.

cyRequested

TBD

[in] pCallback

Pointeur de rappel sur lequel l’application d’accessibilité recevra la notification Undock .

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour	Description
S_OK	Réussite.
E_INVALIDARG	Le handle de fenêtre ou le handle du moniteur n’est pas valide.
E_ACCESSDENIED	Le processus appelant n’est pas une application d’accessibilité UIAcess ou le processus appelant n’est pas propriétaire de la fenêtre.
IMM_E_DOCKOCCUPIED	Il y a déjà une autre fenêtre qui occupe l’espace d’ancrage. Une seule fenêtre peut être ancrée à la fois.
IMM_E_INSUFFICIENTHEIGHT	L’uHeight demandé est supérieur à la hauteur d’ancrage maximale autorisée pour le moniteur spécifié. Toutefois, si ce code d’erreur est retourné, cela signifie que ce moniteur prend en charge l’ancrage, bien qu’à une hauteur indiquée par un appel à la méthode GetAvailableSize .
HRESULT_FROM_WIN32(ERROR_INVALID_MONITOR_HANDLE)	Le moniteur spécifié par le handle de moniteur ne prend pas en charge l’ancrage.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	shobjidl.h

Voir aussi

IAccessibilityDockingService

Partager via