Megosztás a következőn keresztül:


CRichEditView osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

A CRichEditDoc és a CRichEditCntrItem lehetővé teszi a részletes szerkesztési vezérlő funkcióit az MFC dokumentumnézet-architektúrájának kontextusában.

Szemantika

class CRichEditView : public CCtrlView

Tagok

Nyilvános konstruktorok

Név Description
CRichEditView::CRichEditView Egy CRichEditView objektumot hoz létre.

Nyilvános metódusok

Név Description
CRichEditView::AdjustDialogPosition Áthelyez egy párbeszédpanelt, hogy ne takarja el az aktuális kijelölést.
CRichEditView::CanPaste Azt jelzi, hogy a vágólap tartalmaz-e olyan adatokat, amelyek beilleszthetők a gazdag szerkesztési nézetbe.
CRichEditView::D oPaste OLE-elemet illeszt be ebbe a gazdag szerkesztési nézetbe.
CRichEditView::FindText Megkeresi a megadott szöveget a várakozási kurzor meghívásával.
CRichEditView::FindTextSimple Megkeresi a megadott szöveget.
CRichEditView::GetCharFormatSelection Lekéri az aktuális kijelölés karakterformázási attribútumait.
CRichEditView::GetDocument A kapcsolódó CRichEditDoc mutatót kér le.
CRichEditView::GetInPlaceActiveItem Lekéri az OLE-elemet, amely jelenleg aktív a rich edit nézetben.
CRichEditView::GetMargins Lekéri a gazdag szerkesztési nézet margóit.
CRichEditView::GetPageRect Lekéri a lap téglalapot ehhez a gazdag szerkesztési nézethez.
CRichEditView::GetPaperSize A gazdag szerkesztési nézet papírméretét kéri le.
CRichEditView::GetParaFormatSelection Lekéri az aktuális kijelölés bekezdésformázási attribútumait.
CRichEditView::GetPrintRect Lekéri a nyomtatási téglalapot ehhez a gazdag szerkesztési nézethez.
CRichEditView::GetPrintWidth Lekéri a gazdag szerkesztési nézet nyomtatási szélességét.
CRichEditView::GetRichEditCtrl Lekéri a rich edit vezérlőt.
CRichEditView::GetSelectedItem Lekéri a kijelölt elemet a rich edit nézetből.
CRichEditView::GetTextLength Beolvassa a szöveg hosszát a rich edit nézetben.
CRichEditView::GetTextLengthEx Beolvassa a karakterek vagy bájtok számát a rich edit nézetben. Kibontott jelölőlista a hossz meghatározásának módszeréhez.
CRichEditView::InsertFileAsObject Fájl beszúrása OLE-elemként.
CRichEditView::InsertItem Új elemet szúr be OLE-elemként.
CRichEditView::IsRichEditFormat Azt jelzi, hogy a vágólap gazdag szerkesztési vagy szöveges formátumú adatokat tartalmaz-e.
CRichEditView::OnCharEffect Az aktuális kijelölés karakterformázásának váltása.
CRichEditView::OnParaAlign Módosítja a bekezdések igazítását.
CRichEditView::OnUpdateCharEffect Frissíti a parancs felhasználói felületét a nyilvános tagfüggvényekhez.
CRichEditView::OnUpdateParaAlign Frissíti a parancs felhasználói felületét a bekezdés nyilvános tagfüggvényeihez.
CRichEditView::P rintInsideRect Formázja a megadott szöveget az adott téglalapon belül.
CRichEditView::P rintPage A megadott szöveg formázása az adott lapon.
CRichEditView::SetCharFormat Beállítja az aktuális kijelölés karakterformázási attribútumait.
CRichEditView::SetMargins Beállítja a gazdag szerkesztési nézet margóit.
CRichEditView::SetPaperSize Beállítja a papírméretet ehhez a gazdag szerkesztési nézethez.
CRichEditView::SetParaFormat Beállítja az aktuális kijelölés bekezdésformázási attribútumait.
CRichEditView::TextNotFound Alaphelyzetbe állítja a vezérlő belső keresési állapotát.

Védett metódusok

Név Description
CRichEditView::GetClipboardData Ebben a gazdag szerkesztési nézetben lekéri a vágólap-objektumot egy tartományhoz.
CRichEditView::GetContextMenu Lekéri a jobb egérgombbal lefelé használható helyi menüt.
CRichEditView::IsSelected Azt jelzi, hogy a megadott OLE elem ki van-e jelölve.
CRichEditView::OnFindNext Megkeresi egy részszűkítés következő előfordulását.
CRichEditView::OnInitialUpdate Frissíti a nézetet, amikor először csatolja egy dokumentumhoz.
CRichEditView::OnPasteNativeObject Natív adatokat kér le egy OLE-elemből.
CRichEditView::OnPrinterChanged Beállítja a nyomtatási jellemzőket az adott eszközre.
CRichEditView::OnReplaceAll Egy adott sztring összes előfordulását lecseréli egy új sztringre.
CRichEditView::OnReplaceSel Lecseréli az aktuális kijelölést.
CRichEditView::OnTextNotFound Kezeli a felhasználó értesítését arról, hogy a kért szöveg nem található.
CRichEditView::QueryAcceptData Lekérdezések a IDataObject.
CRichEditView::WrapChanged Ennek a gazdag szerkesztési nézetnek a célkimeneti eszközét az érték alapján állítja m_nWordWrapbe.

Nyilvános adatok tagjai

Név Description
CRichEditView::m_nBulletIndent A listajeles listák behúzási mennyiségét jelzi.
CRichEditView::m_nWordWrap A szófuttatási kényszereket jelzi.

Megjegyzések

