CRichEditCtrl::SetDefaultCharFormat

Artículo
06/10/2015

Establece los atributos de formato de caracteres para el nuevo texto en este objeto de CRichEditCtrl .

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

Parámetros

cf
En la primera versión, un puntero a una estructura de CHARFORMAT que contiene los nuevos atributos predeterminados de formato de caracteres.

En la segunda versión, un puntero a una estructura de CHARFORMAT2 , que es una extensión de Rich Edit 2,0 a la estructura de CHARFORMAT , contiene el formato de caracteres predeterminado admite.

Valor devuelto

Distinto de cero si correctamente; de lo contrario, 0.

Comentarios

Solo los atributos especificados por el miembro de dwMask de cf son modificados por esta función.

Para obtener más información, vea el mensaje de EM_SETCHARFORMAT y estructuras de CHARFORMAT y de CHARFORMAT2 en Windows SDK.

Ejemplo

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);