CRichEditCtrl Kelas

Menyediakan fungsionalitas kontrol edit yang kaya.

Sintaks

class CRichEditCtrl : public CWnd

Anggota

Konstruktor Publik

Nama	Deskripsi
CRichEditCtrl::CRichEditCtrl	Membuat CRichEditCtrl objek.

Metode Publik

Nama	Deskripsi
CRichEditCtrl::CanPaste	Menentukan apakah isi Papan Klip dapat ditempelkan ke kontrol edit kaya ini.
CRichEditCtrl::CanRedo	Menentukan apakah ada tindakan dalam antrean pengulangan kontrol.
CRichEditCtrl::CanUndo	Menentukan apakah operasi pengeditan dapat dibatalkan.
CRichEditCtrl::CharFromPos	Mengambil informasi tentang karakter yang paling dekat dengan titik tertentu di area klien kontrol edit.
CRichEditCtrl::Clear	Menghapus pilihan saat ini.
CRichEditCtrl::Copy	Menyalin pilihan saat ini ke Papan Klip.
CRichEditCtrl::Create	Membuat kontrol edit kaya Windows dan mengaitkannya dengan objek ini CRichEditCtrl .
CRichEditCtrl::CreateEx	Membuat kontrol edit kaya Windows dengan gaya Windows yang diperluas yang ditentukan dan mengaitkannya dengan objek ini CRichEditCtrl .
CRichEditCtrl::Cut	Memotong pilihan saat ini ke Papan Klip.
CRichEditCtrl::DisplayBand	Menampilkan sebagian isi objek ini CRichEditCtrl .
CRichEditCtrl::EmptyUndoBuffer	Mereset (menghapus) bendera batalkan objek ini CRichEditCtrl .
CRichEditCtrl::FindText	Menemukan teks di dalam objek ini CRichEditCtrl .
CRichEditCtrl::FindWordBreak	Menemukan pemisah kata berikutnya sebelum atau sesudah posisi karakter yang ditentukan, atau mengambil informasi tentang karakter pada posisi tersebut.
CRichEditCtrl::FormatRange	Memformat rentang teks untuk perangkat output target.
CRichEditCtrl::GetCharPos	Menentukan lokasi karakter tertentu dalam objek ini CRichEditCtrl .
CRichEditCtrl::GetDefaultCharFormat	Mengambil atribut pemformatan karakter default saat ini dalam objek ini CRichEditCtrl .
CRichEditCtrl::GetEventMask	Mengambil masker peristiwa untuk objek ini CRichEditCtrl .
CRichEditCtrl::GetFirstVisibleLine	Menentukan garis paling atas yang terlihat dalam objek ini CRichEditCtrl .
CRichEditCtrl::GetIRichEditOle	Mengambil penunjuk ke IRichEditOle antarmuka untuk kontrol edit kaya ini.
CRichEditCtrl::GetLimitText	Mendapatkan batasan jumlah teks yang dapat dimasukkan pengguna ke dalam objek ini CRichEditCtrl .
CRichEditCtrl::GetLine	Mengambil baris teks dari objek ini CRichEditCtrl .
CRichEditCtrl::GetLineCount	Mengambil jumlah baris dalam objek ini CRichEditCtrl .
CRichEditCtrl::GetModify	Menentukan apakah isi objek ini CRichEditCtrl telah berubah sejak penyimpanan terakhir.
CRichEditCtrl::GetOptions	Mengambil opsi kontrol edit yang kaya.
CRichEditCtrl::GetParaFormat	Mengambil atribut pemformatan paragraf dalam pilihan saat ini dalam objek ini CRichEditCtrl .
CRichEditCtrl::GetPunctuation	Mengambil karakter tanda baca saat ini untuk kontrol edit kaya. Pesan ini hanya tersedia dalam versi bahasa Asia dari sistem operasi.
CRichEditCtrl::GetRect	Mengambil persegi panjang pemformatan untuk objek ini CRichEditCtrl .
CRichEditCtrl::GetRedoName	Mengambil jenis tindakan berikutnya, jika ada, dalam antrean pengulangan kontrol.
CRichEditCtrl::GetSel	Mendapatkan posisi awal dan akhir dari pilihan saat ini dalam objek ini CRichEditCtrl .
CRichEditCtrl::GetSelectionCharFormat	Mengambil atribut pemformatan karakter dalam pilihan saat ini dalam objek ini CRichEditCtrl .
CRichEditCtrl::GetSelectionType	Mengambil tipe isi dalam pilihan saat ini dalam objek ini CRichEditCtrl .
CRichEditCtrl::GetSelText	Mendapatkan teks pilihan saat ini dalam objek ini CRichEditCtrl
CRichEditCtrl::GetTextLength	Mengambil panjang teks, dalam karakter, dalam objek ini CRichEditCtrl . Tidak termasuk karakter null yang mengakhiri.
CRichEditCtrl::GetTextLengthEx	Mengambil jumlah karakter atau byte dalam tampilan edit kaya. Menerima daftar bendera untuk menunjukkan metode penentuan panjang teks dalam kontrol edit yang kaya
CRichEditCtrl::GetTextMode	Mengambil mode teks saat ini dan membatalkan tingkat kontrol edit yang kaya.
CRichEditCtrl::GetTextRange	Mengambil rentang teks yang ditentukan.
CRichEditCtrl::GetUndoName	Mengambil jenis tindakan batalkan berikutnya, jika ada.
CRichEditCtrl::GetWordWrapMode	Mengambil opsi pembungkusan kata dan pemecahan kata saat ini untuk kontrol edit kaya. Pesan ini hanya tersedia dalam versi bahasa Asia dari sistem operasi.
CRichEditCtrl::HideSelection	Memperlihatkan atau menyembunyikan pilihan saat ini.
CRichEditCtrl::LimitText	Membatasi jumlah teks yang dapat dimasukkan pengguna ke CRichEditCtrl dalam objek.
CRichEditCtrl::LineFromChar	Menentukan baris mana yang berisi karakter yang diberikan.
CRichEditCtrl::LineIndex	Mengambil indeks karakter dari baris tertentu dalam objek ini CRichEditCtrl .
CRichEditCtrl::LineLength	Mengambil panjang baris tertentu dalam objek ini CRichEditCtrl .
CRichEditCtrl::LineScroll	Menggulir teks dalam objek ini CRichEditCtrl .
CRichEditCtrl::Paste	Sisipkan isi Papan Klip ke kontrol edit kaya ini.
CRichEditCtrl::PasteSpecial	Sisipkan isi Papan Klip ke kontrol edit kaya ini dalam format data yang ditentukan.
CRichEditCtrl::PosFromChar	Mengambil koordinat area klien dari karakter tertentu dalam kontrol edit.
CRichEditCtrl::Redo	Mengulangi tindakan berikutnya dalam antrean pengulangan kontrol.
CRichEditCtrl::ReplaceSel	Mengganti pilihan saat ini dalam objek ini CRichEditCtrl dengan teks yang ditentukan.
CRichEditCtrl::RequestResize	Memaksa objek ini CRichEditCtrl untuk mengirim pemberitahuan mengubah ukuran permintaan.
CRichEditCtrl::SetAutoURLDetect	Menunjukkan apakah deteksi URL otomatis aktif dalam kontrol edit yang kaya.
CRichEditCtrl::SetBackgroundColor	Menyetel warna latar belakang dalam objek ini CRichEditCtrl .
CRichEditCtrl::SetDefaultCharFormat	Menyetel atribut pemformatan karakter default saat ini dalam objek ini CRichEditCtrl .
CRichEditCtrl::SetEventMask	Mengatur masker peristiwa untuk objek ini CRichEditCtrl .
CRichEditCtrl::SetModify	Mengatur atau menghapus bendera modifikasi untuk objek ini CRichEditCtrl .
CRichEditCtrl::SetOLECallback	IRichEditOleCallback Mengatur objek COM untuk kontrol edit kaya ini.
CRichEditCtrl::SetOptions	Mengatur opsi untuk objek ini CRichEditCtrl .
CRichEditCtrl::SetParaFormat	Menyetel atribut pemformatan paragraf dalam pilihan saat ini dalam objek ini CRichEditCtrl .
CRichEditCtrl::SetPunctuation	Mengatur karakter tanda baca untuk kontrol edit yang kaya. Pesan ini hanya tersedia dalam versi bahasa Asia dari sistem operasi.
CRichEditCtrl::SetReadOnly	Mengatur opsi baca-saja untuk objek ini CRichEditCtrl .
CRichEditCtrl::SetRect	Menyetel persegi panjang pemformatan untuk objek ini CRichEditCtrl .
CRichEditCtrl::SetSel	Menyetel pilihan dalam objek ini CRichEditCtrl .
CRichEditCtrl::SetSelectionCharFormat	Menyetel atribut pemformatan karakter dalam pilihan saat ini dalam objek ini CRichEditCtrl .
CRichEditCtrl::SetTargetDevice	Mengatur perangkat output target untuk objek ini CRichEditCtrl .
CRichEditCtrl::SetTextMode	Mengatur mode teks atau mengurungkan tingkat kontrol edit yang kaya. Pesan gagal jika kontrol berisi teks.
CRichEditCtrl::SetUndoLimit	Mengatur jumlah maksimum tindakan yang dapat disimpan dalam antrean batalkan.
CRichEditCtrl::SetWordCharFormat	Menyetel atribut pemformatan karakter dalam kata saat ini dalam objek ini CRichEditCtrl .
CRichEditCtrl::SetWordWrapMode	Mengatur opsi pembungkusan kata dan pemecahan kata untuk kontrol edit kaya. Pesan ini hanya tersedia dalam versi bahasa Asia dari sistem operasi.
CRichEditCtrl::StopGroupTyping	Menghentikan kontrol mengumpulkan tindakan pengetikan tambahan ke dalam tindakan batalkan saat ini. Kontrol menyimpan tindakan pengetikan berikutnya, jika ada, ke dalam tindakan baru dalam antrean batalkan.
CRichEditCtrl::StreamIn	Menyisipkan teks dari aliran input ke dalam objek ini CRichEditCtrl .
CRichEditCtrl::StreamOut	Menyimpan teks dari objek ini CRichEditCtrl ke dalam aliran output.
CRichEditCtrl::Undo	Membalikkan operasi pengeditan terakhir.

Keterangan

"Kontrol edit kaya" adalah jendela tempat pengguna dapat memasukkan dan mengedit teks. Teks dapat ditetapkan karakter dan pemformatan paragraf, dan dapat menyertakan objek OLE yang disematkan. Kontrol edit kaya menyediakan antarmuka pemrograman untuk memformat teks. Namun, aplikasi harus menerapkan komponen antarmuka pengguna apa pun yang diperlukan untuk membuat operasi pemformatan tersedia untuk pengguna.

