CHARFORMAT2A struttura (richedit.h)
Contiene informazioni sulla formattazione dei caratteri in un controllo di modifica avanzato. CHARFORMAT2 è un'estensione di Microsoft Rich Edit 2.0 della struttura CHARFORMAT . Microsoft Rich Edit 2.0 consente di usare entrambe le strutture con i messaggi di 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;
};
Ereditarietà
La struttura CHARFORMAT2A implementa _charformat .
Membri
wWeight
Tipo: WORD
Peso del carattere. Questo membro è lo stesso del membro lfWeight della struttura LOGFONT . Per usare questo membro, impostare il flag di CFM_WEIGHT nel membro dwMask .
sSpacing
Tipo: SHORT
Spazio orizzontale tra lettere, in twips. Questo valore non ha alcun effetto sul testo visualizzato da un controllo di modifica avanzato; è incluso per la compatibilità con le interfacce TOM di Windows. Per usare 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 , usare 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 checker ortografici e grammaticali possono usarlo per gestire i problemi dipendenti dalla lingua. È possibile usare la macro per creare un valore LCID . Per usare questo membro, impostare il flag di CFM_LCID nel membro dwMask .
dwReserved
Tipo: DWORD
Riservati; il valore deve essere zero.
dwCookie
Tipo: DWORD
Cookie client. Questo membro è opaco a 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 avanzato; è incluso per la compatibilità con le interfacce WindowsTOM. Per usare questo membro, impostare il flag CFM_STYLE nel membro dwMask . Per altre informazioni, vedere la documentazione di TOM.
wKerning
Tipo: WORD
Valore delle dimensioni del tipo di carattere, sopra il quale eseguire la kern del carattere (yHeight). Questo valore non ha alcun effetto sul testo visualizzato da un controllo di modifica avanzato; è incluso per la compatibilità con le interfacce TOM. Per usare questo membro, impostare il flag di CFM_KERNING nel membro dwMask .
bUnderlineType
Tipo: BYTE
Specifica il tipo di sottolineatura. Per usare questo membro, impostare il flag CFM_UNDERLINETYPE nel membro dwMask . Questo membro può essere uno dei valori seguenti.
| Valore | Significato |
|---|---|
|
La struttura esegue il mapping della sottolineatura del bit CHARFORMAT a CHARFORMAT2, ovvero esegue un tipo CHARFORMAT di sottolineatura su questo testo. |
|
Per la composizione IME, falso una selezione. |
|
Testo sottolineato con una singola linea unita. |
|
Testo sottolineato con trattini. |
|
Testo sottolineato con una linea tratteggiata e punteggiata. |
|
Testo sottolineato con una linea tratteggiata e doppia. |
|
Testo sottolineato con una linea punteggiata. Per le versioni precedenti a Microsoft Rich Edit 3.0, il testo viene visualizzato con una sottolineatura solida. |
|
Testo sottolineato con una doppia riga. Il controllo di modifica avanzato visualizza il testo con una sottolineatura solida. |
|
Visualizza come CFU_UNDERLINEWAVE. |
|
Visualizza come CFU_UNDERLINE. |
|
Visualizza come CFU_UNDERLINEWAVE. |
|
Visualizza come CFU_UNDERLINEDASH. |
|
Nessuna sottolineatura. Questo è il valore predefinito. |
|
Visualizza come CFU_UNDERLINE. |
|
Visualizza come CFU_UNDERLINEDASH. |
|
Visualizza come CFU_UNDERLINEDASHDOT. |
|
Visualizza come CFU_UNDERLINEDASHDOT. |
|
Visualizza come CFU_UNDERLINEDOT. |
|
Visualizza come CFU_UNDERLINEDASH. |
|
RichEdit 4.1 e versioni successive: testo sottolineato con una linea ondulata. |
|
RichEdit 4.1 e versioni successive: sottolinea solo le parole. Il controllo di modifica avanzato visualizza il testo con una sottolineatura solida. |
bAnimation
Tipo: BYTE
Tipo di animazione di testo. Questo valore non ha alcun effetto sul testo visualizzato da un controllo di modifica avanzato; è incluso per la compatibilità con le interfacce TOM. Per usare questo membro, impostare il flag CFM_ANIMATION nel membro dwMask .
bRevAuthor
Tipo: BYTE
Indice che identifica l'autore che effettua una revisione. Il controllo di modifica avanzato usa colori di testo diversi per ogni indice di 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;
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 CHARFORMAT2 come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante 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
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per