Struktur GETTEXTEX (richedit.h)

Berisi informasi yang digunakan dalam mendapatkan teks dari kontrol edit yang kaya. Struktur ini digunakan dengan pesan EM_GETTEXTEX .

Sintaks

typedef struct _gettextex {
  DWORD  cb;
  DWORD  flags;
  UINT   codepage;
  LPCSTR lpDefaultChar;
  LPBOOL lpUsedDefChar;
} GETTEXTEX;

Anggota

cb

Jenis: DWORD

Ukuran, dalam byte, dari buffer yang digunakan untuk menyimpan teks yang diambil.

flags

Jenis: DWORD

Nilai yang menentukan operasi teks. Anggota ini bisa menjadi salah satu nilai berikut.

Nilai Makna
GT_DEFAULT
Semua teks diambil sesuai dengan kriteria berikut:
  • Pengembalian pengangkutan (U+000D) tidak diterjemahkan ke dalam CRLF (U+000D U+000A).
  • Karakter struktur tabel dan objek matematika dihapus (lihat GT_RAWTEXT).
  • Teks tersembunyi disertakan.
  • Nomor daftar tidak disertakan.
GT_NOHIDDENTEXT
Teks tersembunyi tidak disertakan dalam teks yang diambil.
GT_RAWTEXT
Teks diambil persis seperti yang muncul dalam memori. Ini termasuk karakter struktur khusus untuk pemisah baris tabel dan sel (lihat Keterangan untuk EM_INSERTTABLE) serta pemisah objek matematika (mulai pemisah U+FDD0, pembatas argumen U+FDEE, dan U+FDDF pemisah akhir) dan penanda objek (U+FFFC). Ini mempertahankan perataan posisi karakter antara teks yang diambil dan teks dalam memori.
GT_SELECTION
Ambil teks untuk pilihan saat ini.
GT_USECRLF
Saat menyalin teks, terjemahkan setiap CR ke dalam CR/LF.

codepage

Jenis: UINT

Halaman kode yang digunakan dalam terjemahan. Ini CP_ACP untuk halaman kode ANSI dan 1200 untuk Unicode.

lpDefaultChar

Jenis: LPCSTR

Karakter yang digunakan jika karakter lebar tidak dapat diwakili di halaman kode yang ditentukan. Ini hanya digunakan jika halaman kode bukan 1200 (Unicode). Jika anggota ini NULL, nilai default sistem akan digunakan.

lpUsedDefChar

Jenis: LPBOOL

Bendera yang menunjukkan apakah karakter default (lpDefaultChar) digunakan. Anggota ini hanya digunakan jika halaman kode bukan 1200 atau CP_UTF8 (Unicode). Bendera true jika satu atau beberapa karakter lebar dalam string sumber tidak dapat diwakili di halaman kode yang ditentukan. Jika tidak, benderanya adalah FALSE. Anggota ini bisa NULL.

Keterangan

Pesan EM_GETTEXTEX lebih cepat ketika lpDefaultChar dan lpUsedDefCharadalah NULL.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Header richedit.h

Lihat juga

EM_GETTEXTEX