CRichEditCtrl Sınıf

Zengin düzenleme denetiminin işlevselliğini sağlar.

Sözdizimi

class CRichEditCtrl : public CWnd

Üyeler

Ortak Oluşturucular

Veri Akışı Adı	Açıklama
CRichEditCtrl::CRichEditCtrl	Bir CRichEditCtrl nesne oluşturur.

Genel Yöntemler

Veri Akışı Adı	Açıklama
CRichEditCtrl::CanPaste	Pano içeriğinin bu zengin düzenleme denetimine yapıştırılıp yapıştırılmadığını belirler.
CRichEditCtrl::CanRedo	Denetimin yineleme kuyruğunda herhangi bir eylem olup olmadığını belirler.
CRichEditCtrl::CanUndo	Düzenleme işleminin geri alınabileceğini belirler.
CRichEditCtrl::CharFromPos	Düzenleme denetiminin istemci alanında belirtilen bir noktaya en yakın karakter hakkındaki bilgileri alır.
CRichEditCtrl::Clear	Geçerli seçimi temizler.
CRichEditCtrl::Copy	Geçerli seçimi Pano'ya kopyalar.
CRichEditCtrl::Create	Windows zengin düzenleme denetimini oluşturur ve bu CRichEditCtrl nesneyle ilişkilendirir.
CRichEditCtrl::CreateEx	Belirtilen genişletilmiş Windows stilleriyle Windows zengin düzenleme denetimini oluşturur ve bu CRichEditCtrl nesneyle ilişkilendirir.
CRichEditCtrl::Cut	Geçerli seçimi Pano'ya keser.
CRichEditCtrl::DisplayBand	Bu CRichEditCtrl nesnenin içeriğinin bir bölümünü görüntüler.
CRichEditCtrl::EmptyUndoBuffer	Bu CRichEditCtrl nesnenin geri alma bayrağını sıfırlar (temizler).
CRichEditCtrl::FindText	Bu CRichEditCtrl nesnenin içindeki metni bulur.
CRichEditCtrl::FindWordBreak	Belirtilen karakter konumundan önce veya sonra gelen sonraki sözcük sonunu bulur veya bu konumdaki karakterle ilgili bilgileri alır.
CRichEditCtrl::FormatRange	Hedef çıkış cihazı için bir metin aralığı biçimlendirin.
CRichEditCtrl::GetCharPos	Bu CRichEditCtrl nesne içindeki belirli bir karakterin konumunu belirler.
CRichEditCtrl::GetDefaultCharFormat	Bu CRichEditCtrl nesnedeki geçerli varsayılan karakter biçimlendirme özniteliklerini alır.
CRichEditCtrl::GetEventMask	Bu CRichEditCtrl nesne için olay maskesini alır.
CRichEditCtrl::GetFirstVisibleLine	Bu CRichEditCtrl nesnenin en üstteki görünür satırını belirler.
CRichEditCtrl::GetIRichEditOle	Bu zengin düzenleme denetiminin IRichEditOle arabirimine yönelik bir işaretçi alır.
CRichEditCtrl::GetLimitText	Kullanıcının bu CRichEditCtrl nesneye girebileceği metin miktarının sınırını alır.
CRichEditCtrl::GetLine	Bu CRichEditCtrl nesneden bir metin satırı alır.
CRichEditCtrl::GetLineCount	Bu CRichEditCtrl nesnedeki satır sayısını alır.
CRichEditCtrl::GetModify	Bu CRichEditCtrl nesnenin içeriğinin son kaydetmeden sonra değişip değişmediğini belirler.
CRichEditCtrl::GetOptions	Zengin düzenleme denetimi seçeneklerini alır.
CRichEditCtrl::GetParaFormat	Bu CRichEditCtrl nesnedeki geçerli seçimdeki paragraf biçimlendirme özniteliklerini alır.
CRichEditCtrl::GetPunctuation	Zengin düzenleme denetimi için geçerli noktalama işaretlerini alır. Bu ileti yalnızca işletim sisteminin Asya dillerindeki sürümlerinde kullanılabilir.
CRichEditCtrl::GetRect	Bu CRichEditCtrl nesne için biçimlendirme dikdörtgenini alır.
CRichEditCtrl::GetRedoName	Varsa, denetimin yineleme kuyruğunda bir sonraki eylemin türünü alır.
CRichEditCtrl::GetSel	Bu CRichEditCtrl nesnedeki geçerli seçimin başlangıç ve bitiş konumlarını alır.
CRichEditCtrl::GetSelectionCharFormat	Bu CRichEditCtrl nesnedeki geçerli seçimdeki karakter biçimlendirme özniteliklerini alır.
CRichEditCtrl::GetSelectionType	Bu CRichEditCtrl nesnedeki geçerli seçimdeki içerik türünü alır.
CRichEditCtrl::GetSelText	Bu CRichEditCtrl nesnedeki geçerli seçimin metnini alır
CRichEditCtrl::GetTextLength	Bu CRichEditCtrl nesnedeki metnin uzunluğunu karakter olarak alır. Sonlandırıcı null karakteri içermez.
CRichEditCtrl::GetTextLengthEx	Zengin düzenleme görünümündeki karakter veya bayt sayısını alır. Zengin düzenleme denetiminde metnin uzunluğunu belirleme yöntemini belirtmek için bayrak listesini kabul eder
CRichEditCtrl::GetTextMode	Geçerli metin modunu alır ve zengin düzenleme denetiminin düzeyini geri alır.
CRichEditCtrl::GetTextRange	Belirtilen metin aralığını alır.
CRichEditCtrl::GetUndoName	Varsa, sonraki geri alma eyleminin türünü alır.
CRichEditCtrl::GetWordWrapMode	Zengin düzenleme denetimi için geçerli sözcük kaydırma ve sözcük kesme seçeneklerini alır. Bu ileti yalnızca işletim sisteminin Asya dillerindeki sürümlerinde kullanılabilir.
CRichEditCtrl::HideSelection	Geçerli seçimi gösterir veya gizler.
CRichEditCtrl::LimitText	Kullanıcının nesneye CRichEditCtrl girebileceği metin miktarını sınırlar.
CRichEditCtrl::LineFromChar	Verilen karakteri hangi satırın içerdiğini belirler.
CRichEditCtrl::LineIndex	Bu CRichEditCtrl nesnedeki belirli bir satırın karakter dizinini alır.
CRichEditCtrl::LineLength	Bu CRichEditCtrl nesnedeki belirli bir satırın uzunluğunu alır.
CRichEditCtrl::LineScroll	Bu CRichEditCtrl nesnedeki metni kaydırıyor.
CRichEditCtrl::Paste	Pano'nun içeriğini bu zengin düzenleme denetimine ekler.
CRichEditCtrl::PasteSpecial	Pano'nun içeriğini belirtilen veri biçimindeki bu zengin düzenleme denetimine ekler.
CRichEditCtrl::PosFromChar	Düzenleme denetiminde belirtilen karakterin istemci alanı koordinatlarını alır.
CRichEditCtrl::Redo	Denetimin yineleme kuyruğunda bir sonraki eylemi yineler.
CRichEditCtrl::ReplaceSel	Bu CRichEditCtrl nesnedeki geçerli seçimi belirtilen metinle değiştirir.
CRichEditCtrl::RequestResize	Bu CRichEditCtrl nesneyi istek yeniden boyutlandırma bildirimleri göndermeye zorlar.
CRichEditCtrl::SetAutoURLDetect	Otomatik URL algılamanın zengin bir düzenleme denetiminde etkin olup olmadığını gösterir.
CRichEditCtrl::SetBackgroundColor	Bu CRichEditCtrl nesnedeki arka plan rengini ayarlar.
CRichEditCtrl::SetDefaultCharFormat	Bu CRichEditCtrl nesnedeki geçerli varsayılan karakter biçimlendirme özniteliklerini ayarlar.
CRichEditCtrl::SetEventMask	Bu CRichEditCtrl nesne için olay maskesini ayarlar.
CRichEditCtrl::SetModify	Bu CRichEditCtrl nesne için değişiklik bayrağını ayarlar veya temizler.
CRichEditCtrl::SetOLECallback	IRichEditOleCallback Bu zengin düzenleme denetimi için COM nesnesini ayarlar.
CRichEditCtrl::SetOptions	Bu CRichEditCtrl nesnenin seçeneklerini ayarlar.
CRichEditCtrl::SetParaFormat	Bu CRichEditCtrl nesnedeki geçerli seçimde paragraf biçimlendirme özniteliklerini ayarlar.
CRichEditCtrl::SetPunctuation	Zengin düzenleme denetimi için noktalama işaretlerini ayarlar. Bu ileti yalnızca işletim sisteminin Asya dillerindeki sürümlerinde kullanılabilir.
CRichEditCtrl::SetReadOnly	Bu CRichEditCtrl nesne için salt okunur seçeneği ayarlar.
CRichEditCtrl::SetRect	Bu CRichEditCtrl nesne için biçimlendirme dikdörtgenini ayarlar.
CRichEditCtrl::SetSel	Bu CRichEditCtrl nesnedeki seçimi ayarlar.
CRichEditCtrl::SetSelectionCharFormat	Bu CRichEditCtrl nesnedeki geçerli seçimdeki karakter biçimlendirme özniteliklerini ayarlar.
CRichEditCtrl::SetTargetDevice	Bu CRichEditCtrl nesne için hedef çıkış cihazını ayarlar.
CRichEditCtrl::SetTextMode	Zengin düzenleme denetiminin metin modunu veya geri alma düzeyini ayarlar. Denetim metin içeriyorsa ileti başarısız olur.
CRichEditCtrl::SetUndoLimit	Geri alma kuyruğunda depolanabilecek en fazla eylem sayısını ayarlar.
CRichEditCtrl::SetWordCharFormat	Bu CRichEditCtrl nesnedeki geçerli sözcükteki karakter biçimlendirme özniteliklerini ayarlar.
CRichEditCtrl::SetWordWrapMode	Zengin düzenleme denetimi için sözcük kaydırma ve sözcük kesme seçeneklerini ayarlar. Bu ileti yalnızca işletim sisteminin Asya dillerindeki sürümlerinde kullanılabilir.
CRichEditCtrl::StopGroupTyping	Denetimin geçerli geri alma eylemine ek yazma eylemleri toplamasını durdurur. Denetim, varsa sonraki yazma eylemini geri alma kuyruğundaki yeni bir eylemde depolar.
CRichEditCtrl::StreamIn	Giriş akışından bu CRichEditCtrl nesneye metin ekler.
CRichEditCtrl::StreamOut	Bu CRichEditCtrl nesneden gelen metni çıkış akışında depolar.
CRichEditCtrl::Undo	Son düzenleme işlemini tersine çevirir.

