Struttura CHARFORMATA (richedit.h)

Articolo
02/01/2024

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

Modifica avanzata 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 di 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;

Members

cbSize

Tipo: UINT

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

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 sono validi.
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 è 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 di 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: I caratteri vengono visualizzati con un'ombreggiatura che è offset da 3/4 punti o un pixel, che tuttavia è più grande.
CFE_ITALIC	I caratteri sono corsivi.
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 twips (1/1440 di un pollice o 1/20 del punto di una stampante).

yOffset

Tipo: LONG

Offset di caratteri, in twips, dalla baseline. Se il valore di questo membro è positivo, il carattere è un descrittore; se è negativo, il carattere è un descrittore.

crTextColor

Tipo: COLORREF

Colore del testo. Questo membro viene ignorato se viene specificato l'effetto carattere CFE_AUTOCOLOR. Per generare un COLORREF, usare 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 è lo stesso del membro lfPitchAndFamily della struttura LOGFONT .

szFaceName[LF_FACESIZE]

Tipo: TCHAR[LF_FACESIZE]

Matrice di caratteri con terminazione null specificando il nome del tipo di carattere.

Commenti

Per disattivare un attributo di formattazione, impostare il valore appropriato in dwMask , ma non impostare il valore corrispondente in dwEffects. Ad esempio, per disattivare i corsivi, 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 di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	richedit.h

Vedi anche

Riferimento