CRichEditCtrl::FormatRange

Artykuł
02/27/2013

Formaty zakresu tekstu w formancie edycji wzbogaconej dla określonego urządzenia.

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

Parametry

PFR
Wskaźnik do FORMATRANGE struktury, która zawiera informacje na urządzenie wyjściowe.NULL wskazuje buforowanych informacji w formancie edycji wzbogaconej może zostać zwolnione.
bDisplay
Wskazuje tekst powinien być odwzorowywany.Jeśli FALSE, mierzona jest tylko tekst.

Wartość zwracana

Indeks ostatniego znaku, który mieści się w regionie, plus jeden.

Uwagi

Zazwyczaj tego wywołania następuje wywołanie DisplayBand.

Aby uzyskać więcej informacji, zobacz EM_FORMATRANGE wiadomości i FORMATRANGE struktury w Windows SDK.

Przykład

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