Compartilhar via


EM_FORMATRANGE mensagem

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

Parâmetros

wParam

Especifica se o texto deve ser renderizado. Se esse parâmetro não for zero, o texto será renderizado. Caso contrário, o texto será apenas medido.

lParam

Uma estrutura FORMATRANGE que contém informações sobre o dispositivo de saída ou NULL para liberar informações armazenadas em cache pelo controle.

Valor retornado

Essa mensagem retorna o índice do último caractere que se encaixa na região, mais 1.

Comentários

Normalmente, essa mensagem é usada para formatar o conteúdo do controle de edição avançada para um dispositivo de saída, como uma impressora.

Depois de usar essa mensagem para formatar um intervalo de texto, é importante que você libere informações armazenadas em cache enviando EM_FORMATRANGE novamente, mas com lParam definido como NULL; caso contrário, ocorrerá um vazamento de memória. Além disso, depois de usar essa mensagem para um dispositivo, você deve liberar informações armazenadas em cache antes de usá-la novamente para um dispositivo diferente.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho
Richedit.h

Confira também

Referência

EM_DISPLAYBAND

Conceitual

Imprimindo controles de edição avançada