CRichEditCtrl::FormatRange

Artigo
02/25/2013

Formata um intervalo de texto em um controle de edição rico para um dispositivo específico.

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

Parâmetros

pfr
Ponteiro para a estrutura de FORMATRANGE que contém informações sobre o dispositivo de saída.NULO indica que as informações em cache dentro do controle de edição rico pode ser liberada.
bDisplay
Indica se o texto é renderizado.Se Falso, o texto é medido apenas.

Valor de retorno

O índice do caractere mais recente que couber na região mais uma.

Comentários

Normalmente, essa chamada é seguido por uma chamada a DisplayBand.

Para obter mais informações, consulte a mensagem de EM_FORMATRANGE e a estrutura de FORMATRANGE em Windows SDK.

Exemplo

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