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 valores a seguir.

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 alternativa (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 de caracteres do LCID.
SCF_DEFAULT	RichEdit 4.1: Define a fonte padrão para o controle .
SPF_DONTSETDEFAULT	Impede a definiçã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 puder manipular o script.
SCF_USEUIRULES	RichEdit 4.1: Usado com SCF_SELECTION. Indica que o formato veio de uma barra de ferramentas ou 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 especificando 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 sizeof(CHARFORMAT)cbSize da estrutura como 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