Açıklamalar

"Zengin düzenleme denetimi", kullanıcının metin girip düzenleyebileceği bir penceredir. Metne karakter ve paragraf biçimlendirmesi atanabilir ve eklenmiş OLE nesneleri içerebilir. Zengin düzenleme denetimleri, metni biçimlendirmek için bir programlama arabirimi sağlar. Ancak, bir uygulamanın biçimlendirme işlemlerinin kullanıcının kullanımına sunulması için gereken tüm kullanıcı arabirimi bileşenlerini uygulaması gerekir.

Bu Windows Ortak denetimi (ve dolayısıyla CRichEditCtrl sınıfı), yalnızca Windows 95/98 ve Windows NT sürüm 3.51 ve üzeri altında çalışan programlarda kullanılabilir. sınıfı, CRichEditCtrl Windows SDK zengin düzenleme denetiminin 2.0 ve 3.0 sürümlerini destekler.

Dikkat

bir iletişim kutusunda zengin düzenleme denetimi kullanıyorsanız (uygulamanızın SDI, MDI veya iletişim kutusu tabanlı olmasına bakılmaksızın), iletişim kutusu görüntülenmeden önce bir kez aramanız AfxInitRichEdit gerekir. Bu işlevi çağırmak için tipik bir yer, programınızın InitInstance üye işlevindedir. İletişim kutusunu her görüntülüyorsanız, yalnızca ilk kez çağırmanız gerekmez. ile CRichEditViewçalışıyorsanız arama AfxInitRichEdit yapmanız gerekmez.

kullanma CRichEditCtrlhakkında daha fazla bilgi için bkz:

• Denetimler

• Kullan -arak CRichEditCtrl

MFC uygulamasında zengin düzenleme denetimi kullanma örneği için bkz . WORDPAD örnek uygulaması.

Devralma Hiyerarşisi

CObject

CCmdTarget

CWnd

CRichEditCtrl

Gereksinimler

Üstbilgi: afxcmn.h

CRichEditCtrl::CanPaste

Zengin düzenleme denetiminin belirtilen Pano biçimini yapıştırabileceğini belirler.

BOOL CanPaste(UINT nFormat = 0) const;

Parametreler

nFormat
Sorgu için Pano veri biçimi. Bu parametre, önceden tanımlanmış Pano biçimlerinden biri veya tarafından RegisterClipboardFormatdöndürülen değer olabilir.

Dönüş Değeri

Pano biçimi yapıştırılabilirse sıfır olmayan; aksi takdirde 0.

Açıklamalar

0 ise nFormat , CanPaste şu anda Pano'da bulunan herhangi bir biçimi dener.

Daha fazla bilgi için bkz EM_CANPASTE . Windows SDK'sında ileti ve RegisterClipboardFormat işlev.

Örnek

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

CRichEditCtrl::CanRedo

Yineleme kuyruğunun herhangi bir eylem içerip içermediğini belirler.

BOOL CanRedo() const;

Dönüş Değeri

Yineleme kuyruğu eylemler içeriyorsa sıfır olmayan, aksi takdirde 0.

Açıklamalar

Yineleme kuyruğundaki işlemin adını bulmak için öğesini çağırın CRichEditCtrl::GetRedoName. En son Geri Alma işlemini yinelemek için öğesini çağırın Redo.

Daha fazla bilgi için bkz EM_CANREDO . Windows SDK'sı.

CRichEditCtrl::CanUndo

Son düzenleme işleminin geri alınabileceğini belirler.

BOOL CanUndo() const;

Dönüş Değeri

Son düzenleme işlemi üye işlevine Undo yapılan bir çağrıyla geri alınabiliyorsa sıfır olmayan; geri alınamazsa 0.

Açıklamalar

Daha fazla bilgi için bkz EM_CANUNDO . Windows SDK'sı.

Örnek

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

CRichEditCtrl::CharFromPos

parametresi pttarafından belirtilen noktadaki karakter hakkında bilgi alır.

int CharFromPos(CPoint pt) const;

Parametreler

pt
CPoint Belirtilen noktanın koordinatlarını içeren bir nesne.

Dönüş Değeri

Belirtilen noktaya en yakın karakterin sıfır tabanlı karakter dizini. Belirtilen nokta denetimdeki son karakterin ötesindeyse, dönüş değeri denetimdeki son karakteri gösterir.

Açıklamalar

Bu üye işlevi zengin bir düzenleme denetimiyle çalışır. Düzenleme denetiminin bilgilerini almak için öğesini çağırın CEdit::CharFromPos.

Daha fazla bilgi için bkz EM_CHARFROMPOS . Windows SDK'sı.

CRichEditCtrl::Clear

Zengin düzenleme denetimindeki geçerli seçimi (varsa) siler (temizler).

void Clear();

Açıklamalar

tarafından Clear gerçekleştirilen silme işlemi üye işlevi çağrılarak Undo geri alınabilir.

Geçerli seçimi silmek ve silinen içeriği Pano'ya yerleştirmek için üye işlevini çağırın Cut .

Daha fazla bilgi için bkz WM_CLEAR . Windows SDK'sı.

Örnek

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

CRichEditCtrl::Copy

Zengin düzenleme denetimindeki geçerli seçimi (varsa) Pano'ya kopyalar.

void Copy();

Açıklamalar

Daha fazla bilgi için bkz WM_COPY . Windows SDK'sı.

Örnek

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

CRichEditCtrl::Create

Windows zengin düzenleme denetimini oluşturur ve bu CRichEditCtrl nesneyle ilişkilendirir.

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

Parametreler

dwStyle
Düzenleme denetiminin stilini belirtir. Aşağıdaki Açıklamalar bölümünde listelenen pencere stillerinin bir bileşimini uygulayın ve Windows SDK'sında açıklanan denetim stillerini düzenleyin.

rect
Düzenleme denetiminin boyutunu ve konumunu belirtir. Bir CRect nesne veya RECT yapı olabilir.

pParentWnd
Düzenleme denetiminin üst penceresini belirtir (genellikle bir CDialog). Bu olmamalıdır NULL.

nID
Düzenleme denetiminin kimliğini belirtir.

Dönüş Değeri

Başlatma başarılı olursa sıfır olmayan; aksi takdirde, 0.

Açıklamalar

İki adımda bir CRichEditCtrl nesne oluşturursunuz. İlk olarak oluşturucuyu çağırınCRichEditCtrl, ardından Windows düzenleme denetimini oluşturan ve nesnesine ekleyen öğesini çağırınCreateCRichEditCtrl.

Bu işlevle zengin bir düzenleme denetimi oluşturduğunuzda, önce gerekli ortak denetim kitaplığını yüklemeniz gerekir. Kitaplığı yüklemek için genel işlevini AfxInitRichEditçağırın ve bu işlev de ortak denetim kitaplığını başlatır. İşleminizde yalnızca bir kez aramanız AfxInitRichEdit gerekir.

Yürütülürken Create , Windows düzenleme denetimine WM_NCCREATE, WM_NCCALCSIZE, WM_CREATEve WM_GETMINMAXINFO iletilerini gönderir.

Bu iletiler varsayılan olarak temel sınıftaki OnNcCreate, OnNcCalcSize, OnCreateve OnGetMinMaxInfo üye işlevleri CWnd tarafından işlenir. Varsayılan ileti işlemeyi genişletmek için öğesinden CRichEditCtrlbir sınıf türetin, yeni sınıfa bir ileti eşlemesi ekleyin ve yukarıdaki ileti işleyicisi üye işlevlerini geçersiz kılın. Örneğin, yeni sınıf için gerekli başlatmayı gerçekleştirmek için öğesini geçersiz kılın OnCreate.

Aşağıdaki pencere stillerini düzenleme denetimine uygulayın.

• WS_CHILD Her zaman.

• WS_VISIBLE Genelde.

• WS_DISABLED Nadiren.

• WS_GROUP Denetimleri gruplandırmak için.

• WS_TABSTOP Düzenleme denetimini sekme sırasına eklemek için.

Pencere stilleri hakkında daha fazla bilgi için bkz CreateWindow . Windows SDK'sı.