A "rich edit control" egy ablak, amelyben a felhasználó szöveget írhat be és szerkeszthet. A szöveg hozzárendelhető karakter- és bekezdésformázáshoz, és beágyazott OLE-objektumokat is tartalmazhat. A részletes szerkesztési vezérlők programozási felületet biztosítanak a szövegformázáshoz. Az alkalmazásnak azonban implementálnia kell minden olyan felhasználói felületi összetevőt, amely ahhoz szükséges, hogy a formázási műveleteket elérhetővé tegye a felhasználó számára.

CRichEditView megőrzi a szövegre jellemző formázást és megjelenést. CRichEditDoc fenntartja a nézetben lévő OLE-ügyfélelemek listáját. CRichEditCntrItem tárolóoldali hozzáférést biztosít az OLE-ügyféltételhez.

Ez a Windows common control (és így a CRichEditCtrl és a kapcsolódó osztályok) csak a Windows 95/98 és a Windows NT 3.51-ös és újabb verzióiban futó programokhoz érhető el.

Ha egy MFC-alkalmazásban gazdag szerkesztési nézetet használ, tekintse meg a WORDPAD mintaalkalmazást.

Öröklési hierarchia

CObject

CCmdTarget

CWnd

CView

CCtrlView

CRichEditView

Requirements

Fejléc: afxrich.h

CRichEditView::AdjustDialogPosition

A függvény meghívásával helyezze át a megadott párbeszédpanelt, hogy ne takarja el az aktuális kijelölést.

void AdjustDialogPosition(CDialog* pDlg);

Paraméterek

pDlg
Mutasson egy objektumra CDialog .

CRichEditView::CanPaste

Hívja meg ezt a függvényt annak megállapításához, hogy a vágólap tartalmaz-e olyan információkat, amelyek beilleszthetők ebbe a gazdag szerkesztési nézetbe.

BOOL CanPaste() const;

Visszaadott érték

Nonzero, ha a vágólap olyan formátumú adatokat tartalmaz, amelyeket ez a gazdag szerkesztési nézet elfogadhat; ellenkező esetben 0.

CRichEditView::CRichEditView

A függvény meghívása objektum létrehozásához CRichEditView .

CRichEditView();

CRichEditView::D oPaste

Hívja meg ezt a függvényt, hogy illessze be az OLE elemet a dataobjba ebbe a gazdag szerkesztési dokumentumba/nézetbe.

void DoPaste(
    COleDataObject& dataobj,
    CLIPFORMAT cf,
    HMETAFILEPICT hMetaPict);

Paraméterek

dataobj
A beillesztendő adatokat tartalmazó COleDataObject .

Cf
A vágólap kívánt formátuma.

hMetaPict
A beillesztendő elemet jelképező metafájl.

Megjegyzések

A keretrendszer ezt a függvényt a QueryAcceptData alapértelmezett implementációjának részeként hívja meg.

Ez a függvény határozza meg a beillesztés típusát a Speciális beillesztés kezelőjének eredményei alapján. Ha cf 0, az új elem az aktuális ikonikus megjelenítést használja. Ha a cf nem nulla, és a hMetaPict értéke nem NULL, akkor az új elem a hMetaPict értéket használja a megjelenítéséhez.

CRichEditView::FindText

Hívja meg ezt a függvényt, hogy megkeresse a megadott szöveget, és állítsa be az aktuális kijelölésre.

BOOL FindText(
    LPCTSTR lpszFind,
    BOOL bCase = TRUE,
    BOOL bWord = TRUE,
    BOOL bNext = TRUE);

Paraméterek

lpszFind
A keresendő sztringet tartalmazza.

bCase
Azt jelzi, hogy a keresés megkülönbözteti-e a kis- és nagybetűket.

bWord
Azt jelzi, hogy a keresésnek csak egész szavaknak kell-e egyeznie, nem pedig a szavak részeinek.

bNext
A keresés irányát jelzi. Ha IGAZ, a keresési irány a puffer vége felé tart. Ha HAMIS, a keresési irány a puffer elejére kerül.

Visszaadott érték

Nonzero, ha az lpszFind szöveg található; egyéb esetben 0.

Megjegyzések

Ez a függvény megjeleníti a várakozási kurzort a keresési művelet során.

Example

void CMyRichEditView::OnReplaceAll(LPCTSTR lpszFind, LPCTSTR lpszReplace,
   BOOL bCase, BOOL bWord)
{
   CWaitCursor wait;
   // no selection or different than what we are looking for
   if (!FindText(lpszFind, bCase, bWord))
   {
      OnTextNotFound(lpszFind);
      return;
   }

   GetRichEditCtrl().HideSelection(TRUE, FALSE);
   m_nNumReplaced = 0;
   do
   {
      GetRichEditCtrl().ReplaceSel(lpszReplace);
      m_nNumReplaced++;  // Record the number of replacements

   } while (FindTextSimple(lpszFind));
   GetRichEditCtrl().HideSelection(FALSE, FALSE);
}

CRichEditView::FindTextSimple

Hívja meg ezt a függvényt, hogy megkeresse a megadott szöveget, és állítsa be az aktuális kijelölésre.

BOOL FindTextSimple(
    LPCTSTR lpszFind,
    BOOL bCase = TRUE,
    BOOL bWord = TRUE,
    BOOL bNext = TRUE);

Paraméterek

lpszFind
A keresendő sztringet tartalmazza.

bCase
Azt jelzi, hogy a keresés megkülönbözteti-e a kis- és nagybetűket.

bWord
Azt jelzi, hogy a keresésnek csak egész szavaknak kell-e egyeznie, nem pedig a szavak részeinek.

bNext
A keresés irányát jelzi. Ha IGAZ, a keresési irány a puffer vége felé tart. Ha HAMIS, a keresési irány a puffer elejére kerül.

