Metodo IOleControlSite::TransformCoords (ocidl.h)

Articolo
08/25/2023

Converte le coordinate espresse in unità HIMETRIC (come è standard in OLE) nelle unità specificate dal contenitore.

Sintassi

HRESULT TransformCoords(
  [in, out] POINTL *pPtlHimetric,
  [in, out] POINTF *pPtfContainer,
  [in]      DWORD  dwFlags
);

Parametri

[in, out] pPtlHimetric

Indirizzo di una struttura POINTL contenente le coordinate espresse in unità HIMETRIC . Si tratta di un parametro [in] quando dwFlags contiene XFORMCOORDS_HIMETRICTOCONTAINER; è un parametro [out] con XFORMCOORDS_CONTAINERTOHIMETRIC. In quest'ultimo caso, il contenuto non è definito in caso di errore.

[in, out] pPtfContainer

Indirizzo di una struttura POINTF allocata dal chiamante che riceve le coordinate convertite. Si tratta di un parametro [in] quando dwFlags contiene XFORMCOORDS_CONTAINERTOHIMETRIC; è un parametro [out] con XFORMCOORDS_HIMETRICTOCONTAINER. In quest'ultimo caso, il contenuto non è definito in caso di errore.

[in] dwFlags

Flag che indicano la conversione esatta da eseguire. Questo parametro può essere qualsiasi combinazione dei valori seguenti, ad eccezione di quanto indicato.

Valore	Significato
XFORMCOORDS_POSITION 0x1	Le coordinate da convertire rappresentano un punto di posizione. Impossibile utilizzare con XFORMCOORDS_SIZE.
XFORMCOORDS_SIZE 0x2	Le coordinate da convertire rappresentano un set di dimensioni. Impossibile utilizzare con XFORMCOORDS_POSITION.
XFORMCOORDS_HIMETRICTOCONTAINER 0x4	L'operazione converte pptlHimetric in pptfContainer. Impossibile utilizzare con XFORMCOORDS_CONTAINERTOHIMETRIC.
XFORMCOORDS_CONTAINERTOHIMETRIC 0x8	L'operazione converte pptfContainer in pptlHimetric. Impossibile utilizzare con XFORMCOORDS_HIMETRICTOCONTAINER.
XFORMCOORDS_EVENTCOMPAT 0x10	L'operazione mantiene la compatibilità con un evento.

Valore restituito

Questo metodo può restituire i valori restituiti standard E_INVALIDARG e E_UNEXPECTED, nonché i valori seguenti.

Codice restituito	Descrizione
S_OK	Metodo completato correttamente.
E_NOTIMPL	Il contenitore non richiede conversioni di coordinate speciali. Il contenitore si occupa completamente in HIMETRIC.
E_POINTER	L'indirizzo in pPtlHimetric o pPtfContainer non è valido. Ad esempio, può essere NULL.

Commenti

Un controllo usa questo metodo quando deve inviare coordinate a un contenitore all'interno di un evento o in un'altra chiamata personalizzata o quando il controllo dispone di coordinate del contenitore da convertire in unità HIMETRIC .

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ocidl.h

Vedi anche

IOleControlSite

Condividi tramite