PARAFORMAT2 Struktur (richedit.h)

  • Artikel

Enthält Informationen zu Absatzformatierungsattributen in einem Rich-Edit-Steuerelement. 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

struct PARAFORMAT2 : _paraformat {
  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;
};

Vererbung

Die PARAFORMAT2-Struktur implementiert _paraformat.

Member

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.

Wert Bedeutung
0
 Einzelner Abstand. Das dyLineSpacing-Element wird ignoriert.
1
 Anderthalb Abstände. Das dyLineSpacing-Element wird ignoriert.
2
 Doppelter Abstand. Das dyLineSpacing-Element wird ignoriert.
3
 Das dyLineSpacing-Element gibt den Abstand von einer Zeile zur nächsten in twips an. Wenn dyLineSpacing jedoch einen Wert angibt, der kleiner als ein einzelner Abstand ist, zeigt das Steuerelement Text mit einem einzelnen Abstand an.
4
 Das dyLineSpacing-Element gibt den Abstand von einer Zeile zur nächsten in twips an. Das Steuerelement verwendet den genauen angegebenen Abstand, auch wenn dyLineSpacing einen Wert angibt, der kleiner als ein einzelner Abstand ist.
5
 Der Wert von dyLineSpacing /20 ist der Abstand in Zeilen von einer Zeile zur nächsten. Daher erzeugt das Festlegen von dyLineSpacing auf 20 einen einzelnen Text, 40 einen doppelten Abstand, 60 einen dreifachen Abstand usw.

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.

Wert Bedeutung
0
 Keine
1
 Dunkel horizontal
2
 Dunkel vertikal
3
 Abdunken diagonal
4
 Diagonal dunkel
5
 Dunkles Raster
6
 Dunkle Spaliers
7
 Horizontales Licht
8
 Vertikales Licht
9
 Diagonales Licht nach unten
10
 Diagonales Licht
11
 Lichtgitter
12
 Lichtgitter
 

Die Vordergrund- und Hintergrundfarbindizes können einer der folgenden Werte sein.

Wert Bedeutung
0
 Schwarz
1
 Blau
2
 Cyan
3
 Grün
4
 Magenta
5
 Red
6
 Gelb
7
 Weiß
8
 Dunkelblau
9
 Dunkles Zyan
10
 Dunkelgrün
11
 Dunkles Magenta
12
 Dunkelrot
13
 Dunkelgelb
14
 Dunkelgrau
15
 Hellgrau

wNumberingStart

Typ: WORD

Startnummer oder Unicode-Wert, der für nummerierte Absätze verwendet wird. Verwenden Sie diesen Member in Verbindung mit dem wNumbering-Member . Dieser 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 flag PFM_NUMBERINGSTART im dwMask-Element fest.

wNumberingStyle

Typ: WORD

Nummerierungsformat, das mit nummerierten Absätzen verwendet wird. Verwenden Sie diesen Member in Verbindung mit dem wNumbering-Member . Dieser Member ist nur aus Gründen der Kompatibilität mit TOM-Schnittstellen enthalten. Das Rich-Edit-Steuerelement speichert den Wert, aber Rich Edit-Versionen vor 3.0 verwenden es nicht, um den Text oder Aufzählungszeichen anzuzeigen. Um dieses Element zu verwenden, legen Sie das flag PFM_NUMBERINGSTYLE im dwMask-Element fest. Dieser Member kann einer der folgenden Werte sein.

Wert Bedeutung
PFNS_PAREN
 Folgt der Zahl mit einer rechten Klammer.
PFNS_PARENS
 Schließt die Zahl in Klammern ein.
PFNS_PERIOD
 Folgt der Zahl mit einem Punkt.
PFNS_PLAIN
 Zeigt nur die Zahl an.
PFNS_NONUMBER
 Setzt eine nummerierte Liste fort, ohne die nächste Zahl oder das nächste Aufzählungszeichen anzuwenden.
PFNS_NEWNUMBER
 Startet eine neue Zahl mit wNumberingStart.

wNumberingTab

Typ: WORD

Minimaler Abstand zwischen einer Absatznummer und dem Absatztext in Twips. Verwenden Sie diesen Member 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 flag PFM_NUMBERINGTAB im dwMask-Element fest.

wBorderSpace

Typ: WORD

Der Abstand 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 flag PFM_BORDER im dwMask-Element fest.

wBorderWidth

Typ: WORD

Rahmenbreite in Twips. Um dieses Element zu verwenden, legen Sie das flag PFM_BORDER im dwMask-Element fest.

wBorders

Typ: WORD

Rahmenposition, Stil 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 flag PFM_BORDER im dwMask-Element fest.

Geben Sie die Rahmenpositionen mithilfe einer Kombination der folgenden Werte in den Bits 0 bis 7 an.

Wert Bedeutung
1
 Linker Rahmen.
2
 Rechter Rahmen.
4
 Oberer Rahmen.
8
 Unterer Rahmen.
16
 Innerhalb von Rändern.
32
 Außerhalb der Grenzen.
64
 Automatisches Einfärben. Wenn dieses Bit festgelegt ist, wird der Farbindex in den Bits 12 bis 15 nicht verwendet.
 

Geben Sie das Rahmenformat mit einem der folgenden Werte für bits 8 bis 11 an.

Wert Bedeutung
0
 Keine
1
 3/4 Punkt
2
 11/2 Nummer
3
 21/4 Punkt
4
 3 Punkt
5
 41/2 Nummer
6
 6 Punkt
7
 3/4 Punkt double
8
 11/2 Punkt double
9
 21/4 Punkt double
10
 3/4 Punkt grau
11
 3/4 Punkt grau gestrichelt
 

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
0
 Schwarz
1
 Blau
2
 Cyan
3
 Grün
4
 Magenta
5
 Red
6
 Gelb
7
 Weiß
8
 Dunkelblau
9
 Dunkles Zyan
10
 Dunkelgrün
11
 Dunkles Magenta
12
 Dunkelrot
13
 Dunkelgelb
14
 Dunkelgrau
15
 Hellgrau

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Kopfzeile richedit.h

Weitere Informationen

EM_GETPARAFORMAT

EM_SETPARAFORMAT

PARAFORMAT