Visszaadott érték

Nonzero, ha az lpszFind szöveg található; egyéb esetben 0.

Example

Lásd a CRichEditView::FindText példáját.

CRichEditView::GetCharFormatSelection

A függvény meghívásával lekérheti az aktuális kijelölés karakterformázási attribútumait.

CHARFORMAT2& GetCharFormatSelection();

Visszaadott érték

Egy CHARFORMAT2 szerkezet, amely az aktuális kijelölés karakterformázási attribútumait tartalmazza.

Megjegyzések

További információ: EM_GETCHARFORMAT üzenet és a Windows SDK CHARFORMAT2 struktúrája.

Example

void CMyRichEditView::OnCharUnderline()
{
   CHARFORMAT2 cf;
   cf = GetCharFormatSelection();

   if (!(cf.dwMask & CFM_UNDERLINE) || !(cf.dwEffects & CFE_UNDERLINE))
      cf.dwEffects = CFE_UNDERLINE;
   else
      cf.dwEffects = 0;

   cf.dwMask = CFM_UNDERLINE;
   SetCharFormat(cf);
}

CRichEditView::GetClipboardData

A keretrendszer ezt a függvényt az IRichEditOleCallback::GetClipboardData feldolgozásának részeként hívja meg.

virtual HRESULT GetClipboardData(
    CHARRANGE* lpchrg,
    DWORD dwReco,
    LPDATAOBJECT lpRichDataObj,
    LPDATAOBJECT* lplpdataobj);

Paraméterek

lpchrg
Az lplpdataobj által megadott adatobjektumba másolandó karaktertartományt (és OLE-elemeket) megjelölő CHARRANGE-struktúrára mutató mutató.

dwReco
Vágólap műveleti jelzője. Ezek közé az értékek közé tartozhat.

  • RECO_COPY Másolás a vágólapra.

  • RECO_CUT Vágja a vágólapra.

  • RECO_DRAG húzási művelet (húzással).

  • RECO_DROP Drop művelet (húzással).

  • RECO_PASTE Beillesztés a vágólapról.

lpRichDataObj
Mutasson egy IDataObject objektumra, amely a vágólap adatait tartalmazza a rich edit vezérlőelemből ( IRichEditOle::GetClipboardData).

lplpdataobj
Mutasson arra a mutatóváltozóra, amely az lpchrg paraméterben megadott tartományt képviselő objektum címét IDataObject kapja. A függvény figyelmen kívül hagyja az lplpdataobj értékét, ha hibát ad vissza.

Visszaadott érték

Egy HRESULT érték, amely a művelet sikerességét jelenti. További információ a HRESULT-ról: COM-hibakódok struktúrája a Windows SDK-ban.

Megjegyzések

Ha a visszatérési érték sikerességet jelez, IRichEditOleCallback::GetClipboardData az IDataObjectlplpdataobj által elért értéket adja vissza, ellenkező esetben az lpRichDataObj által elért értéket adja vissza. A függvény felülbírálása saját vágólapadatok megadásához. A függvény alapértelmezett implementációja E_NOTIMPL ad vissza.

Ez egy speciális felülírható.

További információ : IRichEditOle::GetClipboardData, IRichEditOleCallback::GetClipboardData és CHARRANGE a Windows SDK-ban, és lásd: IDataObject a Windows SDK-ban.

CRichEditView::GetContextMenu

A keretrendszer ezt a függvényt az IRichEditOleCallback::GetContextMenu feldolgozás részeként hívja meg.

virtual HMENU GetContextMenu(
    WORD seltyp,
    LPOLEOBJECT lpoleobj,
    CHARRANGE* lpchrg);

Paraméterek

seltyp
A kijelölés típusa. A kijelöléstípus értékeit a Megjegyzések szakaszban ismertetjük.

lpoleobj
Mutató az OLEOBJECT első kijelölt OLE objektumot megjelölő struktúrára, ha a kijelölés egy vagy több OLE-elemet tartalmaz. Ha a kijelölés nem tartalmaz elemeket, akkor az lpoleobj null értékű. A OLEOBJECT struktúra egy OLE objektum v-táblára mutató mutatót tartalmaz.

lpchrg
Mutasson az aktuális kijelölést tartalmazó CHARRANGE-struktúrára .

Visszaadott érték

Kezelje a helyi menüt.

Megjegyzések

Ez a függvény a jobb egérgombos lefelé feldolgozás tipikus része.

A kijelölési típus a következő jelölők tetszőleges kombinációja lehet:

  • SEL_EMPTY Azt jelzi, hogy nincs aktuális kijelölés.

  • SEL_TEXT Azt jelzi, hogy az aktuális kijelölés szöveget tartalmaz.

  • SEL_OBJECT Azt jelzi, hogy az aktuális kijelölés legalább egy OLE elemet tartalmaz.

  • SEL_MULTICHAR Azt jelzi, hogy az aktuális kijelölés egynél több szöveg karaktert tartalmaz.

  • SEL_MULTIOBJECT Azt jelzi, hogy az aktuális kijelölés több OLE objektumot tartalmaz.

Az alapértelmezett implementáció null értéket ad vissza. Ez egy speciális felülírható.

További információ: IRichEditOleCallback::GetContextMenu és CHARRANGE a Windows SDK-ban.

CRichEditView::GetDocument

Hívja meg ezt a függvényt, hogy CRichEditDoc a nézethez társított mutatót kapjon.

CRichEditDoc* GetDocument() const;

Visszaadott érték

Mutasson az objektumhoz társított CRichEditDoc objektumra CRichEditView .

CRichEditView::GetInPlaceActiveItem

