PARAFORMAT2 Struktur (Rich Edit 2.0)

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

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;

Angehörige

cbSize

Typ: UINT-

Strukturgröße in Byte. Bevor Sie diese Struktur an ein Rich-Edit-Steuerelement ü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 Elemente der PARAFORMAT2 Struktur, die gültige Informationen enthalten. Das dwMask Member kann eine Kombination der Werte aus zwei Bit-Flags sein. Ein Satz gibt die gültigen Strukturmber an; Ein weiterer Satz gibt die gültigen Attribute im wEffects Member an.

Legen Sie die folgenden Werte fest, um die gültigen Strukturmber anzugeben.

Legen Sie die folgenden Werte fest, um die gültigen Attribute des wEffects Member anzugeben.

wNumbering

Typ: WORD-

Optionen, die für Aufzählungszeichen oder nummerierte Absätze verwendet werden. Um dieses Element zu verwenden, legen Sie das PFM_NUMBERING Flag im dwMask--Element fest.

Dieses Element kann einer der folgenden Werte sein:

Rich Edit-Versionen vor Version 3.0 zeigen keine Absatznummern an. Aus Gründen der Kompatibilität mit Microsoft Textobjektmodell- (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-

Dieses Element wird auch als wReserved- für Microsoft Rich Edit 1.0 bezeichnet, da es reserviert war.

Rich Edit 1.0: Reserviert; der Wert muss null sein.

Rich Edit 2.0: Eine Reihe von Bitkennzeichnungen, die Absatzeffekte angeben. Diese Flags sind nur zur Kompatibilität mit TOM-Schnittstellen enthalten; Das Rich Edit-Steuerelement speichert den Wert, verwendet ihn jedoch nicht zum Anzeigen des Texts.

Dieses Element kann eine Kombination aus den folgenden Werten sein.

dxStartIndent

Typ: LONG

Einzug der ersten Zeile des Absatzes in Twips. Der Einzug der nachfolgenden Zeilen hängt vom dxOffset Member ab. Um das dxStartIndent--Element zu verwenden, legen Sie das PFM_STARTINDENT- oder PFM_OFFSETINDENT-Flag im dwMask Member fest. Wenn Sie den Einzug festlegen, verwenden Sie das PFM_STARTINDENT Flag, um einen absoluten Einzug vom linken Rand anzugeben. oder verwenden Sie das PFM_OFFSETINDENT Flag, um einen Einzug relativ zum aktuellen Einzug des Absatzes anzugeben. Verwenden Sie beide Kennzeichnungen, 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 PFM_RIGHTINDENT Flag 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 eingezogen, wenn dieses Element negativ oder heruntergezogen ist, wenn dieses Element positiv ist. Um dieses Element zu verwenden, legen Sie das PFM_OFFSET Flag im dwMask Member fest.

wAlignment

Typ: WORD-

Absatzausrichtung. Um dieses Element zu verwenden, legen Sie das PFM_ALIGNMENT Flag im dwMask Member fest. Dieses Element kann einer der folgenden Werte sein:

cTabCount

Typ: SHORT

Anzahl der tabstopps, die in der rgxTabs Array definiert sind.

rgxTabs[MAX_TAB_STOPS]

Typ: LONG

Array von absoluten Tabstopppositionen. Jedes Element im Array gibt Informationen zu einem Tabstopp an. Die 24 Bit mit niedriger Reihenfolge geben den absoluten Offset in Twips an. Um dieses Element zu verwenden, legen Sie das PFM_TABSTOPS Flag im dwMask Member fest.

Rich Edit 2.0: Zur Kompatibilität mit TOM-Schnittstellen können Sie die acht Hochreihenfolgebits verwenden, um zusätzliche Informationen zu jedem Tabstopp zu speichern.

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.

Bits 28-31 können einen der folgenden Werte angeben, um den Typ des Füllzeichens anzugeben. Diese Bits wirken sich nicht auf die Anzeige des Rich-Edit-Steuerelements aus.

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:

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.

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

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:

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.

Geben Sie die Rahmenart mit einem der folgenden Werte für 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.

Anforderungen

Siehe auch

EM_GETPARAFORMAT

EM_SETPARAFORMAT

PARAFORMAT-