PARAFORMAT-Struktur (richedit.h)

  • Artikel

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 beide Strukturen mit EM_GETPARAFORMAT und EM_SETPARAFORMAT verwenden.

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;

Members

cbSize

Typ: UINT

Strukturgröße in Bytes. Das Element muss ausgefüllt werden, bevor sie an das Rich-Bearbeitungssteuerelement übergeben werden.

dwMask

Typ: DWORD

Member, 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-Element ist gültig.
PFM_NUMBERING
 Das wNumbering-Element ist gültig.
PFM_OFFSET
 Das dxOffset-Element ist gültig.
PFM_OFFSETINDENT
 Der dxStartIndent-Member ist gültig und gibt einen relativen Wert an.
PFM_RIGHTINDENT
 Das dxRightIndent-Element ist gültig.
PFM_RTLPARA
 Rich Edit 2.0: Der wEffects-Member ist gültig.
PFM_STARTINDENT
 Das dxStartIndent-Element ist gültig.
PFM_TABSTOPS
 Die Member cTabStobs und rgxTabStops sind gültig.

wNumbering

Typ: WORD

Wert, der Nummerierungsoptionen angibt. Dieser Member kann null oder PFN_BULLET sein.

wReserved

Typ: WORD

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

Rich Edit 2.0: Dieses Element heißt wEffects. Ein Bitflag, das einen Absatzeffekt angibt. Es 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 des Texts. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert Bedeutung
0
 Zeigt Text in der Lesereihenfolge von links nach rechts an. Dies ist die Standardoption.
PFE_RLTPARA
 Zeigt Text in der Lesereihenfolge von rechts nach links an.

wEffects

dxStartIndent

Typ: LONG

Einzug der ersten Zeile im Absatz in Twips. Wenn die Absatzformatierung festgelegt und PFM_OFFSETINDENT angegeben wird, wird dieser Member 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 eingerückt, wenn dieses Element negativ ist oder über einen Überrückungsdruck verfügt, wenn dieses Element positiv ist.

wAlignment

Typ: WORD

Wert, der die Absatzausrichtung angibt. Dieser Member kann einer der folgenden Werte sein.

Wert Bedeutung
PFA_CENTER
 Absätze sind 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 Bits niedriger Reihenfolge geben den absoluten Offset in Twips an. Um dieses Element zu verwenden, legen Sie das PFM_TABSTOPS-Flag 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.

Bits 24-27 kann 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
 Registerkarte "Normal"
1
 Registerkarte "Mitte"
2
 Rechtsbündige Registerkarte
3
 Registerkarte "Dezimal"
4
 Word Balkenregisterkarte (vertikaler Balken)
 

Bits 28-31 kann einen der folgenden Werte angeben, um den Typ der Registerkartenführer anzugeben. Diese Bits wirken sich nicht auf die Anzeige des Rich-Edit-Steuerelements aus.

Wert Bedeutung
0
 Keine Führungskraft
1
 Gepunktete Führungsspitze
2
 Gestrichelter Leiter
3
 Unterstrichene Führungsspitze
4
 Dicker Linienleiter
5
 Doppelzeilenführung

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

EM_GETPARAFORMAT

EM_SETPARAFORMAT

PARAFORMAT2

Referenz