Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
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
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:
WrapNoneNem jelez automatikus szóburkolást.WrapToWindowAz ablak szélessége alapján jelzi a szóburkolást.WrapToTargetDeviceA 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