Hívja meg ezt a függvényt, hogy lekérje az objektumban CRichEditView jelenleg aktivált OLE-elemet.

CRichEditCntrItem* GetInPlaceActiveItem() const;

Visszaadott érték

Mutató az egyetlen, helyben aktív CRichEditCntrItem objektumra ebben a gazdag szerkesztési nézetben; NULL érték, ha jelenleg nincs OLE elem a helyben aktív állapotban.

CRichEditView::GetMargins

Hívja meg ezt a függvényt a nyomtatáshoz használt aktuális margók lekéréséhez.

CRect GetMargins() const;

Visszaadott érték

A nyomtatásban használt margók, MM_TWIPS mérve.

CRichEditView::GetPageRect

A függvény meghívásával lekérheti a nyomtatáshoz használt oldal méreteit.

CRect GetPageRect() const;

Visszaadott érték

A nyomtatásban használt oldal határai, MM_TWIPS mérve.

Megjegyzések

Ez az érték a papírméreten alapul.

CRichEditView::GetPaperSize

Hívja meg ezt a függvényt az aktuális papírméret lekéréséhez.

CSize GetPaperSize() const;

Visszaadott érték

A nyomtatáshoz használt papír mérete, MM_TWIPS mérve.

Example

void CMyRichEditView::OnPrint(CDC* pDC, CPrintInfo* pInfo)
{
   UNREFERENCED_PARAMETER(pInfo);

   // Get the current paper size and construct an actual printing
   // rectangle by leaving out one half inch margin from each side.
   CSize sizePaper = GetPaperSize();
   CRect rectMargins(720, 720, sizePaper.cx - 720,
      sizePaper.cy - 720);

   // Need to set the margins when printing from CRichEditView
   SetMargins(rectMargins);

   // Set up three rectangular regions spaced an inch apart
   CRect rectHeader(0, 0, rectMargins.right, 1440);
   CRect rectBody(0, 1440, rectMargins.right, 1440 * 2);
   CRect rectFooter(0, 1440 * 2, rectMargins.right, 1440 * 3);

   // Format the first 10 characters in the buffer.
   int nSavedDC = pDC->SaveDC();
   PrintInsideRect(pDC, rectHeader, 0, 10, TRUE); // characters 0-10
   pDC->RestoreDC(nSavedDC);

   // Format the second 10 characters in the buffer.
   nSavedDC = pDC->SaveDC();
   PrintInsideRect(pDC, rectBody, 10, 20, TRUE); // characters 10-20
   pDC->RestoreDC(nSavedDC);

   // Format the third 10 characters in the buffer.
   nSavedDC = pDC->SaveDC();
   PrintInsideRect(pDC, rectFooter, 20, 30, TRUE); // characters 20-30
   pDC->RestoreDC(nSavedDC);

   //   CRichEditView::OnPrint(pDC, pInfo);
}

CRichEditView::GetParaFormatSelection

Hívja meg ezt a függvényt az aktuális kijelölés bekezdésformázási attribútumainak lekéréséhez.

PARAFORMAT2& GetParaFormatSelection();

Visszaadott érték

Egy PARAFORMAT2 szerkezet, amely az aktuális kijelölés bekezdésformázási attribútumait tartalmazza.

Megjegyzések

További információ: EM_GETPARAFORMAT üzenet és PARAFORMAT2 struktúra a Windows SDK-ban.

CRichEditView::GetPrintRect

A függvény meghívásával lekérheti a nyomtatási terület határait az oldal téglalapján belül.

CRect GetPrintRect() const;

Visszaadott érték

A nyomtatásban használt képterület határai, MM_TWIPS mérve.

Example

void CMyRichEditView::OnBeginPrinting(CDC* pDC, CPrintInfo* pInfo)
{
   CRect rectPrintPage = GetPrintRect();  // Measured in MM_TWIPS

   pInfo->SetMaxPage((m_nDocSizeInInches * 1440) / rectPrintPage.Height());

   CRichEditView::OnBeginPrinting(pDC, pInfo);
}

CRichEditView::GetPrintWidth

Hívja meg ezt a függvényt a nyomtatási terület szélességének meghatározásához.

int GetPrintWidth() const;

Visszaadott érték

A nyomtatási terület szélessége, MM_TWIPS mérve.

CRichEditView::GetRichEditCtrl

Hívja meg ezt a függvényt az objektumhoz társított CRichEditCtrl objektum lekéréséhez CRichEditView .

CRichEditCtrl& GetRichEditCtrl() const;

Visszaadott érték

A CRichEditCtrl nézet objektuma.

Example

Lásd a CRichEditView::FindText példáját.

CRichEditView::GetSelectedItem

Hívja meg ezt a függvényt az objektumban CRichEditView jelenleg kijelölt OLE elem (objektumCRichEditCntrItem) lekéréséhez.

CRichEditCntrItem* GetSelectedItem() const;

Visszaadott érték

Mutató az objektumban CRichEditView kijelölt CRichEditCntrItem objektumra; NULL érték, ha nincs elem kijelölve ebben a nézetben.

CRichEditView::GetTextLength

Hívja meg ezt a függvényt az objektum szövegének CRichEditView hosszának lekéréséhez.

long GetTextLength() const;

Visszaadott érték

Az objektum szövegének CRichEditView hossza.

CRichEditView::GetTextLengthEx

Hívja meg ezt a tagfüggvényt az objektum szövegének CRichEditView hosszának kiszámításához.

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

Paraméterek

dwFlags
A szöveg hosszának meghatározásához használandó metódust meghatározó érték. Ez a tag a Windows SDK-ban leírt GETTEXTLENGTHEX jelzőkben felsorolt értékek közül egy vagy több lehet.

uCodePage
Kódlap fordításhoz (CP_ACP ANSI-kódlaphoz, Unicode esetén 1200).

