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

  • Article

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