Örnek

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

CRichEditCtrl::CreateEx

Bir denetim (alt pencere) oluşturur ve bunu nesnesiyle CRichEditCtrl ilişkilendirir.

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

Parametreler

dwExStyle
Oluşturulan denetimin genişletilmiş stilini belirtir. Genişletilmiş Windows stillerinin listesi için Windows SDK'sında parametresine CreateWindowEx bakındwExStyle.

dwStyle
Düzenleme denetiminin stilini belirtir. Windows SDK'sında açıklanan denetim stillerinin Açıklamalar bölümünde Create listelenen pencere stillerinin bir bileşimini uygulayın ve denetim stillerini düzenleyin.

rect
oluşturulacak pencerenin boyutunu ve konumunu istemci koordinatlarında pParentWndaçıklayan bir RECT yapı başvurusu.

pParentWnd
Denetimin üst öğesi olan pencere işaretçisi.

nID
Denetimin alt pencere kimliği.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Create Yerine, Windows genişletilmiş stil ön biçimi WS_EX_tarafından belirtilen genişletilmiş Windows stilleri uygulamak için kullanınCreateEx.

CRichEditCtrl::CRichEditCtrl

Bir CRichEditCtrl nesne oluşturur.

CRichEditCtrl();

Açıklamalar

Windows zengin düzenleme denetimini oluşturmak için kullanın Create .

Örnek

// Declare a local CRichEditCtrl object.
CRichEditCtrl myRichEditCtrl;

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

CRichEditCtrl::Cut

Zengin düzenleme denetimindeki geçerli seçimi (varsa) silin (keser) ve silinen metni Pano'ya kopyalar.

void Cut();

Açıklamalar

tarafından Cut gerçekleştirilen silme işlemi üye işlevi çağrılarak Undo geri alınabilir.

Silinen metni Pano'ya yerleştirmeden geçerli seçimi silmek için üye işlevini çağırın Clear .

Daha fazla bilgi için bkz WM_CUT . Windows SDK'sı.

Örnek

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

CRichEditCtrl::DisplayBand

Daha önce tarafından FormatRangebiçimlendirilen zengin düzenleme denetiminin (metin ve OLE öğeleri) içeriğinin bir bölümünü görüntüler.

BOOL DisplayBand(LPRECT pDisplayRect);

Parametreler

pDisplayRect
Metnin görüntüleneceği cihazın alanını belirten veya RECT CRect nesnesinin işaretçisi.

Dönüş Değeri

Biçimlendirilmiş metnin görüntülenmesi başarılı olursa sıfır olmayan, aksi takdirde 0.

Açıklamalar

Metin ve OLE öğeleri işaretçisi pDisplayRecttarafından belirtilen alana kırpılır.

Daha fazla bilgi için bkz EM_DISPLAYBAND . Windows SDK'sı.

Örnek

örneğine CRichEditCtrl::FormatRangebakın.

CRichEditCtrl::EmptyUndoBuffer

Bu zengin düzenleme denetiminin geri alma bayrağını sıfırlar (temizler).

void EmptyUndoBuffer();

Açıklamalar

Denetim artık son düzenleme işlemini geri alamayacaktır. Zengin düzenleme denetimindeki bir işlem geri alınabildiğinde geri alma bayrağı ayarlanır.

üye işlevini SetWindowTexther çağırdığınızda CWnd geri alma bayrağı otomatik olarak temizlenir.

Daha fazla bilgi için bkz EM_EMPTYUNDOBUFFER . Windows SDK'sı.

Örnek

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

CRichEditCtrl::FindText

Zengin düzenleme denetimindeki metni bulur.

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

Parametreler

dwFlags
Olası değerlerin listesi için Windows SDK'sında EM_FINDTEXTEXT bölümüne bakınwParam.

pFindText
FINDTEXTEX Arama için parametreleri veren ve eşleşmenin bulunduğu aralığı döndüren yapı işaretçisi.

Dönüş Değeri

Sonraki eşleşmenin sıfır tabanlı karakter konumu; - Başka eşleşme yoksa 1.

Açıklamalar

Yapı içindeki FINDTEXTEX yapıda CHARRANGE uygun aralık parametrelerini ayarlayarak yukarı veya aşağı doğru arama yapabilirsiniz.

Daha fazla bilgi için bkz EM_FINDTEXTEX . Windows SDK'sında ileti ve FINDTEXTEX yapı.

Örnek

// 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

tarafından nStartbelirtilen konumdan önceki veya sonraki sözcük sonunu bulur.

DWORD FindWordBreak(
    UINT nCode,
    DWORD nStart) const;

Parametreler

nCode
Gerçekleştirecek eylemi gösterir. Olası değerlerin listesi için Windows SDK'sında EM_FINDWORDBREAK parametresinin code açıklamasına bakın.

nStart
Başlangıç noktası sıfır tabanlı karakter konumu.

Dönüş Değeri

parametresine nCodegöre. Daha fazla bilgi için bkz EM_FINDWORDBREAK . Windows SDK'sı.

Açıklamalar

Belirli bir konumdaki bir karakter hakkında bilgi almak için bu üye işlevini kullanabilirsiniz.

CRichEditCtrl::FormatRange

Belirli bir cihaz için zengin düzenleme denetimindeki bir metin aralığını biçimlendirin.

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

Parametreler

pfr
FORMATRANGE Çıkış cihazı hakkında bilgi içeren yapı işaretçisi. NULL zengin düzenleme denetimindeki önbelleğe alınmış bilgilerin serbest bırakılabildiğini gösterir.

bDisplay
Metnin işlenip işlenmediğini gösterir. ise FALSE, metin yalnızca ölçülür.

Dönüş Değeri

Bölgeye uyan son karakterin dizini artı bir.

Açıklamalar

Genellikle, bu çağrının ardından bir çağrısı yapılır DisplayBand.

Daha fazla bilgi için bkz EM_FORMATRANGE . Windows SDK'sında ileti ve FORMATRANGE yapı.

Örnek

// 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

Bu CRichEditCtrl nesne içindeki belirli bir karakterin konumunu (sol üst köşe) alır.

CPoint GetCharPos(long lChar) const;

Parametreler

lChar
Karakterin sıfır tabanlı dizini.

Dönüş Değeri

tarafından lCharbelirtilen karakterin sol üst köşesinin konumu.

Açıklamalar

Karakter, sıfır tabanlı dizin değeri verilerek belirtilir. Bu CRichEditCtrl nesnedeki son karakterin dizininden büyükselChar, dönüş değeri bu CRichEditCtrl nesnedeki son karakterin hemen ötesindeki karakter konumunun koordinatlarını belirtir.

Daha fazla bilgi için bkz EM_POSFROMCHAR . Windows SDK'sı.

CRichEditCtrl::GetDefaultCharFormat

Bu CRichEditCtrl nesnenin varsayılan karakter biçimlendirme özniteliklerini alır.

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

Parametreler

cf
İlk sürümde, varsayılan karakter biçimlendirme özniteliklerini tutan bir CHARFORMAT yapı işaretçisi.

İkinci sürümde, varsayılan karakter biçimlendirme özniteliklerini CHARFORMAT2 tutan, yapıya CHARFORMAT zengin düzenleme 2.0 uzantısı olan bir yapı işaretçisi.

Dönüş Değeri

öğesinin dwMask cfveri üyesi. Varsayılan karakter biçimlendirme özniteliklerini belirtti.

Açıklamalar

Daha fazla bilgi için windows SDK'sında EM_GETCHARFORMAT iletiye CHARFORMAT ve ve CHARFORMAT2 yapılara bakın.

Örnek

örneğine SetDefaultCharFormatbakın.

CRichEditCtrl::GetEventMask

Bu CRichEditCtrl nesne için olay maskesini alır.

long GetEventMask() const;

Dönüş Değeri

Bu CRichEditCtrl nesne için olay maskesi.

Açıklamalar

Olay maskesi, nesnenin üst penceresine CRichEditCtrl hangi bildirim iletilerini gönderdiğini belirtir.

Daha fazla bilgi için bkz EM_GETEVENTMASK . Windows SDK'sı.

Örnek

örneğine CRichEditCtrl::SetEventMaskbakın.

CRichEditCtrl::GetFirstVisibleLine

Bu CRichEditCtrl nesnenin en üstteki görünür satırını belirler.

int GetFirstVisibleLine() const;

Dönüş Değeri

Bu CRichEditCtrl nesnedeki en üstteki görünür satırın sıfır tabanlı dizini.

Açıklamalar

Daha fazla bilgi için bkz EM_GETFIRSTVISIBLELINE . Windows SDK'sı.

Örnek

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

Bu CRichEditCtrl nesnenin arabirimine IRichEditOle erişir.

IRichEditOle* GetIRichEditOle() const;

Dönüş Değeri

Bu CRichEditCtrl nesnenin IRichEditOle OLE işlevselliğine erişmek için kullanılabilecek arabirimin işaretçisi; NULL arabirim erişilebilir değilse.

Açıklamalar

Bu nesnenin OLE işlevine erişmek için bu CRichEditCtrl arabirimi kullanın.

Daha fazla bilgi için bkz EM_GETOLEINTERFACE . Windows SDK'sında ileti ve IRichEditOle arabirim.

CRichEditCtrl::GetLimitText

Bu CRichEditCtrl nesne için metin sınırını alır.

long GetLimitText() const;