Visszaadott érték

A szerkesztési vezérlőben lévő karakterek vagy bájtok száma. Ha a nem kompatibilis jelzők dwFlags értékben lettek beállítva, ez a tagfüggvény E_INVALIDARG ad vissza.

Megjegyzések

GetTextLengthEx további módszereket biztosít a szöveg hosszának meghatározására. Támogatja a Rich Edit 2.0 funkciót. További információt a Windows SDK rich edit vezérlőiről szóló cikkben talál.

CRichEditView::InsertFileAsObject

A függvény meghívásával szúrja be a megadott fájlt ( CRichEditCntrItem objektumként) egy gazdag szerkesztési nézetbe.

void InsertFileAsObject(LPCTSTR lpszFileName);

Paraméterek

lpszFileName
A beszúrni kívánt fájl nevét tartalmazó karakterlánc.

CRichEditView::InsertItem

A függvény meghívása CRichEditCntrItem objektum rich edit nézetbe való beszúrásához.

HRESULT InsertItem(CRichEditCntrItem* pItem);

Paraméterek

pItem
Mutasson a beszúrni kívánt elemre.

Visszaadott érték

A beszúrás sikerességét jelző HRESULT érték.

Megjegyzések

További információ a HRESULT-ról: COM-hibakódok struktúrája a Windows SDK-ban.

CRichEditView::IsRichEditFormat

Hívja meg ezt a függvényt annak megállapításához, hogy a cf egy vágólap formátum, amely szöveg, rich text vagy rich text OLE-elemekkel.

static BOOL AFX_CDECL IsRichEditFormat(CLIPFORMAT cf);

Paraméterek

Cf
A vágólap érdekes formátuma.

Visszaadott érték

Nonzero, ha a cf egy gazdag szerkesztési vagy szöveges vágólap formátum.

CRichEditView::IsSelected

Hívja meg ezt a függvényt annak megállapításához, hogy a megadott OLE elem jelenleg ki van-e jelölve ebben a nézetben.

virtual BOOL IsSelected(const CObject* pDocItem) const;

Paraméterek

pDocItem
Mutasson egy objektumra a nézetben.

Visszaadott érték

Nemzero, ha az objektum ki van jelölve; egyéb esetben 0.

Megjegyzések

Bírálja felül ezt a függvényt, ha a származtatott nézetosztály más módszerrel kezeli az OLE-elemek kiválasztását.

CRichEditView::m_nBulletIndent

Listajelek behúzása; alapértelmezés szerint 720 egység, ami 1/2 hüvelyk.

int m_nBulletIndent;

CRichEditView::m_nWordWrap

A rich edit nézet szóburkolásának típusát jelzi.

int m_nWordWrap;

Megjegyzések

Az alábbi értékek egyike:

  • WrapNone Nem jelez automatikus szóburkolást.

  • WrapToWindow Az ablak szélessége alapján jelzi a szóburkolást.

  • WrapToTargetDevice A céleszköz jellemzői alapján jelzi a szóburkolást.

Example

Lásd a CRichEditView::WrapChanged példát.

CRichEditView::OnCharEffect

Hívja meg ezt a függvényt az aktuális kijelölés karakterformázási effektusainak váltásához.

void OnCharEffect(
    DWORD dwMask,
    DWORD dwEffect);

Paraméterek

dwMask
Az aktuális kijelölésben módosítani kívánt karakterformázási effektusok.

dwEffect
A kívánt karakterformázási effektusok listája.

Megjegyzések

A függvény minden hívása az aktuális kijelöléshez megadott formázási effektusokat váltja ki.

A dwMask és a dwEffect paraméterekkel és azok lehetséges értékeivel kapcsolatos további információkért tekintse meg a CHARFORMAT megfelelő adattagjait a Windows SDK-ban.

Example

void CMyRichEditView::OnItalic()
{
   OnCharEffect(CFM_ITALIC, CFE_ITALIC);
}

CRichEditView::OnFindNext

A keretrendszer meghívja, amikor parancsokat dolgoz fel a Keresés/Csere párbeszédpanelen.

virtual void OnFindNext(
    LPCTSTR lpszFind,
    BOOL bNext,
    BOOL bCase,
    BOOL bWord);

Paraméterek

lpszFind
A keresendő sztring.

bNext
A keresés iránya: AZ IGAZ érték lefelé mutat; HAMIS, fel.

bCase
Azt jelzi, hogy a keresés megkülönbözteti-e a kis- és nagybetűket.

bWord
Azt jelzi, hogy a keresés csak a teljes szavaknak felel-e meg.

Megjegyzések

Hívja meg ezt a függvényt a szöveg megkereséséhez a következőn CRichEditViewbelül: . A függvény felülbírálása a származtatott nézetosztály keresési jellemzőinek módosításához.

CRichEditView::OnInitialUpdate

A keretrendszer meghívta, miután a nézetet először csatolták a dokumentumhoz, de a nézet kezdeti megjelenítése előtt.

virtual void OnInitialUpdate();

Megjegyzések

Ennek a függvénynek az alapértelmezett implementációja a CView::OnUpdate tagfüggvényt hívja meg tippinformációk nélkül (azaz az lHint paraméter alapértelmezett 0 értékeit, a pHint paraméter null értékét használva). A függvény felülbírálása minden olyan egyszeri inicializálás végrehajtásához, amely a dokumentumra vonatkozó információkat igényel. Ha például az alkalmazás rögzített méretű dokumentumokkal rendelkezik, ezzel a függvénnyel inicializálhatja a nézet görgetési korlátait a dokumentumméret alapján. Ha az alkalmazás támogatja a változó méretű dokumentumokat, OnUpdate a dokumentum minden módosításakor frissítse a görgetési korlátokat.

