CRichEditCtrl-klasse

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Biedt de functionaliteit van het uitgebreide besturingselement voor bewerken.

Syntaxis

class CRichEditCtrl : public CWnd

Leden

Openbare constructors

Naam	Description
CRichEditCtrl::CRichEditCtrl	Maakt een CRichEditCtrl object.

Openbare methoden

Naam	Description
CRichEditCtrl::CanPaste	Bepaalt of de inhoud van het Klembord kan worden geplakt in dit uitgebreide besturingselement voor bewerken.
CRichEditCtrl::CanRedo	Bepaalt of er acties zijn in de redowachtrij van het besturingselement.
CRichEditCtrl::CanUndo	Bepaalt of een bewerking ongedaan kan worden gemaakt.
CRichEditCtrl::CharFromPos	Hiermee wordt informatie opgehaald over het teken dat zich het dichtst bij een opgegeven punt in het clientgebied van een besturingselement bevindt.
CRichEditCtrl::Clear	Hiermee wordt de huidige selectie gewist.
CRichEditCtrl::Copy	Hiermee kopieert u de huidige selectie naar het Klembord.
CRichEditCtrl::Create	Hiermee maakt u het besturingselement voor uitgebreide bewerkingen van Windows en koppelt u dit aan dit CRichEditCtrl object.
CRichEditCtrl::CreateEx	Hiermee maakt u het uitgebreide besturingselement voor bewerken van Windows met de opgegeven uitgebreide Windows-stijlen en koppelt u dit aan dit CRichEditCtrl object.
CRichEditCtrl::Cut	Hiermee knipt u de huidige selectie naar het Klembord.
CRichEditCtrl::DisplayBand	Geeft een gedeelte van de inhoud van dit CRichEditCtrl object weer.
CRichEditCtrl::EmptyUndoBuffer	Hiermee wordt de vlag ongedaan maken van dit CRichEditCtrl object opnieuw ingesteld (gewist).
CRichEditCtrl::FindText	Hiermee wordt tekst in dit CRichEditCtrl object gevonden.
CRichEditCtrl::FindWordBreak	Hiermee vindt u het volgende woordeinde vóór of na de opgegeven tekenpositie of haalt u informatie over het teken op die positie op.
CRichEditCtrl::FormatRange	Hiermee wordt een tekstbereik opgemaakt voor het doeluitvoerapparaat.
CRichEditCtrl::GetCharPos	Bepaalt de locatie van een bepaald teken binnen dit CRichEditCtrl object.
CRichEditCtrl::GetDefaultCharFormat	Hiermee worden de huidige standaardkenmerken voor tekenopmaak in dit CRichEditCtrl object opgehaald.
CRichEditCtrl::GetEventMask	Hiermee haalt u het gebeurtenismasker voor dit CRichEditCtrl object op.
CRichEditCtrl::GetFirstVisibleLine	Bepaalt de bovenste zichtbare lijn in dit CRichEditCtrl object.
CRichEditCtrl::GetIRichEditOle	Hiermee haalt u een aanwijzer naar de IRichEditOle interface voor dit uitgebreide besturingselement voor bewerken.
CRichEditCtrl::GetLimitText	Hiermee haalt u de limiet op voor de hoeveelheid tekst die een gebruiker in dit CRichEditCtrl object kan invoeren.
CRichEditCtrl::GetLine	Hiermee haalt u een tekstregel op uit dit CRichEditCtrl object.
CRichEditCtrl::GetLineCount	Hiermee wordt het aantal regels in dit CRichEditCtrl object opgehaald.
CRichEditCtrl::GetModify	Bepaalt of de inhoud van dit CRichEditCtrl object is gewijzigd sinds de laatste opslag.
CRichEditCtrl::GetOptions	Hiermee haalt u de uitgebreide besturingselementopties voor bewerken op.
CRichEditCtrl::GetParaFormat	Hiermee worden de alineaopmaakkenmerken in de huidige selectie in dit CRichEditCtrl object opgehaald.
CRichEditCtrl::GetPunctuation	Haalt de huidige interpunctietekens voor het uitgebreide besturingselement voor bewerken op. Dit bericht is alleen beschikbaar in aziatische versies van het besturingssysteem.
CRichEditCtrl::GetRect	Hiermee haalt u de opmaakrechthoek voor dit CRichEditCtrl object op.
CRichEditCtrl::GetRedoName	Hiermee wordt het type van de volgende actie, indien aanwezig, opgehaald in de redowachtrij van het besturingselement.
CRichEditCtrl::GetSel	Hiermee haalt u de begin- en eindposities van de huidige selectie in dit CRichEditCtrl object op.
CRichEditCtrl::GetSelectionCharFormat	Hiermee worden de kenmerken voor tekenopmaak in de huidige selectie in dit CRichEditCtrl object opgehaald.
CRichEditCtrl::GetSelectionType	Hiermee haalt u het type inhoud op in de huidige selectie in dit CRichEditCtrl object.
CRichEditCtrl::GetSelText	Hiermee haalt u de tekst van de huidige selectie in dit CRichEditCtrl object op
CRichEditCtrl::GetTextLength	Hiermee wordt de lengte van de tekst, in tekens, in dit CRichEditCtrl object opgehaald. Bevat niet het null-teken voor het beëindigen van de waarde.
CRichEditCtrl::GetTextLengthEx	Hiermee wordt het aantal tekens of bytes opgehaald in de uitgebreide bewerkingsweergave. Accepteert een lijst met vlaggen om de methode aan te geven voor het bepalen van de lengte van de tekst in een besturingselement voor rtf bewerken
CRichEditCtrl::GetTextMode	Hiermee wordt de huidige tekstmodus opgehaald en het niveau van een besturingselement voor uitgebreide bewerking ongedaan maken.
CRichEditCtrl::GetTextRange	Hiermee wordt het opgegeven tekstbereik opgehaald.
CRichEditCtrl::GetUndoName	Hiermee haalt u het type van de volgende actie ongedaan maken, indien van toepassing.
CRichEditCtrl::GetWordWrapMode	Hiermee haalt u de huidige opties voor tekstterugloop en woordbreking op voor het uitgebreide besturingselement bewerken. Dit bericht is alleen beschikbaar in aziatische versies van het besturingssysteem.
CRichEditCtrl::HideSelection	Hiermee wordt de huidige selectie weergegeven of verborgen.
CRichEditCtrl::LimitText	Hiermee beperkt u de hoeveelheid tekst die een gebruiker in het CRichEditCtrl object kan invoeren.
CRichEditCtrl::LineFromChar	Bepaalt welke regel het opgegeven teken bevat.
CRichEditCtrl::LineIndex	Haalt de tekenindex van een bepaalde regel in dit CRichEditCtrl object op.
CRichEditCtrl::LineLength	Hiermee wordt de lengte van een bepaalde regel in dit CRichEditCtrl object opgehaald.
CRichEditCtrl::LineScroll	Hiermee schuift u door de tekst in dit CRichEditCtrl object.
CRichEditCtrl::Paste	Hiermee wordt de inhoud van het Klembord in dit uitgebreide besturingselement voor bewerken ingevoegd.
CRichEditCtrl::PasteSpecial	Hiermee voegt u de inhoud van het Klembord in dit uitgebreide besturingselement voor bewerken in de opgegeven gegevensindeling.
CRichEditCtrl::PosFromChar	Hiermee worden de coördinaten van het clientgebied van een opgegeven teken opgehaald in een besturingselement voor bewerken.
CRichEditCtrl::Redo	Hiermee wordt de volgende actie opnieuw uitgevoerd in de wachtrij voor opnieuw uitvoeren van het besturingselement.
CRichEditCtrl::ReplaceSel	Hiermee vervangt u de huidige selectie in dit CRichEditCtrl object door de opgegeven tekst.
CRichEditCtrl::RequestResize	Hiermee dwingt u dit CRichEditCtrl object om de grootte van aanvragen te verzenden.
CRichEditCtrl::SetAutoURLDetect	Geeft aan of de automatische URL-detectie actief is in een uitgebreid besturingselement voor bewerken.
CRichEditCtrl::SetBackgroundColor	Hiermee stelt u de achtergrondkleur in dit CRichEditCtrl object in.
CRichEditCtrl::SetDefaultCharFormat	Hiermee stelt u de huidige standaardkenmerken voor tekenopmaak in dit CRichEditCtrl object in.
CRichEditCtrl::SetEventMask	Hiermee stelt u het gebeurtenismasker voor dit CRichEditCtrl object in.
CRichEditCtrl::SetModify	Hiermee stelt u de wijzigingsvlag voor dit object in of wist u deze CRichEditCtrl .
CRichEditCtrl::SetOLECallback	Hiermee stelt u het IRichEditOleCallback COM-object voor dit uitgebreide bewerkingsbesturingselement in.
CRichEditCtrl::SetOptions	Hiermee stelt u de opties voor dit CRichEditCtrl object in.
CRichEditCtrl::SetParaFormat	Hiermee stelt u de alineaopmaakkenmerken in de huidige selectie in dit CRichEditCtrl object in.
CRichEditCtrl::SetPunctuation	Hiermee stelt u de interpunctietekens in voor een uitgebreid besturingselement voor bewerken. Dit bericht is alleen beschikbaar in aziatische versies van het besturingssysteem.
CRichEditCtrl::SetReadOnly	Hiermee stelt u de optie alleen-lezen voor dit CRichEditCtrl object in.
CRichEditCtrl::SetRect	Hiermee stelt u de opmaakrechthoek voor dit CRichEditCtrl object in.
CRichEditCtrl::SetSel	Hiermee stelt u de selectie in dit CRichEditCtrl object in.
CRichEditCtrl::SetSelectionCharFormat	Hiermee stelt u de kenmerken voor tekenopmaak in de huidige selectie in dit CRichEditCtrl object in.
CRichEditCtrl::SetTargetDevice	Hiermee stelt u het doeluitvoerapparaat voor dit CRichEditCtrl object in.
CRichEditCtrl::SetTextMode	Hiermee stelt u de tekstmodus in of maakt u het niveau van een besturingselement voor uitgebreide bewerking ongedaan. Het bericht mislukt als het besturingselement tekst bevat.
CRichEditCtrl::SetUndoLimit	Hiermee stelt u het maximum aantal acties in dat kan worden opgeslagen in de wachtrij ongedaan maken.
CRichEditCtrl::SetWordCharFormat	Hiermee stelt u de kenmerken voor tekenopmaak in het huidige woord in dit CRichEditCtrl object in.
CRichEditCtrl::SetWordWrapMode	Hiermee stelt u de opties voor tekstterugloop en woordbreking in voor het uitgebreide besturingselement bewerken. Dit bericht is alleen beschikbaar in aziatische versies van het besturingssysteem.
CRichEditCtrl::StopGroupTyping	Hiermee voorkomt u dat het besturingselement aanvullende typacties verzamelt in de huidige bewerking ongedaan maken. In het besturingselement wordt de volgende typactie opgeslagen in een nieuwe actie in de wachtrij ongedaan maken.
CRichEditCtrl::StreamIn	Hiermee voegt u tekst uit een invoerstroom in dit CRichEditCtrl object in.
CRichEditCtrl::StreamOut	Hiermee slaat u tekst van dit CRichEditCtrl object op in een uitvoerstroom.
CRichEditCtrl::Undo	Hiermee wordt de laatste bewerking omgedraaid.

