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:
Untuk contoh penggunaan kontrol edit yang kaya dalam aplikasi MFC, lihat aplikasi sampel WORDPAD .
Hierarki Warisan
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 AfxInitRichEdit
global , yang pada gilirannya menginisialisasi pustaka kontrol umum. Anda hanya perlu memanggil AfxInitRichEdit
sekali dalam proses Anda.
Saat Create
dijalankan, Windows mengirimkan WM_NCCREATE
pesan , , WM_NCCALCSIZE
WM_CREATE
, dan WM_GETMINMAXINFO
ke kontrol edit.
Pesan ini ditangani secara default oleh OnNcCreate
fungsi anggota , , OnNcCalcSize
OnCreate
, 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 SetWindowText
anggota .
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 menggunakanCHARRANGE
struktur dengan anggota dancpMax
untukcpMin
mengembalikan batas.GetSel(
nStartChar
, ,nEndChar
) Formulir ini mengembalikan batas dalam parameternStartChar
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 dalamlpBuf
, 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 olehdwFlags
.ECOOP_OR
Gabungkan opsi saat ini dengan yang ditentukan olehdwFlags
.ECOOP_AND
Pertahankan hanya opsi saat ini yang juga ditentukan olehdwFlags
.ECOOP_XOR
Secara logis eksklusif ATAU opsi saat ini dengan yang ditentukan olehdwFlags
.
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 menentukanECO_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 menggunakanCHARRANGE
struktur dengan anggota dancpMax
untukcpMin
mengatur batas.SetSel(
nStartChar
, ,nEndChar
) Formulir ini menggunakan parameternStartChar
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