IOleControlSite::TransformCoords-Methode (ocidl.h)

Artikel
08/25/2023

Konvertiert Koordinaten, die in HIMETRIC-Einheiten ausgedrückt werden (wie in OLE standard) in die vom Container angegebenen Einheiten.

Syntax

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

Parameter

[in, out] pPtlHimetric

Adresse einer POINTL-Struktur , die Koordinaten enthält, ausgedrückt in HIMETRIC-Einheiten . Dies ist ein [in]-Parameter, wenn dwFlags XFORMCOORDS_HIMETRICTOCONTAINER enthält. Es handelt sich um einen [out]-Parameter mit XFORMCOORDS_CONTAINERTOHIMETRIC. Im letzteren Fall ist der Inhalt auf Fehler undefiniert.

[in, out] pPtfContainer

Adresse einer vom Aufrufer zugeordneten POINTF-Struktur , die die konvertierten Koordinaten empfängt. Dies ist ein [in]-Parameter, wenn dwFlags XFORMCOORDS_CONTAINERTOHIMETRIC enthält. Es handelt sich um einen [out]-Parameter mit XFORMCOORDS_HIMETRICTOCONTAINER. Im letzteren Fall ist der Inhalt auf Fehler undefiniert.

[in] dwFlags

Flags, die die genaue auszuführende Konvertierung angeben. Dieser Parameter kann eine beliebige Kombination der folgenden Werte sein, außer wie angegeben.

Wert	Bedeutung
XFORMCOORDS_POSITION 0x1	Die zu konvertierenden Koordinaten stellen einen Positionspunkt dar. Kann nicht mit XFORMCOORDS_SIZE verwendet werden.
XFORMCOORDS_SIZE 0x2	Die zu konvertierenden Koordinaten stellen einen Satz von Dimensionen dar. Kann nicht mit XFORMCOORDS_POSITION verwendet werden.
XFORMCOORDS_HIMETRICTOCONTAINER 0x4	Der Vorgang konvertiert pptlHimetric in pptfContainer. Kann nicht mit XFORMCOORDS_CONTAINERTOHIMETRIC verwendet werden.
XFORMCOORDS_CONTAINERTOHIMETRIC 0x8	Der Vorgang konvertiert pptfContainer in pptlHimetric. Kann nicht mit XFORMCOORDS_HIMETRICTOCONTAINER verwendet werden.
XFORMCOORDS_EVENTCOMPAT 0x10	Der Vorgang behält die Kompatibilität mit einem Ereignis bei.

Rückgabewert

Diese Methode kann die standardmäßigen Rückgabewerte E_INVALIDARG und E_UNEXPECTED sowie die folgenden Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich abgeschlossen.
E_NOTIMPL	Für den Container sind keine speziellen Koordinatenkonvertierungen erforderlich. Der Container wird vollständig in HIMETRIC behandelt.
E_POINTER	Die Adresse in pPtlHimetric oder pPtfContainer ist ungültig. Es kann z. B. NULL sein.

Hinweise

Ein Steuerelement verwendet diese Methode, wenn es Innerhalb eines Ereignisses oder eines anderen benutzerdefinierten Aufrufs Koordinaten an einen Container senden muss oder wenn das Steuerelement Containerkoordinaten aufweist, die in HIMETRIC-Einheiten konvertiert werden müssen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ocidl.h

Weitere Informationen

IOleControlSite

Freigeben über