Opmerkingen

Een 'besturingselement voor rtf bewerken' is een venster waarin de gebruiker tekst kan invoeren en bewerken. De tekst kan worden toegewezen aan teken- en alineaopmaak en kan ingesloten OLE-objecten bevatten. Besturingselementen voor rtf bewerken bieden een programmeerinterface voor het opmaken van tekst. Een toepassing moet echter eventuele onderdelen van de gebruikersinterface implementeren die nodig zijn om opmaakbewerkingen beschikbaar te maken voor de gebruiker.

Dit algemene Besturingselement voor Windows (en daarom de CRichEditCtrl klasse) is alleen beschikbaar voor programma's die worden uitgevoerd onder Windows 95/98 en Windows NT-versies 3.51 en hoger. De CRichEditCtrl klasse ondersteunt versies 2.0 en 3.0 van het uitgebreide besturingselement voor bewerken van de Windows SDK.

Waarschuwing

Als u een uitgebreid besturingselement voor bewerken in een dialoogvenster gebruikt (ongeacht of uw toepassing SDI, MDI of dialoogvensters is), moet u één keer bellen AfxInitRichEdit voordat het dialoogvenster wordt weergegeven. Een typische plaats om deze functie aan te roepen, bevindt zich in de lidfunctie van InitInstance uw programma. U hoeft het niet elke keer uit te voeren wanneer u het dialoogvenster weergeeft, maar alleen de eerste keer. U hoeft niet te bellen AfxInitRichEdit als u met CRichEditViewwerkt.

Zie voor meer informatie over het gebruik CRichEditCtrl:

• Besturingselementen

• Gebruik CRichEditCtrl

Zie de wordPAD-voorbeeldtoepassing voor een voorbeeld van het gebruik van een uitgebreid besturingselement voor bewerken in een MFC-toepassing.

Overnamehiërarchie

CObject

CCmdTarget

CWnd

CRichEditCtrl

Requirements

Rubriek:afxcmn.h

CRichEditCtrl::CanPaste

Bepaalt of het besturingselement rich edit de opgegeven Klembord-indeling kan plakken.

BOOL CanPaste(UINT nFormat = 0) const;

Parameterwaarden

nFormat
De gegevensindeling van het Klembord om een query uit te voeren. Deze parameter kan een van de vooraf gedefinieerde Klembord-indelingen of de waarde zijn die wordt geretourneerd door RegisterClipboardFormat.

Retourwaarde

Niet-nul als de Klembord-indeling kan worden geplakt; anders 0.

Opmerkingen

Als nFormat dit 0 is, CanPaste probeert u een indeling op het Klembord.

Zie EM_CANPASTE bericht en RegisterClipboardFormat functie in de Windows SDK voor meer informatie.

Example

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

CRichEditCtrl::CanRedo

Bepaalt of de redo-wachtrij acties bevat.

BOOL CanRedo() const;

Retourwaarde

Niet-nul als de wachtrij opnieuw acties bevat, anders 0.

Opmerkingen

Als u de naam van de bewerking in de redo-wachtrij wilt detecteren, roept u aan CRichEditCtrl::GetRedoName. Als u de meest recente bewerking Ongedaan maken opnieuw wilt uitvoeren, roept u aan Redo.

Zie de Windows SDK voor meer informatie EM_CANREDO .

CRichEditCtrl::CanUndo

Bepaalt of de laatste bewerking ongedaan kan worden gemaakt.

BOOL CanUndo() const;

Retourwaarde

Niet-nul als de laatste bewerking ongedaan kan worden gemaakt door een aanroep naar de Undo lidfunctie; 0 als deze niet ongedaan kan worden gemaakt.

Opmerkingen

Zie de Windows SDK voor meer informatie EM_CANUNDO .

Example

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

CRichEditCtrl::CharFromPos

Haalt informatie op over het teken op het punt dat is opgegeven door de parameter pt.

int CharFromPos(CPoint pt) const;

Parameterwaarden

pt
Een CPoint object met de coördinaten van het opgegeven punt.

Retourwaarde

De op nul gebaseerde tekenindex van het teken dat het dichtst bij het opgegeven punt staat. Als het opgegeven punt buiten het laatste teken in het besturingselement valt, geeft de retourwaarde het laatste teken in het besturingselement aan.

Opmerkingen

Deze lidfunctie werkt met een uitgebreid besturingselement voor bewerken. Als u de informatie voor een besturingselement voor bewerken wilt ophalen, roept u het aan CEdit::CharFromPos.

Zie de Windows SDK voor meer informatie EM_CHARFROMPOS .

CRichEditCtrl::Clear

Hiermee verwijdert u de huidige selectie (indien aanwezig) in het uitgebreide besturingselement voor bewerken.

void Clear();

Opmerkingen

De verwijdering die wordt Clear uitgevoerd, kan ongedaan worden gemaakt door de Undo lidfunctie aan te roepen.

Als u de huidige selectie wilt verwijderen en de verwijderde inhoud op het Klembord wilt plaatsen, roept u de Cut lidfunctie aan.

Zie de Windows SDK voor meer informatie WM_CLEAR .

Example

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

CRichEditCtrl::Copy

Hiermee kopieert u de huidige selectie (indien aanwezig) in het besturingselement voor uitgebreide bewerking naar het Klembord.

void Copy();

Opmerkingen

Zie de Windows SDK voor meer informatie WM_COPY .

Example

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

CRichEditCtrl::Create

Hiermee maakt u het besturingselement voor uitgebreide bewerkingen van Windows en koppelt u dit aan dit CRichEditCtrl object.

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

Parameterwaarden

dwStyle
Hiermee geeft u de stijl van het besturingselement bewerken. Pas een combinatie van de vensterstijlen toe die worden vermeld in de sectie Opmerkingen hieronder en bewerk besturingsstijlen, zoals beschreven in de Windows SDK.

rect
Hiermee geeft u de grootte en positie van het besturingselement bewerken. Dit kan een CRect object of RECT structuur zijn.

pParentWnd
Hiermee geeft u het bovenliggende venster van het besturingselement bewerken (vaak een CDialog). Het mag niet zijn NULL.

nID
Hiermee geeft u de id van het besturingselement bewerken.

Retourwaarde

Niet-nul als initialisatie is geslaagd; anders, 0.

Opmerkingen

U maakt een CRichEditCtrl object in twee stappen. Roep eerst de CRichEditCtrl constructor aan en roep Createvervolgens het Besturingselement bewerken van Windows aan en koppelt het aan het CRichEditCtrl object.

Wanneer u een uitgebreid bewerkingsbesturingselement maakt met deze functie, moet u eerst de benodigde algemene besturingsbibliotheek laden. Als u de bibliotheek wilt laden, roept u de globale functie AfxInitRichEditaan, die op zijn beurt de algemene besturingsbibliotheek initialiseert. U hoeft slechts één keer in uw proces aan te roepen AfxInitRichEdit .

Wanneer Create dit wordt uitgevoerd, verzendt Windows het WM_NCCREATEbesturingselement , WM_NCCALCSIZEen WM_CREATEWM_GETMINMAXINFO berichten naar het besturingselement bewerken.

Deze berichten worden standaard verwerkt door de OnNcCreatefuncties , OnNcCalcSizeen OnCreateOnGetMinMaxInfo leden in de CWnd basisklasse. Als u de standaardverwerking van CRichEditCtrlberichten wilt uitbreiden, leidt u een klasse af, voegt u een berichttoewijzing toe aan de nieuwe klasse en overschrijft u de bovenstaande berichtenhandlerlidfuncties. Overschrijven OnCreate, bijvoorbeeld om de benodigde initialisatie voor de nieuwe klasse uit te voeren.

