PARAFORMAT2-Struktur (Rich Edit 2.0)
Enthält Informationen zu Absatzformatierungsattributen in einem umfangreichen Bearbeitungssteuerelement. PARAFORMAT2 ist eine Microsoft Rich Edit 2.0-Erweiterung der PARAFORMAT-Struktur . Mit Microsoft Rich Edit 2.0 können Sie beide Strukturen mit den EM_GETPARAFORMAT - und EM_SETPARAFORMAT-Nachrichten verwenden.
Syntax
typedef struct _paraformat2 {
UINT cbSize;
DWORD dwMask;
WORD wNumbering;
union {
WORD wReserved;
WORD wEffects;
};
LONG dxStartIndent;
LONG dxRightIndent;
LONG dxOffset;
WORD wAlignment;
SHORT cTabCount;
LONG rgxTabs[MAX_TAB_STOPS];
LONG dySpaceBefore;
LONG dySpaceAfter;
LONG dyLineSpacing;
SHORT sStyle;
BYTE bLineSpacingRule;
BYTE bOutlineLevel;
WORD wShadingWeight;
WORD wShadingStyle;
WORD wNumberingStart;
WORD wNumberingStyle;
WORD wNumberingTab;
WORD wBorderSpace;
WORD wBorderWidth;
WORD wBorders;
} PARAFORMAT2;
Member
cbSize
Typ: UINT
Strukturgröße in Byte. Bevor Sie diese Struktur an ein umfangreiches Bearbeitungssteuerelement übergeben, legen Sie cbSize auf die Größe der PARAFORMAT - oder PARAFORMAT2-Struktur fest. Wenn cbSize der Größe einer PARAFORMAT-Struktur entspricht, verwendet das Steuerelement nur die PARAFORMAT-Member .
dwMask
Typ: DWORD
Die Member der PARAFORMAT2-Struktur , die gültige Informationen enthalten. Das dwMask-Element kann eine Kombination der Werte aus zwei Sätzen von Bitflags sein. Ein Satz gibt die gültigen Strukturmber an. ein anderer Satz gibt die gültigen Attribute im wEffects-Element an.
Legen Sie die folgenden Werte fest, um die gültigen Strukturmember anzugeben.
Legen Sie die folgenden Werte fest, um die gültigen Attribute des wEffects-Elements anzugeben.
wNumbering
Typ: WORD
Optionen, die für Aufzählungszeichen oder nummerierte Absätze verwendet werden. Um dieses Element zu verwenden, legen Sie das flag PFM_NUMBERING im dwMask-Element fest.
Dieser Member kann einer der folgenden Werte sein.
| Wert | Bedeutung |
|---|---|
|
Keine Absatznummerierung oder Aufzählungszeichen. |
|
Fügen Sie am Anfang jedes ausgewählten Absatzes ein Aufzählungszeichen ein. |
Rich Edit-Versionen vor Version 3.0 zeigen keine Absatznummern an. Aus Gründen der Kompatibilität mit Microsoft Text Object Model (TOM)-Schnittstellen kann wNumbering jedoch einen der folgenden Werte angeben. (Das Rich-Edit-Steuerelement speichert den Wert, verwendet ihn jedoch nicht, um den Text anzuzeigen.)
wReserved
wEffects
Typ: WORD
Dieser Member wird auch als wReserved für Microsoft Rich Edit 1.0 bezeichnet, da es reserviert war.
Rich Edit 1.0: Reserviert; der Wert muss 0 (null) sein.
Rich Edit 2.0: Eine Reihe von Bitflags, die Absatzeffekte angeben. Diese Flags sind nur aus Gründen der Kompatibilität mit TOM-Schnittstellen enthalten. Das Rich-Edit-Steuerelement speichert den Wert, verwendet ihn jedoch nicht, um den Text anzuzeigen.
Dieser Member kann eine Kombination der folgenden Werte sein.
dxStartIndent
Typ: LONG
Einzug der ersten Zeile des Absatzes in Twips. Der Einzug der nachfolgenden Zeilen hängt vom dxOffset-Element ab. Um das dxStartIndent-Element zu verwenden, legen Sie das flag PFM_STARTINDENT oder PFM_OFFSETINDENT im dwMask-Element fest. Wenn Sie den Einzug festlegen, verwenden Sie das Flag PFM_STARTINDENT, um einen absoluten Einzug vom linken Rand anzugeben. oder verwenden Sie das flag PFM_OFFSETINDENT, um einen Einzug relativ zum aktuellen Einzug des Absatzes anzugeben. Verwenden Sie beide Flags, um den aktuellen Einzug abzurufen.
dxRightIndent
Typ: LONG
Einzug der rechten Seite des Absatzes relativ zum rechten Rand in Twips. Um dieses Element zu verwenden, legen Sie das flag PFM_RIGHTINDENT im dwMask-Element fest.
dxOffset
Typ: LONG
Einzug der zweiten und nachfolgenden Zeilen relativ zum Einzug der ersten Zeile in Twips. Die erste Zeile wird eingerückt, wenn dieses Element negativ ist, oder wenn dieser Member positiv ist. Um dieses Element zu verwenden, legen Sie das flag PFM_OFFSET im dwMask-Element fest.
wAlignment
Typ: WORD
Absatzausrichtung. Um dieses Element zu verwenden, legen Sie das flag PFM_ALIGNMENT im dwMask-Element fest. Dieser Member kann einer der folgenden Werte sein.
cTabCount
Typ: SHORT
Anzahl der im rgxTabs-Array definierten Tabstopps .
rgxTabs[MAX_TAB_STOPS]
Typ: LONG
Array von absoluten Tabstopppositionen. Jedes Element im Array gibt Informationen zu einem Tabstopp an. Die 24 Bits niedriger Ordnung geben den absoluten Offset in Twips an. Um dieses Element zu verwenden, legen Sie das flag PFM_TABSTOPS im dwMask-Element fest.
Rich Edit 2.0: Aus Gründen der Kompatibilität mit TOM-Schnittstellen können Sie die acht Bits mit hoher Reihenfolge verwenden, um zusätzliche Informationen zu jedem Tabstopp zu speichern.
Die Bits 24-27 können einen der folgenden Werte angeben, um die Registerkartenausrichtung anzugeben. Diese Bits wirken sich nicht auf die Anzeige des Rich Edit-Steuerelements für Versionen vor Microsoft Rich Edit 3.0 aus.
| Wert | Bedeutung |
|---|---|
|
Registerkarte "Normal" |
|
Zentrierregisterkarte |
|
Rechtsbündige Registerkarte |
|
Registerkarte "Dezimal" |
|
Word Balkenregisterkarte (vertikaler Balken) |
Die Bits 28-31 können einen der folgenden Werte angeben, um den Typ der Registerkartenführung anzugeben. Diese Bits wirken sich nicht auf die Anzeige des umfangreichen Bearbeitungssteuerelements aus.
| Wert | Bedeutung |
|---|---|
|
Kein Anführer |
|
Gepunktete Führungsspitze |
|
Gestrichelter Leiter |
|
Unterstrichene Führungsperson |
|
Dicker Linienvorrang |
|
Doppelzeilenleiter |
dySpaceBefore
Typ: LONG
Größe des Abstands über dem Absatz in Twips. Um dieses Element zu verwenden, legen Sie das PFM_SPACEBEFORE-Flag im dwMask-Element fest. Der Wert muss größer oder gleich 0 sein.
dySpaceAfter
Typ: LONG
Gibt die Größe des Abstands unterhalb des Absatzes in Twips an. Um dieses Element zu verwenden, legen Sie das PFM_SPACEAFTER-Flag im dwMask-Element fest. Der Wert muss größer oder gleich 0 sein.
dyLineSpacing
Typ: LONG
Abstand zwischen Den Zeilen. Eine Beschreibung der Interpretation dieses Werts finden Sie im Element bLineSpacingRule . Um dieses Element zu verwenden, legen Sie das PFM_LINESPACING-Flag im dwMask-Element fest.
sStyle
Typ: SHORT
Textformat Um dieses Element zu verwenden, legen Sie das PFM_STYLE-Flag im dwMask-Element fest. Dieses Element ist nur aus Gründen der Kompatibilität mit TOM-Schnittstellen und Word enthalten. Das Rich-Edit-Steuerelement speichert den Wert, verwendet es jedoch nicht zum Anzeigen des Texts.
bLineSpacingRule
Typ: BYTE
Art des Zeilenabstands. Um dieses Element zu verwenden, legen Sie das PFM_LINESPACING-Flag im dwMask-Element fest. Dieser Member kann einer der folgenden Werte sein.
bOutlineLevel
Typ: BYTE
Reserviert; muss null sein.
wShadingWeight
Typ: WORD
Prozentsatz der Vordergrundfarbe, die bei Schattierung verwendet wird. Das wShadingStyle-Element gibt die Vordergrund- und Hintergrundschattierungsfarben an. Der Wert 5 gibt eine Schattierungsfarbe an, die aus 5 Prozent Vordergrundfarbe und 95 Prozent Hintergrundfarbe besteht. Um diese Member zu verwenden, legen Sie das PFM_SHADING-Flag im dwMask-Element fest. Dieses Element ist nur aus Gründen der Kompatibilität mit Word enthalten. Das Rich-Edit-Steuerelement speichert den Wert, verwendet ihn jedoch nicht zum Anzeigen des Texts.
wShadingStyle
Typ: WORD
Stil und Farben, die für die Hintergrundschattierung verwendet werden. Die Bits 0 bis 3 enthalten die Schattierungsart, die Bits 4 bis 7 den Vordergrundfarbindex und die Bits 8 bis 11 den Hintergrundfarbindex. Um dieses Element zu verwenden, legen Sie das PFM_SHADING-Flag im dwMask-Element fest. Dieses Element ist nur aus Gründen der Kompatibilität mit Word enthalten. Das Rich-Edit-Steuerelement speichert den Wert, verwendet ihn jedoch nicht zum Anzeigen des Texts.
Der Schattierungsstil kann einer der folgenden Werte sein.
Die Vordergrund- und Hintergrundfarbindizes können einer der folgenden Werte sein.
| Wert | Bedeutung |
|---|---|
|
Schwarz |
|
Blau |
|
Cyan |
|
Grün |
|
Magenta |
|
Red |
|
Gelb |
|
Weiß |
|
Dunkelblau |
|
Dunkles Cyan |
|
Dunkelgrün |
|
Dunkler Magenta |
|
Dunkelrot |
|
Dunkelgelb |
|
Dunkelgrau |
|
Hellgrau |
wNumberingStart
Typ: WORD
Startnummer oder Unicode-Wert, der für nummerierte Absätze verwendet wird. Verwenden Sie dieses Element in Verbindung mit dem wNumbering-Member . Dieses Member ist nur aus Gründen der Kompatibilität mit TOM-Schnittstellen enthalten. das Rich-Edit-Steuerelement speichert den Wert, verwendet ihn jedoch nicht zum Anzeigen von Text oder Aufzählungszeichen. Um dieses Element zu verwenden, legen Sie das PFM_NUMBERINGSTART-Flag im dwMask-Element fest.
wNumberingStyle
Typ: WORD
Nummerierungsformat, das mit nummerierten Absätzen verwendet wird. Verwenden Sie dieses Element in Verbindung mit dem wNumbering-Member . Dieses Member ist nur aus Gründen der Kompatibilität mit TOM-Schnittstellen enthalten. das Rich-Edit-Steuerelement speichert den Wert, aber Rich-Bearbeitungsversionen vor 3.0 verwenden es nicht, um den Text oder Aufzählungszeichen anzuzeigen. Um dieses Element zu verwenden, legen Sie das PFM_NUMBERINGSTYLE-Flag im dwMask-Element fest. Dieser Member kann einer der folgenden Werte sein.
wNumberingTab
Typ: WORD
Mindestabstand zwischen einer Absatznummer und dem Absatztext in Twips. Verwenden Sie dieses Element in Verbindung mit dem wNumbering-Member . Das wNumberingTab-Element ist aus Gründen der Kompatibilität mit TOM-Schnittstellen enthalten. vor Microsoft Rich Edit 3.0 speichert das Rich-Edit-Steuerelement den Wert, verwendet ihn jedoch nicht zum Anzeigen von Text. Um dieses Element zu verwenden, legen Sie das PFM_NUMBERINGTAB-Flag im dwMask-Element fest.
wBorderSpace
Typ: WORD
Das Leerzeichen zwischen dem Rahmen und dem Absatztext in Twips. Das wBorderSpace-Element ist aus Gründen der Kompatibilität mit Word enthalten. Das Rich-Edit-Steuerelement speichert die Werte, verwendet sie jedoch nicht zum Anzeigen von Text. Um dieses Element zu verwenden, legen Sie das PFM_BORDER-Flag im dwMask-Element fest.
wBorderWidth
Typ: WORD
Rahmenbreite in Twips. Um dieses Element zu verwenden, legen Sie das PFM_BORDER-Flag im dwMask-Element fest.
wBorders
Typ: WORD
Rahmenort, Format und Farbe. Die Bits 0 bis 7 geben die Rahmenpositionen an, die Bits 8 bis 11 geben die Rahmenart an, und die Bits 12 bis 15 geben den Rahmenfarbindex an. Um dieses Element zu verwenden, legen Sie das PFM_BORDER-Flag im dwMask-Element fest.
Geben Sie die Rahmenpositionen mit einer Kombination der folgenden Werte in bits 0 bis 7 an.
Geben Sie die Rahmenart mit einem der folgenden Werte für die Bits 8 bis 11 an.
Geben Sie die Rahmenfarbe mit einem der folgenden Werte für bits 12 bis 15 an. Dieser Wert wird ignoriert, wenn das Autocolor-Bit (Bit 6) festgelegt ist.
| Wert | Bedeutung |
|---|---|
|
Schwarz |
|
Blau |
|
Cyan |
|
Grün |
|
Magenta |
|
Red |
|
Gelb |
|
Weiß |
|
Dunkelblau |
|
Dunkles Cyan |
|
Dunkelgrün |
|
Dunkler Magenta |
|
Dunkelrot |
|
Dunkelgelb |
|
Dunkelgrau |
|
Hellgrau |
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Kopfzeile | richedit.h |
Weitere Informationen
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für