IOleControlSite::TransformCoords-Methode (ocidl.h)

  • Artikel

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