Pas de volgende vensterstijlen toe op een besturingselement bewerken.

• WS_CHILD Altijd.

• WS_VISIBLE Meestal.

• WS_DISABLED Zelden.

• WS_GROUP Besturingselementen groeperen.

• WS_TABSTOP Besturingselement bewerken opnemen in de tabvolgorde.

Zie de Windows SDK voor meer informatie over vensterstijlen CreateWindow .

Example

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

CRichEditCtrl::CreateEx

Hiermee maakt u een besturingselement (een onderliggend venster) en koppelt u dit aan het CRichEditCtrl object.

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

Parameterwaarden

dwExStyle
Hiermee geeft u de uitgebreide stijl van het besturingselement dat wordt gemaakt. Zie de dwExStyle parameter voor in de Windows SDK voor CreateWindowEx een lijst met uitgebreide Windows-stijlen.

dwStyle
Hiermee geeft u de stijl van het besturingselement bewerken. Pas een combinatie van de vensterstijlen toe die worden vermeld in de sectie Opmerkingen van Create en besturingselementstijlen bewerken, zoals beschreven in de Windows SDK.

rect
Een verwijzing naar een RECT structuur die de grootte en positie van het venster beschrijft dat moet worden gemaakt, in clientcoördinaten van pParentWnd.

pParentWnd
Een aanwijzer naar het venster dat het bovenliggende besturingselement is.

nID
De id van het onderliggende venster van het besturingselement.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Opmerkingen

Gebruik CreateEx in plaats van Create uitgebreide Windows-stijlen toe te passen, die zijn opgegeven door het voorwoord WS_EX_voor de uitgebreide Stijl van Windows.

CRichEditCtrl::CRichEditCtrl

Maakt een CRichEditCtrl object.

CRichEditCtrl();

Opmerkingen

Hiermee Create maakt u het besturingselement voor uitgebreide bewerkingen van Windows.

Example

// Declare a local CRichEditCtrl object.
CRichEditCtrl myRichEditCtrl;

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

CRichEditCtrl::Cut

Verwijder (snijdt) de huidige selectie (indien aanwezig) in het besturingselement voor uitgebreide bewerking en kopieert de verwijderde tekst naar het Klembord.

void Cut();

Opmerkingen

De verwijdering die wordt Cut uitgevoerd, kan ongedaan worden gemaakt door de Undo lidfunctie aan te roepen.

Als u de huidige selectie wilt verwijderen zonder de verwijderde tekst in het Klembord te plaatsen, roept u de Clear lidfunctie aan.

Zie de Windows SDK voor meer informatie WM_CUT .

Example

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

CRichEditCtrl::DisplayBand

Geeft een gedeelte weer van de inhoud van het besturingselement voor rtf bewerken (tekst en OLE-items), zoals eerder opgemaakt door FormatRange.

BOOL DisplayBand(LPRECT pDisplayRect);

Parameterwaarden

pDisplayRect
Wijs een RECT of CRect object aan waarmee het gebied van het apparaat wordt opgegeven om de tekst weer te geven.

Retourwaarde

Niet-nul als de weergave van de opgemaakte tekst slaagt, anders 0.

Opmerkingen

De tekst en OLE-items worden geknipt naar het gebied dat is opgegeven door de aanwijzer pDisplayRect.

Zie de Windows SDK voor meer informatie EM_DISPLAYBAND .

Example

Zie het voorbeeld voor CRichEditCtrl::FormatRange.

CRichEditCtrl::EmptyUndoBuffer

Hiermee stelt u de vlag voor ongedaan maken van dit uitgebreide bewerkingsbesturingselement opnieuw in (wissen).

void EmptyUndoBuffer();

Opmerkingen

Het besturingselement kan nu de laatste bewerking niet ongedaan maken. De vlag ongedaan maken wordt ingesteld wanneer een bewerking in het uitgebreide bewerkingsbesturingselement ongedaan kan worden gemaakt.

De vlag ongedaan maken wordt automatisch gewist wanneer u de CWnd lidfunctie SetWindowTextaanroept.

Zie de Windows SDK voor meer informatie EM_EMPTYUNDOBUFFER .

Example

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

CRichEditCtrl::FindText

Hiermee zoekt u tekst in het besturingselement rtf bewerken.

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

Parameterwaarden

dwFlags
Zie in EM_FINDTEXTEXT de Windows SDK voor een lijst met mogelijke waardenwParam.

pFindText
Wijs de FINDTEXTEX structuur aan met de parameters voor de zoekopdracht en retourneert het bereik waarin de overeenkomst is gevonden.

Retourwaarde

Op nul gebaseerde tekenpositie van de volgende overeenkomst; - 1 als er geen overeenkomsten meer zijn.

Opmerkingen

U kunt omhoog of omlaag zoeken door de juiste bereikparameters in te stellen in de CHARRANGE structuur binnen de FINDTEXTEX structuur.

Zie voor meer informatie EM_FINDTEXTEX bericht en FINDTEXTEX structuur in de Windows SDK.

Example

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

Hiermee vindt u het volgende woordeinde voor of na de positie die is opgegeven door nStart.

DWORD FindWordBreak(
    UINT nCode,
    DWORD nStart) const;

Parameterwaarden

nCode
Geeft de actie aan die moet worden uitgevoerd. Zie de beschrijving voor de parameter code in EM_FINDWORDBREAK de Windows SDK voor een lijst met mogelijke waarden.

nStart
De op nul gebaseerde tekenpositie van waaruit moet worden gestart.

Retourwaarde

Op basis van de parameter nCode. Zie de Windows SDK voor meer informatie EM_FINDWORDBREAK .

Opmerkingen

U kunt deze lidfunctie gebruiken om informatie over een teken op een bepaalde positie op te halen.

CRichEditCtrl::FormatRange

Hiermee wordt een tekstbereik opgemaakt in een besturingselement voor rtf bewerken voor een specifiek apparaat.

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

Parameterwaarden

pfr
Wijs de FORMATRANGE structuur aan die informatie over het uitvoerapparaat bevat. NULL geeft aan dat informatie in de cache in het uitgebreide besturingselement voor bewerken kan worden vrijgemaakt.

bDisplay
Geeft aan of de tekst moet worden weergegeven. Als FALSE, wordt de tekst zojuist gemeten.

Retourwaarde

De index van het laatste teken dat in de regio past plus één.

Opmerkingen

Deze aanroep wordt meestal gevolgd door een aanroep naar DisplayBand.

Zie voor meer informatie EM_FORMATRANGE bericht en FORMATRANGE structuur in de Windows SDK.

Example

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

Hiermee haalt u de positie (linkerbovenhoek) van een bepaald teken in dit CRichEditCtrl object op.

CPoint GetCharPos(long lChar) const;

Parameterwaarden

lChar
Op nul gebaseerde index van het teken.

Retourwaarde

De locatie van de linkerbovenhoek van het teken dat is opgegeven door lChar.

Opmerkingen

Het teken wordt opgegeven door de indexwaarde op basis van nul te geven. Als lChar de index van het laatste teken in dit CRichEditCtrl object groter is dan de index, geeft de retourwaarde de coördinaten op van de tekenpositie net voorbij het laatste teken in dit CRichEditCtrl object.

Zie de Windows SDK voor meer informatie EM_POSFROMCHAR .

CRichEditCtrl::GetDefaultCharFormat

Hiermee worden de standaardkenmerken voor tekenopmaak van dit CRichEditCtrl object opgehaald.

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

Parameterwaarden

cf
In de eerste versie wijst u een aanwijzer naar een CHARFORMAT structuur met de standaardkenmerken voor tekenopmaak.

In de tweede versie wijst u een aanwijzer naar een CHARFORMAT2 structuur, een rich edit 2.0-extensie voor de CHARFORMAT structuur, met de standaardkenmerken voor tekenopmaak.

Retourwaarde

Het dwMask gegevenslid van cf. De standaardkenmerken voor tekenopmaak zijn opgegeven.

Opmerkingen

Zie het EM_GETCHARFORMAT bericht en de CHARFORMATCHARFORMAT2 structuren in de Windows SDK voor meer informatie.

Example

Zie het voorbeeld voor SetDefaultCharFormat.

CRichEditCtrl::GetEventMask

Hiermee haalt u het gebeurtenismasker voor dit CRichEditCtrl object op.

long GetEventMask() const;

Retourwaarde

Het gebeurtenismasker voor dit CRichEditCtrl object.

Opmerkingen

Het gebeurtenismasker geeft aan welke meldingsberichten het object naar het CRichEditCtrl bovenliggende venster verzendt.

Zie de Windows SDK voor meer informatie EM_GETEVENTMASK .

Example

Zie het voorbeeld voor CRichEditCtrl::SetEventMask.

CRichEditCtrl::GetFirstVisibleLine

Bepaalt de bovenste zichtbare lijn in dit CRichEditCtrl object.

int GetFirstVisibleLine() const;

Retourwaarde

Op nul gebaseerde index van de bovenste zichtbare lijn in dit CRichEditCtrl object.

Opmerkingen

Zie de Windows SDK voor meer informatie EM_GETFIRSTVISIBLELINE .

Example

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

Hiermee opent u de IRichEditOle interface voor dit CRichEditCtrl object.

IRichEditOle* GetIRichEditOle() const;

Retourwaarde

Wijs de IRichEditOle interface aan die kan worden gebruikt voor toegang tot de OLE-functionaliteit van dit CRichEditCtrl object. NULL Als de interface niet toegankelijk is.

Opmerkingen