Example

Lásd a CRichEditView::m_nWordWrap.

CRichEditView::OnPasteNativeObject

Ezzel a függvénnyel natív adatokat tölthet be egy beágyazott elemből.

virtual BOOL OnPasteNativeObject(LPSTORAGE lpStg);

Paraméterek

lpStg
Mutasson egy IStorage-objektumra .

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0;

Megjegyzések

Ezt általában úgy teheti meg, hogy létrehoz egy COleStreamFile fájlt a IStorage. A COleStreamFile fájl csatolható egy archívumhoz és a CObject::Szerializálható az adatok betöltéséhez.

Ez egy speciális felülírható.

További információ: IStorage a Windows SDK-ban.

CRichEditView::OnParaAlign

Hívja meg ezt a függvényt a kijelölt bekezdések bekezdésigazításának módosításához.

void OnParaAlign(WORD wAlign);

Paraméterek

wAlign
Kívánt bekezdésigazítás. Az alábbi értékek egyike:

  • PFA_LEFT Bekezdések igazítása a bal margóhoz.

  • PFA_RIGHT A bekezdések igazítása a jobb margóhoz.

  • PFA_CENTER Bekezdések középre igazítása a margók között.

Example

void CMyRichEditView::OnParaCenter()
{
   OnParaAlign(PFA_CENTER);
}

CRichEditView::OnPrinterChanged

A függvény felülbírálása a gazdag szerkesztési nézet jellemzőinek módosításához, amikor a nyomtató megváltozik.

virtual void OnPrinterChanged(const CDC& dcPrinter);

Paraméterek

dcPrinter
CDC-objektum az új nyomtatóhoz.

Megjegyzések

Az alapértelmezett implementáció a papírméretet a kimeneti eszköz (nyomtató) fizikai magasságára és szélességére állítja. Ha a dcPrinterhez nincs eszközkörnyezet társítva, az alapértelmezett implementáció 8,5 x 11 hüvelykre állítja a papírméretet.

CRichEditView::OnReplaceAll

A keretrendszer meghívta, amikor a Csere párbeszédpanelen az Összes parancs cseréje parancsot feldolgozta.

virtual void OnReplaceAll(
    LPCTSTR lpszFind,
    LPCTSTR lpszReplace,
    BOOL bCase,
    BOOL bWord);

Paraméterek

lpszFind
A lecserélendő szöveg.

lpszReplace
A helyettesítő szöveg.

bCase
Azt jelzi, hogy a keresés megkülönbözteti-e a kis- és nagybetűket.

bWord
Azt jelzi, hogy a keresésnek egész szavakat kell-e kijelölnie.

Megjegyzések

Ezt a függvényt úgy hívhatja meg, hogy egy adott szöveg összes előfordulását lecserélje egy másik sztringre. A függvény felülbírálása a nézet keresési jellemzőinek módosításához.

Example

Lásd a CRichEditView::FindText példáját.

CRichEditView::OnReplaceSel

A keretrendszer meghívja a Csere parancsok a Csere párbeszédpanelről történő feldolgozásakor.

virtual void OnReplaceSel(
    LPCTSTR lpszFind,
    BOOL bNext,
    BOOL bCase,
    BOOL bWord,
    LPCTSTR lpszReplace);

Paraméterek

lpszFind
A lecserélendő szöveg.

bNext
A keresés irányát jelzi: AZ IGAZ érték nem érhető el; HAMIS, fel.

bCase
Azt jelzi, hogy a keresés megkülönbözteti-e a kis- és nagybetűket.

bWord
Azt jelzi, hogy a keresésnek egész szavakat kell-e kijelölnie.

lpszReplace
A helyettesítő szöveg.

Megjegyzések

Hívja meg ezt a függvényt, ha egy adott szöveg egy előfordulását egy másik sztringre cseréli. A függvény felülbírálása a nézet keresési jellemzőinek módosításához.

CRichEditView::OnTextNotFound

A keretrendszer meghívja, ha egy keresés sikertelen.

virtual void OnTextNotFound(LPCTSTR lpszFind);

Paraméterek

lpszFind
A nem található szöveg.

Megjegyzések

A függvény felülbírálása a kimeneti értesítés MessageBeep-ről való módosításához.

További információ: MessageBeep a Windows SDK-ban.

Example

void CMyRichEditView::OnTextNotFound(LPCTSTR lpszFind)
{
   // Replace the beep with a message box
   CString str;
   str.Format(_T("'%s' was not found."), lpszFind);
   AfxMessageBox(str);
}

CRichEditView::OnUpdateCharEffect

A keretrendszer meghívja ezt a függvényt, hogy frissítse a parancs felhasználói felületét a karaktereffektus-parancsokhoz.

void OnUpdateCharEffect(
    CCmdUI* pCmdUI,
    DWORD dwMask,
    DWORD dwEffect);

Paraméterek

pCmdUI
Mutató egy CCmdUI-objektumra .

dwMask
A karakterformázási maszkot jelzi.

dwEffect
A karakterformázási effektust jelzi.

Megjegyzések

A maszk dwMask határozza meg, hogy mely karakterformázási attribútumokat kell ellenőrizni. A dwEffect jelzők felsorolják a beállítandó/törölendő karakterformázási attribútumokat.

A dwMask és a dwEffect paraméterekkel és azok lehetséges értékeivel kapcsolatos további információkért tekintse meg a CHARFORMAT megfelelő adattagjait a Windows SDK-ban.

Example

void CMyRichEditView::OnUpdateCharItalicUI(CCmdUI* pCmdUI)
{
   OnUpdateCharEffect(pCmdUI, CFM_ITALIC, CFE_ITALIC);
}