Dönüş Değeri

Bu CRichEditCtrl nesne için bayt cinsinden geçerli metin sınırı.

Açıklamalar

Metin sınırı, zengin düzenleme denetiminin kabul edebildiği bayt cinsinden en fazla metin miktarıdır.

Daha fazla bilgi için bkz EM_GETLIMITTEXT . Windows SDK'sı.

Örnek

// 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

Bu CRichEditCtrl nesneden bir metin satırı alır.

int GetLine(
    int nIndex,
    LPTSTR lpszBuffer) const;

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

Parametreler

nIndex
Alınacak satırın sıfır tabanlı dizini.

lpszBuffer
Metni almak için arabelleğe işaret edin. Arabelleğin ilk sözcüğü arabelleğe kopyalanacak en fazla bayt sayısını belirtmelidir.

nMaxLength
içine lpszBufferkopyalanacak karakter sayısı üst sınırı. İkinci biçimi GetLine , bu değeri tarafından lpszBufferbelirtilen arabelleğin ilk sözcüğüne yerleştirir.

Dönüş Değeri

içine lpszBufferkopyalanan karakter sayısı.

Açıklamalar

Kopyalanan satır sonlandırıcı null karakter içermiyor.

Not

Arabelleğin ilk sözcüğü kopyalanacak karakter sayısını depoladığı için, arabelleğinizin en az 4 bayt uzunluğunda olduğundan emin olun.

Daha fazla bilgi için bkz EM_GETLINE . Windows SDK'sı.

Örnek

örneğine GetLineCountbakın.

CRichEditCtrl::GetLineCount

Nesnedeki CRichEditCtrl satır sayısını alır.

int GetLineCount() const;

Dönüş Değeri

Bu CRichEditCtrl nesnedeki satır sayısı.

Açıklamalar

Daha fazla bilgi için bkz EM_GETLINECOUNT . Windows SDK'sı.

Örnek

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

Bu CRichEditCtrl nesnenin içeriğinin değiştirilip değiştirilmediğini belirler.

BOOL GetModify() const;

Dönüş Değeri

Bu CRichEditCtrl nesnedeki metin değiştirildiyse sıfır olmayan; aksi takdirde 0.

Açıklamalar

Windows, zengin düzenleme denetiminin içeriğinin değiştirilip değiştirilmediğini belirten bir iç bayrak tutar. Düzenleme denetimi ilk oluşturulduğunda bu bayrak temizlenir ve üye işlevi çağrılarak SetModify da temizlenebilir.

Daha fazla bilgi için bkz EM_GETMODIFY . Windows SDK'sı.

Örnek

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

CRichEditCtrl::GetOptions

Zengin düzenleme denetimi için ayarlanmış olan seçenekleri alır.

UINT GetOptions() const;

Dönüş Değeri

Geçerli seçenek bayrağı değerlerinin birleşimi. Bu değerlerin listesi için windows SDK'sında EM_SETOPTIONS açıklandığı gibi iletideki parametresine bakınfOptions.

CRichEditCtrl::GetParaFormat

Geçerli seçimin paragraf biçimlendirme özniteliklerini alır.

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

Parametreler

pf
İlk sürümde, geçerli seçimin paragraf biçimlendirme özniteliklerini tutan bir PARAFORMAT yapı işaretçisi.

İkinci sürümde, varsayılan karakter biçimlendirme özniteliklerini PARAFORMAT2 tutan, yapıya PARAFORMAT zengin düzenleme 2.0 uzantısı olan bir yapı işaretçisi.

Dönüş Değeri

öğesinin dwMask pfveri üyesi. Geçerli seçim boyunca tutarlı olan paragraf biçimlendirme özniteliklerini belirtir.

Açıklamalar

Birden fazla paragraf seçiliyse, pf seçilen ilk paragrafın özniteliklerini alır. Dönüş değeri, seçim boyunca hangi özniteliklerin tutarlı olduğunu belirtir.

Daha fazla bilgi için windows SDK'sında EM_GETPARAFORMAT iletiye PARAFORMAT ve ve PARAFORMAT2 yapılara bakın.

Örnek

örneğine CRichEditCtrl::SetParaFormatbakın.

CRichEditCtrl::GetPunctuation

Zengin düzenleme denetimindeki geçerli noktalama işaretlerini alır.

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

Parametreler

fType
Windows SDK'sında parametresinde fType EM_GETPUNCTUATION açıklandığı gibi noktalama türü bayrağı.

lpPunc
Windows SDK'da açıklandığı gibi bir PUNCTUATION yapı işaretçisi.

Dönüş Değeri

İşlem başarılı olursa sıfır olmayan, aksi takdirde 0.

Açıklamalar

Bu üye işlevi yalnızca işletim sisteminin Asya dillerindeki sürümleriyle kullanılabilir.

CRichEditCtrl::GetRect

Bu CRichEditCtrl nesne için biçimlendirme dikdörtgenini alır.

void GetRect(LPRECT lpRect) const;

Parametreler

lpRect
CRectveya bu CRichEditCtrl nesnenin biçimlendirme dikdörtgenini almak için bir RECT işaretçisi.

Açıklamalar

Biçimlendirme dikdörtgeni, metnin sınırlayıcı dikdörtgenidir. Bu değer nesnenin boyutundan CRichEditCtrl bağımsızdır.

Daha fazla bilgi için bkz EM_GETRECT . Windows SDK'sı.

Örnek

örneğine LimitTextbakın.

CRichEditCtrl::GetRedoName

Varsa yineleme kuyruğunda bir sonraki kullanılabilir eylemin türünü alır.

UNDONAMEID GetRedoName() const;

Dönüş Değeri

Başarılı olursa, GetRedoName denetimin UNDONAMEID yineleme kuyruğundaki bir sonraki eylemin türünü belirten numaralandırma türünü döndürür. Yineleme kuyruğu boşsa veya kuyruktaki yineleme eylemi bilinmeyen türdeyse, GetRedoName 0 döndürür.

Açıklamalar

Geri alınabilecek veya yeniden oluşturulabilen eylem türleri arasında yazma, silme, sürükleme-bırakma, kesme ve yapıştırma işlemleri yer alır. Bu bilgiler, geri alma ve yineleme işlemleri için genişletilmiş bir kullanıcı arabirimi sağlayan uygulamalar için yararlı olabilir; örneğin, yinelenebilir eylemlerin açılan liste kutusu.

CRichEditCtrl::GetSel

Bu CRichEditCtrl nesnedeki geçerli seçimin sınırlarını alır.

void GetSel(CHARRANGE& cr) const;

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

Parametreler

cr
Geçerli seçimin sınırlarını almak için bir CHARRANGE yapıya başvuru.

nStartChar
Geçerli seçimdeki ilk karakterin sıfır tabanlı dizini.

nEndChar
Geçerli seçimdeki son karakterin sıfır tabanlı dizini.

Açıklamalar

Bu işlevin iki biçimi, seçimin sınırlarını almak için alternatif yollar sağlar. Bu formların kısa açıklamaları şunlardır:

• GetSel( cr ) Bu form, ve üyeleriyle birlikte cpMin cpMax yapısını kullanarak CHARRANGE sınırları döndürür.

• GetSel( nStartChar , nEndChar ) Bu form ve nEndCharparametrelerindeki nStartChar sınırları döndürür.

Başlangıç ( veya ) 0 ve bitiş (cpMincpMax veya nStartCharnEndChar) - 1 ise, seçim her şeyi içerir.

Daha fazla bilgi için bkz EM_EXGETSEL . Windows SDK'sında ileti ve CHARRANGE yapı.

Örnek

// 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

Geçerli seçimin karakter biçimlendirme özniteliklerini alır.

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

Parametreler

cf
İlk sürümde, geçerli seçimin karakter biçimlendirme özniteliklerini almak için bir CHARFORMAT yapı işaretçisi.

İkinci sürümde, geçerli seçimin karakter biçimlendirme özniteliklerini almak için CHARFORMAT2 yapıya CHARFORMAT zengin düzenleme 2.0 uzantısı olan bir yapı işaretçisi.

Dönüş Değeri

öğesinin dwMask cfveri üyesi. Geçerli seçim boyunca tutarlı olan karakter biçimlendirme özniteliklerini belirtir.

Açıklamalar

parametresi geçerli cf seçimdeki ilk karakterin özniteliklerini alır. Dönüş değeri, seçim boyunca hangi özniteliklerin tutarlı olduğunu belirtir.

Daha fazla bilgi için windows SDK'sında EM_GETCHARFORMAT iletiye CHARFORMAT ve ve CHARFORMAT2 yapılara bakın.

Örnek

örneğine SetSelectionCharFormatbakın.

CRichEditCtrl::GetSelectionType

Bu CRichEditCtrl nesnedeki seçim türünü belirler.

WORD GetSelectionType() const;

Dönüş Değeri

Geçerli seçimin içeriğini gösteren bayraklar. Aşağıdaki bayrakların birleşimi:

• SEL_EMPTY Geçerli bir seçim olmadığını gösterir.

• SEL_TEXT Geçerli seçimin metin içerdiğini gösterir.

• SEL_OBJECT Geçerli seçimin en az bir OLE öğesi içerdiğini gösterir.

• SEL_MULTICHAR Geçerli seçimin birden fazla metin karakteri içerdiğini gösterir.

• SEL_MULTIOBJECT Geçerli seçimin birden fazla OLE nesnesi içerdiğini gösterir.