Gebruik deze interface om toegang te krijgen tot de OLE-functionaliteit van dit CRichEditCtrl object.

Zie bericht en IRichEditOle interface in de Windows SDK voor meer informatieEM_GETOLEINTERFACE.

CRichEditCtrl::GetLimitText

Hiermee haalt u de tekstlimiet voor dit CRichEditCtrl object op.

long GetLimitText() const;

Retourwaarde

De huidige tekstlimiet, in bytes, voor dit CRichEditCtrl object.

Opmerkingen

De tekstlimiet is de maximale hoeveelheid tekst, in bytes, die door het besturingselement voor rtf bewerken kan worden geaccepteerd.

Zie de Windows SDK voor meer informatie EM_GETLIMITTEXT .

Example

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

Hiermee haalt u een tekstregel op uit dit CRichEditCtrl object.

int GetLine(
    int nIndex,
    LPTSTR lpszBuffer) const;

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

Parameterwaarden

nIndex
Op nul gebaseerde index van de regel die moet worden opgehaald.

lpszBuffer
Verwijst naar de buffer om de tekst te ontvangen. Het eerste woord van de buffer moet het maximum aantal bytes opgeven dat in de buffer kan worden gekopieerd.

nMaxLength
Maximum aantal tekens dat kan worden gekopieerd naar lpszBuffer. In de tweede vorm wordt GetLine deze waarde in het eerste woord van de buffer geplaatst die is opgegeven door lpszBuffer.

Retourwaarde

Het aantal tekens dat is gekopieerd naar lpszBuffer.

Opmerkingen

De gekopieerde regel bevat geen null-eindteken.

Opmerking

Omdat het eerste woord van de buffer het aantal tekens opslaat dat moet worden gekopieerd, moet u ervoor zorgen dat uw buffer minimaal 4 bytes lang is.

Zie de Windows SDK voor meer informatie EM_GETLINE .

Example

Zie het voorbeeld voor GetLineCount.

CRichEditCtrl::GetLineCount

Hiermee haalt u het aantal regels in het CRichEditCtrl object op.

int GetLineCount() const;

Retourwaarde

Het aantal regels in dit CRichEditCtrl object.

Opmerkingen

Zie de Windows SDK voor meer informatie EM_GETLINECOUNT .

Example

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

Bepaalt of de inhoud van dit CRichEditCtrl object is gewijzigd.

BOOL GetModify() const;

Retourwaarde

Niet-nul als de tekst in dit CRichEditCtrl object is gewijzigd; anders 0.

Opmerkingen

Windows onderhoudt een interne vlag die aangeeft of de inhoud van het uitgebreide besturingselement voor bewerken is gewijzigd. Deze vlag wordt gewist wanneer het bewerkingsbesturingselement voor het eerst wordt gemaakt en kan ook worden gewist door de SetModify lidfunctie aan te roepen.

Zie de Windows SDK voor meer informatie EM_GETMODIFY .

Example

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

CRichEditCtrl::GetOptions

Hiermee worden de opties opgehaald die momenteel zijn ingesteld voor het uitgebreide besturingselement voor bewerken.

UINT GetOptions() const;

Retourwaarde

Een combinatie van de huidige optievlagwaarden. Zie de fOptions parameter in het EM_SETOPTIONS bericht voor een lijst met deze waarden, zoals beschreven in de Windows SDK.

CRichEditCtrl::GetParaFormat

Hiermee haalt u de alineaopmaakkenmerken van de huidige selectie op.

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

Parameterwaarden

pf
In de eerste versie wijst u een aanwijzer naar een PARAFORMAT structuur om de alineaopmaakkenmerken van de huidige selectie op te slaan.

In de tweede versie wijst u een aanwijzer naar een PARAFORMAT2 structuur, een rich edit 2.0-extensie voor de PARAFORMAT structuur, met de standaardkenmerken voor tekenopmaak.

Retourwaarde

Het dwMask gegevenslid van pf. Hiermee geeft u de alineaopmaakkenmerken op die consistent zijn in de huidige selectie.

Opmerkingen

Als er meer dan één alinea is geselecteerd, pf ontvangt u de kenmerken van de eerste geselecteerde alinea. De retourwaarde geeft aan welke kenmerken consistent zijn tijdens de selectie.

Zie het EM_GETPARAFORMAT bericht en de PARAFORMATPARAFORMAT2 structuren in de Windows SDK voor meer informatie.

Example

Zie het voorbeeld voor CRichEditCtrl::SetParaFormat.

CRichEditCtrl::GetPunctuation

Hiermee haalt u de huidige interpunctietekens op in een uitgebreid besturingselement voor bewerken.

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

Parameterwaarden

fType
De vlag van het interpunctietype, zoals beschreven in de fType parameter van EM_GETPUNCTUATION de Windows SDK.

lpPunc
Een aanwijzer naar een PUNCTUATION structuur, zoals beschreven in de Windows SDK.

Retourwaarde

Niet-nul als de bewerking is geslaagd, anders 0.

Opmerkingen

Deze lidfunctie is alleen beschikbaar met de Aziatische taalversies van het besturingssysteem.

CRichEditCtrl::GetRect

Hiermee haalt u de opmaakrechthoek voor dit CRichEditCtrl object op.

void GetRect(LPRECT lpRect) const;

Parameterwaarden

lpRect
CRect of wijs een aanwijzer naar een RECT om de rechthoek met opmaak van dit CRichEditCtrl object te ontvangen.

Opmerkingen

De opmaakrechthoek is de begrenzingsrechthoek voor de tekst. Deze waarde is onafhankelijk van de grootte van het CRichEditCtrl object.

Zie de Windows SDK voor meer informatie EM_GETRECT .

Example

Zie het voorbeeld voor LimitText.

CRichEditCtrl::GetRedoName

Hiermee wordt het type van de volgende beschikbare actie opgehaald in de redo-wachtrij, indien van toepassing.

UNDONAMEID GetRedoName() const;

Retourwaarde

Als dit lukt, GetRedoName wordt het UNDONAMEID opsommingstype geretourneerd dat het type van de volgende actie aangeeft in de redo-wachtrij van het besturingselement. Als de redo-wachtrij leeg is of als de actie Opnieuw in de wachtrij van een onbekend type is, GetRedoName wordt 0 geretourneerd.

Opmerkingen

De typen acties die ongedaan kunnen worden gemaakt of opnieuw kunnen worden uitgevoerd, zijn typen, verwijderen, slepen en neerzetten, knippen en plakken. Deze informatie kan handig zijn voor toepassingen die een uitgebreide gebruikersinterface bieden voor bewerkingen ongedaan maken en opnieuw uitvoeren, zoals een vervolgkeuzelijst met heroeerbare acties.

CRichEditCtrl::GetSel

Hiermee haalt u de grenzen van de huidige selectie in dit CRichEditCtrl object op.

void GetSel(CHARRANGE& cr) const;

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

Parameterwaarden

cr
Verwijzing naar een CHARRANGE structuur om de grenzen van de huidige selectie te ontvangen.

nStartChar
Op nul gebaseerde index van het eerste teken in de huidige selectie.

nEndChar
Op nul gebaseerde index van het laatste teken in de huidige selectie.

Opmerkingen

De twee vormen van deze functie bieden alternatieve manieren om de grenzen voor de selectie op te halen. Korte beschrijvingen van deze formulieren volgen:

• GetSel(cr) Dit formulier gebruikt de CHARRANGE structuur met de bijbehorende cpMin en cpMax leden om de grenzen te retourneren.

• GetSel(nStartChar,nEndChar) Dit formulier retourneert de grenzen in de parameters nStartChar en nEndChar.

De selectie bevat alles als het begin (cpMin of nStartChar) 0 is en het einde (cpMax of nEndChar) - 1 is.

Zie voor meer informatie EM_EXGETSEL bericht en CHARRANGE structuur in de Windows SDK.

Example

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

Hiermee haalt u de kenmerken voor tekenopmaak van de huidige selectie op.

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

Parameterwaarden

cf
In de eerste versie wijst u een aanwijzer naar een CHARFORMAT structuur om de kenmerken voor tekenopmaak van de huidige selectie te ontvangen.

In de tweede versie verwijst een verwijzing naar een CHARFORMAT2 structuur, een rich edit 2.0-extensie voor de CHARFORMAT structuur om de kenmerken voor tekenopmaak van de huidige selectie te ontvangen.

Retourwaarde

Het dwMask gegevenslid van cf. Hiermee geeft u de kenmerken voor tekenopmaak op die consistent zijn in de huidige selectie.

Opmerkingen

De cf parameter ontvangt de kenmerken van het eerste teken in de huidige selectie. De retourwaarde geeft aan welke kenmerken consistent zijn tijdens de selectie.

Zie het EM_GETCHARFORMAT bericht en de CHARFORMATCHARFORMAT2 structuren in de Windows SDK voor meer informatie.

Example

Zie het voorbeeld voor SetSelectionCharFormat.

CRichEditCtrl::GetSelectionType

Bepaalt het selectietype in dit CRichEditCtrl object.

WORD GetSelectionType() const;

Retourwaarde

Vlaggen die de inhoud van de huidige selectie aangeven. Een combinatie van de volgende vlaggen:

• SEL_EMPTY Hiermee wordt aangegeven dat er geen huidige selectie is.

• SEL_TEXT Geeft aan dat de huidige selectie tekst bevat.

• SEL_OBJECT Geeft aan dat de huidige selectie ten minste één OLE-item bevat.

• SEL_MULTICHAR Geeft aan dat de huidige selectie meer dan één teken van tekst bevat.

