Metodo IDirectManipulationViewport::SetViewportTransform (directmanipulation.h)

Articolo
08/23/2023

Specifica la trasformazione dal sistema di coordinate viewport al sistema di coordinate client della finestra.

Sintassi

HRESULT SetViewportTransform(
  [in] const float *matrix,
  [in] DWORD       pointCount
);

Parametri

[in] matrix

Matrice di trasformazione, in ordine di riga: _11, _12, _21, _22, _31, _32.

[in] pointCount

Dimensione della matrice di trasformazione. Questo valore è sempre 6, perché viene usata una matrice 3x2 per tutte le trasformazioni di manipolazione diretta.

Valore restituito

Se il metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Chiamare questa funzione per specificare la posizione del riquadro di visualizzazione, il ridimensionamento e l'orientamento sullo schermo. La posizione del viewport, il ridimensionamento, l'orientamento e le dimensioni sono determinati in modo univoco dalla trasformazione viewport e dal rettangolo del riquadro di visualizzazione. L'applicazione può specificare la trasformazione viewport usando questo metodo e il rettangolo viewport usando SetViewportRect.

Il rettangolo viewport (l'area rettangolare all'interno del contenuto visibile all'utente) viene specificato nelle coordinate del riquadro di visualizzazione. Se il rettangolo di visualizzazione in alto a sinistra è (0,0), il rettangolo del riquadro di visualizzazione è posizionato esattamente all'origine del sistema di coordinate del riquadro di visualizzazione. L'offset dei viewport dall'origine del sistema di coordinate viewport può essere specificato in due modi:

Tramite il rettangolo di visualizzazione in alto a sinistra
Tramite il componente di conversione della trasformazione viewport (_31, _32)

La trasformazione viewport converte dal sistema di coordinate viewport al sistema di coordinate client della finestra. La manipolazione diretta ignora la proprietà RTL della finestra, quindi l'origine dell'area client è sempre il punto superiore sinistro. Le trasformazioni vengono applicate nell'ordine seguente:

Offset rettangolo viewport
Trasformazione Viewport (da viewport a sistema di coordinate client)
Mapping dello schermo da client a schermo (dal client al sistema di coordinate dello schermo)

Requisiti


Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	directmanipulation.h

Vedi anche

IDirectManipulationViewport

Condividi tramite