Açıklamalar

Daha fazla bilgi için bkz EM_SELECTIONTYPE . Windows SDK'sı.

Örnek

// 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

Bu CRichEditCtrl nesnedeki geçerli seçimden metni alır.

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

Parametreler

lpBuf
Geçerli seçimdeki metni almak için arabelleğe işaret eden işaretçi.

Dönüş Değeri

Forma bağlıdır:

• GetSelText(lpBuf) null sonlandırma dahil olmak üzere içine kopyalanan lpBufkarakter sayısı.

• GetSelText( ) Geçerli seçimi içeren dize.

Açıklamalar

İlk formu kullanırsanız, GetSelText(lpBuf)arabelleğin alacağı metin için yeterince büyük olduğundan emin olmanız gerekir. Geçerli seçimdeki karakter sayısını belirlemek için çağrısı GetSel yapın.

Daha fazla bilgi için bkz EM_GETSELTEXT . Windows SDK'sı.

Örnek

örneğine CRichEditCtrl::GetSelectionTypebakın.

CRichEditCtrl::GetTextLength

Sonlandırıcı null karakteri dahil değil, bu CRichEditCtrl nesnedeki metnin uzunluğunu karakterler halinde alır.

long GetTextLength() const;

Dönüş Değeri

Bu CRichEditCtrl nesnedeki metnin uzunluğu.

Açıklamalar

Daha fazla bilgi için bkz WM_GETTEXTLENGTH . Windows SDK'sı.

Örnek

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

CRichEditCtrl::GetTextLengthEx

Zengin düzenleme denetimindeki metnin uzunluğunu hesaplar.

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

Parametreler

dwFlags
Metin uzunluğunun belirlenmesinde kullanılacak yöntemi belirten değer. Bu üye, Windows SDK'sında açıklanan bayraklar üyesinde GETTEXTLENGTHEX listelenen değerlerden biri veya daha fazlası olabilir.

uCodePage
Çeviri için kod sayfası (CP_ACP ANSI Kod Sayfası için, Unicode için 1200).

Dönüş Değeri

Düzenleme denetimindeki karakter veya bayt sayısı. içinde dwFlagsuyumsuz bayraklar ayarlandıysa, bu üye işlevi döndürür E_INVALIDARG.

Açıklamalar

GetTextLengthEx , metnin uzunluğunu belirlemenin ek yollarını sağlar. Zengin Düzenleme 2.0 işlevselliğini destekler. Daha fazla bilgi için bkz . Windows SDK'de Zengin Düzenleme Denetimleri Hakkında.

CRichEditCtrl::GetTextMode

Geçerli metin modunu alır ve zengin düzenleme denetiminin düzeyini geri alır.

UINT GetTextMode() const;

Dönüş Değeri

Windows SDK'da açıklandığı gibi numaralandırma türünden bit bayrakları TEXTMODE kümesi. Bayraklar geçerli metin modunu gösterir ve denetimin geri alma düzeyini gösterir.

CRichEditCtrl::GetTextRange

Belirtilen karakter aralığını alır.

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

Parametreler

nFirst
Aralıktaki ilk karakterden hemen önce gelen karakter konumu dizini.

nLast
Aralıktaki son karakterin hemen ardından gelen karakter konumu.

refString
Metni alacak bir CString nesneye başvuru.

Dönüş Değeri

Sonlandırıcı null karakter dahil değil, kopyalanan karakter sayısı.

Açıklamalar

Daha fazla bilgi için bkz EM_GETTEXTRANGE . Windows SDK'sı.

GetTextRange Zengin Düzenleme 2.0 işlevini destekler. Daha fazla bilgi için bkz . Windows SDK'de Zengin Düzenleme Denetimleri Hakkında.

CRichEditCtrl::GetUndoName

Varsa, geri alma kuyruğunda bir sonraki kullanılabilir eylemin türünü alır.

UNDONAMEID GetUndoName() const;

Dönüş Değeri

Bir geri alma eylemi denetimin geri alma kuyruğundaysa, GetUndoName kuyruktaki sonraki eylemin türünü belirten UNDONAMEID numaralandırma türünü döndürür. Geri alma kuyruğu boşsa veya kuyruktaki geri alma eylemi bilinmeyen GetUndoName türdeyse 0 döndürür.

Açıklamalar

Geri alınabilecek veya yeniden oluşturulabilen eylem türleri arasında yazma, silme, sürükleme-bırakma, kesme ve yapıştırma işlemleri yer alır. Bu bilgiler, geri alınabilecek eylemlerin açılan liste kutusu gibi Geri Al ve Yinele işlemleri için genişletilmiş bir kullanıcı arabirimi sağlayan uygulamalar için yararlı olabilir.

CRichEditCtrl::GetWordWrapMode

Zengin düzenleme denetimi için geçerli sözcük kaydırma ve sözcük kesme seçeneklerini alır.

UINT GetWordWrapMode() const;

Dönüş Değeri

Geçerli sözcük kaydırma ve sözcük kesme seçenekleri. Bu seçenekler Windows SDK'sında EM_SETWORDWRAPMODE açıklanmıştır.

Açıklamalar

Bu üye işlevi yalnızca işletim sisteminin Asya dillerindeki sürümleri için kullanılabilir.

CRichEditCtrl::HideSelection

Seçimin görünürlüğünü değiştirir.

void HideSelection(
    BOOL bHide,
    BOOL bPerm);

Parametreler

bHide
Seçimi gizlemek için seçimin gösterilip gösterilmeydiğini veya gizlenmesi TRUE gerektiğini gösterir.

bPerm
Seçimin görünürlüğündeki bu değişikliğin kalıcı olması gerekip gerekmediğini gösterir.

Açıklamalar

olduğunda bPerm TRUE, bu CRichEditCtrl nesnenin ECO_NOHIDESEL seçeneğini değiştirir. Bu seçeneğin kısa bir açıklaması için bkz SetOptions. . Bu işlevi, bu nesnenin tüm seçeneklerini ayarlamak için CRichEditCtrl kullanabilirsiniz.

Daha fazla bilgi için bkz EM_HIDESELECTION . Windows SDK'sı.

Örnek

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

CRichEditCtrl::LimitText

Kullanıcının düzenleme denetimine girebileceği metnin uzunluğunu sınırlar.

void LimitText(long nChars = 0);

Parametreler

nChars
Kullanıcının girebileceği metnin uzunluğunu (bayt cinsinden) belirtir. Bu parametre 0 ise (varsayılan değer), metin uzunluğu 64K bayt olarak ayarlanır.

Açıklamalar

Metin sınırının değiştirilmesi yalnızca kullanıcının girebileceği metni kısıtlar. Düzenleme denetiminde bulunan herhangi bir metin üzerinde hiçbir etkisi yoktur ve içindeki üye işlevi CWndtarafından SetWindowText düzenleme denetimine kopyalanan metnin uzunluğunu etkilemez. Bir uygulama, düzenleme denetimine SetWindowText çağrısında belirtilenden daha fazla metin yerleştirmek için LimitTextişlevini kullanırsa, kullanıcı düzenleme denetimindeki metinlerden herhangi birini silebilir. Ancak, geçerli seçimin silinmesi metnin metin sınırının altına düşmesine neden olmadığı sürece, metin sınırı kullanıcının var olan metni yeni metinle değiştirmesini engeller.

Not

Metin sınırı için her OLE öğesi tek bir karakter olarak sayılır.

Daha fazla bilgi için bkz EM_EXLIMITTEXT . Windows SDK'sı.

Örnek

// 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

Belirtilen karakter dizinini içeren satırın satır numarasını alır.

long LineFromChar(long nIndex) const;

Parametreler

nIndex
Düzenleme denetiminin metninde istenen karakter için sıfır tabanlı dizin değeri veya -1 içerir. -1 ise nIndex , geçerli satırı, yani şapka işaretini içeren satırı belirtir.

Dönüş Değeri

tarafından nIndexbelirtilen karakter dizinini içeren satırın sıfır tabanlı satır numarası. -1 ise nIndex , seçimin ilk karakterini içeren satırın sayısı döndürülür. Seçim yoksa, geçerli satır numarası döndürülür.

Açıklamalar

Karakter dizini, zengin düzenleme denetiminin başındaki karakter sayısıdır. Karakter sayma için ole öğesi tek bir karakter olarak sayılır.

Daha fazla bilgi için bkz EM_EXLINEFROMCHAR . Windows SDK'sı.

Örnek

// 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

Bu CRichEditCtrl nesne içindeki bir satırın karakter dizinini alır.

int LineIndex(int nLine = -1) const;

Parametreler

nLine
Düzenleme denetiminin metninde istenen satırın dizin değerini veya -1 değerini içerir. -1 ise nLine , geçerli satırı, yani şapka işaretini içeren satırı belirtir.

Dönüş Değeri

Belirtilen satır numarası düzenleme denetimindeki satır sayısından büyükse veya -1 içinde belirtilen nLine satırın karakter dizini.

Açıklamalar

Karakter dizini, zengin düzenleme denetiminin başından belirtilen satıra kadar olan karakter sayısıdır.

Daha fazla bilgi için bkz EM_LINEINDEX . Windows SDK'sı.

Örnek

// 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

Zengin düzenleme denetimindeki bir satırın uzunluğunu alır.

int LineLength(int nLine = -1) const;

Parametreler

