Méthode IOleControlSite::TransformCoords (ocidl.h)

Article
08/25/2023

Convertit les coordonnées exprimées en unités HIMETRIC (comme c’est le cas dans OLE) en unités spécifiées par le conteneur.

Syntaxe

HRESULT TransformCoords(
  [in, out] POINTL *pPtlHimetric,
  [in, out] POINTF *pPtfContainer,
  [in]      DWORD  dwFlags
);

Paramètres

[in, out] pPtlHimetric

Adresse d’une structure POINTL contenant des coordonnées exprimées en unités HIMETRIC . Il s’agit d’un paramètre [in] lorsque dwFlags contient XFORMCOORDS_HIMETRICTOCONTAINER ; il s’agit d’un paramètre [out] avec XFORMCOORDS_CONTAINERTOHIMETRIC. Dans ce dernier cas, le contenu n’est pas défini en cas d’erreur.

[in, out] pPtfContainer

Adresse d’une structure POINTF allouée à l’appelant qui reçoit les coordonnées converties. Il s’agit d’un paramètre [in] lorsque dwFlags contient XFORMCOORDS_CONTAINERTOHIMETRIC ; il s’agit d’un paramètre [out] avec XFORMCOORDS_HIMETRICTOCONTAINER. Dans ce dernier cas, le contenu n’est pas défini en cas d’erreur.

[in] dwFlags

Indicateurs indiquant la conversion exacte à effectuer. Ce paramètre peut être n’importe quelle combinaison des valeurs suivantes, sauf indication contraire.

Valeur	Signification
XFORMCOORDS_POSITION 0x1	Les coordonnées à convertir représentent un point de position. Ne peut pas être utilisé avec XFORMCOORDS_SIZE.
XFORMCOORDS_SIZE 0x2	Les coordonnées à convertir représentent un ensemble de dimensions. Ne peut pas être utilisé avec XFORMCOORDS_POSITION.
XFORMCOORDS_HIMETRICTOCONTAINER 0x4	L’opération convertit pptlHimetric en pptfContainer. Ne peut pas être utilisé avec XFORMCOORDS_CONTAINERTOHIMETRIC.
XFORMCOORDS_CONTAINERTOHIMETRIC 0x8	L’opération convertit pptfContainer en pptlHimetric. Ne peut pas être utilisé avec XFORMCOORDS_HIMETRICTOCONTAINER.
XFORMCOORDS_EVENTCOMPAT 0x10	L’opération maintient la compatibilité avec un événement.

Valeur retournée

Cette méthode peut retourner les valeurs de retour standard E_INVALIDARG et E_UNEXPECTED, ainsi que les valeurs suivantes.

Code de retour	Description
S_OK	La commande s'est correctement terminée.
E_NOTIMPL	Le conteneur ne nécessite aucune conversion de coordonnées spéciales. Le conteneur est entièrement en HIMETRIC.
E_POINTER	L’adresse dans pPtlHimetric ou pPtfContainer n’est pas valide. Par exemple, il peut s’agir de NULL.

Notes

Un contrôle utilise cette méthode lorsqu’il doit envoyer des coordonnées à un conteneur au sein d’un événement ou d’un autre appel personnalisé ou lorsque le contrôle a des coordonnées de conteneur qu’il doit convertir en unités HIMETRIC .

Spécifications


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	ocidl.h

Voir aussi

IOleControlSite

Partager via