Função ModifyWorldTransform (wingdi.h)

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

Confira também

Coordenar funções de espaço e transformação

Visão geral de espaços de coordenadas e transformações

GetWorldTransform

Setgraphicsmode

SetWorldTransform

XFORM