Condividi tramite


Funzione ModifyWorldTransform (wingdi.h)

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

Vedi anche

Funzioni di coordinata e trasformazione

Panoramica degli spazi e delle trasformazioni delle coordinate

GetWorldTransform

SetGraphicsMode

SetWorldTransform

XFORM