CRichEditView::OnUpdateParaAlign

A keretrendszer meghívja ezt a függvényt, hogy frissítse a parancs felhasználói felületét a bekezdéseffektus-parancsokhoz.

void OnUpdateParaAlign(
    CCmdUI* pCmdUI,
    WORD wAlign);

Paraméterek

pCmdUI
Mutató egy CCmdUI-objektumra .

wAlign
Az ellenőrzéshez használandó bekezdésigazítás. Az alábbi értékek egyike:

  • PFA_LEFT Bekezdések igazítása a bal margóhoz.

  • PFA_RIGHT A bekezdések igazítása a jobb margóhoz.

  • PFA_CENTER Bekezdések középre igazítása a margók között.

Example

void CMyRichEditView::OnUpdateParaCenterUI(CCmdUI* pCmdUI)
{
   OnUpdateParaAlign(pCmdUI, PFA_CENTER);
}

CRichEditView::P rintInsideRect

Ezt a függvényt úgy hívhatja meg, hogy a szövegtartományt rich edit vezérlőelemben formázza úgy, hogy illeszkedjen a pDC által megadott eszköz rectLayout eleméhez.

long PrintInsideRect(
    CDC* pDC,
    RECT& rectLayout,
    long nIndexStart,
    long nIndexStop,
    BOOL bOutput);

Paraméterek

Pdc
Mutasson a kimeneti terület eszközkörnyezetére.

rectLayout
A kimeneti területet meghatározó RECT vagy CRect.

nIndexStart
Az első formázandó karakter nulla alapú indexe.

nIndexStop
Az utolsó formázandó karakter nulla alapú indexe.

bOutput
Azt jelzi, hogy a szöveget renderelni kell-e. Ha HAMIS, a szöveg csak meg van mérve.

Visszaadott érték

A kimeneti területen elférő utolsó karakter indexe plusz egy.

Megjegyzések

Ezt a hívást általában a CRichEditCtrl::D isplayBand hívása követi, amely létrehozza a kimenetet.

Example

Lásd a CRichEditView::GetPaperSize példát.

CRichEditView::P rintPage

Ennek a függvénynek a meghívásával formázhat egy szövegtartományt a pDC által megadott kimeneti eszköz részletes szerkesztési vezérlőjében.

long PrintPage(
    CDC* pDC,
    long nIndexStart,
    long nIndexStop);

Paraméterek

Pdc
Mutató egy eszközkörnyezetre a lapkimenethez.

nIndexStart
Az első formázandó karakter nulla alapú indexe.

nIndexStop
Az utolsó formázandó karakter nulla alapú indexe.

Visszaadott érték

Az oldalon elférő utolsó karakter indexe plusz egy.

Megjegyzések

Az egyes lapok elrendezését a GetPageRect és a GetPrintRect szabályozza. Ezt a hívást általában a CRichEditCtrl::D isplayBand hívása követi, amely létrehozza a kimenetet.

Vegye figyelembe, hogy a margók a fizikai oldalhoz viszonyítva vannak, nem a logikai oldalhoz. Így a nulla margók gyakran kivágják a szöveget, mivel sok nyomtató nyomtathatatlan területekkel rendelkezik az oldalon. A szöveg kivágásának elkerülése érdekében a nyomtatás előtt hívja meg a SetMarginst , és állítsa be a megfelelő margókat.

CRichEditView::QueryAcceptData

A keretrendszer meghívta, hogy illessze be az objektumot a rich editbe.

virtual HRESULT QueryAcceptData(
    LPDATAOBJECT lpdataobj,
    CLIPFORMAT* lpcfFormat,
    DWORD dwReco,
    BOOL bReally,
    HGLOBAL hMetaFile);

Paraméterek

lpdataobj
A lekérdezéshez mutasson az IDataObject elemre.

lpcfFormat
Mutasson az elfogadható adatformátumra.

dwReco
Nincs használatban.

bReally
Azt jelzi, hogy a beillesztési műveletnek folytatódnia kell-e vagy sem.

hMetaFile
Az elem ikonjának rajzolásához használt metafájl leírója.

Visszaadott érték

Egy HRESULT érték, amely a művelet sikerességét jelenti.

Megjegyzések

A függvény felülbírálása a com-elemek különböző rendszerezésének kezeléséhez a származtatott dokumentumosztályban. Ez egy speciális felülírható.

További információ a HRESULT-ról és IDataObjecta Windows SDK COM-hibakódjainak szerkezetéről és az IDataObjectről.

Example

// This code fragment is taken from the Wordpad sample.
HRESULT CMyRichEditView::QueryAcceptData(LPDATAOBJECT lpdataobj,
   CLIPFORMAT* lpcfFormat, DWORD dwReco, BOOL bReally, HGLOBAL hMetaFile)
{
   if (bReally && *lpcfFormat == 0 && (m_nPasteType == 0))
   {
      COleDataObject dataobj;
      dataobj.Attach(lpdataobj, FALSE);
      if (!dataobj.IsDataAvailable(cfRTO)) // native avail, let 
                                           // richedit do as it wants
      {
         if (dataobj.IsDataAvailable(cfEmbeddedObject))
         {
            if (PasteNative(lpdataobj)) // See WordPad sample for info
                                        // on PasteNative
               return S_FALSE;
         }
      }
   }
   return CRichEditView::QueryAcceptData(lpdataobj, lpcfFormat, dwReco,
      bReally, hMetaFile);
}

CRichEditView::SetCharFormat

Hívja meg ezt a függvényt az objektum új CRichEditView szövegének karakterformázási attribútumainak beállításához.

void SetCharFormat(CHARFORMAT2 cf);

Paraméterek