Kontrol Windows Common ini (dan oleh karena itu CRichEditCtrl kelas) hanya tersedia untuk program yang berjalan di bawah Windows 95/98 dan Windows NT versi 3.51 dan yang lebih baru. Kelas ini CRichEditCtrl mendukung kontrol edit kaya Windows SDK versi 2.0 dan 3.0.

Perhatian

Jika Anda menggunakan kontrol edit kaya dalam kotak dialog (terlepas dari apakah aplikasi Anda berbasis SDI, MDI, atau dialog), Anda harus memanggil AfxInitRichEdit sekali sebelum kotak dialog ditampilkan. Tempat umum untuk memanggil fungsi ini ada di fungsi anggota program InitInstance Anda. Anda tidak perlu memanggilnya untuk setiap kali Anda menampilkan kotak dialog, hanya pertama kalinya. Anda tidak perlu menelepon AfxInitRichEdit jika Anda bekerja dengan CRichEditView.

Untuk informasi selengkapnya tentang menggunakan CRichEditCtrl, lihat:

• Kontrol

• Menggunakan CRichEditCtrl

Untuk contoh penggunaan kontrol edit yang kaya dalam aplikasi MFC, lihat aplikasi sampel WORDPAD .

Hierarki Warisan

CObject

CCmdTarget

CWnd

CRichEditCtrl

Persyaratan

Header: afxcmn.h

CRichEditCtrl::CanPaste

Menentukan apakah kontrol edit kaya dapat menempelkan format Papan Klip yang ditentukan.

BOOL CanPaste(UINT nFormat = 0) const;

Parameter

nFormat
Format data Clipboard untuk dikueri. Parameter ini bisa menjadi salah satu format Clipboard yang telah ditentukan sebelumnya atau nilai yang dikembalikan oleh RegisterClipboardFormat.

Tampilkan Nilai

Bukan nol jika format Clipboard dapat ditempelkan; jika tidak, 0.

Keterangan

Jika nFormat adalah 0, CanPaste akan mencoba format apa pun yang saat ini ada di Clipboard.

Untuk informasi selengkapnya, lihat EM_CANPASTE pesan dan RegisterClipboardFormat fungsi di Windows SDK.

Contoh

// Paste the clipboard data if possible.
if (m_myRichEditCtrl.CanPaste())
{
   m_myRichEditCtrl.Paste();
}

CRichEditCtrl::CanRedo

Menentukan apakah antrean pengulangan berisi tindakan apa pun.

BOOL CanRedo() const;

Tampilkan Nilai

Nonzero jika antrean pengulangan berisi tindakan, jika tidak, 0.

Keterangan

Untuk menemukan nama operasi dalam antrean pengulangan, panggil CRichEditCtrl::GetRedoName. Untuk mengulangi operasi Batalkan terbaru, panggil Redo.

Untuk informasi selengkapnya, lihat EM_CANREDO di Windows SDK.

CRichEditCtrl::CanUndo

Menentukan apakah operasi pengeditan terakhir dapat dibatalkan.

BOOL CanUndo() const;

Tampilkan Nilai

Bukan nol jika operasi edit terakhir dapat dibatalkan dengan panggilan ke Undo fungsi anggota; 0 jika tidak dapat dibatalkan.

Keterangan

Untuk informasi selengkapnya, lihat EM_CANUNDO di Windows SDK.

Contoh

// Undo the last operation, if possible.
if (m_myRichEditCtrl.CanUndo())
   m_myRichEditCtrl.Undo();

CRichEditCtrl::CharFromPos

Mengambil informasi tentang karakter pada titik yang ditentukan oleh parameter pt.

int CharFromPos(CPoint pt) const;

Parameter

pt
Objek CPoint yang berisi koordinat titik yang ditentukan.

Tampilkan Nilai

Indeks karakter berbasis nol dari karakter terdekat dengan titik yang ditentukan. Jika titik yang ditentukan berada di luar karakter terakhir dalam kontrol, nilai pengembalian menunjukkan karakter terakhir dalam kontrol.

Keterangan

Fungsi anggota ini bekerja dengan kontrol edit yang kaya. Untuk mendapatkan informasi kontrol edit, panggil CEdit::CharFromPos.

Untuk informasi selengkapnya, lihat EM_CHARFROMPOS di Windows SDK.

CRichEditCtrl::Clear

Menghapus (menghapus) pilihan saat ini (jika ada) dalam kontrol edit kaya.

void Clear();

Keterangan

Penghapusan yang dilakukan oleh Clear dapat dibatalkan dengan memanggil Undo fungsi anggota.

Untuk menghapus pilihan saat ini dan menempatkan konten yang dihapus ke Clipboard, panggil Cut fungsi anggota.

Untuk informasi selengkapnya, lihat WM_CLEAR di Windows SDK.

Contoh

// Delete all of the text.
m_myRichEditCtrl.SetSel(0, -1);
m_myRichEditCtrl.Clear();

CRichEditCtrl::Copy

Menyalin pilihan saat ini (jika ada) di kontrol edit kaya ke Clipboard.

void Copy();

Keterangan

Untuk informasi selengkapnya, lihat WM_COPY di Windows SDK.

Contoh

// Copy all of the text to the clipboard.
m_myRichEditCtrl.SetSel(0, -1);
m_myRichEditCtrl.Copy();

CRichEditCtrl::Create

Membuat kontrol edit kaya Windows dan mengaitkannya dengan objek ini CRichEditCtrl .

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parameter

dwStyle
Menentukan gaya kontrol edit. Terapkan kombinasi gaya jendela yang tercantum di bagian Keterangan di bawah ini, dan edit gaya kontrol, yang dijelaskan dalam Windows SDK.

rect
Menentukan ukuran dan posisi kontrol edit. Bisa menjadi CRect objek atau RECT struktur.

pParentWnd
Menentukan jendela induk kontrol edit (sering kali ).CDialog Ini tidak boleh NULL.

nID
Menentukan ID kontrol edit.

Tampilkan Nilai

Bukan nol jika inisialisasi berhasil; jika tidak, 0.

Keterangan

Anda membuat CRichEditCtrl objek dalam dua langkah. Pertama, panggil CRichEditCtrl konstruktor, lalu panggil Create, yang membuat kontrol edit Windows dan melampirkannya ke CRichEditCtrl objek.

Saat Anda membuat kontrol edit kaya dengan fungsi ini, pertama-tama Anda harus memuat pustaka kontrol umum yang diperlukan. Untuk memuat pustaka, panggil fungsi AfxInitRichEditglobal , yang pada gilirannya menginisialisasi pustaka kontrol umum. Anda hanya perlu memanggil AfxInitRichEdit sekali dalam proses Anda.

Saat Create dijalankan, Windows mengirimkan WM_NCCREATEpesan , , WM_NCCALCSIZEWM_CREATE, dan WM_GETMINMAXINFO ke kontrol edit.

Pesan ini ditangani secara default oleh OnNcCreatefungsi anggota , , OnNcCalcSizeOnCreate, dan OnGetMinMaxInfo di CWnd kelas dasar. Untuk memperluas penanganan pesan default, dapatkan kelas dari CRichEditCtrl, tambahkan peta pesan ke kelas baru, dan ambil alih fungsi anggota penanganan pesan di atas. Ambil alih OnCreate, misalnya, untuk melakukan inisialisasi yang diperlukan untuk kelas baru.

Terapkan gaya jendela berikut ke kontrol edit.

• WS_CHILD Selalu.

• WS_VISIBLE Biasanya.

• WS_DISABLED Jarang.

• WS_GROUP Untuk mengelompokkan kontrol.

• WS_TABSTOP Untuk menyertakan kontrol edit dalam urutan tab.

Untuk informasi selengkapnya tentang gaya jendela, lihat CreateWindow di Windows SDK.

Contoh

m_myRichEditCtrl.Create(
    WS_CHILD | WS_VISIBLE | WS_BORDER | ES_MULTILINE,
    CRect(10, 10, 100, 200), pParentWnd, IDD_RICHEDITCTRL);

CRichEditCtrl::CreateEx

Membuat kontrol (jendela anak) dan mengaitkannya dengan CRichEditCtrl objek.

