EM_SETCHARFORMAT mensagem

Define a formatação de caracteres em um controle de edição avançada.

Parâmetros

wParam

Formatação de caractere que se aplica ao controle. Se esse parâmetro for zero, o formato de caractere padrão será definido. Caso contrário, ele pode ser um dos seguintes valores.

Valor Significado
SCF_ALL
Aplica a formatação a todo o texto no controle. Não é válido com SCF_SELECTION ou SCF_WORD.
SCF_ASSOCIATEFONT
RichEdit 4.1: Associa uma fonte a um determinado script, alterando assim a fonte padrão para esse script. Para especificar a fonte, use os seguintes membros de CHARFORMAT2: yHeight, bCharSet, bPitchAndFamily, szFaceName e lcid.
SCF_ASSOCIATEFONT2
RichEdit 4.1: Associa uma fonte substituta (plano-2) a um determinado script, alterando assim a fonte padrão para esse script. Para especificar a fonte, use os seguintes membros de CHARFORMAT2: yHeight, bCharSet, bPitchAndFamily, szFaceName e lcid.
SCF_CHARREPFROMLCID
Obtém o repertório do caractere do LCID.
SCF_DEFAULT
RichEdit 4.1: Define a fonte padrão para o controle.
SPF_DONTSETDEFAULT
Impede a configuração do formato de parágrafo padrão quando o controle de edição avançada está vazio.
SCF_NOKBUPDATE
RichEdit 4.1: Impede a alternância de teclado para corresponder à fonte. Por exemplo, se uma fonte árabe estiver definida, normalmente o recurso de teclado automático para idiomas Bidi alterará o teclado para um teclado árabe.
SCF_SELECTION
Aplica a formatação à seleção atual. Se a seleção estiver vazia, a formatação de caracteres será aplicada ao ponto de inserção e o novo formato de caractere só estará em vigor até que o ponto de inserção seja alterado.
SPF_SETDEFAULT
Define os atributos de formatação de parágrafo padrão.
SCF_SMARTFONT
Aplique a fonte somente se ela puder manipular o script.
SCF_USEUIRULES
RichEdit 4.1: Usado com SCF_SELECTION. Indica que o formato veio de uma barra de ferramentas ou de outra ferramenta de interface do usuário, portanto, as regras de formatação da interface do usuário devem ser usadas em vez de formatação literal.
SCF_WORD
Aplica a formatação à palavra ou palavras selecionadas. Se a seleção estiver vazia, mas o ponto de inserção estiver dentro de uma palavra, a formatação será aplicada à palavra. O valor SCF_WORD deve ser usado em conjunto com o valor SCF_SELECTION .

lParam

Ponteiro para uma estrutura CHARFORMAT que especifica a formatação de caractere a ser usada. Somente os atributos de formatação especificados pelo membro dwMask são alterados.

Microsoft Rich Edit 2.0 e posterior: esse parâmetro pode ser um ponteiro para uma estrutura CHARFORMAT2 , que é uma extensão da estrutura CHARFORMAT . Antes de enviar a mensagem EM_SETCHARFORMAT , defina o membro cbSize da estrutura como sizeof(CHARFORMAT) ou sizeof(CHARFORMAT2) indique qual versão da estrutura está sendo usada.

Os membros szFaceName e bCharSet podem ser rejeitados quando inválidos para caracteres, por exemplo: Arial em caracteres kanji.

Valor retornado

Se a operação for bem-sucedida, o valor retornado será um valor diferente de zero.

Se a operação falhar, o valor retornado será zero.

Comentários

Se essa mensagem for enviada mais de uma vez com os mesmos parâmetros, o efeito no texto será alternado. Ou seja, enviar a mensagem uma vez produz o efeito, enviar a mensagem duas vezes cancela o efeito e assim por diante.

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

CHARFORMAT

CHARFORMAT2