Compartilhar via


EM_SETRECT mensagem

Define o retângulo de formatação de um controle de edição de várias linhas. O retângulo de formatação é o retângulo limitador no qual o controle desenha o texto. O retângulo de limitação é independente do tamanho da janela de controle de edição.

Essa mensagem é processada apenas por controles de edição de várias linhas. Você pode enviar essa mensagem para um controle de edição ou um controle de edição avançada.

Parâmetros

wParam

Edição Avançada 2.0 e posterior: Indica se lParam especifica coordenadas absolutas ou relativas. Um valor zero indica coordenadas absolutas. Um valor de 1 indica deslocamentos relativos ao retângulo de formatação atual. (Os deslocamentos podem ser positivos ou negativos.)

Editar controles e Rich Edit 1.0: Esse parâmetro não é usado e deve ser zero.

lParam

Um ponteiro para uma estrutura RECT que especifica as novas dimensões do retângulo. Se esse parâmetro for NULL, o retângulo de formatação será definido como seus valores padrão.

Valor retornado

Esta mensagem não retorna um valor.

Comentários

Definir lParam como NULL não terá efeito se um dispositivo touch estiver instalado ou se EM_SETRECT for enviado de um thread que tenha um gancho instalado (consulte SetWindowsHookEx). Nesses casos, lParam deve conter um ponteiro válido para uma estrutura RECT .

A mensagem EM_SETRECT faz com que o texto do controle de edição seja redesenhado. Para alterar o tamanho do retângulo de formatação sem redesenhar o texto, use a mensagem EM_SETRECTNP .

Quando um controle de edição é criado pela primeira vez, o retângulo de formatação é definido como um tamanho padrão. Você pode usar a mensagem EM_SETRECT para tornar o retângulo de formatação maior ou menor que a janela de controle de edição.

Se o controle de edição não tiver uma barra de rolagem horizontal e o retângulo de formatação estiver definido como maior que a janela de controle de edição, as linhas de texto que excedem a largura da janela de controle de edição (mas menor que a largura do retângulo de formatação) serão recortadas em vez de encapsuladas.

Se o controle de edição contiver uma borda, o retângulo de formatação será reduzido pelo tamanho da borda. Se você estiver ajustando o retângulo retornado por uma mensagem EM_GETRECT , deverá remover o tamanho da borda antes de usar o retângulo com a mensagem EM_SETRECT .

Edição avançada: Com suporte no Microsoft Rich Edit 1.0 e posterior. O retângulo de formatação não inclui a barra de seleção, que é uma área não marcada à esquerda de cada parágrafo. Quando o usuário clica na barra de seleção, a linha correspondente é selecionada. Para obter informações sobre a compatibilidade de versões de edição avançada com as várias versões do sistema, consulte Sobre controles de edição avançada.

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
Winuser.h (inclua Windows.h)

Confira também

Referência

EM_GETRECT

EM_SETRECTNP

Outros recursos

RECT