CRichEditCtrl::FormatRange

Artikel
02/26/2013

Formatiert einen Textbereich in einem RichEdit-Steuerelement für ein bestimmtes Gerät.

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

Parameter

pfr
Zeiger auf die FORMATRANGE-Struktur, die Informationen über das Ausgabegerät enthält.NULL gibt an, dass zwischengespeicherte Informationen innerhalb des Rich-Edit-Steuerelements freigegeben werden können.
bDisplay
Gibt an, ob der Text gerendert wird.Wenn FALSE, der Text nur gemessen wird.

Rückgabewert

Der Index des letzten Zeichens der in den Bereich plus ein.

Hinweise

In der Regel wird dieser Aufruf in einem Aufruf DisplayBand erfolgreich.

Weitere Informationen finden Sie unter EM_FORMATRANGE Meldung und FORMATRANGE-Struktur in Windows SDK.

Beispiel

// 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();
}