Bagikan melalui


Metode ITextHost::TxGetMaxLength (textserv.h)

Mendapatkan panjang maksimum host teks yang diizinkan untuk teks.

Sintaks

HRESULT TxGetMaxLength(
  DWORD *plength
);

Parameter

plength

Jenis: DWORD*

Panjang teks maksimum yang diizinkan, dalam jumlah karakter. Jika INFINITE dikembalikan, objek layanan teks dapat menggunakan memori sebanyak yang diperlukan untuk menyimpan teks yang ditentukan.

Menampilkan nilai

Jenis: HRESULT

Nilai yang dikembalikan S_OK.

Keterangan

Ketika maksimum ini tercapai, objek layanan teks harus menolak penyisipan karakter lebih lanjut dan teks yang ditempelkan. Namun TxSetText masih harus menerima (dan mengatur) teks lebih panjang dari panjang maksimum. Ini karena metode ini digunakan untuk pengikatan dan sangat penting untuk mempertahankan integritas data yang terikat dengan kontrol.

Metode ini menyejajarkan pesan EM_LIMITTEXT .

Jika batas yang dikembalikan kurang dari jumlah karakter yang saat ini ada di objek layanan teks, tidak ada data yang hilang. Sebaliknya, tidak ada pengeditan yang diizinkan untuk teks selain penghapusan sampai teks dikurangi menjadi di bawah batas.

Persyaratan

   
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

Lihat juga

Konseptual

EM_LIMITTEXT

ITextHost

Referensi

Kontrol Edit Kaya Tanpa Jendela