Struttura CHARFORMATA (richedit.h)

Articolo
08/15/2024

Contiene informazioni sulla formattazione dei caratteri in un controllo di modifica rtf.

Rich Edit 2.0: La struttura CHARFORMAT2 è un'estensione di Microsoft Rich Edit 2.0 della struttura CHARFORMAT . Microsoft Rich Edit 2.0 e versioni successive consente di usare entrambe le strutture con i messaggi EM_GETCHARFORMAT e EM_SETCHARFORMAT.

Sintassi

typedef struct _charformat {
  UINT     cbSize;
  DWORD    dwMask;
  DWORD    dwEffects;
  LONG     yHeight;
  LONG     yOffset;
  COLORREF crTextColor;
  BYTE     bCharSet;
  BYTE     bPitchAndFamily;
  char     szFaceName[LF_FACESIZE];
} CHARFORMATA;

Membri

cbSize

Tipo: UINT

Dimensioni in byte della struttura specificata. Questo membro deve essere impostato prima di passare la struttura al controllo rich edit.

dwMask

Tipo: DWORD

Membri contenenti informazioni o attributi validi da impostare. Questo membro può essere zero, uno o più di uno dei valori seguenti.

Valore	Significato
CFM_ALL	windows 8: combinazione dei valori seguenti: CFM_EFFECTS \| CFM_SIZE \| CFM_FACE \| CFM_OFFSET \| CFM_CHARSET
CFM_BOLD	Il valore CFE_BOLD del membro dwEffects è valido.
CFM_CHARSET	Il membro bCharSet è valido.
CFM_COLOR	Il membro crTextColor e il valore CFE_AUTOCOLOR del membro dwEffects .
CFM_EFFECTS	Windows 8: combinazione dei valori seguenti: CFM_BOLD \| CFM_ITALIC \| CFM_UNDERLINE \| CFM_COLOR \| CFM_STRIKEOUT \| CFE_PROTECTED \| CFM_LINK
CFM_FACE	Il membro szFaceName è valido.
CFM_ITALIC	Il valore CFE_ITALIC del membro dwEffects è valido.
CFM_OFFSET	Il membro yOffset è valido.
CFM_PROTECTED	Il valore CFE_PROTECTED del membro dwEffects di è valido.
CFM_SIZE	Il membro yHeight è valido.
CFM_STRIKEOUT	Il valore CFE_STRIKEOUT del membro dwEffects è valido.
CFM_UNDERLINE.	Il valore CFE_UNDERLINE del membro dwEffects è valido.

dwEffects

Tipo: DWORD

Effetti carattere. Questo membro può essere una combinazione dei valori seguenti.

Valore	Significato
CFE_AUTOCOLOR	Il colore del testo è il valore restituito di GetSysColor(COLOR_WINDOWTEXT).
CFE_BOLD	I caratteri sono in grassetto.
CFE_DISABLED	RichEdit 2.0 e versioni successive: Caratteri vengono visualizzati con un'ombreggiatura sfalsato di 3/4 punti o un pixel, a differenza di un pixel maggiore.
CFE_ITALIC	I caratteri sono in corsivo.
CFE_STRIKEOUT	I caratteri vengono colpiti.
CFE_UNDERLINE	I caratteri sono sottolineati.
CFE_PROTECTED	I caratteri sono protetti; Un tentativo di modificarli causerà un codice di notifica EN_PROTECTED.

yHeight

Tipo: LONG

Altezza carattere, in twip (1/1440 di un pollice o 1/20 del punto di una stampante).

yOffset

Tipo: LONG

Offset di caratteri, in twip, dalla linea di base. Se il valore di questo membro è positivo, il carattere è un apice; se è negativo, il carattere è un pedice.

crTextColor

Tipo: COLORREF

Colore del testo. Questo membro viene ignorato se viene specificato l'effetto carattere CFE_AUTOCOLOR. Per generare un COLORREF, utilizzare la macro RGB .

bCharSet

Tipo: BYTE

Valore del set di caratteri. Il membro bCharSet può essere uno dei valori specificati per il membro lfCharSet della struttura LOGFONT . Microsoft Rich Edit 3.0 può eseguire l'override di questo valore se non è valido per i caratteri di destinazione.

bPitchAndFamily

Tipo: BYTE

Famiglia di caratteri e passo. Questo membro corrisponde al membro lfPitchAndFamily della struttura LOGFONT.

szFaceName[LF_FACESIZE]

Tipo: TCHAR[LF_FACESIZE]

Matrice di caratteri con terminazione Null che specifica il nome del tipo di carattere.

Osservazioni

Per disattivare un attributo di formattazione, impostare il valore appropriato in dwMask ma non impostare il valore corrispondente in dwEffects. Ad esempio, per disattivare il corsivo, impostare CFM_ITALIC ma non impostare CFE_ITALIC.

Nota

L'intestazione richedit.h definisce CHARFORMAT come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.