Metode ITextServices::TxGetNaturalSize (textserv.h)

Artikel
08/26/2023

Memungkinkan kontrol diubah ukurannya sehingga sesuai dengan kontennya dengan tepat.

Sintaks

HRESULT TxGetNaturalSize(
            DWORD          dwAspect,
            HDC            hdcDraw,
            HDC            hicTargetDev,
            DVTARGETDEVICE *ptd,
            DWORD          dwMode,
            const SIZEL    *psizelExtent,
  [in, out] LONG           *pwidth,
  [in, out] LONG           *pheight
);

Parameter

dwAspect

Jenis: DWORD

Aspek untuk gambar. Ini bisa menjadi salah satu nilai dari enumerasi DVASPECT .

hdcDraw

Jenis: HDC

Konteks perangkat tempat gambar terjadi.

hicTargetDev

Jenis: HDC

Konteks perangkat yang teksnya harus diformat (yaitu, untuk WYSIWYG).

ptd

Jenis: DVTARGETDEVICE*

Informasi selengkapnya tentang perangkat target.

dwMode

Jenis: DWORD

Jenis pas yang diminta. Ini bisa menjadi salah satu dari berikut ini.

Nilai	Makna
TXTNS_EMU	Gunakan Unit Metrik Bahasa Inggris (EMU) alih-alih piksel sebagai unit pengukuran untuk parameter metode ini.
TXTNS_FITTOCONTENT	Mengubah ukuran kontrol agar pas dengan seluruh teks dengan memformat teks ke lebar yang diteruskan. Objek layanan teks mengembalikan tinggi seluruh teks dan lebar garis terluas. Misalnya, ini harus dilakukan ketika pengguna mengklik dua kali salah satu handel kontrol.
TXTNS_FITTOCONTENT2	Mengubah ukuran kontrol agar pas dengan konten yang diindentasi.
TXTNS_FITTOCONTENT3	Mengubah ukuran kontrol sehingga pas dengan konten yang diindentasi dan spasi kosong berikutnya.
TXTNS_FITTOCONTENTWSP	Mengubah ukuran kontrol sehingga pas dengan konten yang tidak diindentasi dan spasi kosong berikutnya.
TXTNS_INCLUDELASTLINE	Untuk kontrol teks biasa, sertakan tinggi pengembalian pengangkutan akhir saat menghitung ukuran.
TXTNS_ROUNDTOLINE	Mengubah ukuran kontrol untuk memperlihatkan jumlah baris integral (tidak ada garis yang dipotong). Format teks yang cukup untuk mengisi lebar dan tinggi yang diteruskan, lalu kembalikan tinggi yang dibulatkan ke batas garis terdekat. Catatan Lebar dan tinggi yang diteruskan dan dikembalikan sesuai dengan persegi tampilan. Host harus menyesuaikan kembali ke persegi panjang klien sesuai kebutuhan. Karena nilai-nilai ini mewakili jangkauan objek teks, nilai tersebut adalah input dan output dalam koordinat HIMETRIC (setiap unit HIMETRIC adalah .01 milimeter), dan pengukuran tidak termasuk faktor zoom apa pun. Untuk diskusi tentang faktor zoom, lihat TxGetExtent.

psizelExtent

Jenis: const SIZEL*

Tidak didukung.

[in, out] pwidth

Jenis: LONG*

Lebar untuk penyesuaian yang ditentukan oleh dwMode.

[in, out] pheight

Jenis: LONG*

Tinggi untuk pengepasan yang ditentukan oleh dwMode.

Mengembalikan nilai

Jenis: HRESULT

Jika metode berhasil, nilai yang dikembalikan adalah S_OK.

Jika layanan teks tidak dapat mengaktifkan objek, nilai yang dikembalikan adalah salah satu kode HRESULT berikut. Untuk informasi selengkapnya tentang kode kesalahan COM, lihat Penanganan Kesalahan di COM.

Menampilkan kode	Deskripsi
E_FAIL	Tidak dapat menentukan ukuran yang benar.
E_INVALIDARG	Satu atau beberapa argumen tidak valid.
E_OUTOFMEMORY	Memori tidak cukup.

Keterangan

Empat parameter pertama mirip dengan parameter yang setara di ITextServices::TxDraw dan memberikan informasi yang sama. Dalam kasus di mana baris harus dihitung ulang, baris harus menggunakan nilai-nilai ini dengan cara yang sama seperti dalam ITextServices::TxDraw.

Parameter pwidth dan pheight adalah parameter masuk/keluar. Host melewati lebar dan tinggi tentatif dari tingkat alami objek teks. Objek layanan teks membandingkan nilai-nilai ini dengan status cache saat ini, dan jika berbeda, hitung ulang baris. Kemudian, ia menghitung dan mengembalikan ukuran alami, seperti yang ditentukan oleh dwMode.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	textserv.h
DLL	Msftedit.dll