Share via

Metode IOleControlSite::TransformCoords (ocidl.h)

  • Artikel

Mengonversi koordinat yang dinyatakan dalam unit HIMETRIC (seperti halnya standar dalam OLE) ke unit yang ditentukan oleh kontainer.

Sintaks

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

Parameter

[in, out] pPtlHimetric

Alamat struktur POINTL yang berisi koordinat yang dinyatakan dalam unit HIMETRIC . Ini adalah parameter [in] ketika dwFlags berisi XFORMCOORDS_HIMETRICTOCONTAINER; ini adalah parameter [keluar] dengan XFORMCOORDS_CONTAINERTOHIMETRIC. Dalam kasus terakhir, konten tidak terdefinisi pada kesalahan.

[in, out] pPtfContainer

Alamat struktur POINTF yang dialokasikan penelepon yang menerima koordinat yang dikonversi. Ini adalah parameter [in] ketika dwFlags berisi XFORMCOORDS_CONTAINERTOHIMETRIC; ini adalah parameter [out] dengan XFORMCOORDS_HIMETRICTOCONTAINER. Dalam kasus terakhir, konten tidak terdefinisi pada kesalahan.

[in] dwFlags

Bendera yang menunjukkan konversi yang tepat untuk dilakukan. Parameter ini dapat berupa kombinasi apa pun dari nilai berikut, kecuali seperti yang ditunjukkan.

Nilai Makna
XFORMCOORDS_POSITION
0x1
 Koordinat yang akan dikonversi mewakili titik posisi. Tidak dapat digunakan dengan XFORMCOORDS_SIZE.
XFORMCOORDS_SIZE
0x2
 Koordinat yang akan dikonversi mewakili sekumpulan dimensi. Tidak dapat digunakan dengan XFORMCOORDS_POSITION.
XFORMCOORDS_HIMETRICTOCONTAINER
0x4
 Operasi mengonversi pptlHimetric menjadi pptfContainer. Tidak dapat digunakan dengan XFORMCOORDS_CONTAINERTOHIMETRIC.
XFORMCOORDS_CONTAINERTOHIMETRIC
0x8
 Operasi ini mengonversi pptfContainer menjadi pptlHimetric. Tidak dapat digunakan dengan XFORMCOORDS_HIMETRICTOCONTAINER.
XFORMCOORDS_EVENTCOMPAT
0x10
 Operasi ini mempertahankan kompatibilitas dengan suatu peristiwa.

Nilai kembali

Metode ini dapat mengembalikan nilai pengembalian standar E_INVALIDARG dan E_UNEXPECTED, serta nilai berikut.

Menampilkan kode Deskripsi
S_OK
 Metode berhasil diselesaikan.
E_NOTIMPL
 Kontainer tidak memerlukan konversi koordinat khusus. Kontainer sepenuhnya berurusan dengan HIMETRIC.
E_POINTER
 Alamat dalam pPtlHimetric atau pPtfContainer tidak valid. Misalnya, mungkin NULL.

Keterangan

Kontrol menggunakan metode ini ketika harus mengirim koordinat ke kontainer dalam suatu peristiwa atau beberapa panggilan kustom lainnya atau ketika kontrol memiliki koordinat kontainer yang perlu dikonversi menjadi unit HIMETRIC .

Persyaratan

   
Klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Target Platform Windows
Header ocidl.h

Lihat juga

IOleControlSite