nLine
Uzunluğu alınacak olan satırdaki bir karakterin karakter dizinini belirtir. Bu parametre -1 ise, geçerli satırın uzunluğu (şapka işaretini içeren çizgi) döndürülür, satır içindeki seçili metnin uzunluğu dahil değildir. Tek satırlı düzenleme denetimi için çağrıldığında LineLength , bu parametre yoksayılır.

Dönüş Değeri

Çok satırlı düzenleme denetimi için çağrıldığındaLineLength, dönüş değeri tarafından nLinebelirtilen satırın uzunluğudur (içindeTCHAR). Satırın sonundaki satır başı karakterini içermez. Tek satırlı düzenleme denetimi için çağrıldığında LineLength , dönüş değeri düzenleme denetimindeki metnin uzunluğudur (içinde TCHAR). Denetimdeki karakter sayısından büyükse nLine , dönüş değeri sıfırdır.

Açıklamalar

Bu CRichEditCtrl nesne içindeki LineIndex belirli bir satır numarası için karakter dizini almak için üye işlevini kullanın.

Daha fazla bilgi için bkz EM_LINELENGTH . Windows SDK'sı.

Örnek

örneğine LineIndexbakın.

CRichEditCtrl::LineScroll

Çok satırlı düzenleme denetiminin metnini kaydırıyor.

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

Parametreler

nLines
Dikey olarak kaydıracak satır sayısını belirtir.

nChars
Yatay olarak kaydıracak karakter konumlarının sayısını belirtir. Zengin düzenleme denetimi veya ES_CENTER stiline ES_RIGHT sahipse bu değer yoksayılır. Düzenleme stilleri içinde Createbelirtilir.

Açıklamalar

Düzenleme denetimi, düzenleme denetimindeki metnin son satırını dikey olarak kaydırmaz. Geçerli satır artı tarafından nLines belirtilen satır sayısı düzenleme denetimindeki toplam satır sayısını aşarsa, düzenleme denetiminin son satırının düzenleme denetimi penceresinin en üstüne kaydırılması için değer ayarlanır.

LineScroll herhangi bir satırın son karakterini yatay olarak kaydırmak için kullanılabilir.

Daha fazla bilgi için bkz EM_LINESCROLL . Windows SDK'sı.

Örnek

örneğine GetFirstVisibleLinebakın.

CRichEditCtrl::Paste

Panodaki CRichEditCtrl verileri ekleme noktasındaki giriş işaretinin konumuna ekler.

void Paste();

Açıklamalar

Veriler yalnızca Pano tanınan bir biçimde veri içeriyorsa eklenir.

Daha fazla bilgi için bkz WM_PASTE . Windows SDK'sı.

Örnek

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

CRichEditCtrl::PasteSpecial

Verileri belirli bir Pano biçiminde bu CRichEditCtrl nesneye yapıştırır.

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

Parametreler

nClipFormat
Bu CRichEditCtrl nesneye yapıştıracak pano biçimi.

dvAspect
Pano'dan alınacak verilerin cihaz yönü.

hMF
Yapıştırılacak nesnenin simgesel görünümünü içeren meta dosyasının tanıtıcısı.

Açıklamalar

Yeni malzeme ekleme noktasına, şapka işaretinin konumuna eklenir.

Daha fazla bilgi için bkz EM_PASTESPECIAL . Windows SDK'sı.

Örnek

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

CRichEditCtrl::PosFromChar

Düzenleme denetiminde belirtilen karakterin istemci alanı koordinatlarını alır.

CPoint PosFromChar(UINT nChar) const;

Parametreler

nChar
Karakterin sıfır tabanlı dizini.

Dönüş Değeri

Karakterin konumu (x, y). Tek satırlı düzenleme denetimi için y koordinatı her zaman sıfırdır.

Açıklamalar

Daha fazla bilgi için bkz EM_POSFROMCHAR . Windows SDK'sı.

CRichEditCtrl::Redo

Denetimin yineleme kuyruğunda bir sonraki eylemi yineler.

BOOL Redo();

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde, 0.

Açıklamalar

Daha fazla bilgi için bkz EM_REDO . Windows SDK'sı.

CRichEditCtrl::ReplaceSel

Bu CRichEditCtrl nesnedeki geçerli seçimi belirtilen metinle değiştirir.

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

Parametreler

lpszNewText
Yeni metni içeren null olarak sonlandırılan bir dizenin işaretçisi.

bCanUndo
Bu işlevin geri alınabileceğini belirtmek için, bu parametrenin değerini olarak TRUEayarlayın. Varsayılan değer şudur: FALSE.

Açıklamalar

Bu CRichEditCtrl nesnedeki tüm metni değiştirmek için kullanın CWnd::SetWindowText.

Geçerli bir seçim yoksa, değiştirme metni ekleme noktasına, yani geçerli şapka işareti konumuna eklenir.

Bu işlev, eklenen metni varolan karakter biçimlendirmesiyle biçimlendirecektir. Metin aralığının tamamını (çağırmadan önce (0,-1) çağırarakSetSelReplaceSel) değiştirirken, yeni eklenen metin tarafından devralınan önceki paragrafın biçimlendirmesini koruyan bir paragraf karakteri sonu vardır.

Daha fazla bilgi için bkz EM_REPLACESEL . Windows SDK'sı.

Örnek

örneğine LineIndexbakın.

CRichEditCtrl::RequestResize

Bu CRichEditCtrl nesneyi üst penceresine bildirim iletileri göndermeye EN_REQUESTRESIZE zorlar.

void RequestResize();

Açıklamalar

Bu işlev, altsız CRichEditCtrl bir nesne için işlenirken CWnd::OnSize kullanışlıdır.

Daha fazla bilgi için windows SDK'sında EM_REQUESTRESIZE Zengin Düzenleme Denetimleri Hakkında'nın iletiyi ve Altsız Zengin Düzenleme Denetimleri bölümünü inceleyin.

CRichEditCtrl::SetAutoURLDetect

Bir URL'yi otomatik olarak algılamak için zengin düzenleme denetimini ayarlar.

BOOL SetAutoURLDetect(BOOL bEnable = TRUE);

Parametreler

bEnable
Denetimin bir URL'yi otomatik olarak algılamak için ayarlanıp ayarlanmayacağını belirtir. ise TRUEetkindir. ise FALSEdevre dışı bırakılır.

Dönüş Değeri

Başarılı olursa sıfır, aksi halde sıfır olmayan. Örneğin, yetersiz bellek nedeniyle ileti başarısız olabilir.

Açıklamalar

Etkinleştirilirse, zengin düzenleme denetimi metni tarar ve standart bir URL biçimiyle eşleşip eşleşmediğini belirler. Bu URL biçimlerinin listesi için Bkz EM_AUTOURLDETECT . Windows SDK'sı.

Not

Düzenleme denetiminiz URL'ler dışındaki metinler CFE_LINK için efekti kullanıyorsa olarak ayarlamayın.SetAutoURLDetect TRUE SetAutoURLDetect URL'ler için bu etkiyi etkinleştirir ve diğer tüm metinler için devre dışı bırakır. Etki hakkında CFE_LINK daha fazla bilgi için bkz. EN_LINK.

CRichEditCtrl::SetBackgroundColor

Bu CRichEditCtrl nesne için arka plan rengini ayarlar.

COLORREF SetBackgroundColor(
    BOOL bSysColor,
    COLORREF cr);

Parametreler

bSysColor
Arka plan renginin sistem değerine ayarlı olup olmadığını gösterir. Bu değer ise TRUEcr yoksayılır.

cr
İstenen arka plan rengi. Yalnızca ise bSysColor kullanılır FALSE.

Dönüş Değeri

Bu CRichEditCtrl nesnenin önceki arka plan rengi.

Açıklamalar

Arka plan rengi sistem değerine veya belirtilen COLORREF bir değere ayarlanabilir.

Daha fazla bilgi için bkz EM_SETBKGNDCOLOR . Windows SDK'sında ileti ve COLORREF yapı.

Örnek

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

CRichEditCtrl::SetDefaultCharFormat

Bu CRichEditCtrl nesnedeki yeni metin için karakter biçimlendirme özniteliklerini ayarlar.

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

Parametreler

cf
İlk sürümde, yeni varsayılan karakter biçimlendirme özniteliklerini içeren bir CHARFORMAT yapı işaretçisi.

İkinci sürümde, varsayılan karakter biçimlendirme özniteliklerini içeren, yapıya CHARFORMAT2 CHARFORMAT zengin düzenleme 2.0 uzantısı olan bir yapı işaretçisi.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde, 0.

Açıklamalar

Yalnızca öğesi cf tarafından dwMask belirtilen öznitelikler bu işlev tarafından değiştirilir.

Daha fazla bilgi için windows SDK'sında EM_SETCHARFORMAT iletiye CHARFORMAT ve ve CHARFORMAT2 yapılara bakın.

Örnek

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

Bu CRichEditCtrl nesne için olay maskesini ayarlar.

DWORD SetEventMask(DWORD dwEventMask);

Parametreler

dwEventMask
Bu CRichEditCtrl nesne için yeni olay maskesi.

Dönüş Değeri

Önceki olay maskesi.

Açıklamalar

Olay maskesi, nesnenin üst penceresine CRichEditCtrl hangi bildirim iletilerini gönderdiğini belirtir.

Daha fazla bilgi için bkz EM_SETEVENTMASK . Windows SDK'sı.

Örnek

// 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

