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
Referensi