Freigeben über


PARAFORMAT2 Struktur (richedit.h)

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 eine der beiden 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;
};

Erbschaft

Die PARAFORMAT2 Struktur implementiert _paraformat.

Angehörige

dySpaceBefore

Typ: LONG

Größe des Abstands oberhalb des Absatzes in Twips. Um dieses Element zu verwenden, legen Sie das PFM_SPACEBEFORE Flag im dwMask Mitglied fest. Der Wert muss größer oder gleich Null 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 Member fest. Der Wert muss größer oder gleich Null sein.

dyLineSpacing

Typ: LONG

Abstand zwischen Zeilen. Eine Beschreibung der Interpretation dieses Werts finden Sie im bLineSpacingRule Member. Um dieses Element zu verwenden, legen Sie das PFM_LINESPACING Flag im dwMask Member fest.

sStyle

Typ: SHORT

Textformatvorlage. Um dieses Element zu verwenden, legen Sie das PFM_STYLE Flag im dwMask--Element fest. Dieses Mitglied ist nur zur Kompatibilität mit TOM-Schnittstellen und Word enthalten; Das Rich Edit-Steuerelement speichert den Wert, verwendet ihn jedoch nicht zum Anzeigen des Texts.

bLineSpacingRule

Typ: BYTE-

Typ des Zeilenabstands. Um dieses Element zu verwenden, legen Sie das PFM_LINESPACING Flag im dwMask Member fest. Dieses Element kann einer der folgenden Werte sein:

Wert Bedeutung
0
Einzelner Abstand. Das dyLineSpacing Member wird ignoriert.
1
Eineinhalb Abstände. Das dyLineSpacing Member wird ignoriert.
2
Doppelter Abstand. Das dyLineSpacing Member wird ignoriert.
3
Der dyLineSpacing Member gibt den Abstand zwischen einer Zeile und der nächsten zeile in Twips an. Wenn dyLineSpacing jedoch einen Wert angibt, der kleiner als ein einzelner Abstand ist, zeigt das Steuerelement Text mit einem Leerzeichen an.
4
Der dyLineSpacing Member gibt den Abstand zwischen einer Zeile und der 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 zwischen einer Zeile und der nächsten Zeile. Das Festlegen von dyLineSpacing auf 20 erzeugt einen einfachen Text, 40 ist doppelter Abstand, 60 ist dreifacher Abstand usw.

bOutlineLevel

Typ: BYTE-

Reserviert; muss null sein.

wShadingWeight

Typ: WORD-

Prozentsatz der Vordergrundfarbe, die in der Schattierung verwendet wird. Das wShadingStyle Member gibt die Vordergrund- und Hintergrundschattierungsfarben an. Ein Wert von 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 Mitglied ist nur zur 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. Bits 0 bis 3 enthalten die Schattierungsart, Bits 4 bis 7 enthalten den Vordergrundfarbindex, und Bits 8 bis 11 enthalten den Hintergrundfarbindex. Um dieses Element zu verwenden, legen Sie das PFM_SHADING Flag im dwMask Member fest. Dieses Mitglied ist nur zur Kompatibilität mit Word enthalten; Das Rich Edit-Steuerelement speichert den Wert, verwendet ihn jedoch nicht zum Anzeigen des Texts.

Die Schattierungsart kann einen der folgenden Werte aufweisen.

Wert Bedeutung
0
Nichts
1
Dunkel horizontal
2
Dunkel vertikal
3
Diagonal dunkel unten
4
Diagonal nach oben dunkel
5
Dunkles Raster
6
Dunkle Gittergitter
7
Hell horizontal
8
Hell vertikal
9
Diagonal hell nach unten
10
Diagonal nach oben
11
Helles Raster
12
Helle Trellis
 

Die Vordergrund- und Hintergrundfarbindizes können einen der folgenden Werte aufweisen.

Wert Bedeutung
0
Schwarz
1
Blau
2
Zyan
3
Grün
4
Magenta
5
Rot
6
Gelb
7
Weiß
8
Dunkelblau
9
Dunkles Zyan
10
Dunkelgrün
11
Dunkle 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 dieses Element in Verbindung mit dem wNumbering Member. Dieses Mitglied ist nur zur Kompatibilität mit TOM-Schnittstellen enthalten; Das Rich Edit-Steuerelement speichert den Wert, verwendet ihn jedoch nicht, um den Text oder die Aufzählungszeichen anzuzeigen. Um dieses Element zu verwenden, legen Sie das PFM_NUMBERINGSTART Flag im dwMask Member fest.

wNumberingStyle

Typ: WORD-

Nummerierungsformatvorlage, die mit nummerierten Absätzen verwendet wird. Verwenden Sie dieses Element in Verbindung mit dem wNumbering Member. Dieses Mitglied ist nur zur 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 die Aufzählungszeichen anzuzeigen. Um dieses Element zu verwenden, legen Sie das PFM_NUMBERINGSTYLE Flag im dwMask Member fest. Dieses Element 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 Nummer 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 dieses Element in Verbindung mit dem wNumbering Member. Das wNumberingTab Member ist für die 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-

Der Abstand zwischen dem Rahmen und dem Absatztext in Twips. Das wBorderSpace Mitglied 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 Member fest.

wBorderWidth

Typ: WORD-

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

wBorders

Typ: WORD-

Rahmenposition, Formatvorlage und Farbe. Bits 0 bis 7 geben die Rahmenpositionen an, Bits 8 bis 11 geben die Rahmenart an, und Bits 12 bis 15 geben den Rahmenfarbindex an. Um dieses Element zu verwenden, legen Sie das PFM_BORDER Flag im dwMask Member fest.

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

Wert Bedeutung
1
Linker Rahmen.
2
Rechter Rahmen.
4
Oberer Rahmen.
8
Unterer Rahmen.
16
Innenrahmen.
32
Außenrahmen.
64
Autocolor. Wenn dieses Bit festgelegt ist, wird der Farbindex in Bits 12 bis 15 nicht verwendet.
 

Geben Sie die Rahmenart mit einem der folgenden Werte für Bits 8 bis 11 an.

Wert Bedeutung
0
Nichts
1
3/4 Punkt
2
11/2 Punkt
3
21/4 Punkt
4
3 Punkt
5
41/2 Punkt
6
6 Punkt
7
3/4 Punkt doppelt
8
11/2 Punkt doppelt
9
21/4 Punkt doppelt
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
Zyan
3
Grün
4
Magenta
5
Rot
6
Gelb
7
Weiß
8
Dunkelblau
9
Dunkles Zyan
10
Dunkelgrün
11
Dunkle Magenta
12
Dunkelrot
13
Dunkelgelb
14
Dunkelgrau
15
Hellgrau

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server- Windows Server 2003 [Nur Desktop-Apps]
Header- richedit.h

Siehe auch

EM_GETPARAFORMAT

EM_SETPARAFORMAT

PARAFORMAT-