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

  • Artículo

Convierte las coordenadas expresadas en unidades HIMETRIC (como es estándar en OLE) en las unidades especificadas por el contenedor.

Sintaxis

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

Parámetros

[in, out] pPtlHimetric

Dirección de una estructura POINTL que contiene coordenadas expresadas en unidades HIMETRIC . Se trata de un parámetro [in] cuando dwFlags contiene XFORMCOORDS_HIMETRICTOCONTAINER; es un parámetro [out] con XFORMCOORDS_CONTAINERTOHIMETRIC. En este último caso, el contenido no está definido en caso de error.

[in, out] pPtfContainer

Dirección de una estructura POINTF asignada por el autor de la llamada que recibe las coordenadas convertidas. Se trata de un parámetro [in] cuando dwFlags contiene XFORMCOORDS_CONTAINERTOHIMETRIC; es un parámetro [out] con XFORMCOORDS_HIMETRICTOCONTAINER. En este último caso, el contenido no está definido en caso de error.

[in] dwFlags

Marcas que indican la conversión exacta que se va a realizar. Este parámetro puede ser cualquier combinación de los valores siguientes, excepto como se indica.

Valor Significado
XFORMCOORDS_POSITION
0x1
 Las coordenadas que se van a convertir representan un punto de posición. No se puede usar con XFORMCOORDS_SIZE.
XFORMCOORDS_SIZE
0x2
 Las coordenadas que se van a convertir representan un conjunto de dimensiones. No se puede usar con XFORMCOORDS_POSITION.
XFORMCOORDS_HIMETRICTOCONTAINER
0x4
 La operación convierte pptlHimetric en pptfContainer. No se puede usar con XFORMCOORDS_CONTAINERTOHIMETRIC.
XFORMCOORDS_CONTAINERTOHIMETRIC
0x8
 La operación convierte pptfContainer en pptlHimetric. No se puede usar con XFORMCOORDS_HIMETRICTOCONTAINER.
XFORMCOORDS_EVENTCOMPAT
0x10
 La operación mantiene la compatibilidad con un evento.

Valor devuelto

Este método puede devolver los valores devueltos estándar E_INVALIDARG y E_UNEXPECTED, así como los siguientes valores.

Código devuelto Descripción
S_OK
 El método se completó correctamente.
E_NOTIMPL
 El contenedor no requiere ninguna conversión de coordenadas especial. El contenedor se ocupa completamente en HIMETRIC.
E_POINTER
 La dirección de pPtlHimetric o pPtfContainer no es válida. Por ejemplo, puede ser NULL.

Comentarios

Un control usa este método cuando tiene que enviar coordenadas a un contenedor dentro de un evento u otra llamada personalizada o cuando el control tiene coordenadas de contenedor que necesita convertir en unidades HIMETRIC .

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ocidl.h

Consulte también

IOleControlSite