nf-ocidl-iolecontrolsite-transformcoords.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:ocidl.IOleControlSite.TransformCoords	IOleControlSite::TransformCoords (ocidl.h)	Converts coordinates expressed in HIMETRIC units (as is standard in OLE) to the units specified by the container.	IOleControlSite interface [COM] TransformCoords method IOleControlSite.TransformCoords IOleControlSite::TransformCoords TransformCoords TransformCoords method [COM] TransformCoords method [COM] IOleControlSite interface XFORMCOORDS_CONTAINERTOHIMETRIC XFORMCOORDS_EVENTCOMPAT XFORMCOORDS_HIMETRICTOCONTAINER XFORMCOORDS_POSITION XFORMCOORDS_SIZE _ctrl_iolecontrolsite_transformcoords com.iolecontrolsite_transformcoords ocidl/IOleControlSite::TransformCoords	com\iolecontrolsite_transformcoords.htm	com	c7add062-4b42-43be-a982-c881c947f8f0	12/05/2018	IOleControlSite interface [COM],TransformCoords method, IOleControlSite.TransformCoords, IOleControlSite::TransformCoords, TransformCoords, TransformCoords method [COM], TransformCoords method [COM],IOleControlSite interface, XFORMCOORDS_CONTAINERTOHIMETRIC, XFORMCOORDS_EVENTCOMPAT, XFORMCOORDS_HIMETRICTOCONTAINER, XFORMCOORDS_POSITION, XFORMCOORDS_SIZE, _ctrl_iolecontrolsite_transformcoords, com.iolecontrolsite_transformcoords, ocidl/IOleControlSite::TransformCoords	ocidl.h		Windows	Windows 2000 Professional [desktop apps only]	Windows 2000 Server [desktop apps only]					OCIdl.idl								Windows			19H1	IOleControlSite::TransformCoords ocidl/IOleControlSite::TransformCoords	c++	APIRef kbSyntax	COM	OCIdl.h	IOleControlSite.TransformCoords

IOleControlSite::TransformCoords

-description

Converts coordinates expressed in HIMETRIC units (as is standard in OLE) to the units specified by the container.

-parameters

-param pPtlHimetric [in, out]

Address of a POINTL structure containing coordinates expressed in HIMETRIC units. This is an [in] parameter when dwFlags contains XFORMCOORDS_HIMETRICTOCONTAINER; it is an [out] parameter with XFORMCOORDS_CONTAINERTOHIMETRIC. In the latter case, the contents are undefined on error.

-param pPtfContainer [in, out]

Address of a caller-allocated POINTF structure that receives the converted coordinates. This is an [in] parameter when dwFlags contains XFORMCOORDS_CONTAINERTOHIMETRIC; it is an [out] parameter with XFORMCOORDS_HIMETRICTOCONTAINER. In the latter case, the contents are undefined on error.

-param dwFlags [in]

Flags indicating the exact conversion to perform. This parameter can be any combination of the following values, except as indicated.

Value	Meaning
XFORMCOORDS_POSITION 0x1	The coordinates to convert represent a position point. Cannot be used with XFORMCOORDS_SIZE.
XFORMCOORDS_SIZE 0x2	The coordinates to convert represent a set of dimensions. Cannot be used with XFORMCOORDS_POSITION.
XFORMCOORDS_HIMETRICTOCONTAINER 0x4	The operation converts pptlHimetric into pptfContainer. Cannot be used with XFORMCOORDS_CONTAINERTOHIMETRIC.
XFORMCOORDS_CONTAINERTOHIMETRIC 0x8	The operation converts pptfContainer into pptlHimetric. Cannot be used with XFORMCOORDS_HIMETRICTOCONTAINER.
XFORMCOORDS_EVENTCOMPAT 0x10	The operation maintains compatibility with an event.

-returns

This method can return the standard return values E_INVALIDARG and E_UNEXPECTED, as well as the following values.

Return code	Description
S_OK	The method completed successfully.
E_NOTIMPL	The container does not require any special coordinate conversions. The container deals completely in HIMETRIC.
E_POINTER	The address in pPtlHimetric or pPtfContainer is not valid. For example, it may be NULL.

-remarks

A control uses this method when it has to send coordinates to a container within an event or some other custom call or when the control has container coordinates that it needs to convert into HIMETRIC units.

-see-also

IOleControlSite