• SEL_MULTIOBJECT Geeft aan dat de huidige selectie meer dan één OLE-object bevat.

Opmerkingen

Zie de Windows SDK voor meer informatie EM_SELECTIONTYPE .

Example

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

Hiermee haalt u de tekst op uit de huidige selectie in dit CRichEditCtrl object.

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

Parameterwaarden

lpBuf
Wijs de buffer aan om de tekst in de huidige selectie te ontvangen.

Retourwaarde

Afhankelijk van het formulier:

• GetSelText(lpBuf) Het aantal tekens dat is gekopieerd naar lpBuf, niet inclusief de null-beëindiging.

• GetSelText( ) De tekenreeks met de huidige selectie.

Opmerkingen

Als u het eerste formulier gebruikt, GetSelText(lpBuf)moet u ervoor zorgen dat de buffer groot genoeg is voor de tekst die deze ontvangt. Aanroep GetSel om het aantal tekens in de huidige selectie te bepalen.

Zie de Windows SDK voor meer informatie EM_GETSELTEXT .

Example

Zie het voorbeeld voor CRichEditCtrl::GetSelectionType.

CRichEditCtrl::GetTextLength

Hiermee wordt de lengte van de tekst, in tekens, in dit CRichEditCtrl object opgehaald, met inbegrip van het afsluit-null-teken.

long GetTextLength() const;

Retourwaarde

De lengte van de tekst in dit CRichEditCtrl object.

Opmerkingen

Zie de Windows SDK voor meer informatie WM_GETTEXTLENGTH .

Example

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

CRichEditCtrl::GetTextLengthEx

Berekent de lengte van de tekst in het besturingselement rtf bewerken.

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

Parameterwaarden

dwFlags
Waarde die de methode aangeeft die moet worden gebruikt bij het bepalen van de tekstlengte. Dit lid kan een of meer van de waarden zijn die worden vermeld in het vlaglid van GETTEXTLENGTHEX beschreven in de Windows SDK.

uCodePage
Codepagina voor vertaling (CP_ACP voor ANSI-codepagina, 1200 voor Unicode).

Retourwaarde

Het aantal tekens of bytes in het besturingselement bewerken. Als er incompatibele vlaggen zijn ingesteld dwFlags, retourneert E_INVALIDARGdeze lidfunctie .

Opmerkingen

GetTextLengthEx biedt aanvullende manieren om de lengte van de tekst te bepalen. Het ondersteunt de functionaliteit Rich Edit 2.0. Zie Over uitgebreide besturingselementen voor bewerken in de Windows SDK voor meer informatie.

CRichEditCtrl::GetTextMode

Hiermee wordt de huidige tekstmodus opgehaald en het niveau van een besturingselement voor uitgebreide bewerking ongedaan maken.

UINT GetTextMode() const;

Retourwaarde

Een set bitvlagken van het TEXTMODE opsommingstype, zoals beschreven in de Windows SDK. De vlaggen geven de huidige tekstmodus aan en maken het niveau van het besturingselement ongedaan.

CRichEditCtrl::GetTextRange

Hiermee haalt u het opgegeven bereik van tekens op.

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

Parameterwaarden

nFirst
De positieindex van het teken direct voorafgaand aan het eerste teken in het bereik.

nLast
De positie van het teken direct na het laatste teken in het bereik.

refString
Een verwijzing naar een CString object dat de tekst ontvangt.

Retourwaarde

Het aantal gekopieerde tekens, niet inclusief het null-teken dat wordt beëindigd.

Opmerkingen

Zie de Windows SDK voor meer informatie EM_GETTEXTRANGE .

GetTextRange ondersteunt de functionaliteit Rich Edit 2.0. Zie Over uitgebreide besturingselementen voor bewerken in de Windows SDK voor meer informatie.

CRichEditCtrl::GetUndoName

Hiermee haalt u het type van de volgende beschikbare actie in de wachtrij ongedaan maken, indien van toepassing.

UNDONAMEID GetUndoName() const;

Retourwaarde

Als een bewerking ongedaan maken zich in de wachtrij voor ongedaan maken van het besturingselement bevindt, GetUndoName retourneert u het opsommingstype UNDONAMEID dat het type van de volgende actie in de wachtrij aangeeft. Als de wachtrij ongedaan maken leeg is of als de actie ongedaan maken in de wachtrij van een onbekend type is, GetUndoName retourneert u 0.

Opmerkingen

De typen acties die ongedaan kunnen worden gemaakt of opnieuw kunnen worden uitgevoerd, zijn typen, verwijderen, slepen en neerzetten, knippen en plakken. Deze informatie kan nuttig zijn voor toepassingen die een uitgebreide gebruikersinterface bieden voor bewerkingen ongedaan maken en opnieuw uitvoeren, zoals een vervolgkeuzelijst met acties die ongedaan kunnen worden gemaakt.

CRichEditCtrl::GetWordWrapMode

Hiermee haalt u de huidige opties voor tekstterugloop en woordbreking op voor het uitgebreide besturingselement bewerken.

UINT GetWordWrapMode() const;

Retourwaarde

De huidige opties voor tekstterugloop en woordbreking. Deze opties worden beschreven in EM_SETWORDWRAPMODE de Windows SDK.

Opmerkingen

Deze lidfunctie is alleen beschikbaar voor Aziatische versies van het besturingssysteem.

CRichEditCtrl::HideSelection

Hiermee wijzigt u de zichtbaarheid van de selectie.

void HideSelection(
    BOOL bHide,
    BOOL bPerm);

Parameterwaarden

bHide
Geeft aan of de selectie moet worden weergegeven of verborgen om TRUE de selectie te verbergen.

bPerm
Geeft aan of deze wijziging in zichtbaarheid voor de selectie permanent moet zijn.

Opmerkingen

Wanneer bPerm dit is TRUE, wordt de ECO_NOHIDESEL optie voor dit CRichEditCtrl object gewijzigd. Zie voor een korte beschrijving van deze optie SetOptions. U kunt deze functie gebruiken om alle opties voor dit CRichEditCtrl object in te stellen.

Zie de Windows SDK voor meer informatie EM_HIDESELECTION .

Example

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

CRichEditCtrl::LimitText

Hiermee beperkt u de lengte van de tekst die de gebruiker in een besturingselement voor bewerken kan invoeren.

void LimitText(long nChars = 0);

Parameterwaarden

nChars
Hiermee geeft u de lengte (in bytes) van de tekst die de gebruiker kan invoeren. Als deze parameter 0 is (de standaardwaarde), wordt de tekstlengte ingesteld op 64.000 bytes.

Opmerkingen

Als u de tekstlimiet wijzigt, beperkt u alleen de tekst die de gebruiker kan invoeren. Het heeft geen effect op tekst die al in het besturingselement bewerken staat en heeft evenmin invloed op de lengte van de tekst die naar het besturingselement bewerken is gekopieerd door de SetWindowText lidfunctie in CWnd. Als een toepassing de SetWindowText functie gebruikt om meer tekst in een besturingselement te plaatsen dan is opgegeven in de aanroep LimitText, kan de gebruiker een van de tekst in het besturingselement bewerken verwijderen. De tekstlimiet voorkomt echter dat de gebruiker de bestaande tekst vervangt door nieuwe tekst, tenzij het verwijderen van de huidige selectie ervoor zorgt dat de tekst onder de tekstlimiet valt.

Opmerking

Voor de tekstlimiet telt elk OLE-item als één teken.

Zie de Windows SDK voor meer informatie EM_EXLIMITTEXT .

Example

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

Hiermee wordt het regelnummer opgehaald van de regel die de opgegeven tekenindex bevat.

long LineFromChar(long nIndex) const;

Parameterwaarden

nIndex
Bevat de indexwaarde op basis van nul voor het gewenste teken in de tekst van het besturingselement bewerken of bevat -1. Als nIndex -1 is, geeft deze de huidige lijn aan, dat wil gezegd, de lijn die de caret bevat.

Retourwaarde

Het regelnummer op basis van nul van de regel met de tekenindex die is opgegeven door nIndex. Als nIndex dit -1 is, wordt het nummer van de regel met het eerste teken van de selectie geretourneerd. Als er geen selectie is, wordt het huidige regelnummer geretourneerd.

Opmerkingen

Een tekenindex is het aantal tekens vanaf het begin van het uitgebreide bewerkingsbesturingselement. Voor het tellen van tekens wordt een OLE-item geteld als één teken.

Zie de Windows SDK voor meer informatie EM_EXLINEFROMCHAR .

Example

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

Haalt de tekenindex van een regel in dit CRichEditCtrl object op.

int LineIndex(int nLine = -1) const;

Parameterwaarden

nLine
Bevat de indexwaarde voor de gewenste regel in de tekst van het besturingselement bewerken of bevat -1. Als nLine -1 is, geeft deze de huidige lijn aan, dat wil gezegd, de lijn die de caret bevat.

Retourwaarde

De tekenindex van de regel die is opgegeven in nLine of -1 als het opgegeven regelnummer groter is dan het aantal regels in het bewerkingsbesturingselement.

Opmerkingen

De tekenindex is het aantal tekens vanaf het begin van het uitgebreide bewerkingsbesturingselement tot de opgegeven regel.

Zie de Windows SDK voor meer informatie EM_LINEINDEX .

Example

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

Hiermee haalt u de lengte van een regel op in een uitgebreid besturingselement voor bewerken.

int LineLength(int nLine = -1) const;

Parameterwaarden