Düzenleme denetimi için değiştirilmiş bayrağı ayarlar veya temizler.

void SetModify(BOOL bModified = TRUE);

Parametreler

bModified
değeri TRUE , metnin değiştirildiğini, değeri FALSE ise değiştirilmediğini gösterir. Varsayılan olarak, değiştirilen bayrak ayarlanır.

Açıklamalar

Değiştirilen bayrak, düzenleme denetimindeki metnin değiştirilip değiştirilmediğini gösterir. Kullanıcı metni her değiştirdiği zaman otomatik olarak ayarlanır. Değeri üye işleviyle GetModify alınabilir.

Daha fazla bilgi için bkz EM_SETMODIFY . Windows SDK'sı.

Örnek

örneğine GetModifybakın.

CRichEditCtrl::SetOLECallback

Bu CRichEditCtrl nesneye OLE ile ilgili kaynaklara ve bilgilere erişmek için kullanılacak bir IRichEditOleCallback nesne verir.

BOOL SetOLECallback(IRichEditOleCallback* pCallback);

Parametreler

pCallback
Bu CRichEditCtrl nesnenin OLE ile ilgili kaynakları ve bilgileri almak için kullanacağı nesnenin IRichEditOleCallback işaretçisi.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde, 0.

Açıklamalar

Bu CRichEditCtrl nesne tarafından pCallbackbelirtilen COM nesnesinin kullanım sayısını artırmak için çağrısı IUnknown::AddRef yapacaktır.

Daha fazla bilgi için bkz EM_SETOLECALLBACK . Windows SDK'sında ileti ve IRichEditOleCallback arabirim.

CRichEditCtrl::SetOptions

Bu CRichEditCtrl nesnenin seçeneklerini ayarlar.

void SetOptions(
    WORD wOp,
    DWORD dwFlags);

Parametreler

wOp
İşlemin türünü gösterir. Aşağıdaki değerlerden biri:

• ECOOP_SET seçenekleri tarafından dwFlagsbelirtilenlere ayarlayın.

• ECOOP_OR Geçerli seçenekleri tarafından belirtilenlerle birleştirin dwFlags.

• ECOOP_AND Yalnızca tarafından dwFlagsda belirtilen geçerli seçenekleri koruyun.

• ECOOP_XOR Mantıksal olarak özel VEYA tarafından dwFlagsbelirtilenlerle geçerli seçenekler.

dwFlags
Zengin düzenleme seçenekleri. Bayrak değerleri Açıklamalar bölümünde listelenir.

Açıklamalar

Seçenekler aşağıdaki değerlerin bir bileşimi olabilir:

• ECO_AUTOWORDSELECTION Çift tıklamada otomatik sözcük seçimi.

• ECO_AUTOVSCROLL Kullanıcı satırın sonuna bir karakter yazdığınızda metni otomatik olarak 10 karakter sağa kaydırıyor. Kullanıcı ENTER tuşuna bastığında, denetim tüm metni sıfır konumuna geri kaydırıyor.

• ECO_AUTOHSCROLL Kullanıcı son satırdaki ENTER tuşuna bastığında metni otomatik olarak bir sayfa yukarı kaydırıyor.

• ECO_NOHIDESEL Düzenleme denetimi için varsayılan davranışı olumsuzlar. Varsayılan davranış, denetim giriş odağını kaybettiğinde seçimi gizler ve denetim giriş odağını aldığında seçimi gösterir. belirtirseniz ECO_NOHIDESEL, denetim odakta olmasa bile seçili metin tersine çevrilir.

• ECO_READONLY Kullanıcının düzenleme denetiminde metin yazmasını veya düzenlemesini engeller.

• ECO_WANTRETURN Kullanıcı, iletişim kutusundaki çok satırlı zengin düzenleme denetimine metin girerken ENTER tuşuna bastığında satır başı eklendiğini belirtir. Bu stili belirtmezseniz, ENTER tuşuna basmak zengin düzenleme denetiminin üst penceresine bir komut gönderir ve bu komut üst pencerenin varsayılan düğmesine (örneğin, iletişim kutusundaki Tamam düğmesi) tıklamayı taklit eder. Bu stilin tek satırlı düzenleme denetimi üzerinde hiçbir etkisi yoktur.

• ECO_SAVESEL Denetim odağı kaybettiğinde seçimi korur. Varsayılan olarak, odağı yeniden kazandığında denetimin tüm içeriği seçilir.

• ECO_VERTICAL Metni ve nesneleri dikey yönde çizer. Yalnızca Asya dillerinde kullanılabilir.

Daha fazla bilgi için bkz EM_SETOPTIONS . Windows SDK'sı.

Örnek

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

CRichEditCtrl::SetParaFormat

Bu CRichEditCtrl nesnedeki geçerli seçim için paragraf biçimlendirme özniteliklerini ayarlar.

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

Parametreler

pf
İlk sürümde, yeni varsayılan paragraf biçimlendirme özniteliklerini içeren bir PARAFORMAT yapı işaretçisi.

İkinci sürümde, varsayılan karakter biçimlendirme özniteliklerini PARAFORMAT2 tutan, yapıya PARAFORMAT zengin düzenleme 2.0 uzantısı olan bir yapı işaretçisi.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde, 0.

Açıklamalar

Yalnızca öğesi pf tarafından dwMask belirtilen öznitelikler bu işlev tarafından değiştirilir.

Daha fazla bilgi için windows SDK'sında EM_SETPARAFORMAT iletiye PARAFORMAT ve ve PARAFORMAT2 yapılara bakın.

Örnek

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

Zengin düzenleme denetiminde noktalama işaretlerini ayarlar.

BOOL SetPunctuation(
    UINT fType,
    PUNCTUATION* lpPunc);

Parametreler

fType
Noktalama işareti. Olası değerlerin listesi için Windows SDK'sında parametresine EM_SETPUNCTUATION bakınfType.

lpPunc
Windows SDK'da açıklandığı gibi bir PUNCTUATION yapı işaretçisi.

Dönüş Değeri

Başarılı olursa sıfır olmayan, aksi takdirde 0.

Açıklamalar

Bu üye işlevi, işletim sisteminin yalnızca Asya dillerindeki sürümleri için kullanılabilir.

CRichEditCtrl::SetReadOnly

Bu CRichEditCtrl nesnenin ECO_READONLY seçeneğini değiştirir.

BOOL SetReadOnly(BOOL bReadOnly = TRUE);

Parametreler

bReadOnly
Bu CRichEditCtrl nesnenin salt okunur olup olmadığını gösterir.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde, 0.

Açıklamalar

Bu seçeneğin kısa bir açıklaması için bkz SetOptions. . Bu işlevi, bu nesnenin tüm seçeneklerini ayarlamak için CRichEditCtrl kullanabilirsiniz.

Daha fazla bilgi için bkz EM_SETREADONLY . Windows SDK'sı.

Örnek

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

CRichEditCtrl::SetRect

Bu CRichEditCtrl nesne için biçimlendirme dikdörtgenini ayarlar.

void SetRect(LPCRECT lpRect);

Parametreler

lpRect
CRect veya biçimlendirme dikdörtgeninin yeni sınırlarını gösteren bir RECT işaretçi.

Açıklamalar

Biçimlendirme dikdörtgeni, metnin sınırlayıcı dikdörtgenidir. Sınırlayıcı dikdörtgen, zengin düzenleme denetimi penceresinin boyutundan bağımsızdır. Bu CRichEditCtrl nesne ilk oluşturulduğunda, biçimlendirme dikdörtgeni pencerenin istemci alanıyla aynı boyuttadır. Biçimlendirme dikdörtgenini zengin düzenleme penceresinden daha büyük veya küçük yapmak için kullanın SetRect .

Daha fazla bilgi için bkz EM_SETRECT . Windows SDK'sı.

Örnek

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

Bu CRichEditCtrl nesnenin içindeki seçimi ayarlar.

void SetSel(
    long nStartChar,
    long nEndChar);

void SetSel(CHARRANGE& cr);

Parametreler

nStartChar
Seçim için ilk karakterin sıfır tabanlı dizini.

nEndChar
Seçim için son karakterin sıfır tabanlı dizini.

cr
CHARRANGE geçerli seçimin sınırlarını tutan yapı.

Açıklamalar

Bu işlevin iki biçimi, seçimin sınırlarını ayarlamak için alternatif yollar sağlar. Bu formların kısa açıklamaları şunlardır:

• SetSel( cr ) Bu form, sınırları ayarlamak için ve cpMax üyeleriyle birlikte cpMin yapısını kullanırCHARRANGE.

• SetSel( nStartChar , nEndChar ) Bu form, sınırları nStartChar ayarlamak için parametreleri ve nEndChar'ı kullanır.

Şapka işareti, başlangıç ( veya ) ve bitiş (cpMincpMax nEndCharveya nStartChar) dizinlerinin büyük olduğu belirtilen seçimin sonuna yerleştirilir. Bu işlev, öğesinin CRichEditCtrl içeriğini kaydırarak şapka işaretinin görünür hale geldiğini gösterir.

Bu CRichEditCtrl nesnedeki tüm metni seçmek için, başlangıç dizini 0 ve bitiş dizini - 1 ile çağrısı SetSel yapın.

Daha fazla bilgi için bkz EM_EXSETSEL . Windows SDK'sında ileti ve CHARRANGE yapı.

Örnek

örneğine GetSelbakın.

CRichEditCtrl::SetSelectionCharFormat

