struttura CHARFORMAT2A (richedit.h)

Articolo
08/15/2024

Contiene informazioni sulla formattazione dei caratteri in un controllo di modifica rtf. CHARFORMAT2 è un'estensione Microsoft Rich Edit 2.0 della struttura CHARFORMAT . Microsoft Rich Edit 2.0 consente di usare una delle due strutture con i messaggi EM_GETCHARFORMAT e EM_SETCHARFORMAT.

Sintassi

struct CHARFORMAT2A : _charformat {
  WORD     wWeight;
  SHORT    sSpacing;
  COLORREF crBackColor;
  LCID     lcid;
  union {
    DWORD dwReserved;
    DWORD dwCookie;
  };
  DWORD    dwReserved;
  SHORT    sStyle;
  WORD     wKerning;
  BYTE     bUnderlineType;
  BYTE     bAnimation;
  BYTE     bRevAuthor;
  BYTE     bUnderlineColor;
};

Eredità

La struttura CHARFORMAT2A implementa _charformat.

Membri

wWeight

Tipo: WORD

Spessore del carattere. Questo membro corrisponde al membro lfWeight della struttura LOGFONT . Per utilizzare questo membro, impostare il flag di CFM_WEIGHT nel membro dwMask.

sSpacing

Tipo: SHORT

Spazio orizzontale tra lettere, in twip. Questo valore non ha alcun effetto sul testo visualizzato da un controllo di modifica rtf; è incluso per la compatibilità con le interfacce TOM di Windows. Per utilizzare questo membro, impostare il flag di CFM_SPACING nel membro dwMask.

crBackColor

Tipo: COLORREF

Colore di sfondo. Per usare questo membro, impostare il flag di CFM_BACKCOLOR nel membro dwMask. Questo membro viene ignorato se viene specificato l'effetto carattere CFE_AUTOBACKCOLOR. Per generare un oggetto , utilizzare la macro .

lcid

Tipo: LCID

Identificatore delle impostazioni locali a 32 bit che contiene un identificatore di lingua nella parola inferiore e un identificatore di ordinamento e un valore riservato nella parola superiore. Questo membro non ha alcun effetto sul testo visualizzato da un controllo di modifica avanzato, ma i correttori ortografici e grammaticali possono usarlo per gestire i problemi dipendenti dalla lingua. È possibile utilizzare la macro per creare un valore LCID. Per usare questo membro, impostare il flag di CFM_LCID nel membro dwMask .

dwReserved

Tipo: DWORD

Riservato; il valore deve essere zero.

dwCookie

Tipo: DWORD

Cookie client. Questo membro è opaco per un controllo di modifica avanzato.

sStyle

Tipo: SHORT

Handle di stile carattere. Questo valore non ha alcun effetto sul testo visualizzato da un controllo di modifica rtf; è incluso per la compatibilità con le interfacce WindowsTOM. Per usare questo membro, impostare il flag di CFM_STYLE nel membro dwMask. Per altre informazioni, vedere la documentazione di TOM.

wKerning

Tipo: WORD

Valore della dimensione del carattere, al di sopra del quale creare il carattere (yHeight). Questo valore non ha alcun effetto sul testo visualizzato da un controllo di modifica rtf; è incluso per la compatibilità con le interfacce TOM. Per utilizzare questo membro, impostare il flag di CFM_KERNING nel membro dwMask.

bUnderlineType

Tipo: BYTE

Specifica il tipo di sottolineatura. Per utilizzare questo membro, impostare il flag di CFM_UNDERLINETYPE nel membro dwMask. Questo membro può essere uno dei valori seguenti.

Valore	Significato
CFU_CF1UNDERLINE	La struttura esegue il mapping sottolineatura bit di CHARFORMATa CHARFORMAT2, ovvero esegue un charFORMAT tipo di sottolineatura in questo testo.
CFU_INVERT	Per la composizione IME, falso una selezione.
CFU_UNDERLINE	Testo sottolineato con una singola linea continua.
CFU_UNDERLINEDASH	Testo sottolineato con trattini.
CFU_UNDERLINEDASHDOT	Testo sottolineato con una linea tratteggiata e tratteggiata.
CFU_UNDERLINEDASHDOTDOT	Testo sottolineato con una linea tratteggiata e tratteggiata doppia.
CFU_UNDERLINEDOTTED	Testo sottolineato con una linea tratteggiata. Per le versioni precedenti a Microsoft Rich Edit 3.0, il testo viene visualizzato con una sottolineatura continua.
CFU_UNDERLINEDOUBLE	Testo sottolineato con una doppia riga. Il controllo rich edit visualizza il testo con una sottolineatura continua.
CFU_UNDERLINEDOUBLEWAVE	Visualizza come CFU_UNDERLINEWAVE.
CFU_UNDERLINEHAIRLINE	Visualizza come CFU_UNDERLINE.
CFU_UNDERLINEHEAVYWAVE	Visualizza come CFU_UNDERLINEWAVE.
CFU_UNDERLINELONGDASH	Visualizza come CFU_UNDERLINEDASH.
CFU_UNDERLINENONE	Nessuna sottolineatura. Si tratta dell'impostazione predefinita.
CFU_UNDERLINETHICK	Visualizza come CFU_UNDERLINE.
CFU_UNDERLINETHICKDASH	Visualizza come CFU_UNDERLINEDASH.
CFU_UNDERLINETHICKDASHDOT	Visualizza come CFU_UNDERLINEDASHDOT.
CFU_UNDERLINETHICKDASHDOTDOT	Visualizza come CFU_UNDERLINEDASHDOT.
CFU_UNDERLINETHICKDOTTED	Visualizza come CFU_UNDERLINEDOT.
CFU_UNDERLINETHICKLONGDASH	Visualizza come CFU_UNDERLINEDASH.
CFU_UNDERLINEWAVE	RichEdit 4.1 e versioni successive: testo sottolineato con una linea ondulata.
CFU_UNDERLINEWORD	RichEdit 4.1 e versioni successive: sottolinea solo le parole. Il controllo rich edit visualizza il testo con una sottolineatura continua.

bAnimation

Tipo: BYTE

Tipo di animazione di testo. Questo valore non ha alcun effetto sul testo visualizzato da un controllo di modifica rtf; è incluso per la compatibilità con le interfacce TOM. Per usare questo membro, impostare il flag di CFM_ANIMATION nel membro dwMask.

bRevAuthor

Tipo: BYTE

Indice che identifica l'autore che effettua una revisione. Il controllo rich edit utilizza colori di testo diversi per ogni indice dell'autore diverso. Per usare questo membro, impostare il flag di CFM_REVAUTHOR nel membro dwMask.

bUnderlineColor

Tipo: BYTE

Colore sottolineatura:

UnderlineColor_Black = 0x00;
UnderlineColor_Blue = 0x01;
UnderlineColor_Aqua = 0x02;
UnderlineColor_Lime = 0x03;
UnderlineColor_Fuchsia = 0x04;
UnderlineColor_Red = 0x05;
UnderlineColor_Yellow = 0x06;
UnderlineColor_White = 0x07;
UnderlineColor_Navy = 0x08;
UnderlineColor_Teal = 0x09;
UnderlineColor_Green = 0x0A;
UnderlineColor_Purple = 0x0B;
UnderlineColor_Maroon = 0x0C;
UnderlineColor_Olive = 0x0D;
UnderlineColor_DkGray = 0x0E;
UnderlineColor_LtGray = 0x0F;

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 CHARFORMAT2 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.