nLine
Hiermee geeft u de tekenindex van een teken in de regel waarvan de lengte moet worden opgehaald. Als deze parameter -1 is, wordt de lengte van de huidige regel (de regel die de caret bevat) geretourneerd, niet inclusief de lengte van geselecteerde tekst binnen de regel. Wanneer LineLength wordt aangeroepen voor een besturingselement voor bewerken met één regel, wordt deze parameter genegeerd.

Retourwaarde

Wanneer LineLength wordt aangeroepen voor een besturingselement voor bewerken met meerdere regels, is de retourwaarde de lengte (in TCHAR) van de regel die is opgegeven door nLine. Het teken voor regelterugloop staat niet aan het einde van de regel. Wanneer LineLength wordt aangeroepen voor een besturingselement voor bewerken met één regel, is de retourwaarde de lengte (in TCHAR) van de tekst in het besturingselement bewerken. Als nLine de waarde groter is dan het aantal tekens in het besturingselement, is de retourwaarde nul.

Opmerkingen

Gebruik de LineIndex lidfunctie om een tekenindex op te halen voor een bepaald regelnummer binnen dit CRichEditCtrl object.

Zie de Windows SDK voor meer informatie EM_LINELENGTH .

Example

Zie het voorbeeld voor LineIndex.

CRichEditCtrl::LineScroll

Hiermee schuift u de tekst van een besturingselement voor bewerken met meerdere regels.

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

Parameterwaarden

nLines
Hiermee geeft u het aantal regels op om verticaal te schuiven.

nChars
Hiermee geeft u het aantal tekenposities om horizontaal te schuiven. Deze waarde wordt genegeerd als het besturingselement voor uitgebreide bewerking de ES_RIGHT of ES_CENTER stijl heeft. Bewerkingsstijlen worden opgegeven in Create.

Opmerkingen

Het besturingselement bewerken schuift niet verticaal voorbij de laatste tekstregel in het besturingselement bewerken. Als de huidige regel plus het aantal regels dat is nLines opgegeven, groter is dan het totale aantal regels in het besturingselement bewerken, wordt de waarde zodanig aangepast dat de laatste regel van het besturingselement voor bewerken naar de bovenkant van het besturingselement voor bewerken wordt geschoven.

LineScroll kan worden gebruikt om horizontaal voorbij het laatste teken van een willekeurige regel te schuiven.

Zie de Windows SDK voor meer informatie EM_LINESCROLL .

Example

Zie het voorbeeld voor GetFirstVisibleLine.

CRichEditCtrl::Paste

Hiermee voegt u de gegevens van het Klembord in op de CRichEditCtrl invoegpositie, de locatie van de caret.

void Paste();

Opmerkingen

Gegevens worden alleen ingevoegd als het Klembord gegevens in een herkende indeling bevat.

Zie de Windows SDK voor meer informatie WM_PASTE .

Example

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

CRichEditCtrl::PasteSpecial

Hiermee plakt u gegevens in een specifieke Klembord-indeling in dit CRichEditCtrl object.

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

Parameterwaarden

nClipFormat
Klembordindeling om in dit CRichEditCtrl object te plakken.

dvAspect
Apparaataspect voor de gegevens die moeten worden opgehaald van het Klembord.

hMF
Greep naar het metabestand met de iconische weergave van het object dat moet worden geplakt.

Opmerkingen

Het nieuwe materiaal wordt ingevoegd op de invoegpositie, de locatie van de caret.

Zie de Windows SDK voor meer informatie EM_PASTESPECIAL .

Example

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

CRichEditCtrl::PosFromChar

Hiermee worden de coördinaten van het clientgebied van een opgegeven teken opgehaald in een besturingselement voor bewerken.

CPoint PosFromChar(UINT nChar) const;

Parameterwaarden

nChar
De op nul gebaseerde index van het teken.

Retourwaarde

De positie van het teken, (x, y). Voor een bewerkingsbesturingselement met één regel is de y-coördinaat altijd nul.

Opmerkingen

Zie de Windows SDK voor meer informatie EM_POSFROMCHAR .

CRichEditCtrl::Redo

Hiermee wordt de volgende actie opnieuw uitgevoerd in de wachtrij voor opnieuw uitvoeren van het besturingselement.

BOOL Redo();

Retourwaarde

Niet-nul indien geslaagd; anders, 0.

Opmerkingen

Zie de Windows SDK voor meer informatie EM_REDO .

CRichEditCtrl::ReplaceSel

Hiermee vervangt u de huidige selectie in dit CRichEditCtrl object door de opgegeven tekst.

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

Parameterwaarden

lpszNewText
Aanwijzer naar een door null beëindigde tekenreeks die de vervangende tekst bevat.

bCanUndo
Als u wilt opgeven dat deze functie ongedaan kan worden gemaakt, stelt u de waarde van deze parameter in op TRUE. De standaardwaarde is FALSE.

Opmerkingen

Als u alle tekst in dit CRichEditCtrl object wilt vervangen, gebruikt u CWnd::SetWindowText.

Als er geen huidige selectie is, wordt de vervangende tekst ingevoegd op de invoegpositie, dat wil gezegd de huidige caretlocatie.