virtual BOOL CreateEx(
    DWORD dwExStyle,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parameter

dwExStyle
Menentukan gaya kontrol yang diperluas yang sedang dibuat. Untuk daftar gaya Windows yang diperluas, lihat dwExStyle parameter untuk CreateWindowEx di Windows SDK.

dwStyle
Menentukan gaya kontrol edit. Terapkan kombinasi gaya jendela yang tercantum di bagian Keterangan dari Create dan edit gaya kontrol, yang dijelaskan dalam Windows SDK.

rect
Referensi ke struktur yang RECT menjelaskan ukuran dan posisi jendela yang akan dibuat, dalam koordinat klien .pParentWnd

pParentWnd
Penunjuk ke jendela yang merupakan induk kontrol.

nID
ID jendela anak kontrol.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Keterangan

Gunakan CreateEx alih-alih Create untuk menerapkan gaya Windows yang diperluas, yang ditentukan oleh preface WS_EX_gaya windows yang diperluas .

CRichEditCtrl::CRichEditCtrl

Membuat CRichEditCtrl objek.

CRichEditCtrl();

Keterangan

Gunakan Create untuk membangun kontrol edit kaya Windows.

Contoh

// Declare a local CRichEditCtrl object.
CRichEditCtrl myRichEditCtrl;

// Declare a dynamic CRichEditCtrl object.
CRichEditCtrl* pRichEditCtrl = new CRichEditCtrl;

CRichEditCtrl::Cut

Hapus (potong) pilihan saat ini (jika ada) di kontrol edit kaya dan salin teks yang dihapus ke Clipboard.

void Cut();

Keterangan

Penghapusan yang dilakukan oleh Cut dapat dibatalkan dengan memanggil Undo fungsi anggota.

Untuk menghapus pilihan saat ini tanpa menempatkan teks yang dihapus ke Clipboard, panggil Clear fungsi anggota.

Untuk informasi selengkapnya, lihat WM_CUT di Windows SDK.

Contoh

// Delete all of the text and copy it to the clipboard.
m_myRichEditCtrl.SetSel(0, -1);
m_myRichEditCtrl.Cut();

CRichEditCtrl::DisplayBand

Menampilkan sebagian konten kontrol edit kaya (teks dan item OLE), seperti yang sebelumnya diformat oleh FormatRange.

BOOL DisplayBand(LPRECT pDisplayRect);

Parameter

pDisplayRect
Penunjuk RECT ke objek atau CRect yang menentukan area perangkat untuk menampilkan teks.

Tampilkan Nilai

Bukan nol jika tampilan teks yang diformat berhasil, jika tidak, 0.

Keterangan

Teks dan item OLE diklip ke area yang ditentukan oleh penunjuk pDisplayRect.

Untuk informasi selengkapnya, lihat EM_DISPLAYBAND di Windows SDK.

Contoh

Lihat contoh untuk CRichEditCtrl::FormatRange.

CRichEditCtrl::EmptyUndoBuffer

Mengatur ulang (menghapus) bendera batalkan kontrol edit kaya ini.

void EmptyUndoBuffer();

Keterangan

Kontrol sekarang tidak akan dapat membatalkan operasi pengeditan terakhir. Bendera batalkan diatur setiap kali operasi dalam kontrol edit kaya dapat dibatalkan.

Bendera batalkan secara otomatis dihapus setiap kali Anda memanggil CWnd fungsi SetWindowTextanggota .

Untuk informasi selengkapnya, lihat EM_EMPTYUNDOBUFFER di Windows SDK.

Contoh

// Clear the undo buffer.
if (m_myRichEditCtrl.CanUndo())
{
   m_myRichEditCtrl.EmptyUndoBuffer();
   ASSERT(!m_myRichEditCtrl.CanUndo());
}

CRichEditCtrl::FindText

Menemukan teks dalam kontrol edit kaya.

long FindText(
    DWORD dwFlags,
    FINDTEXTEX* pFindText) const;

Parameter

dwFlags
Untuk daftar nilai yang mungkin, lihat wParam di EM_FINDTEXTEXT Windows SDK.

pFindText
Penunjuk ke FINDTEXTEX struktur yang memberikan parameter untuk pencarian dan mengembalikan rentang tempat kecocokan ditemukan.

Tampilkan Nilai

Posisi karakter berbasis nol dari kecocokan berikutnya; - 1 jika tidak ada lagi kecocokan.

Keterangan

Anda dapat mencari ke atas atau ke bawah dengan mengatur parameter rentang yang CHARRANGE tepat dalam struktur dalam FINDTEXTEX struktur.

Untuk informasi selengkapnya, lihat EM_FINDTEXTEX pesan dan FINDTEXTEX struktur di Windows SDK.

Contoh

// Set the selection to be the first occurrence of the
// string lpszmyString, if it is found.
FINDTEXTEX ft;
ft.chrg.cpMin = 0;
ft.chrg.cpMax = 50;
ft.lpstrText = _T("wallaby");
long n = m_myRichEditCtrl.FindText(FR_MATCHCASE | FR_WHOLEWORD, &ft);
if (n != -1)
   m_myRichEditCtrl.SetSel(ft.chrgText);

CRichEditCtrl::FindWordBreak

Menemukan pemisah kata berikutnya sebelum atau sesudah posisi yang ditentukan oleh nStart.

DWORD FindWordBreak(
    UINT nCode,
    DWORD nStart) const;

Parameter

nCode
Menunjukkan tindakan yang harus diambil. Untuk daftar nilai yang mungkin, lihat deskripsi untuk parameter code di EM_FINDWORDBREAK di Windows SDK.

nStart
Posisi karakter berbasis nol untuk memulai.

Tampilkan Nilai

Berdasarkan parameter nCode. Untuk informasi selengkapnya, lihat EM_FINDWORDBREAK di Windows SDK.

Keterangan

Anda dapat menggunakan fungsi anggota ini untuk mengambil informasi tentang karakter pada posisi tertentu.

CRichEditCtrl::FormatRange

Memformat rentang teks dalam kontrol edit yang kaya untuk perangkat tertentu.

long FormatRange(
    FORMATRANGE* pfr,
    BOOL bDisplay = TRUE);

Parameter

pfr
Penunjuk ke FORMATRANGE struktur yang berisi informasi tentang perangkat output. NULL menunjukkan bahwa informasi yang di-cache dalam kontrol edit yang kaya dapat dibebaskan.

bDisplay
Menunjukkan apakah teks harus dirender. Jika FALSE, teks baru saja diukur.

Tampilkan Nilai

Indeks karakter terakhir yang pas di wilayah ditambah satu.

Keterangan

Biasanya, panggilan ini diikuti dengan panggilan ke DisplayBand.

Untuk informasi selengkapnya, lihat EM_FORMATRANGE pesan dan FORMATRANGE struktur di Windows SDK.

Contoh

// First obtain a pointer to a printer DC.
CPageSetupDialog psDlg;
if (IDOK == psDlg.DoModal())
{
   CDC *pMyPrinterDC = CDC::FromHandle(psDlg.CreatePrinterDC());

   FORMATRANGE fr;

   // Get the page width and height from the printer.
   long lPageWidth = ::MulDiv(pMyPrinterDC->GetDeviceCaps(PHYSICALWIDTH),
                              1440, pMyPrinterDC->GetDeviceCaps(LOGPIXELSX));
   long lPageHeight = ::MulDiv(pMyPrinterDC->GetDeviceCaps(PHYSICALHEIGHT),
                               1440, pMyPrinterDC->GetDeviceCaps(LOGPIXELSY));
   CRect rcPage(0, 0, lPageWidth, lPageHeight);

   // Format the text and render it to the printer.
   fr.hdc = pMyPrinterDC->m_hDC;
   fr.hdcTarget = pMyPrinterDC->m_hDC;
   fr.rc = rcPage;
   fr.rcPage = rcPage;
   fr.chrg.cpMin = 0;
   fr.chrg.cpMax = -1;
   m_myRichEditCtrl.FormatRange(&fr, TRUE);

   // Update the display with the new formatting.
   RECT rcClient;
   m_myRichEditCtrl.GetClientRect(&rcClient);
   m_myRichEditCtrl.DisplayBand(&rcClient);

   pMyPrinterDC->DeleteDC();
}

CRichEditCtrl::GetCharPos

Mendapatkan posisi (sudut kiri atas) dari karakter tertentu dalam objek ini CRichEditCtrl .

CPoint GetCharPos(long lChar) const;

Parameter

lChar
Indeks karakter berbasis nol.

Tampilkan Nilai

Lokasi sudut kiri atas karakter yang ditentukan oleh lChar.

Keterangan

Karakter ditentukan dengan memberikan nilai indeks berbasis nol. Jika lChar lebih besar dari indeks karakter terakhir dalam objek ini CRichEditCtrl , nilai pengembalian menentukan koordinat posisi karakter hanya melewati karakter terakhir dalam objek ini CRichEditCtrl .

Untuk informasi selengkapnya, lihat EM_POSFROMCHAR di Windows SDK.

CRichEditCtrl::GetDefaultCharFormat

Mendapatkan atribut pemformatan karakter default dari objek ini CRichEditCtrl .

DWORD GetDefaultCharFormat(CHARFORMAT& cf) const;
DWORD GetDefaultCharFormat(CHARFORMAT2& cf) const;

Parameter

cf
Di versi pertama, penunjuk ke struktur yang CHARFORMAT memegang atribut pemformatan karakter default.

Di versi kedua, penunjuk ke CHARFORMAT2 struktur, yang merupakan ekstensi Rich Edit 2.0 ke CHARFORMAT struktur, memegang atribut pemformatan karakter default.

Tampilkan Nilai

Anggota dwMask data dari cf. Ini menentukan atribut pemformatan karakter default.

Keterangan

Untuk informasi selengkapnya, lihat EM_GETCHARFORMAT pesan dan CHARFORMAT struktur dan CHARFORMAT2 di Windows SDK.

Contoh

Lihat contoh untuk SetDefaultCharFormat.

CRichEditCtrl::GetEventMask

Mendapatkan masker peristiwa untuk objek ini CRichEditCtrl .

long GetEventMask() const;

Tampilkan Nilai

Masker peristiwa untuk objek ini CRichEditCtrl .

Keterangan

Masker peristiwa menentukan pesan CRichEditCtrl pemberitahuan mana yang dikirim objek ke jendela induknya.

Untuk informasi selengkapnya, lihat EM_GETEVENTMASK di Windows SDK.

Contoh

Lihat contoh untuk CRichEditCtrl::SetEventMask.

CRichEditCtrl::GetFirstVisibleLine

Menentukan garis paling atas yang terlihat dalam objek ini CRichEditCtrl .

int GetFirstVisibleLine() const;

Tampilkan Nilai

Indeks berbasis nol dari garis paling atas terlihat dalam objek ini CRichEditCtrl .

Keterangan

Untuk informasi selengkapnya, lihat EM_GETFIRSTVISIBLELINE di Windows SDK.

Contoh

int nFirstVisible = m_myRichEditCtrl.GetFirstVisibleLine();

// Scroll the rich edit control so that the first visible line
// is the first line of text.
if (nFirstVisible > 0)
{
   m_myRichEditCtrl.LineScroll(-nFirstVisible, 0);
}

CRichEditCtrl::GetIRichEditOle

IRichEditOle Mengakses antarmuka untuk objek iniCRichEditCtrl.

IRichEditOle* GetIRichEditOle() const;

Tampilkan Nilai

Penunjuk ke IRichEditOle antarmuka yang dapat digunakan untuk mengakses fungsionalitas OLE objek ini CRichEditCtrl ; NULL jika antarmuka tidak dapat diakses.

Keterangan

Gunakan antarmuka ini untuk mengakses fungsionalitas OLE objek ini CRichEditCtrl .

Untuk informasi selengkapnya, lihat EM_GETOLEINTERFACE pesan dan IRichEditOle antarmuka di Windows SDK.

CRichEditCtrl::GetLimitText

Mendapatkan batas teks untuk objek ini CRichEditCtrl .

long GetLimitText() const;

Tampilkan Nilai

Batas teks saat ini, dalam byte, untuk objek ini CRichEditCtrl .

Keterangan

Batas teks adalah jumlah maksimum teks, dalam byte, kontrol edit kaya dapat menerima.

Untuk informasi selengkapnya, lihat EM_GETLIMITTEXT di Windows SDK.

Contoh

// The new text of the rich edit control.
LPCTSTR lpszmyString = _T("Here's some text in our rich edit control!");
long nLength = (long)_tcslen(lpszmyString);

// Want the text limit to be at least the size of the new string.
if (m_myRichEditCtrl.GetLimitText() < nLength)
   m_myRichEditCtrl.LimitText(nLength);

m_myRichEditCtrl.SetWindowText(lpszmyString);

CRichEditCtrl::GetLine

Mengambil baris teks dari objek ini CRichEditCtrl .

int GetLine(
    int nIndex,
    LPTSTR lpszBuffer) const;

int GetLine(
    int nIndex,
    LPTSTR lpszBuffer,
    int nMaxLength) const;

Parameter

nIndex
Indeks berbasis nol dari baris yang akan diambil.

lpszBuffer
Arahkan ke buffer untuk menerima teks. Kata pertama buffer harus menentukan jumlah maksimum byte yang dapat disalin ke dalam buffer.

nMaxLength
Jumlah maksimum karakter yang dapat disalin ke dalam lpszBuffer. Bentuk GetLine kedua menempatkan nilai ini ke dalam kata pertama buffer yang ditentukan oleh lpszBuffer.

Tampilkan Nilai

Jumlah karakter yang disalin ke dalam lpszBuffer.

Keterangan

Baris yang disalin tidak berisi karakter null yang dihentikan.

Catatan

Karena kata pertama buffer menyimpan jumlah karakter yang akan disalin, pastikan buffer Anda memiliki panjang setidaknya 4 byte.

Untuk informasi selengkapnya, lihat EM_GETLINE di Windows SDK.

Contoh

Lihat contoh untuk GetLineCount.

CRichEditCtrl::GetLineCount

Mengambil jumlah baris dalam CRichEditCtrl objek.

int GetLineCount() const;

Tampilkan Nilai

Jumlah baris dalam objek ini CRichEditCtrl .

Keterangan

Untuk informasi selengkapnya, lihat EM_GETLINECOUNT di Windows SDK.

Contoh

int nLineLength, nLineIndex, nLineCount = m_myRichEditCtrl.GetLineCount();
CString strText, strLine;

// Dump every line of text of the rich edit control.
for (int i = 0; i < nLineCount; i++)
{
   nLineIndex = m_myRichEditCtrl.LineIndex(i);
   nLineLength = m_myRichEditCtrl.LineLength(nLineIndex);
   m_myRichEditCtrl.GetLine(i, strText.GetBufferSetLength(nLineLength + 1),
                            nLineLength);
   strText.SetAt(nLineLength, _T('\0')); // null terminate
   strText.ReleaseBuffer(nLineLength + 1);

   TRACE(_T("line %d: '%s'\r\n"), i, strText);
}

CRichEditCtrl::GetModify

Menentukan apakah isi objek ini CRichEditCtrl telah dimodifikasi.

BOOL GetModify() const;

Tampilkan Nilai

Bukan nol jika teks dalam objek ini CRichEditCtrl telah dimodifikasi; jika tidak, 0.

Keterangan

Windows mempertahankan bendera internal yang menunjukkan apakah isi kontrol edit kaya telah diubah. Bendera ini dibersihkan ketika kontrol edit pertama kali dibuat dan juga dapat dibersihkan dengan memanggil SetModify fungsi anggota.

Untuk informasi selengkapnya, lihat EM_GETMODIFY di Windows SDK.

Contoh

// Reset the modified state only if the text has been modified.
if (m_myRichEditCtrl.GetModify())
   m_myRichEditCtrl.SetModify(FALSE);

CRichEditCtrl::GetOptions

Mengambil opsi yang saat ini diatur untuk kontrol edit kaya.

UINT GetOptions() const;

Tampilkan Nilai

Kombinasi nilai bendera opsi saat ini. Untuk daftar nilai ini, lihat fOptions parameter dalam EM_SETOPTIONS pesan, seperti yang dijelaskan di Windows SDK.

CRichEditCtrl::GetParaFormat

Mendapatkan atribut pemformatan paragraf dari pilihan saat ini.

DWORD GetParaFormat(PARAFORMAT& pf) const;
DWORD GetParaFormat(PARAFORMAT2& pf) const;

Parameter

pf
Di versi pertama, penunjuk ke PARAFORMAT struktur untuk menahan atribut pemformatan paragraf dari pilihan saat ini.

Di versi kedua, penunjuk ke PARAFORMAT2 struktur, yang merupakan ekstensi Rich Edit 2.0 ke PARAFORMAT struktur, memegang atribut pemformatan karakter default.

Tampilkan Nilai

Anggota dwMask data dari pf. Ini menentukan atribut pemformatan paragraf yang konsisten di seluruh pilihan saat ini.

Keterangan

Jika lebih dari satu paragraf dipilih, pf menerima atribut paragraf pertama yang dipilih. Nilai pengembalian menentukan atribut mana yang konsisten di seluruh pilihan.

Untuk informasi selengkapnya, lihat EM_GETPARAFORMAT pesan dan PARAFORMAT struktur dan PARAFORMAT2 di Windows SDK.

Contoh

Lihat contoh untuk CRichEditCtrl::SetParaFormat.

CRichEditCtrl::GetPunctuation

Mendapatkan karakter tanda baca saat ini dalam kontrol edit yang kaya.

BOOL GetPunctuation(
    UINT fType,
    PUNCTUATION* lpPunc) const;

Parameter

fType
Bendera jenis tanda baca, seperti yang dijelaskan dalam fType parameter EM_GETPUNCTUATION di Windows SDK.

lpPunc
Penunjuk ke struktur, seperti yang PUNCTUATION dijelaskan dalam Windows SDK.

Tampilkan Nilai

Nonzero jika operasi berhasil, jika tidak, 0.

Keterangan

Fungsi anggota ini hanya tersedia dengan versi bahasa Asia dari sistem operasi.

CRichEditCtrl::GetRect

Mengambil persegi panjang pemformatan untuk objek ini CRichEditCtrl .

void GetRect(LPRECT lpRect) const;

Parameter

lpRect
CRect atau penunjuk ke RECT untuk menerima persegi panjang pemformatan objek ini CRichEditCtrl .

Keterangan

Persegi panjang pemformatan adalah persegi panjang pembatas untuk teks. Nilai ini tidak tergantung pada ukuran CRichEditCtrl objek.

Untuk informasi selengkapnya, lihat EM_GETRECT di Windows SDK.

Contoh

Lihat contoh untuk LimitText.

CRichEditCtrl::GetRedoName

Mengambil jenis tindakan berikutnya yang tersedia dalam antrean pengulangan, jika ada.

UNDONAMEID GetRedoName() const;

Tampilkan Nilai

Jika berhasil, GetRedoName mengembalikan UNDONAMEID jenis enumerasi yang menunjukkan jenis tindakan berikutnya dalam antrean pengulangan kontrol. Jika antrean pengulangan kosong, atau jika tindakan ulangi dalam antrean adalah jenis yang tidak diketahui, GetRedoName mengembalikan 0.

Keterangan

Jenis tindakan yang dapat dibatalkan atau di-redone termasuk mengetik, menghapus, menyeret,memotong, dan menempelkan operasi. Informasi ini dapat berguna untuk aplikasi yang menyediakan antarmuka pengguna yang diperluas untuk operasi Batalkan dan Ulangi, seperti kotak daftar drop-down tindakan yang dapat diulang.

CRichEditCtrl::GetSel

Mengambil batas pilihan saat ini dalam objek ini CRichEditCtrl .

void GetSel(CHARRANGE& cr) const;

void GetSel(
    long& nStartChar,
    long& nEndChar) const;

Parameter

cr
Referensi ke CHARRANGE struktur untuk menerima batas pilihan saat ini.

nStartChar
Indeks berbasis nol dari karakter pertama dalam pilihan saat ini.

nEndChar
Indeks berbasis nol dari karakter terakhir dalam pilihan saat ini.

Keterangan

Dua bentuk fungsi ini menyediakan cara alternatif untuk mendapatkan batas untuk pemilihan. Deskripsi singkat dari formulir-formulir ini berikut:

• GetSel( cr ) Formulir ini menggunakan CHARRANGE struktur dengan anggota dan cpMax untuk cpMin mengembalikan batas.

• GetSel( nStartChar , , nEndChar ) Formulir ini mengembalikan batas dalam parameter nStartChar dan .nEndChar

Pilihan mencakup semuanya jika awal (cpMin atau nStartChar) adalah 0 dan akhir (cpMax atau nEndChar) adalah - 1.

Untuk informasi selengkapnya, lihat EM_EXGETSEL pesan dan CHARRANGE struktur di Windows SDK.

Contoh

// Set the selection to be all characters after the current selection.
long nStartChar, nEndChar;

m_myRichEditCtrl.GetSel(nStartChar, nEndChar);
m_myRichEditCtrl.SetSel(nEndChar, -1);

CRichEditCtrl::GetSelectionCharFormat

Mendapatkan atribut pemformatan karakter dari pilihan saat ini.

DWORD GetSelectionCharFormat(CHARFORMAT& cf) const;
DWORD GetSelectionCharFormat(CHARFORMAT2& cf) const;

Parameter

cf
Di versi pertama, penunjuk ke CHARFORMAT struktur untuk menerima atribut pemformatan karakter dari pilihan saat ini.

Di versi kedua, penunjuk ke CHARFORMAT2 struktur, yang merupakan ekstensi Rich Edit 2.0 ke CHARFORMAT struktur untuk menerima atribut pemformatan karakter dari pilihan saat ini.

Tampilkan Nilai

Anggota dwMask data dari cf. Ini menentukan atribut pemformatan karakter yang konsisten di seluruh pilihan saat ini.

Keterangan

Parameter cf menerima atribut karakter pertama dalam pilihan saat ini. Nilai pengembalian menentukan atribut mana yang konsisten di seluruh pilihan.

Untuk informasi selengkapnya, lihat EM_GETCHARFORMAT pesan dan CHARFORMAT struktur dan CHARFORMAT2 di Windows SDK.

Contoh

Lihat contoh untuk SetSelectionCharFormat.

CRichEditCtrl::GetSelectionType

Menentukan tipe pilihan dalam objek ini CRichEditCtrl .

WORD GetSelectionType() const;

Tampilkan Nilai

Bendera yang menunjukkan isi pilihan saat ini. Kombinasi bendera berikut:

• SEL_EMPTY Menunjukkan bahwa tidak ada pilihan saat ini.

• SEL_TEXT Menunjukkan bahwa pilihan saat ini berisi teks.

• SEL_OBJECT Menunjukkan bahwa pilihan saat ini berisi setidaknya satu item OLE.

• SEL_MULTICHAR Menunjukkan bahwa pilihan saat ini berisi lebih dari satu karakter teks.

• SEL_MULTIOBJECT Menunjukkan bahwa pilihan saat ini berisi lebih dari satu objek OLE.

Keterangan

Untuk informasi selengkapnya, lihat EM_SELECTIONTYPE di Windows SDK.

Contoh

// Dump the selection text only if it contains at least one text character.
if (m_myRichEditCtrl.GetSelectionType() & (SEL_TEXT | SEL_MULTICHAR))
{
   CString strText = m_myRichEditCtrl.GetSelText();

   TRACE(_T("selection text is '%s'.\r\n"), strText);
}

CRichEditCtrl::GetSelText

Mengambil teks dari pilihan saat ini dalam objek ini CRichEditCtrl .

long GetSelText(LPSTR lpBuf) const;
CString GetSelText() const;

Parameter

lpBuf
Penunjuk ke buffer untuk menerima teks dalam pilihan saat ini.

Tampilkan Nilai

Tergantung pada formulir:

• GetSelText(lpBuf) Jumlah karakter yang disalin ke dalam lpBuf, tidak termasuk penghentian null.

• GetSelText( ) String yang berisi pilihan saat ini.

Keterangan

Jika Anda menggunakan formulir pertama, GetSelText(lpBuf), Anda harus memastikan bahwa buffer cukup besar untuk teks yang akan diterimanya. Panggil GetSel untuk menentukan jumlah karakter dalam pilihan saat ini.

Untuk informasi selengkapnya, lihat EM_GETSELTEXT di Windows SDK.

Contoh

Lihat contoh untuk CRichEditCtrl::GetSelectionType.

CRichEditCtrl::GetTextLength

Mengambil panjang teks, dalam karakter, dalam objek ini CRichEditCtrl , tidak termasuk karakter null yang dihentikan.

long GetTextLength() const;

Tampilkan Nilai

Panjang teks dalam objek ini CRichEditCtrl .

Keterangan

Untuk informasi selengkapnya, lihat WM_GETTEXTLENGTH di Windows SDK.

Contoh

// Limit the rich edit controls text to the number of
// characters currently in it.
m_myRichEditCtrl.LimitText(m_myRichEditCtrl.GetTextLength());

CRichEditCtrl::GetTextLengthEx

Menghitung panjang teks dalam kontrol edit kaya.

long GetTextLengthEx(
    DWORD dwFlags,
    UINT uCodePage = -1) const;

Parameter

dwFlags
Nilai yang menentukan metode yang akan digunakan dalam menentukan panjang teks. Anggota ini bisa menjadi satu atau beberapa nilai yang tercantum dalam anggota bendera yang GETTEXTLENGTHEX dijelaskan di Windows SDK.

uCodePage
Halaman kode untuk terjemahan (CP_ACP untuk Halaman Kode ANSI, 1200 untuk Unicode).

Tampilkan Nilai

Jumlah karakter atau byte dalam kontrol edit. Jika bendera yang tidak kompatibel diatur dalam dwFlags, fungsi anggota ini mengembalikan E_INVALIDARG.

Keterangan

GetTextLengthEx menyediakan cara tambahan untuk menentukan panjang teks. Ini mendukung fungsionalitas Rich Edit 2.0. Lihat Tentang Kontrol Edit Kaya di Windows SDKuntuk informasi selengkapnya.

CRichEditCtrl::GetTextMode

Mengambil mode teks saat ini dan membatalkan tingkat kontrol edit yang kaya.

UINT GetTextMode() const;

Tampilkan Nilai

Sekumpulan bendera bit dari TEXTMODE jenis enumerasi, seperti yang dijelaskan dalam Windows SDK. Bendera menunjukkan mode teks saat ini dan membatalkan tingkat kontrol.

CRichEditCtrl::GetTextRange

Mendapatkan rentang karakter yang ditentukan.

int GetTextRange(
    int nFirst,
    int nLast,
    CString& refString) const;

Parameter

nFirst
Indeks posisi karakter segera mendahului karakter pertama dalam rentang.

nLast
Posisi karakter segera mengikuti karakter terakhir dalam rentang.

refString
Referensi ke CString objek yang akan menerima teks.

Tampilkan Nilai

Jumlah karakter yang disalin, tidak termasuk karakter null yang dihentikan.

Keterangan

Untuk informasi selengkapnya, lihat EM_GETTEXTRANGE di Windows SDK.

GetTextRange mendukung fungsionalitas Rich Edit 2.0. Lihat Tentang Kontrol Edit Kaya di Windows SDKuntuk informasi selengkapnya.

CRichEditCtrl::GetUndoName

Mengambil jenis tindakan berikutnya yang tersedia dalam antrean batalkan, jika ada.

UNDONAMEID GetUndoName() const;

Tampilkan Nilai

Jika tindakan batalkan berada dalam antrean urungkan kontrol, GetUndoName mengembalikan jenis enumerasi UNDONAMEID yang menunjukkan jenis tindakan berikutnya dalam antrean. Jika antrean urungkan kosong, atau jika tindakan batalkan dalam antrean adalah jenis yang tidak diketahui, GetUndoName mengembalikan 0.

Keterangan

Jenis tindakan yang dapat dibatalkan atau di-redone termasuk mengetik, menghapus, menyeret,memotong, dan menempelkan operasi. Informasi ini dapat berguna untuk aplikasi yang menyediakan antarmuka pengguna yang diperluas untuk operasi Batalkan dan Ulangi, seperti kotak daftar drop-down tindakan yang dapat dibatalkan.

CRichEditCtrl::GetWordWrapMode

Mengambil opsi pembungkusan kata dan pemecahan kata saat ini untuk kontrol edit kaya.

UINT GetWordWrapMode() const;

Tampilkan Nilai

Opsi pembungkusan kata dan pemecahan kata saat ini. Opsi ini dijelaskan dalam EM_SETWORDWRAPMODE Windows SDK.

Keterangan

Fungsi anggota ini hanya tersedia untuk versi bahasa Asia dari sistem operasi.

CRichEditCtrl::HideSelection

Mengubah visibilitas pilihan.

void HideSelection(
    BOOL bHide,
    BOOL bPerm);

Parameter

bHide
Menunjukkan apakah pilihan harus ditampilkan atau disembunyikan, TRUE untuk menyembunyikan pilihan.

bPerm
Menunjukkan apakah perubahan ini dalam visibilitas untuk pilihan harus permanen.

Keterangan

Ketika bPerm adalah TRUE, itu mengubah ECO_NOHIDESEL opsi untuk objek ini CRichEditCtrl . Untuk deskripsi singkat tentang opsi ini, lihat SetOptions. Anda dapat menggunakan fungsi ini untuk mengatur semua opsi untuk objek ini CRichEditCtrl .

Untuk informasi selengkapnya, lihat EM_HIDESELECTION di Windows SDK.

Contoh

// Show the selection and make it permanent.
m_myRichEditCtrl.HideSelection(FALSE, TRUE);

CRichEditCtrl::LimitText

Membatasi panjang teks yang dapat dimasukkan pengguna ke dalam kontrol edit.

void LimitText(long nChars = 0);

Parameter

nChars
Menentukan panjang (dalam byte) teks yang dapat dimasukkan pengguna. Jika parameter ini adalah 0 (nilai default), panjang teks diatur ke 64K byte.

Keterangan

Mengubah batas teks hanya membatasi teks yang dapat dimasukkan pengguna. Ini tidak berpengaruh pada teks apa pun yang sudah ada di kontrol edit, juga tidak memengaruhi panjang teks yang disalin ke kontrol edit oleh SetWindowText fungsi anggota di CWnd. Jika aplikasi menggunakan SetWindowText fungsi untuk menempatkan lebih banyak teks ke kontrol edit daripada yang ditentukan dalam panggilan ke LimitText, pengguna dapat menghapus salah satu teks dalam kontrol edit. Namun, batas teks akan mencegah pengguna mengganti teks yang ada dengan teks baru, kecuali jika menghapus pilihan saat ini menyebabkan teks berada di bawah batas teks.

Catatan

Untuk batas teks, setiap item OLE dihitung sebagai satu karakter.

Untuk informasi selengkapnya, lihat EM_EXLIMITTEXT di Windows SDK.

Contoh

// Limit the number of characters to be the maximum number visible.

// Get the text metrics for the edit; needed for the
// average character width.
TEXTMETRIC tm;
CDC *pDC = m_myRichEditCtrl.GetDC();
pDC->GetTextMetrics(&tm);
m_myRichEditCtrl.ReleaseDC(pDC);

CRect r;
m_myRichEditCtrl.GetRect(&r);
m_myRichEditCtrl.LimitText(r.Width() / tm.tmAveCharWidth);

CRichEditCtrl::LineFromChar

Mengambil nomor baris baris yang berisi indeks karakter yang ditentukan.

long LineFromChar(long nIndex) const;

Parameter

nIndex
Berisi nilai indeks berbasis nol untuk karakter yang diinginkan dalam teks kontrol edit, atau berisi -1. Jika nIndex adalah -1, garis saat ini menentukan, yaitu baris yang berisi tanda sisipan.

Tampilkan Nilai

Nomor baris berbasis nol dari baris yang berisi indeks karakter yang ditentukan oleh nIndex. Jika nIndex adalah -1, jumlah baris yang berisi karakter pertama pilihan dikembalikan. Jika tidak ada pilihan, nomor baris saat ini dikembalikan.

Keterangan

Indeks karakter adalah jumlah karakter dari awal kontrol edit kaya. Untuk penghitungan karakter, item OLE dihitung sebagai satu karakter.

Untuk informasi selengkapnya, lihat EM_EXLINEFROMCHAR di Windows SDK.

Contoh

// The index of the char to get information on.
int nIndex = 11;

CString strText;

m_myRichEditCtrl.GetWindowText(strText);
strText = strText.Mid(nIndex, 1);

// Dump the index, character and line number.
TRACE(_T("nIndex = %d, character = %c, line = %d\r\n"),
      nIndex, strText[0], m_myRichEditCtrl.LineFromChar(nIndex));

CRichEditCtrl::LineIndex

Mengambil indeks karakter garis dalam objek ini CRichEditCtrl .

int LineIndex(int nLine = -1) const;

Parameter

nLine
Berisi nilai indeks untuk baris yang diinginkan dalam teks kontrol edit, atau berisi -1. Jika nLine adalah -1, garis saat ini menentukan, yaitu baris yang berisi tanda sisipan.

Tampilkan Nilai

Indeks karakter baris yang ditentukan dalam nLine atau -1 jika nomor baris yang ditentukan lebih besar dari jumlah baris dalam kontrol edit.

Keterangan

Indeks karakter adalah jumlah karakter dari awal kontrol edit kaya ke baris yang ditentukan.

Untuk informasi selengkapnya, lihat EM_LINEINDEX di Windows SDK.

Contoh

// The string for replacing.
LPCTSTR lpszmyString = _T("Hello, I'm the new second line.");

int nBegin, nEnd, nIndex;

// Replace the second line, if it exists, of the rich edit control
// with the text lpszmyString.
nIndex = m_myRichEditCtrl.LineIndex(1);
if ((nBegin = nIndex) != -1)
{
   nEnd = nBegin + m_myRichEditCtrl.LineLength(nIndex);
   m_myRichEditCtrl.SetSel(nBegin, nEnd);
   m_myRichEditCtrl.ReplaceSel(lpszmyString);
}

CRichEditCtrl::LineLength

Mengambil panjang garis dalam kontrol edit yang kaya.

int LineLength(int nLine = -1) const;

Parameter

nLine
Menentukan indeks karakter karakter dalam baris yang panjangnya akan diambil. Jika parameter ini adalah -1, panjang baris saat ini (baris yang berisi tanda sisipan) dikembalikan, tidak termasuk panjang teks yang dipilih dalam baris. Ketika LineLength dipanggil untuk kontrol edit baris tunggal, parameter ini diabaikan.

Tampilkan Nilai

Ketika LineLength dipanggil untuk kontrol edit beberapa baris, nilai yang dikembalikan adalah panjang (dalam TCHAR) baris yang ditentukan oleh nLine. Ini tidak termasuk karakter carriage-return di akhir baris. Ketika LineLength dipanggil untuk kontrol edit baris tunggal, nilai yang dikembalikan adalah panjang (dalam TCHAR) teks dalam kontrol edit. Jika nLine lebih besar dari jumlah karakter dalam kontrol, nilai yang dikembalikan adalah nol.

Keterangan

LineIndex Gunakan fungsi anggota untuk mengambil indeks karakter untuk nomor baris tertentu dalam objek iniCRichEditCtrl.

Untuk informasi selengkapnya, lihat EM_LINELENGTH di Windows SDK.

Contoh

Lihat contoh untuk LineIndex.

CRichEditCtrl::LineScroll

Menggulir teks kontrol edit beberapa baris.

void LineScroll(
    int nLines,
    int nChars = 0);

Parameter

nLines
Menentukan jumlah baris yang akan digulir secara vertikal.

nChars
Menentukan jumlah posisi karakter untuk digulir secara horizontal. Nilai ini diabaikan jika kontrol edit kaya memiliki ES_RIGHT gaya atau ES_CENTER . Edit gaya ditentukan dalam Create.

Keterangan

Kontrol edit tidak menggulir secara vertikal melewati baris terakhir teks dalam kontrol edit. Jika baris saat ini ditambah jumlah baris yang ditentukan oleh nLines melebihi jumlah total baris dalam kontrol edit, nilai disesuaikan sehingga baris terakhir kontrol edit digulir ke bagian atas jendela edit-kontrol.

LineScroll dapat digunakan untuk menggulir secara horizontal melewati karakter terakhir dari baris apa pun.

Untuk informasi selengkapnya, lihat EM_LINESCROLL di Windows SDK.

Contoh

Lihat contoh untuk GetFirstVisibleLine.

CRichEditCtrl::Paste

Menyisipkan data dari Clipboard ke dalam CRichEditCtrl pada titik penyisipan, lokasi tanda sisipan.

void Paste();

Keterangan

Data disisipkan hanya jika Clipboard berisi data dalam format yang dikenali.

Untuk informasi selengkapnya, lihat WM_PASTE di Windows SDK.

Contoh

// Replace all of the text with the text in the clipboard.
m_myRichEditCtrl.SetSel(0, -1);
m_myRichEditCtrl.Paste();

CRichEditCtrl::PasteSpecial

Menempelkan data dalam format Papan Klip tertentu ke dalam objek ini CRichEditCtrl .

void PasteSpecial(
    UINT nClipFormat,
    DWORD dvAspect = 0,
    HMETAFILE hMF = 0);

Parameter

nClipFormat
Format papan klip untuk ditempelkan ke objek ini CRichEditCtrl .

dvAspect
Aspek perangkat agar data diambil dari Clipboard.

hMF
Tangani ke metafile yang berisi tampilan ikonik objek yang akan ditempelkan.

Keterangan

Bahan baru dimasukkan pada titik penyisipan, lokasi tanda sisipan.

Untuk informasi selengkapnya, lihat EM_PASTESPECIAL di Windows SDK.

Contoh

// Paste the data from the clipboard as text.
m_myRichEditCtrl.PasteSpecial(CF_TEXT);

CRichEditCtrl::PosFromChar

Mengambil koordinat area klien dari karakter tertentu dalam kontrol edit.

CPoint PosFromChar(UINT nChar) const;

Parameter

nChar
Indeks karakter berbasis nol.

Tampilkan Nilai

Posisi karakter, (x, y). Untuk kontrol edit satu baris, koordinat y selalu nol.

Keterangan

Untuk informasi selengkapnya, lihat EM_POSFROMCHAR di Windows SDK.

CRichEditCtrl::Redo

Mengulangi tindakan berikutnya dalam antrean pengulangan kontrol.

BOOL Redo();

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Keterangan

Untuk informasi selengkapnya, lihat EM_REDO di Windows SDK.

CRichEditCtrl::ReplaceSel

Mengganti pilihan saat ini dalam objek ini CRichEditCtrl dengan teks yang ditentukan.

void ReplaceSel(
    LPCTSTR lpszNewText,
    BOOL bCanUndo = FALSE);

Parameter

lpszNewText
Penunjuk ke string null-terminated yang berisi teks pengganti.

bCanUndo
Untuk menentukan bahwa fungsi ini dapat dibatalkan, atur nilai parameter ini ke TRUE. Nilai defaultnya adalah FALSE.

Keterangan

Untuk mengganti semua teks dalam objek ini CRichEditCtrl , gunakan CWnd::SetWindowText.

Jika tidak ada pilihan saat ini, teks pengganti disisipkan pada titik penyisipan, yaitu, lokasi tanda sisipan saat ini.

Fungsi ini akan memformat teks yang disisipkan dengan pemformatan karakter yang ada. Saat mengganti seluruh rentang teks (dengan memanggil SetSel(0,-1) sebelum memanggil ReplaceSel), ada akhir karakter paragraf yang mempertahankan pemformatan paragraf sebelumnya, yang diwarisi oleh teks yang baru disisipkan.

Untuk informasi selengkapnya, lihat EM_REPLACESEL di Windows SDK.

Contoh

Lihat contoh untuk LineIndex.

CRichEditCtrl::RequestResize

Memaksa objek ini CRichEditCtrl untuk mengirim EN_REQUESTRESIZE pesan pemberitahuan ke jendela induknya.

void RequestResize();

Keterangan

Fungsi ini berguna selama CWnd::OnSize pemrosesan untuk objek tanpa CRichEditCtrl dasar.

Untuk informasi selengkapnya, lihat EM_REQUESTRESIZE pesan dan bagian Kontrol Edit Kaya Tanpa Dasar dari Tentang Kontrol Edit Kaya di Windows SDK.

CRichEditCtrl::SetAutoURLDetect

Mengatur kontrol edit kaya untuk mendeteksi URL secara otomatis.

BOOL SetAutoURLDetect(BOOL bEnable = TRUE);

Parameter

bEnable
Menentukan apakah kontrol diatur untuk mendeteksi URL secara otomatis. Jika TRUE, itu diaktifkan. Jika FALSE, itu dinonaktifkan.

Tampilkan Nilai

Nol jika berhasil, jika tidak nol. Misalnya, pesan mungkin gagal karena memori yang tidak mencukup.

Keterangan

Jika diaktifkan, kontrol edit kaya akan memindai teks untuk menentukan apakah cocok dengan format URL standar. Untuk daftar format URL ini, lihat EM_AUTOURLDETECT di Windows SDK.

Catatan

Jangan atur SetAutoURLDetect ke TRUE jika kontrol edit Anda menggunakan CFE_LINK efek untuk teks selain URL. SetAutoURLDetect mengaktifkan efek ini untuk URL dan menonaktifkannya untuk semua teks lainnya. Lihat EN_LINK untuk informasi selengkapnya tentang efeknya CFE_LINK .

CRichEditCtrl::SetBackgroundColor

Menyetel warna latar belakang untuk objek ini CRichEditCtrl .

COLORREF SetBackgroundColor(
    BOOL bSysColor,
    COLORREF cr);

Parameter

bSysColor
Menunjukkan apakah warna latar belakang harus diatur ke nilai sistem. Jika nilai ini adalah TRUE, cr diabaikan.

cr
Warna latar belakang yang diminta. Digunakan hanya jika bSysColor adalah FALSE.

Tampilkan Nilai

Warna latar belakang sebelumnya untuk objek ini CRichEditCtrl .

Keterangan

Warna latar belakang dapat diatur ke nilai sistem atau ke nilai tertentu COLORREF .

Untuk informasi selengkapnya, lihat EM_SETBKGNDCOLOR pesan dan COLORREF struktur di Windows SDK.

Contoh

// Use red as the background color.
m_myRichEditCtrl.SetBackgroundColor(FALSE, RGB(255, 0, 0));

CRichEditCtrl::SetDefaultCharFormat

Menyetel atribut pemformatan karakter untuk teks baru dalam objek ini CRichEditCtrl .

BOOL SetDefaultCharFormat(CHARFORMAT& cf);
BOOL SetDefaultCharFormat(CHARFORMAT2& cf);

Parameter

cf
Di versi pertama, penunjuk ke struktur yang CHARFORMAT berisi atribut pemformatan karakter default baru.

Di versi kedua, penunjuk ke CHARFORMAT2 struktur, yang merupakan ekstensi Rich Edit 2.0 ke CHARFORMAT struktur, yang berisi atribut pemformatan karakter default.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Keterangan

Hanya atribut yang ditentukan oleh dwMask anggota yang cf diubah oleh fungsi ini.

Untuk informasi selengkapnya, lihat EM_SETCHARFORMAT pesan dan CHARFORMAT struktur dan CHARFORMAT2 di Windows SDK.

Contoh

CHARFORMAT cf = {0};

// Modify the default character format so that all new
// text is striked out and not bold.
cf.cbSize = sizeof(cf);
cf.dwMask = CFM_STRIKEOUT | CFM_BOLD;
cf.dwEffects = CFE_STRIKEOUT;
m_myRichEditCtrl.SetDefaultCharFormat(cf);

// Verify the settings are what is expected.
m_myRichEditCtrl.GetDefaultCharFormat(cf);
ASSERT((cf.dwMask & (CFM_STRIKEOUT | CFM_BOLD)) ==
       (CFM_STRIKEOUT | CFM_BOLD));
ASSERT((cf.dwEffects & (CFE_STRIKEOUT | CFE_BOLD)) == CFE_STRIKEOUT);

CRichEditCtrl::SetEventMask

Mengatur masker peristiwa untuk objek ini CRichEditCtrl .

DWORD SetEventMask(DWORD dwEventMask);

Parameter

dwEventMask
Masker peristiwa baru untuk objek ini CRichEditCtrl .

Tampilkan Nilai

Masker peristiwa sebelumnya.

Keterangan

Masker peristiwa menentukan pesan CRichEditCtrl pemberitahuan mana yang dikirim objek ke jendela induknya.

Untuk informasi selengkapnya, lihat EM_SETEVENTMASK di Windows SDK.

Contoh

// Set the event mask so that the parent gets notified when the text
// of the rich edit control changes.
m_myRichEditCtrl.SetEventMask(m_myRichEditCtrl.GetEventMask() |
                              ENM_CHANGE);

CRichEditCtrl::SetModify

Mengatur atau menghapus bendera yang dimodifikasi untuk kontrol edit.

void SetModify(BOOL bModified = TRUE);

Parameter

bModified
Nilai TRUE menunjukkan bahwa teks telah dimodifikasi, dan nilai FALSE menunjukkan bahwa teks tersebut tidak dimodifikasi. Secara default, bendera yang dimodifikasi diatur.

Keterangan

Bendera yang dimodifikasi menunjukkan apakah teks dalam kontrol edit telah dimodifikasi atau tidak. Ini secara otomatis diatur setiap kali pengguna mengubah teks. Nilainya dapat diambil dengan GetModify fungsi anggota.

Untuk informasi selengkapnya, lihat EM_SETMODIFY di Windows SDK.

Contoh

Lihat contoh untuk GetModify.

CRichEditCtrl::SetOLECallback

Memberi objek ini CRichEditCtrl objek untuk IRichEditOleCallback digunakan untuk mengakses sumber daya dan informasi terkait OLE.

BOOL SetOLECallback(IRichEditOleCallback* pCallback);

Parameter

pCallback
Penunjuk IRichEditOleCallback ke objek yang akan digunakan objek ini CRichEditCtrl untuk mendapatkan sumber daya dan informasi terkait OLE.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Keterangan

Objek ini CRichEditCtrl akan memanggil IUnknown::AddRef untuk menaikkan jumlah penggunaan untuk objek COM yang ditentukan oleh pCallback.

Untuk informasi selengkapnya, lihat EM_SETOLECALLBACK pesan dan IRichEditOleCallback antarmuka di Windows SDK.

CRichEditCtrl::SetOptions

Mengatur opsi untuk objek ini CRichEditCtrl .

void SetOptions(
    WORD wOp,
    DWORD dwFlags);

Parameter

wOp
Menunjukkan jenis operasi. Salah satu dari nilai berikut:

• ECOOP_SET Atur opsi ke opsi yang ditentukan oleh dwFlags.

• ECOOP_OR Gabungkan opsi saat ini dengan yang ditentukan oleh dwFlags.

• ECOOP_AND Pertahankan hanya opsi saat ini yang juga ditentukan oleh dwFlags.

• ECOOP_XOR Secara logis eksklusif ATAU opsi saat ini dengan yang ditentukan oleh dwFlags.

dwFlags
Opsi edit kaya. Nilai bendera tercantum di bagian Keterangan.

Keterangan

Opsi dapat berupa kombinasi dari nilai berikut:

• ECO_AUTOWORDSELECTION Pemilihan kata otomatis saat klik ganda.

• ECO_AUTOVSCROLL Secara otomatis menggulir teks ke kanan dengan 10 karakter saat pengguna mengetik karakter di akhir baris. Saat pengguna menekan tombol ENTER, kontrol menggulir semua teks kembali ke posisi nol.

• ECO_AUTOHSCROLL Secara otomatis menggulir teks ke atas satu halaman saat pengguna menekan tombol ENTER pada baris terakhir.

• ECO_NOHIDESEL Meniadakan perilaku default untuk kontrol edit. Perilaku default menyembunyikan pilihan saat kontrol kehilangan fokus input dan menunjukkan pilihan saat kontrol menerima fokus input. Jika Anda menentukan ECO_NOHIDESEL, teks yang dipilih dibalik, meskipun kontrol tidak memiliki fokus.

• ECO_READONLY Mencegah pengguna mengetik atau mengedit teks di kontrol edit.

• ECO_WANTRETURN Menentukan bahwa pengembalian pengangkutan disisipkan saat pengguna menekan tombol ENTER saat memasukkan teks ke dalam kontrol edit kaya beberapa baris dalam kotak dialog. Jika Anda tidak menentukan gaya ini, menekan tombol ENTER mengirimkan perintah ke jendela induk kontrol edit kaya, yang meniru tombol default jendela induk (misalnya, tombol OK dalam kotak dialog). Gaya ini tidak berpengaruh pada kontrol edit baris tunggal.

• ECO_SAVESEL Mempertahankan pilihan saat kontrol kehilangan fokus. Secara default, seluruh konten kontrol dipilih saat mendapatkan kembali fokus.

• ECO_VERTICAL Menggambar teks dan objek ke arah vertikal. Hanya tersedia untuk bahasa Asia.

Untuk informasi selengkapnya, lihat EM_SETOPTIONS di Windows SDK.

Contoh

// Add auto horizontal and vertical scrolling.
m_myRichEditCtrl.SetOptions(ECOOP_OR, ECO_AUTOVSCROLL |
                                          ECO_AUTOHSCROLL);

CRichEditCtrl::SetParaFormat

Menyetel atribut pemformatan paragraf untuk pilihan saat ini dalam objek ini CRichEditCtrl .

BOOL SetParaFormat(PARAFORMAT& pf);
BOOL SetParaFormat(PARAFORMAT2& pf);

Parameter

pf
Di versi pertama, penunjuk ke struktur yang PARAFORMAT berisi atribut pemformatan paragraf default baru.

Di versi kedua, penunjuk ke PARAFORMAT2 struktur, yang merupakan ekstensi Rich Edit 2.0 ke PARAFORMAT struktur, memegang atribut pemformatan karakter default.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Keterangan

Hanya atribut yang ditentukan oleh dwMask anggota yang pf diubah oleh fungsi ini.

Untuk informasi selengkapnya, lihat EM_SETPARAFORMAT pesan dan PARAFORMAT struktur dan PARAFORMAT2 di Windows SDK.

Contoh

PARAFORMAT pf;

// Modify the paragraph format so that the text is centered.
pf.cbSize = sizeof(PARAFORMAT);
pf.dwMask = PFM_ALIGNMENT;
pf.wAlignment = PFA_CENTER;
m_myRichEditCtrl.SetParaFormat(pf);

// Verify the settings are what is expected.
m_myRichEditCtrl.GetParaFormat(pf);
ASSERT(pf.dwMask &PFM_ALIGNMENT);
ASSERT(pf.wAlignment == PFA_CENTER);

CRichEditCtrl::SetPunctuation

Mengatur tanda baca dalam kontrol edit yang kaya.

BOOL SetPunctuation(
    UINT fType,
    PUNCTUATION* lpPunc);

Parameter

fType
Bendera tanda baca. Untuk daftar nilai yang mungkin, lihat fType parameter untuk EM_SETPUNCTUATION di Windows SDK.

lpPunc
Penunjuk ke struktur, seperti yang PUNCTUATION dijelaskan dalam Windows SDK.

Tampilkan Nilai

Bukan nol jika berhasil, jika tidak, 0.

Keterangan

Fungsi anggota ini hanya tersedia untuk versi bahasa Asia dari sistem operasi.

CRichEditCtrl::SetReadOnly

ECO_READONLY Mengubah opsi untuk objek iniCRichEditCtrl.

BOOL SetReadOnly(BOOL bReadOnly = TRUE);

Parameter

bReadOnly
Menunjukkan apakah objek ini CRichEditCtrl harus dibaca saja.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Keterangan

Untuk deskripsi singkat tentang opsi ini, lihat SetOptions. Anda dapat menggunakan fungsi ini untuk mengatur semua opsi untuk objek ini CRichEditCtrl .

Untuk informasi selengkapnya, lihat EM_SETREADONLY di Windows SDK.

Contoh

// Set the rich edit control to be read-only.
m_myRichEditCtrl.SetReadOnly(TRUE);
ASSERT(m_myRichEditCtrl.GetStyle() & ES_READONLY);

CRichEditCtrl::SetRect

Menyetel persegi panjang pemformatan untuk objek ini CRichEditCtrl .

void SetRect(LPCRECT lpRect);

Parameter

lpRect
CRect atau penunjuk ke yang RECT menunjukkan batas baru untuk persegi panjang pemformatan.

Keterangan

Persegi panjang pemformatan adalah persegi panjang pembatas untuk teks. Persegi panjang yang membatasi tidak bergantung pada ukuran jendela kontrol edit yang kaya. Ketika objek ini CRichEditCtrl pertama kali dibuat, persegi panjang pemformatan berukuran sama dengan area klien jendela. Gunakan SetRect untuk membuat pemformatan persegi panjang lebih besar atau lebih kecil dari jendela edit kaya.

Untuk informasi selengkapnya, lihat EM_SETRECT di Windows SDK.

Contoh

CRect r;

m_myRichEditCtrl.GetRect(&r);

// Reduce the formatting rect of the rich edit control by
// 10 pixels on each side.
if ((r.Width() > 20) && (r.Height() > 20))
{
   r.DeflateRect(0, 20);
   m_myRichEditCtrl.SetRect(&r);
}

CRichEditCtrl::SetSel

Menyetel pilihan dalam objek ini CRichEditCtrl .

void SetSel(
    long nStartChar,
    long nEndChar);

void SetSel(CHARRANGE& cr);

Parameter

nStartChar
Indeks berbasis nol dari karakter pertama untuk pilihan.

nEndChar
Indeks berbasis nol dari karakter terakhir untuk pilihan.

cr
CHARRANGE struktur yang memegang batas pilihan saat ini.

Keterangan

Dua bentuk fungsi ini menyediakan cara alternatif untuk mengatur batas untuk pemilihan. Deskripsi singkat dari formulir-formulir ini berikut:

• SetSel( cr ) Formulir ini menggunakan CHARRANGE struktur dengan anggota dan cpMax untuk cpMin mengatur batas.

• SetSel( nStartChar , , nEndChar ) Formulir ini menggunakan parameter nStartChar dan nEndChar untuk mengatur batas.

Tanda sisipan ditempatkan di akhir pilihan yang ditunjukkan oleh indeks awal (cpMin atau nStartChar) dan akhir (cpMax atau nEndChar) yang lebih besar. Fungsi ini menggulir konten CRichEditCtrl sehingga tanda sisipan terlihat.

Untuk memilih semua teks dalam objek ini CRichEditCtrl , panggil SetSel dengan indeks awal 0 dan indeks akhir - 1.

Untuk informasi selengkapnya, lihat EM_EXSETSEL pesan dan CHARRANGE struktur di Windows SDK.

Contoh

Lihat contoh untuk GetSel.

CRichEditCtrl::SetSelectionCharFormat

Mengatur atribut pemformatan karakter untuk teks dalam pilihan saat ini dalam objek ini CRichEditCtrl .

BOOL SetSelectionCharFormat(CHARFORMAT& cf);
BOOL SetSelectionCharFormat(CHARFORMAT2& cf);

Parameter

cf
Di versi pertama, penunjuk ke struktur yang CHARFORMAT berisi atribut pemformatan karakter baru untuk pilihan saat ini.

Di versi kedua, penunjuk ke CHARFORMAT2 struktur, yang merupakan ekstensi Rich Edit 2.0 ke CHARFORMAT struktur, yang berisi atribut pemformatan karakter baru untuk pilihan saat ini.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Keterangan

Hanya atribut yang ditentukan oleh dwMask anggota cf yang diubah oleh fungsi ini.

Untuk informasi selengkapnya, lihat EM_SETCHARFORMAT dan CHARFORMAT struktur dan CHARFORMAT2 di Windows SDK.

Contoh

CHARFORMAT cf;

// Modify the selection format so that the selected text is
// displayed in bold and not striked out.
cf.cbSize = sizeof(cf);
cf.dwMask = CFM_STRIKEOUT | CFM_BOLD;
cf.dwEffects = CFE_BOLD;
m_myRichEditCtrl.SetSelectionCharFormat(cf);

// Verify the settings are what is expected.
m_myRichEditCtrl.GetSelectionCharFormat(cf);
ASSERT((cf.dwMask & (CFM_STRIKEOUT | CFM_BOLD)) ==
       (CFM_STRIKEOUT | CFM_BOLD));
ASSERT((cf.dwEffects & (CFE_STRIKEOUT | CFE_BOLD)) == CFE_BOLD);

CRichEditCtrl::SetTargetDevice

Mengatur perangkat target dan lebar garis yang digunakan untuk pemformatan WYSIWYG (yang Anda lihat adalah apa yang Anda dapatkan) dalam objek ini CRichEditCtrl .

BOOL SetTargetDevice(
    HDC hDC,
    long lLineWidth);

BOOL SetTargetDevice(
    CDC& dc,
    long lLineWidth);

Parameter

hDC
Tangani ke konteks perangkat untuk perangkat target baru.

lLineWidth
Lebar garis yang akan digunakan untuk pemformatan.

dc
CDC untuk perangkat target baru.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Keterangan

Jika fungsi ini berhasil, kontrol edit kaya memiliki konteks perangkat yang diteruskan sebagai parameter. Dalam hal ini, fungsi panggilan tidak boleh menghancurkan konteks perangkat.

Untuk informasi selengkapnya, lihat EM_SETTARGETDEVICE di Windows SDK.

Contoh

// First obtain a pointer to a printer DC.
CPageSetupDialog psDlg;
if (IDOK == psDlg.DoModal())
{
   CDC *pMyPrinterDC = CDC::FromHandle(psDlg.CreatePrinterDC());

   // Get line width information from the printer.
   long lLineWidth = ::MulDiv(pMyPrinterDC->GetDeviceCaps(PHYSICALWIDTH),
                              1440, pMyPrinterDC->GetDeviceCaps(LOGPIXELSX));

   // Set the printer as the target device.
   m_myRichEditCtrl.SetTargetDevice(*pMyPrinterDC, lLineWidth);

   pMyPrinterDC->DeleteDC();
}

CRichEditCtrl::SetTextMode

Mengatur mode teks atau membatalkan dan mengulangi tingkat untuk kontrol edit yang kaya.

BOOL SetTextMode(UINT fMode);

Parameter

fMode
Menentukan pengaturan baru untuk mode teks kontrol dan mengurungkan parameter tingkat. Untuk daftar nilai yang mungkin, lihat parameter mode untuk EM_SETTEXTMODE di Windows SDK.

Tampilkan Nilai

Nol jika berhasil, jika tidak nol.

Keterangan

Untuk deskripsi mode teks, lihat EM_SETTEXTMODE di Windows SDK.

Fungsi anggota ini gagal jika kontrol berisi teks. Untuk memastikan kontrol kosong, kirim pesan WM_SETTEXT dengan string kosong.

CRichEditCtrl::SetUndoLimit

Mengatur jumlah maksimum tindakan yang dapat disimpan dalam antrean batalkan.

UINT SetUndoLimit(UINT nLimit);

Parameter

nLimit
Menentukan jumlah maksimum tindakan yang dapat disimpan dalam antrean urungkan. Atur ke nol untuk menonaktifkan Batalkan.

Tampilkan Nilai

Jumlah maksimum baru tindakan batalkan untuk kontrol edit kaya.

Keterangan

Secara default, jumlah maksimum tindakan dalam antrean batalkan adalah 100. Jika Anda meningkatkan jumlah ini, harus ada cukup memori yang tersedia untuk mengakomodasi nomor baru. Untuk performa yang lebih baik, atur batas ke nilai sekecil mungkin.

CRichEditCtrl::SetWordCharFormat

Menyetel atribut pemformatan karakter untuk kata yang saat ini dipilih dalam objek ini CRichEditCtrl .

BOOL SetWordCharFormat(CHARFORMAT& cf);
BOOL SetWordCharFormat(CHARFORMAT2& cf);

Parameter

cf
Di versi pertama, penunjuk ke struktur yang CHARFORMAT berisi atribut pemformatan karakter baru untuk kata yang saat ini dipilih.

Di versi kedua, penunjuk ke CHARFORMAT2 struktur, yang merupakan ekstensi Rich Edit 2.0 ke CHARFORMAT struktur, yang berisi atribut pemformatan karakter baru untuk kata yang saat ini dipilih.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Keterangan

Hanya atribut yang ditentukan oleh dwMask anggota yang cf diubah oleh fungsi ini.

Untuk informasi selengkapnya, lihat EM_SETCHARFORMAT pesan dan CHARFORMAT struktur dan CHARFORMAT2 di Windows SDK.

Contoh

CHARFORMAT cf;

// Modify the word format so that the selected word is
// displayed in bold and not striked out.
cf.cbSize = sizeof(cf);
cf.dwMask = CFM_STRIKEOUT | CFM_BOLD;
cf.dwEffects = CFE_BOLD;
m_myRichEditCtrl.SetWordCharFormat(cf);

CRichEditCtrl::SetWordWrapMode

Mengatur opsi pembungkusan kata dan pemecahan kata untuk kontrol edit kaya.

UINT SetWordWrapMode(UINT uFlags) const;

Parameter

uFlags
Opsi untuk mengatur pembungkusan kata dan pemecahan kata. Untuk daftar opsi yang mungkin, lihat EM_SETWORDWRAPMODE di Windows SDK.

Tampilkan Nilai

Opsi pembungkusan kata dan pemecahan kata saat ini.

Keterangan

Pesan ini hanya tersedia dalam versi bahasa Asia dari sistem operasi.

CRichEditCtrl::StopGroupTyping

Menghentikan kontrol mengumpulkan tindakan pengetikan tambahan ke dalam tindakan batalkan saat ini.

void StopGroupTyping();

Keterangan

Kontrol menyimpan tindakan pengetikan berikutnya, jika ada, ke dalam tindakan baru dalam antrean batalkan.

Untuk informasi selengkapnya, lihat EM_STOPGROUPTYPING di Windows SDK.

CRichEditCtrl::StreamIn

Mengganti teks dalam objek ini CRichEditCtrl dengan teks dari aliran input yang ditentukan.

long StreamIn(
    int nFormat,
    EDITSTREAM& es);

Parameter

nFormat
Bendera yang menentukan format data input. Lihat bagian Keterangan untuk informasi lebih lanjut.

es
EDITSTREAM struktur yang menentukan aliran input. Lihat bagian Keterangan untuk informasi lebih lanjut.

Tampilkan Nilai

Jumlah karakter yang dibaca dari aliran input.

Keterangan

Nilai nFormat harus salah satu dari yang berikut ini:

• SF_TEXT Menunjukkan hanya membaca teks.

• SF_RTF Menunjukkan pembacaan teks dan pemformatan.

Salah satu nilai ini dapat dikombinasikan dengan SFF_SELECTION. Jika SFF_SELECTION ditentukan, StreamIn mengganti pilihan saat ini dengan konten aliran input. Jika tidak ditentukan, StreamIn ganti seluruh isi objek ini CRichEditCtrl .

EDITSTREAM Dalam parameter es, Anda menentukan fungsi panggilan balik yang mengisi buffer dengan teks. Fungsi panggilan balik ini dipanggil berulang kali, hingga aliran input habis.

Untuk informasi selengkapnya, lihat EM_STREAMIN pesan dan EDITSTREAM struktur di Windows SDK.

Contoh

// My callback procedure that reads the rich edit control contents
// from a file.
static DWORD CALLBACK 
MyStreamInCallback(DWORD dwCookie, LPBYTE pbBuff, LONG cb, LONG *pcb)
{
   CFile* pFile = (CFile*) dwCookie;

   *pcb = pFile->Read(pbBuff, cb);

   return 0;
}

 

// The example code.

// The file from which to load the contents of the rich edit control.
CFile cFile(TEXT("My_RichEdit_InFile.rtf"), CFile::modeRead);
EDITSTREAM es;

es.dwCookie = (DWORD)&cFile;
es.pfnCallback = MyStreamInCallback;
m_myRichEditCtrl.StreamIn(SF_RTF, es);

CRichEditCtrl::StreamOut

Menuliskan isi objek ini CRichEditCtrl ke aliran output yang ditentukan.

long StreamOut(
    int nFormat,
    EDITSTREAM& es);

Parameter

nFormat
Bendera yang menentukan format data output. Lihat bagian Keterangan untuk informasi lebih lanjut.

es
EDITSTREAM struktur yang menentukan aliran output. Lihat bagian Keterangan untuk informasi lebih lanjut.

Tampilkan Nilai

Jumlah karakter yang ditulis ke aliran output.

Keterangan

Nilai nFormat harus salah satu dari yang berikut ini:

• SF_TEXT Menunjukkan hanya menulis teks.

• SF_RTF Menunjukkan penulisan teks dan pemformatan.

• SF_RTFNOOBJS Menunjukkan penulisan teks dan pemformatan, mengganti item OLE dengan spasi.

• SF_TEXTIZED Menunjukkan penulisan teks dan pemformatan, dengan representasi tekstual item OLE.

Salah satu nilai ini dapat dikombinasikan dengan SFF_SELECTION. Jika SFF_SELECTION ditentukan, StreamOut tulis pilihan saat ini ke dalam aliran output. Jika tidak ditentukan, StreamOut tulis seluruh isi objek ini CRichEditCtrl .

EDITSTREAM Dalam parameter es, Anda menentukan fungsi panggilan balik yang mengisi buffer dengan teks. Fungsi panggilan balik ini dipanggil berulang kali, hingga aliran output habis.

Untuk informasi selengkapnya, lihat EM_STREAMOUT pesan dan EDITSTREAM struktur di Windows SDK.

Contoh

// My callback procedure that writes the rich edit control contents
// to a file.
static DWORD CALLBACK 
MyStreamOutCallback(DWORD dwCookie, LPBYTE pbBuff, LONG cb, LONG *pcb)
{
   CFile* pFile = (CFile*) dwCookie;

   pFile->Write(pbBuff, cb);
   *pcb = cb;

   return 0;
}

 

// The example code.

// The file to store the contents of the rich edit control.
CFile cFile(TEXT("My_RichEdit_OutFile.rtf"),
            CFile::modeCreate | CFile::modeWrite);
EDITSTREAM es;

es.dwCookie = (DWORD)&cFile;
es.pfnCallback = MyStreamOutCallback;
m_myRichEditCtrl.StreamOut(SF_RTF, es);

CRichEditCtrl::Undo

Membatalkan operasi terakhir dalam kontrol edit kaya.

BOOL Undo();

Tampilkan Nilai

Bukan nol jika operasi batalkan berhasil; jika tidak, 0.

Keterangan

Operasi batalkan juga dapat dibatalkan. Misalnya, Anda dapat memulihkan teks yang dihapus dengan panggilan pertama ke Undo. Selama tidak ada operasi edit intervensi, Anda dapat menghapus teks lagi dengan panggilan kedua ke Undo.

Untuk informasi selengkapnya, lihat EM_UNDO di Windows SDK.

Contoh

Lihat contoh untuk CanUndo.

Lihat juga

Sampel MFC WORDPAD
CWnd Kelas
Bagan Hierarki
CEdit Kelas
CRichEditView Kelas