Cf
CHARFORMAT2 új alapértelmezett karakterformázási attribútumokat tartalmazó struktúra.

Megjegyzések

Ez a függvény csak a dwMaskcf tag által megadott attribútumokat módosítja.

További információ: EM_SETCHARFORMAT üzenet és CHARFORMAT2 struktúra a Windows SDK-ban.

Example

void CMyRichEditView::OnCharUnderline()
{
   CHARFORMAT2 cf;
   cf = GetCharFormatSelection();

   if (!(cf.dwMask & CFM_UNDERLINE) || !(cf.dwEffects & CFE_UNDERLINE))
      cf.dwEffects = CFE_UNDERLINE;
   else
      cf.dwEffects = 0;

   cf.dwMask = CFM_UNDERLINE;
   SetCharFormat(cf);
}

CRichEditView::SetMargins

Hívja meg ezt a függvényt a gazdag szerkesztési nézet nyomtatási margóinak beállításához.

void SetMargins(const CRect& rectMargin);

Paraméterek

rectMargin
A nyomtatáshoz használt új margóértékek, MM_TWIPS mérve.

Megjegyzések

Ha m_nWordWrap , WrapToTargetDeviceakkor a függvény használata után a WrapChanged függvényt kell meghívnia a nyomtatási jellemzők módosításához.

Vegye figyelembe, hogy a PrintPage által használt margók nem a logikai oldalhoz, hanem a fizikai oldalhoz vannak viszonyítva. Így a nulla margók gyakran kivágják a szöveget, mivel sok nyomtató nyomtathatatlan területekkel rendelkezik az oldalon. A szöveg kivágásának elkerülése érdekében a nyomtatás előtt érdemes megfontolni SetMargins a nyomtató margóinak beállítását.

Example

Lásd a CRichEditView::GetPaperSize példát.

CRichEditView::SetPaperSize

A függvény meghívásával beállíthatja a papírméretet a gazdag szerkesztési nézet nyomtatásához.

void SetPaperSize(CSize sizePaper);

Paraméterek

sizePaper
A nyomtatáshoz használt új papírméretértékek, MM_TWIPS mérve.

Megjegyzések

Ha m_nWordWrap , WrapToTargetDeviceakkor a függvény használata után a WrapChanged függvényt kell meghívnia a nyomtatási jellemzők módosításához.

Example

BOOL CMyRichEditView::OnPreparePrinting(CPrintInfo* pInfo)
{
   // Set the printing margins (720 twips = 1/2 inch).
   SetMargins(CRect(720, 720, 720, 720));

   // Change the paper orientation to landscape mode
   // See the example for CWinApp::GetPrinterDeviceDefaults
   ((CMyWinApp*)AfxGetApp())->SetLandscapeMode();

   // Change the paper size in the CRichEditView to 
   // reflect landscape mode
   CSize csPaper = GetPaperSize();
   int temp;
   temp = csPaper.cx; csPaper.cx = csPaper.cy; csPaper.cy = temp;
   SetPaperSize(csPaper);

   return DoPreparePrinting(pInfo);
}

CRichEditView::SetParaFormat

Hívja meg ezt a függvényt az objektum aktuális kijelöléséhez CRichEditView tartozó bekezdésformázási attribútumok beállításához.

BOOL SetParaFormat(PARAFORMAT2& pf);

Paraméterek

Pf
PARAFORMAT2 új alapértelmezett bekezdésformázási attribútumokat tartalmazó struktúrát.

Visszaadott érték

Nonzero, ha sikeres; ellenkező esetben 0.

Megjegyzések

Ez a függvény csak a dwMaskpf tag által megadott attribútumokat módosítja.

További információ: EM_SETPARAFORMAT üzenet és PARAFORMAT2 struktúra a Windows SDK-ban.

Example

void CMyRichEditView::AddBullets()
{
   PARAFORMAT2 pf;

   pf.cbSize = sizeof(PARAFORMAT2);
   pf.dwMask = PFM_NUMBERING | PFM_OFFSET;
   pf.wNumbering = PFN_BULLET;
   pf.dxOffset = 10;

   VERIFY(SetParaFormat(pf));
}

CRichEditView::TextNotFound

Hívja meg ezt a függvényt a CRichEditView vezérlő belső keresési állapotának alaphelyzetbe állításához a FindText sikertelen hívása után.

void TextNotFound(LPCTSTR lpszFind);

Paraméterek

lpszFind
A nem található szöveges sztringet tartalmazza.

Megjegyzések

Javasoljuk, hogy ezt a metódust azonnal hívja meg a FindText sikertelen hívásai után, hogy a vezérlő belső keresési állapota megfelelően vissza legyen állítva.

Az lpszFind paraméternek ugyanazt a tartalmat kell tartalmaznia, mint a FindTextnek megadott sztring. A belső keresési állapot alaphelyzetbe állítása után ez a metódus meghívja az OnTextNotFound metódust a megadott keresési sztringgel.

Example

Lásd a CRichEditView::FindText példáját.

CRichEditView::WrapChanged

Hívja meg ezt a függvényt, ha a nyomtatási jellemzők megváltoztak ( SetMargins vagy SetPaperSize).

virtual void WrapChanged();

Megjegyzések

A függvény felülbírálása a rich edit nézet m_nWordWrap vagy a nyomtatási jellemzők ( OnPrinterChanged) változásainak módosításához.

Example

void CMyRichEditView::OnInitialUpdate()
{
   CRichEditView::OnInitialUpdate();

   // Turn on the horizontal scroll bar
   m_nWordWrap = WrapNone;
   WrapChanged();
}

Lásd még

MFC-minta WORDPAD
CCtrlView osztály
hierarchiadiagram
CRichEditDoc osztály
CRichEditCntrItem osztály