CRichEditCtrl::SetDefaultCharFormat

Artigo
02/25/2013

Defina os atributos de formatação de caracteres para o novo texto em este objeto de CRichEditCtrl .

BOOL SetDefaultCharFormat(
   CHARFORMAT& cf 
);
BOOL SetDefaultCharFormat(
   CHARFORMAT2& cf 
);

Parâmetros

cf
Em a primeira versão, um ponteiro a estrutura de CHARFORMAT que contém os novos atributos de formatação padrões de caracteres.

Em a segunda versão, um ponteiro a estrutura de CHARFORMAT2 , que é uma extensão rica de edição 2,0 para a estrutura de CHARFORMAT , que contém formatação padrão de caracteres atribui.

Valor de retorno

Diferente de zero se com êxito; caso contrário, 0.

Comentários

Somente os atributos especificados pelo membro de dwMask de cf são modificados por essa função.

Para obter mais informações, consulte a mensagem de EM_SETCHARFORMAT e estruturas de CHARFORMAT e de CHARFORMAT2 em Windows SDK.

Exemplo

CHARFORMAT cf = {0};

// Modify the default character format so that all new
// text is striked out and not bold.
cf.cbSize = sizeof(cf);
cf.dwMask = CFM_STRIKEOUT|CFM_BOLD;
cf.dwEffects = CFE_STRIKEOUT;
m_myRichEditCtrl.SetDefaultCharFormat(cf);

// Verify the settings are what is expected.
m_myRichEditCtrl.GetDefaultCharFormat(cf);
ASSERT((cf.dwMask&(CFM_STRIKEOUT|CFM_BOLD)) == 
   (CFM_STRIKEOUT|CFM_BOLD));
ASSERT((cf.dwEffects&(CFE_STRIKEOUT|CFE_BOLD)) == CFE_STRIKEOUT);