PARAFORMAT-Struktur (richedit.h)

Enthält Informationen zu Absatzformatierungsattributen in einem Rich-Edit-Steuerelement. Diese Struktur wird mit den EM_GETPARAFORMAT und EM_SETPARAFORMAT Nachrichten verwendet.

In Microsoft Rich Edit 2.0 ist die PARAFORMAT2-Struktur eine Microsoft Rich Edit 2.0-Erweiterung der PARAFORMAT--Struktur. Mit Microsoft Rich Edit 2.0 können Sie eine der beiden Strukturen mit EM_GETPARAFORMAT und EM_SETPARAFORMATverwenden.

Syntax

typedef struct _paraformat {
  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];
} PARAFORMAT;

Angehörige

cbSize

Typ: UINT-

Strukturgröße in Byte. Das Element muss ausgefüllt werden, bevor es an das Rich-Edit-Steuerelement übergeben wird.

dwMask

Typ: DWORD-

Elemente, die gültige Informationen oder Attribute enthalten, die festgelegt werden sollen. Dieser Parameter kann keine oder eine Kombination der folgenden Werte sein. Wenn sowohl PFM_STARTINDENT als auch PFM_OFFSETINDENT angegeben werden, hat PFM_STARTINDENT Vorrang.

Wert Bedeutung
PFM_ALIGNMENT
Das wAlignment Member ist gültig.
PFM_NUMBERING
Das wNumbering Member ist gültig.
PFM_OFFSET
Der dxOffset- Member ist gültig.
PFM_OFFSETINDENT
Der dxStartIndent Member ist gültig und gibt einen relativen Wert an.
PFM_RIGHTINDENT
Der dxRightIndent Member ist gültig.
PFM_RTLPARA
Rich Edit 2.0: Das wEffects Member ist gültig.
PFM_STARTINDENT
Der dxStartIndent Member ist gültig.
PFM_TABSTOPS
Die cTabStobs und rgxTabStops Member sind gültig.

wNumbering

Typ: WORD-

Wert, der Nummerierungsoptionen angibt. Dieses Element kann null oder PFN_BULLET sein.

wReserved

Typ: WORD-

Rich Edit 1.0:: Dieses Mitglied heißt wReserved. Reserviert; der Wert muss null sein.

Rich Edit 2.0: Dieses Mitglied heißt wEffects. Eine Bitkennzeichnung, die einen Absatzeffekt angibt. Es ist nur zur Kompatibilität mit TOM-Schnittstellen enthalten; Das Rich Edit-Steuerelement speichert den Wert, verwendet ihn jedoch nicht zum Anzeigen des Texts. Dieser Parameter kann einer der folgenden Werte sein:

Wert Bedeutung
0
Zeigt Text mit Leserichtung von links nach rechts an. Dies ist die Standardeinstellung.
PFE_RLTPARA
Zeigt Text mit Leserichtung von rechts nach links an.

wEffects

dxStartIndent

Typ: LONG

Einzug der ersten Zeile im Absatz in Twips. Wenn die Absatzformatierung festgelegt wird und PFM_OFFSETINDENT angegeben wird, wird dieses Element als relativer Wert behandelt, der dem Anfangseinzug jedes betroffenen Absatzes hinzugefügt wird.

dxRightIndent

Typ: LONG

Größe des rechten Einzugs relativ zum rechten Rand in Twips.

dxOffset

Typ: LONG

Einzug der zweiten und nachfolgenden Zeilen eines Absatzes relativ zum Anfangseinzug in Twips. Die erste Zeile wird eingezogen, wenn dieses Element negativ oder heruntergezogen ist, wenn dieses Element positiv ist.

wAlignment

Typ: WORD-

Wert, der die Absatzausrichtung angibt. Dieses Element kann einer der folgenden Werte sein:

Wert Bedeutung
PFA_CENTER
Absätze werden zentriert.
PFA_LEFT
Absätze werden am linken Rand ausgerichtet.
PFA_RIGHT
Absätze werden am rechten Rand ausgerichtet.

cTabCount

Typ: SHORT

Anzahl der Tabstopps.

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.

Wert Bedeutung
0
Normale Registerkarte
1
Zentrierregisterkarte
2
Rechtsbündige Registerkarte
3
Dezimalregisterkarte
4
Word-Leistenregisterkarte (vertikale Leiste)
 

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.

Wert Bedeutung
0
Kein Füllzeichen
1
Gepunkteter Füllzeichen
2
Gestricheltes Führungszeichen
3
Unterstrichene Füllzeichen
4
Dicker Linienleiter
5
Füllzeichen doppelter Linie

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

PARAFORMAT2

Referenz-