Bu CRichEditCtrl nesnedeki geçerli seçimdeki metnin karakter biçimlendirme özniteliklerini ayarlar.

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

Parametreler

cf
İlk sürümde, geçerli seçim için yeni karakter biçimlendirme özniteliklerini içeren bir CHARFORMAT yapı işaretçisi.

İkinci sürümde, geçerli seçim için CHARFORMAT2 yeni karakter biçimlendirme özniteliklerini içeren, yapıya CHARFORMAT zengin düzenleme 2.0 uzantısı olan bir yapı işaretçisi.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde, 0.

Açıklamalar

Yalnızca cf üyesi tarafından dwMask belirtilen öznitelikler bu işlev tarafından değiştirilir.

Daha fazla bilgi için windows SDK'sında EM_SETCHARFORMAT ve CHARFORMAT2 CHARFORMAT ve yapılarını inceleyin.

Örnek

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

Bu CRichEditCtrl nesnedeki WYSIWYG biçimlendirmesi için kullanılan hedef cihazı ve çizgi genişliğini (gördüğünüz şey, elde ettiğiniz şey) ayarlar.

BOOL SetTargetDevice(
    HDC hDC,
    long lLineWidth);

BOOL SetTargetDevice(
    CDC& dc,
    long lLineWidth);

Parametreler

hDC
Yeni hedef cihaz için cihaz bağlamını işleme.

lLineWidth
Biçimlendirme için kullanılacak çizgi genişliği.

dc
CDC yeni hedef cihaz için.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde, 0.

Açıklamalar

Bu işlev başarılı olursa, parametre olarak geçirilen cihaz bağlamı zengin düzenleme denetimine sahip olur. Bu durumda, çağıran işlevi cihaz bağlamını yok etmemelidir.

Daha fazla bilgi için bkz EM_SETTARGETDEVICE . Windows SDK'sı.

Örnek

// 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

Zengin düzenleme denetimi için metin modunu veya geri alma ve yineleme düzeyini ayarlar.

BOOL SetTextMode(UINT fMode);

Parametreler

fMode
Denetimin metin modu ve geri alma düzeyi parametreleri için yeni ayarları belirtir. Olası değerlerin listesi için Windows SDK'sında için EM_SETTEXTMODE mod parametresine bakın.

Dönüş Değeri

Başarılı olursa sıfır, aksi halde sıfır olmayan.

Açıklamalar

Metin modlarının açıklaması için Bkz EM_SETTEXTMODE . Windows SDK'sı.

Denetim metin içeriyorsa bu üye işlevi başarısız olur. Denetimin boş olduğundan emin olmak için boş dize içeren bir WM_SETTEXT ileti gönderin.

CRichEditCtrl::SetUndoLimit

Geri alma kuyruğunda depolanabilecek en fazla eylem sayısını ayarlar.

UINT SetUndoLimit(UINT nLimit);

Parametreler

nLimit
Geri alma kuyruğunda depolanabilecek en fazla eylem sayısını belirtir. Geri Al'ı devre dışı bırakmak için sıfır olarak ayarlayın.

Dönüş Değeri

Zengin düzenleme denetimi için yeni en fazla geri alma eylemi sayısı.

Açıklamalar

Varsayılan olarak, geri alma kuyruğundaki eylem sayısı üst sınırı 100'dür. Bu sayıyı artırırsanız, yeni sayıya uyum sağlamak için yeterli kullanılabilir bellek olmalıdır. Daha iyi performans için sınırı mümkün olan en küçük değere ayarlayın.

CRichEditCtrl::SetWordCharFormat

Bu CRichEditCtrl nesnede seçili durumdaki sözcüğün karakter biçimlendirme özniteliklerini ayarlar.

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

Parametreler

cf
İlk sürümde, seçili durumdaki sözcüğün yeni karakter biçimlendirme özniteliklerini içeren bir CHARFORMAT yapı işaretçisi.

İkinci sürümde, seçili durumdaki sözcüğün CHARFORMAT2 yeni karakter biçimlendirme özniteliklerini içeren, yapıya CHARFORMAT zengin düzenleme 2.0 uzantısı olan bir yapı işaretçisi.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde, 0.

Açıklamalar

Yalnızca öğesi cf tarafından dwMask belirtilen öznitelikler bu işlev tarafından değiştirilir.

Daha fazla bilgi için windows SDK'sında EM_SETCHARFORMAT iletiye CHARFORMAT ve ve CHARFORMAT2 yapılara bakın.

Örnek

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

Zengin düzenleme denetimi için sözcük kaydırma ve sözcük kesme seçeneklerini ayarlar.

UINT SetWordWrapMode(UINT uFlags) const;

Parametreler

uFlags
Sözcük kaydırma ve sözcük kesme için ayar seçenekleri. Olası seçeneklerin listesi için Bkz EM_SETWORDWRAPMODE . Windows SDK'sı.

Dönüş Değeri

Geçerli sözcük kaydırma ve sözcük kesme seçenekleri.

Açıklamalar

Bu ileti yalnızca işletim sisteminin Asya dillerindeki sürümlerinde kullanılabilir.

CRichEditCtrl::StopGroupTyping

Denetimin geçerli geri alma eylemine ek yazma eylemleri toplamasını durdurur.

void StopGroupTyping();

Açıklamalar

Denetim, varsa sonraki yazma eylemini geri alma kuyruğundaki yeni bir eylemde depolar.

Daha fazla bilgi için bkz EM_STOPGROUPTYPING . Windows SDK'sı.

CRichEditCtrl::StreamIn

Bu CRichEditCtrl nesnedeki metni belirtilen giriş akışındaki metinle değiştirir.

long StreamIn(
    int nFormat,
    EDITSTREAM& es);

Parametreler

nFormat
Giriş veri biçimlerini belirten bayraklar. Daha fazla bilgi için Açıklamalar bölümüne bakın.

es
EDITSTREAM giriş akışını belirten yapı. Daha fazla bilgi için Açıklamalar bölümüne bakın.

Dönüş Değeri

Giriş akışından okunan karakter sayısı.

Açıklamalar

değeri nFormat aşağıdakilerden biri olmalıdır:

• SF_TEXT Yalnızca okunan metni gösterir.

• SF_RTF Okunan metni ve biçimlendirmeyi gösterir.

Bu değerlerden biri ile SFF_SELECTIONbirleştirilebilir. belirtilirse SFF_SELECTION , StreamIn geçerli seçimi giriş akışının içeriğiyle değiştirir. Belirtilmezse, StreamIn bu CRichEditCtrl nesnenin tüm içeriğini değiştirir.

parametresinde EDITSTREAM es, arabelleği metinle dolduran bir geri çağırma işlevi belirtirsiniz. Giriş akışı tükenene kadar bu geri çağırma işlevi art arda çağrılır.

Daha fazla bilgi için bkz EM_STREAMIN . Windows SDK'sında ileti ve EDITSTREAM yapı.

Örnek

// 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

Bu CRichEditCtrl nesnenin içeriğini belirtilen çıkış akışına yazar.

long StreamOut(
    int nFormat,
    EDITSTREAM& es);

Parametreler

nFormat
Çıkış veri biçimlerini belirten bayraklar. Daha fazla bilgi için Açıklamalar bölümüne bakın.

es
EDITSTREAM yapısına bakın. Daha fazla bilgi için Açıklamalar bölümüne bakın.

Dönüş Değeri

Çıkış akışına yazılan karakter sayısı.

Açıklamalar

değeri nFormat aşağıdakilerden biri olmalıdır:

• SF_TEXT Yalnızca metin yazmayı gösterir.

• SF_RTF Metin yazmayı ve biçimlendirmeyi gösterir.

• SF_RTFNOOBJS OLE öğelerini boşluklarla değiştirerek metin ve biçimlendirme yazılması gerektiğini gösterir.

• SF_TEXTIZED OLE öğelerinin metinsel gösterimleriyle metin ve biçimlendirme yazmayı gösterir.

Bu değerlerden herhangi biri ile SFF_SELECTIONbirleştirilebilir. belirtilirse SFF_SELECTION , StreamOut geçerli seçimi çıkış akışına yazar. Belirtilmezse, StreamOut bu CRichEditCtrl nesnenin tüm içeriğini yazar.

parametresinde EDITSTREAM es, arabelleği metinle dolduran bir geri çağırma işlevi belirtirsiniz. Bu geri çağırma işlevi, çıkış akışı tükenene kadar art arda çağrılır.

Daha fazla bilgi için bkz EM_STREAMOUT . Windows SDK'sında ileti ve EDITSTREAM yapı.

Örnek

// 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

Zengin düzenleme denetimindeki son işlemi geri alır.

BOOL Undo();

Dönüş Değeri

Geri alma işlemi başarılı olursa sıfır olmayan; aksi takdirde, 0.

Açıklamalar

Geri alma işlemi de geri alınabilir. Örneğin, ilk çağrısıyla Undosilinen metni geri yükleyebilirsiniz. Araya bir düzenleme işlemi olmadığı sürece, ikinci bir çağrısıyla Undometni yeniden kaldırabilirsiniz.

Daha fazla bilgi için bkz EM_UNDO . Windows SDK'sı.

Örnek

örneğine CanUndobakın.

Ayrıca bkz.

MFC Örnek WORDPAD
CWnd Sınıf
Hiyerarşi Grafiği
CEdit Sınıf
CRichEditView Sınıf