Met deze functie wordt de ingevoegde tekst opgemaakt met de bestaande tekenopmaak. Bij het vervangen van het hele tekstbereik (door aan te roepen SetSel(0,-1) voordat u aanroept ReplaceSel, is er een einde van het alineateken dat de opmaak van de vorige alinea behoudt, die wordt overgenomen door de zojuist ingevoegde tekst.

Zie de Windows SDK voor meer informatie EM_REPLACESEL .

Example

Zie het voorbeeld voor LineIndex.

CRichEditCtrl::RequestResize

Hiermee dwingt u af dat dit CRichEditCtrl object meldingsberichten naar het bovenliggende venster verzendt EN_REQUESTRESIZE .

void RequestResize();

Opmerkingen

Deze functie is nuttig tijdens CWnd::OnSize de verwerking voor een object zonder CRichEditCtrl bodem.

Zie het EM_REQUESTRESIZE bericht en de sectie Uitgebreidebesturingselementen voor uitgebreide bewerkingen in de Windows SDK voor meer informatie.

CRichEditCtrl::SetAutoURLDetect

Hiermee stelt u het uitgebreide besturingselement voor bewerken in om automatisch een URL te detecteren.

BOOL SetAutoURLDetect(BOOL bEnable = TRUE);

Parameterwaarden

bEnable
Hiermee geeft u op of het besturingselement is ingesteld om automatisch een URL te detecteren. Als TRUEdit is ingeschakeld. Als FALSE, is deze uitgeschakeld.

Retourwaarde

Nul als dit lukt, anders niet-nul. Het bericht kan bijvoorbeeld mislukken vanwege onvoldoende geheugen.

Opmerkingen

Als dit is ingeschakeld, scant het besturingselement voor rtf bewerken de tekst om te bepalen of deze overeenkomt met een standaard-URL-indeling. Zie de Windows SDK voor een lijst met deze URL-indelingen EM_AUTOURLDETECT .

Opmerking

Stel deze optie niet in SetAutoURLDetectTRUE als uw besturingselement het CFE_LINK effect voor andere tekst dan URL's gebruikt. SetAutoURLDetect schakelt dit effect in voor URL's en schakelt dit uit voor alle andere tekst. Zie EN_LINK voor meer informatie over het CFE_LINK effect.

CRichEditCtrl::SetBackgroundColor

Hiermee stelt u de achtergrondkleur voor dit CRichEditCtrl object in.

COLORREF SetBackgroundColor(
    BOOL bSysColor,
    COLORREF cr);

Parameterwaarden

bSysColor
Geeft aan of de achtergrondkleur moet worden ingesteld op de systeemwaarde. Als deze waarde is TRUE, cr wordt deze genegeerd.

cr
De aangevraagde achtergrondkleur. Wordt alleen gebruikt als bSysColor dit is FALSE.

Retourwaarde

De vorige achtergrondkleur voor dit CRichEditCtrl object.

Opmerkingen

De achtergrondkleur kan worden ingesteld op de systeemwaarde of op een opgegeven COLORREF waarde.

Zie voor meer informatie EM_SETBKGNDCOLOR bericht en COLORREF structuur in de Windows SDK.

Example

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

CRichEditCtrl::SetDefaultCharFormat

Hiermee stelt u de kenmerken voor tekenopmaak in voor nieuwe tekst in dit CRichEditCtrl object.

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

Parameterwaarden

cf
In de eerste versie wijst u een aanwijzer naar een CHARFORMAT structuur met de nieuwe standaardkenmerken voor tekenopmaak.

In de tweede versie verwijst een aanwijzer naar een CHARFORMAT2 structuur, een rich edit 2.0-extensie voor de CHARFORMAT structuur, die de standaardkenmerken voor tekenopmaak bevat.

Retourwaarde

Niet-nul indien geslaagd; anders, 0.

Opmerkingen

Alleen de kenmerken die door het dwMask lid zijn cf opgegeven, worden door deze functie gewijzigd.

Zie het EM_SETCHARFORMAT bericht en de CHARFORMATCHARFORMAT2 structuren in de Windows SDK voor meer informatie.

Example

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

Hiermee stelt u het gebeurtenismasker voor dit CRichEditCtrl object in.

DWORD SetEventMask(DWORD dwEventMask);

Parameterwaarden

dwEventMask
Het nieuwe gebeurtenismasker voor dit CRichEditCtrl object.

Retourwaarde

Het vorige gebeurtenismasker.

Opmerkingen

Het gebeurtenismasker geeft aan welke meldingsberichten het object naar het CRichEditCtrl bovenliggende venster verzendt.

Zie de Windows SDK voor meer informatie EM_SETEVENTMASK .

Example

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

Hiermee stelt u de gewijzigde vlag voor een besturingselement voor bewerken in of wist u deze.

void SetModify(BOOL bModified = TRUE);

Parameterwaarden

bModified
Een waarde van TRUE geeft aan dat de tekst is gewijzigd en een waarde waarmee FALSE wordt aangegeven dat deze ongewijzigd is. De gewijzigde vlag is standaard ingesteld.

Opmerkingen

De gewijzigde vlag geeft aan of de tekst in het besturingselement bewerken al dan niet is gewijzigd. Deze wordt automatisch ingesteld wanneer de gebruiker de tekst wijzigt. De waarde ervan kan worden opgehaald met de GetModify lidfunctie.

Zie de Windows SDK voor meer informatie EM_SETMODIFY .

Example

Zie het voorbeeld voor GetModify.

CRichEditCtrl::SetOLECallback

Geeft dit CRichEditCtrl object een IRichEditOleCallback object dat moet worden gebruikt voor toegang tot OLE-gerelateerde resources en informatie.

BOOL SetOLECallback(IRichEditOleCallback* pCallback);

Parameterwaarden

pCallback
Wijs een IRichEditOleCallback object aan dat door dit CRichEditCtrl object wordt gebruikt om OLE-gerelateerde resources en informatie op te halen.

Retourwaarde

Niet-nul indien geslaagd; anders, 0.

Opmerkingen

Dit CRichEditCtrl object roept aan IUnknown::AddRef om het gebruiksaantal voor het COM-object te verhogen dat is opgegeven door pCallback.

Zie bericht en IRichEditOleCallback interface in de Windows SDK voor meer informatieEM_SETOLECALLBACK.

CRichEditCtrl::SetOptions

Hiermee stelt u de opties voor dit CRichEditCtrl object in.

void SetOptions(
    WORD wOp,
    DWORD dwFlags);

Parameterwaarden

wOp
Geeft het type bewerking aan. Een van de volgende waarden:

• ECOOP_SET Stel de opties in op de opties die zijn opgegeven door dwFlags.

• ECOOP_OR Combineer de huidige opties met de opties die zijn opgegeven door dwFlags.

• ECOOP_AND Alleen de huidige opties behouden die ook worden opgegeven door dwFlags.

• ECOOP_XOR Logisch exclusief OF de huidige opties met de opties die zijn opgegeven door dwFlags.

dwFlags
Uitgebreide bewerkingsopties. De vlagwaarden worden weergegeven in de sectie Opmerkingen.

Opmerkingen

De opties kunnen een combinatie van de volgende waarden zijn:

• ECO_AUTOWORDSELECTION Automatische woordselectie bij dubbelklikken.

• ECO_AUTOVSCROLL Hiermee schuift u automatisch met 10 tekens naar rechts wanneer de gebruiker een teken aan het einde van de regel typt. Wanneer de gebruiker op enter drukt, schuift het besturingselement alle tekst terug naar positie nul.

• ECO_AUTOHSCROLL Hiermee schuift u automatisch één pagina omhoog wanneer de gebruiker op enter drukt op de laatste regel.

• ECO_NOHIDESEL Onderhandelt het standaardgedrag voor een besturingselement bewerken. Het standaardgedrag verbergt de selectie wanneer het besturingselement de invoerfocus verliest en toont de selectie wanneer het besturingselement de invoerfocus ontvangt. Als u opgeeft ECO_NOHIDESEL, wordt de geselecteerde tekst omgekeerd, zelfs als het besturingselement niet de focus heeft.

• ECO_READONLY Hiermee voorkomt u dat de gebruiker tekst typt of bewerkt in het besturingselement bewerken.

• ECO_WANTRETURN Hiermee geeft u op dat een regelterugloop moet worden ingevoegd wanneer de gebruiker op enter drukt tijdens het invoeren van tekst in een besturingselement met opmaak met meerdere regels in een dialoogvenster. Als u deze stijl niet opgeeft, wordt met de enter-toets een opdracht naar het bovenliggende venster van het bovenliggende besturingselement met opmaak verzonden, waarmee wordt nagebootst op de standaardknop van het bovenliggende venster (bijvoorbeeld de knop OK in een dialoogvenster). Deze stijl heeft geen effect op een besturingselement met één regel bewerken.

• ECO_SAVESEL Hiermee blijft de selectie behouden wanneer het besturingselement de focus verliest. Standaard wordt de volledige inhoud van het besturingselement geselecteerd wanneer het de focus krijgt.

• ECO_VERTICAL Hiermee tekent u tekst en objecten in een verticale richting. Alleen beschikbaar voor Aziatische talen.

Zie de Windows SDK voor meer informatie EM_SETOPTIONS .

Example

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

CRichEditCtrl::SetParaFormat

Hiermee stelt u de alineaopmaakkenmerken voor de huidige selectie in dit CRichEditCtrl object in.

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

Parameterwaarden

pf
In de eerste versie wijst u een aanwijzer naar een PARAFORMAT structuur met de nieuwe standaardopmaakkenmerken voor alinea's.

In de tweede versie wijst u een aanwijzer naar een PARAFORMAT2 structuur, een rich edit 2.0-extensie voor de PARAFORMAT structuur, met de standaardkenmerken voor tekenopmaak.

Retourwaarde

Niet-nul indien geslaagd; anders, 0.

Opmerkingen

Alleen de kenmerken die door het dwMask lid zijn pf opgegeven, worden door deze functie gewijzigd.

Zie het EM_SETPARAFORMAT bericht en de PARAFORMATPARAFORMAT2 structuren in de Windows SDK voor meer informatie.

Example

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

Hiermee stelt u de interpunctie in een uitgebreid besturingselement voor bewerken in.

BOOL SetPunctuation(
    UINT fType,
    PUNCTUATION* lpPunc);

Parameterwaarden

fType
De interpunctievlag. Zie de fType parameter voor in de Windows SDK voor EM_SETPUNCTUATION een lijst met mogelijke waarden.

lpPunc
Een aanwijzer naar een PUNCTUATION structuur, zoals beschreven in de Windows SDK.

Retourwaarde

Nonzero als dit lukt, anders 0.

Opmerkingen

Deze lidfunctie is alleen beschikbaar voor Aziatische versies van het besturingssysteem.

CRichEditCtrl::SetReadOnly

Hiermee wijzigt u de ECO_READONLY optie voor dit CRichEditCtrl object.

BOOL SetReadOnly(BOOL bReadOnly = TRUE);

Parameterwaarden

bReadOnly
Geeft aan of dit CRichEditCtrl object alleen-lezen moet zijn.

Retourwaarde

Niet-nul indien geslaagd; anders, 0.

Opmerkingen

Zie voor een korte beschrijving van deze optie SetOptions. U kunt deze functie gebruiken om alle opties voor dit CRichEditCtrl object in te stellen.

Zie de Windows SDK voor meer informatie EM_SETREADONLY .

Example

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

CRichEditCtrl::SetRect

Hiermee stelt u de opmaakrechthoek voor dit CRichEditCtrl object in.

void SetRect(LPCRECT lpRect);

Parameterwaarden

lpRect
CRect of wijs een RECT aanwijzer aan die de nieuwe grenzen voor de opmaakrechthoek aangeeft.

Opmerkingen

De rechthoek met opmaak is de beperkende rechthoek voor de tekst. De begrenzingsrechthoek is onafhankelijk van de grootte van het uitgebreide besturingselementvenster. Wanneer dit CRichEditCtrl object voor het eerst wordt gemaakt, heeft de rechthoek met opmaak dezelfde grootte als het clientgebied van het venster. Gebruik SetRect deze indeling om de opmaakrechthoek groter of kleiner te maken dan het uitgebreide bewerkingsvenster.

Zie de Windows SDK voor meer informatie EM_SETRECT .

Example

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

Hiermee stelt u de selectie in dit CRichEditCtrl object in.

void SetSel(
    long nStartChar,
    long nEndChar);

void SetSel(CHARRANGE& cr);

Parameterwaarden

nStartChar
Op nul gebaseerde index van het eerste teken voor de selectie.

nEndChar
Op nul gebaseerde index van het laatste teken voor de selectie.

cr
CHARRANGE structuur die de grenzen van de huidige selectie bevat.

Opmerkingen

De twee vormen van deze functie bieden alternatieve manieren om de grenzen voor de selectie in te stellen. Korte beschrijvingen van deze formulieren volgen:

• SetSel(cr) Dit formulier maakt gebruik van de CHARRANGE structuur met de bijbehorende cpMin en cpMax leden om de grenzen in te stellen.

• SetSel(nStartChar,nEndChar) Dit formulier gebruikt de parameters nStartChar en nEndChar om de grenzen in te stellen.

De caret wordt geplaatst aan het einde van de selectie die wordt aangegeven door de groter van de begin- (cpMin of nStartChar) en eind- (cpMax of nEndChar) indexen. Met deze functie schuift u de inhoud van de CRichEditCtrl functie zodat de caret zichtbaar is.

Als u alle tekst in dit CRichEditCtrl object wilt selecteren, roept SetSel u aan met een beginindex van 0 en een eindindex van - 1.

Zie voor meer informatie EM_EXSETSEL bericht en CHARRANGE structuur in de Windows SDK.

Example

Zie het voorbeeld voor GetSel.

CRichEditCtrl::SetSelectionCharFormat

Hiermee stelt u de kenmerken voor tekenopmaak in voor de tekst in de huidige selectie in dit CRichEditCtrl object.

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

Parameterwaarden

cf
In de eerste versie wijst u een aanwijzer naar een CHARFORMAT structuur met de nieuwe kenmerken voor tekenopmaak voor de huidige selectie.

In de tweede versie verwijst een verwijzing naar een CHARFORMAT2 structuur, een rich edit 2.0-extensie voor de CHARFORMAT structuur, met de nieuwe tekenopmaakkenmerken voor de huidige selectie.

Retourwaarde

Niet-nul indien geslaagd; anders, 0.

Opmerkingen

Alleen de kenmerken die door het dwMask lid van cf zijn opgegeven, worden door deze functie gewijzigd.

Zie de EM_SETCHARFORMAT en structuren CHARFORMATCHARFORMAT2 in de Windows SDK voor meer informatie.

Example

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

Hiermee stelt u de doelapparaat- en lijnbreedte in die wordt gebruikt voor WYSIWYG (wat u ziet is wat u krijgt) in dit CRichEditCtrl object.

BOOL SetTargetDevice(
    HDC hDC,
    long lLineWidth);

BOOL SetTargetDevice(
    CDC& dc,
    long lLineWidth);

Parameterwaarden

hDC
Afhandelen naar de apparaatcontext voor het nieuwe doelapparaat.

lLineWidth
Lijnbreedte die moet worden gebruikt voor opmaak.

dc
CDC voor het nieuwe doelapparaat.

Retourwaarde

Niet-nul indien geslaagd; anders, 0.

Opmerkingen

Als deze functie is geslaagd, is het uitgebreide bewerkingsbesturingselement eigenaar van de apparaatcontext die als parameter wordt doorgegeven. In dat geval mag de aanroepende functie de apparaatcontext niet vernietigen.

Zie de Windows SDK voor meer informatie EM_SETTARGETDEVICE .

Example

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

Hiermee stelt u de tekstmodus in of maakt u het niveau ongedaan en voert u het opnieuw uit voor een besturingselement voor uitgebreide bewerking.

BOOL SetTextMode(UINT fMode);

Parameterwaarden

fMode
Hiermee geeft u de nieuwe instellingen voor de tekstmodus van het besturingselement en de niveauparameters ongedaan maken. Zie de modusparameter voor EM_SETTEXTMODE een lijst met mogelijke waarden in de Windows SDK.

Retourwaarde

Nul als dit lukt, anders niet-nul.

Opmerkingen

Zie de Windows SDK voor een beschrijving van de tekstmodi EM_SETTEXTMODE .

Deze lidfunctie mislukt als het besturingselement tekst bevat. Als u wilt controleren of het besturingselement leeg is, verzendt u een WM_SETTEXT bericht met een lege tekenreeks.

CRichEditCtrl::SetUndoLimit

Hiermee stelt u het maximum aantal acties in dat kan worden opgeslagen in de wachtrij ongedaan maken.

UINT SetUndoLimit(UINT nLimit);

Parameterwaarden

nLimit
Hiermee geeft u het maximum aantal acties op dat kan worden opgeslagen in de wachtrij voor ongedaan maken. Ingesteld op nul om Ongedaan maken uit te schakelen.

Retourwaarde

Het nieuwe maximum aantal bewerkingen ongedaan maken voor het uitgebreide besturingselement bewerken.

Opmerkingen

Standaard is het maximum aantal acties in de wachtrij ongedaan maken 100. Als u dit aantal verhoogt, moet er voldoende geheugen beschikbaar zijn voor het nieuwe nummer. Voor betere prestaties stelt u de limiet in op de kleinste mogelijke waarde.

CRichEditCtrl::SetWordCharFormat

Hiermee stelt u de kenmerken voor tekenopmaak in voor het geselecteerde woord in dit CRichEditCtrl object.

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

Parameterwaarden

cf
In de eerste versie wijst u een aanwijzer naar een CHARFORMAT structuur met de nieuwe kenmerken voor tekenopmaak voor het geselecteerde woord.

In de tweede versie verwijst een verwijzing naar een CHARFORMAT2 structuur, een rich edit 2.0-extensie voor de CHARFORMAT structuur, met de nieuwe tekenopmaakkenmerken voor het geselecteerde woord.

Retourwaarde

Niet-nul indien geslaagd; anders, 0.

Opmerkingen

Alleen de kenmerken die door het dwMask lid zijn cf opgegeven, worden door deze functie gewijzigd.

Zie het EM_SETCHARFORMAT bericht en de CHARFORMATCHARFORMAT2 structuren in de Windows SDK voor meer informatie.

Example

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

Hiermee stelt u de opties voor tekstterugloop en woordbreking in voor het uitgebreide besturingselement bewerken.

UINT SetWordWrapMode(UINT uFlags) const;

Parameterwaarden

uFlags
De opties die moeten worden ingesteld voor tekstterugloop en woordbreking. Zie de Windows SDK voor een lijst met mogelijke opties EM_SETWORDWRAPMODE .

Retourwaarde

De huidige opties voor tekstterugloop en woordbreking.

Opmerkingen

Dit bericht is alleen beschikbaar in aziatische versies van het besturingssysteem.

CRichEditCtrl::StopGroupTyping

Hiermee voorkomt u dat het besturingselement aanvullende typacties verzamelt in de huidige bewerking ongedaan maken.

void StopGroupTyping();

Opmerkingen

In het besturingselement wordt de volgende typactie opgeslagen in een nieuwe actie in de wachtrij ongedaan maken.

Zie de Windows SDK voor meer informatie EM_STOPGROUPTYPING .

CRichEditCtrl::StreamIn

Hiermee vervangt u tekst in dit CRichEditCtrl object door tekst uit de opgegeven invoerstroom.

long StreamIn(
    int nFormat,
    EDITSTREAM& es);

Parameterwaarden

nFormat
Vlaggen die de indelingen voor invoergegevens opgeven. Zie de sectie Opmerkingen voor meer informatie.

es
EDITSTREAM structuur die de invoerstroom opgeeft. Zie de sectie Opmerkingen voor meer informatie.

Retourwaarde

Het aantal tekens dat uit de invoerstroom wordt gelezen.

Opmerkingen

De waarde van nFormat moet een van de volgende zijn:

• SF_TEXT Geeft alleen leestekst aan.

• SF_RTF Hiermee wordt het lezen van tekst en opmaak aangegeven.

Een van deze waarden kan worden gecombineerd met SFF_SELECTION. Als SFF_SELECTION dit is opgegeven, StreamIn vervangt u de huidige selectie door de inhoud van de invoerstroom. Als dit niet is opgegeven, StreamIn vervangt u de volledige inhoud van dit CRichEditCtrl object.

In de EDITSTREAM parameter esgeeft u een callback-functie op waarmee een buffer wordt gevuld met tekst. Deze callback-functie wordt herhaaldelijk aangeroepen totdat de invoerstroom is uitgeput.

Zie voor meer informatie EM_STREAMIN bericht en EDITSTREAM structuur in de Windows SDK.

Example

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

Hiermee wordt de inhoud van dit CRichEditCtrl object weggeschreven naar de opgegeven uitvoerstroom.

long StreamOut(
    int nFormat,
    EDITSTREAM& es);

Parameterwaarden

nFormat
Vlaggen die de indelingen van de uitvoergegevens opgeven. Zie de sectie Opmerkingen voor meer informatie.

es
EDITSTREAM structuur die de uitvoerstroom opgeeft. Zie de sectie Opmerkingen voor meer informatie.

Retourwaarde

Aantal tekens dat naar de uitvoerstroom is geschreven.

Opmerkingen

De waarde van nFormat moet een van de volgende zijn:

• SF_TEXT Geeft alleen het schrijven van tekst aan.

• SF_RTF Hiermee wordt het schrijven van tekst en opmaak aangegeven.

• SF_RTFNOOBJS Hiermee wordt het schrijven van tekst en opmaak aangegeven, waarbij OLE-items worden vervangen door spaties.

• SF_TEXTIZED Hiermee wordt het schrijven van tekst en opmaak aangegeven, met tekstuele weergaven van OLE-items.

Elk van deze waarden kan worden gecombineerd met SFF_SELECTION. Als SFF_SELECTION dit is opgegeven, StreamOut schrijft u de huidige selectie uit in de uitvoerstroom. Als dit niet is opgegeven, StreamOut schrijft u de volledige inhoud van dit CRichEditCtrl object uit.

In de EDITSTREAM parameter esgeeft u een callback-functie op die een buffer vult met tekst. Deze callback-functie wordt herhaaldelijk aangeroepen totdat de uitvoerstroom is uitgeput.

Zie voor meer informatie EM_STREAMOUT bericht en EDITSTREAM structuur in de Windows SDK.

Example

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

Hiermee wordt de laatste bewerking in het uitgebreide bewerkingsbesturingselement ongedaan maken.

BOOL Undo();

Retourwaarde

Niet-nul als de bewerking ongedaan maken is geslaagd; anders, 0.

Opmerkingen

Een ongedaan maken kan ook ongedaan worden gemaakt. U kunt bijvoorbeeld verwijderde tekst herstellen met de eerste aanroep naar Undo. Zolang er geen tussenliggende bewerking is, kunt u de tekst opnieuw verwijderen met een tweede aanroep naar Undo.

Zie de Windows SDK voor meer informatie EM_UNDO .

Example

Zie het voorbeeld voor CanUndo.

Zie ook

MFC-voorbeeld WORDPAD
CWnd klasse
Hiërarchiegrafiek
CEdit klasse
CRichEditView klasse