Metode ITextFont::GetProtected (tom.h)

Artikel
03/02/2024

Mendapatkan apakah karakter dilindungi dari upaya untuk memodifikasinya.

Sintaks

HRESULT GetProtected(
  long *pValue
);

Parameter

pValue

Jenis: panjang*

Nilai tomBool yang bisa menjadi salah satu dari berikut ini.

Nilai	Makna
tomTrue	Karakter dilindungi.
tomFalse	Karakter tidak dilindungi.
tomUndefined	Properti Terproteksi tidak ditentukan.

Nilai kembali

Jenis: HRESULT

Jika metode berhasil, metode akan mengembalikan S_OK. Jika metode gagal, metode mengembalikan salah satu kode kesalahan COM berikut. Untuk informasi selengkapnya tentang kode kesalahan COM, lihat Penanganan Kesalahan di COM.

Menampilkan kode	Deskripsi
E_INVALIDARG	Argumen tidak valid.
CO_E_RELEASED	Objek font dilampirkan ke rentang yang telah dihapus.

Keterangan

Secara umum, metode Model Objek Teks (TOM) yang mencoba mengubah pemformatan atau konten rentang gagal dengan E_ACCESSDENIED jika ada bagian dari rentang tersebut yang dilindungi, atau jika dokumen dibaca saja. Untuk membuat perubahan dalam teks yang dilindungi, klien TOM harus mencoba menonaktifkan perlindungan teks yang akan dimodifikasi. Pemilik dokumen dapat mengizinkan hal ini terjadi. Misalnya dalam kontrol edit kaya, upaya untuk mengubah teks yang dilindungi menghasilkan kode pemberitahuan EN_PROTECTED kepada pembuat dokumen, yang kemudian dapat menolak atau memberikan izin untuk perubahan tersebut. Pembuat adalah klien yang membuat kontrol edit kaya berjendela melalui fungsi CreateWindow atau objek ITextHost yang disebut fungsi CreateTextServices untuk membuat kontrol edit kaya tanpa jendela.

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	tom.h
DLL	Msftedit.dll