Funzione ModifyWorldTransform (wingdi.h)

Articolo
03/08/2023

La funzione ModifyWorldTransform modifica la trasformazione mondiale per un contesto di dispositivo usando la modalità specificata.

Sintassi

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

Parametri

[in] hdc

Handle nel contesto del dispositivo.

[in] lpxf

Puntatore a una struttura XFORM usata per modificare la trasformazione mondiale per il contesto del dispositivo specificato.

[in] mode

Specifica il modo in cui i dati della trasformazione modificano la trasformazione mondiale corrente. Questo parametro deve essere uno dei valori seguenti.

Valore	Significato
MWT_IDENTITY	Reimposta la trasformazione del mondo corrente usando la matrice di identità. Se questa modalità viene specificata, la struttura XFORM puntata a lpXform viene ignorata.
MWT_LEFTMULTIPLY	Moltiplica la trasformazione corrente per i dati nella struttura XFORM . I dati nella struttura XFORM diventano moltiplicati a sinistra e i dati per la trasformazione corrente diventano moltiplicati a destra.
MWT_RIGHTMULTIPLY	Moltiplica la trasformazione corrente per i dati nella struttura XFORM . I dati nella struttura XFORM diventano moltiplicati a destra e i dati per la trasformazione corrente diventano moltiplicati a sinistra.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero.

Commenti

La funzione ModifyWorldTransform avrà esito negativo a meno che la modalità grafica per il contesto del dispositivo specificato sia stata impostata su GM_ADVANCED chiamando in precedenza la funzione SetGraphicsMode . Analogamente, non sarà possibile reimpostare la modalità grafica per il contesto del dispositivo nella modalità GM_COMPATIBLE predefinita, a meno che la trasformazione mondiale non sia stata prima reimpostata alla trasformazione identità predefinita chiamando SetWorldTransform o ModifyWorldTransform.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wingdi.h (include Windows.h)
Libreria	Gdi32.lib
DLL	Gdi32.dll