Función ModifyWorldTransform (wingdi.h)

Artículo
03/08/2023

La función ModifyWorldTransform cambia la transformación mundial de un contexto de dispositivo mediante el modo especificado.

Sintaxis

BOOL ModifyWorldTransform(
  [in] HDC         hdc,
  [in] const XFORM *lpxf,
  [in] DWORD       mode
);

Parámetros

[in] hdc

Identificador del contexto del dispositivo.

[in] lpxf

Puntero a una estructura XFORM que se usa para modificar la transformación del mundo para el contexto de dispositivo determinado.

[in] mode

Especifica la forma en que los datos de transformación modifican la transformación global actual. Este parámetro puede ser uno de los siguientes valores.

Value	Significado
MWT_IDENTITY	Restablece la transformación del mundo actual mediante la matriz de identidades. Si se especifica este modo, se omite la estructura XFORM a la que apunta lpXform .
MWT_LEFTMULTIPLY	Multiplica la transformación actual por los datos de la estructura XFORM . (Los datos de la estructura XFORM se convierten en la multiplicación izquierda y los datos de la transformación actual se convierten en el multiplicado derecho).
MWT_RIGHTMULTIPLY	Multiplica la transformación actual por los datos de la estructura XFORM . (Los datos de la estructura XFORM se convierten en el multiplicado derecho y los datos de la transformación actual se convierten en el multiplicado izquierdo).

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero.

Comentarios

Se producirá un error en la función ModifyWorldTransform a menos que el modo gráfico del contexto de dispositivo especificado se haya establecido en GM_ADVANCED llamando previamente a la función SetGraphicsMode . Del mismo modo, no será posible restablecer el modo gráfico del contexto del dispositivo al modo de GM_COMPATIBLE predeterminado, a menos que la transformación del mundo se haya restablecido primero a la transformación de identidad predeterminada llamando a SetWorldTransform o ModifyWorldTransform.

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	wingdi.h (incluye Windows.h)
Library	Gdi32.lib
Archivo DLL	Gdi32.dll