Função ModifyWorldTransform (wingdi.h)

Artigo
08/27/2023

A função ModifyWorldTransform altera a transformação do mundo para um contexto de dispositivo usando o modo especificado.

Sintaxe

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

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[in] lpxf

Um ponteiro para uma estrutura XFORM usada para modificar a transformação do mundo para o contexto de dispositivo fornecido.

[in] mode

Especifica como os dados de transformação modificam a transformação global atual. Esse parâmetro deve usar um dos valores a seguir.

Valor	Significado
MWT_IDENTITY	Redefine a transformação do mundo atual usando a matriz de identidade. Se esse modo for especificado, a estrutura XFORM apontada por lpXform será ignorada.
MWT_LEFTMULTIPLY	Multiplica a transformação atual pelos dados na estrutura XFORM . (Os dados na estrutura XFORM se tornam o multiplicando à esquerda e os dados da transformação atual se tornam a multiplicação à direita.)
MWT_RIGHTMULTIPLY	Multiplica a transformação atual pelos dados na estrutura XFORM . (Os dados na estrutura XFORM se tornam o multiplicando à direita e os dados da transformação atual se tornam o multiplicando à esquerda.)

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero.

Comentários

A função ModifyWorldTransform falhará, a menos que o modo gráfico para o contexto de dispositivo especificado tenha sido definido como GM_ADVANCED chamando anteriormente a função SetGraphicsMode . Da mesma forma, não será possível redefinir o modo gráfico do contexto do dispositivo para o modo de GM_COMPATIBLE padrão, a menos que a transformação mundial tenha sido redefinida pela primeira vez para a transformação de identidade padrão chamando SetWorldTransform ou ModifyWorldTransform.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wingdi.h (inclua Windows.h)
Biblioteca	Gdi32.lib
DLL	Gdi32.dll