ITextPara-Schnittstelle (tom.h)

Der Zugriff auf die Rich-Text-Bereichsattribute (Text Object Model, TOM) erfolgt über ein Paar von dualen Schnittstellen, ITextFont und ITextPara.

Vererbung

Die ITextPara-Schnittstelle erbt von der IDispatch-Schnittstelle . ITextPara verfügt auch über folgende Arten von Membern:

Methoden

Die ITextPara-Schnittstelle verfügt über diese Methoden.

ITextPara::AddTab Fügt eine Registerkarte auf der Verschiebung tbPos mit dem Typ tbAlign und dem Leader-Stil tbLeader hinzu.
ITextPara::CanChange Bestimmt, ob die Absatzformatierung geändert werden kann.
ITextPara::ClearAllTabs Löscht alle Registerkarten, und kehrt mit dem Standardregisterkartenabstand wieder auf tabs mit gleichem Abstand zurück.
ITextPara::D eleteTab Löscht eine Registerkarte bei einer angegebenen Verschiebung.
ITextPara::GetAlignment Ruft den aktuellen Absatzausrichtungswert ab.
ITextPara::GetDuplicate Erstellt ein Duplikat des angegebenen Absatzformatobjekts. Die doppelte Eigenschaft ist die Standardeigenschaft eines ITextPara-Objekts.
ITextPara::GetFirstLineIndent Ruft den Betrag ab, der zum Einzug der ersten Zeile eines Absatzes relativ zum linken Einzug verwendet wird. Der linke Einzug ist der Einzug für alle Zeilen des Absatzes mit Ausnahme der ersten Zeile.
ITextPara::GetHyphenation Bestimmt, ob die automatische Silbentrennung für den Bereich aktiviert ist.
ITextPara::GetKeepTogether Bestimmt, ob Seitenumbrüche innerhalb von Absätzen zulässig sind.
ITextPara::GetKeepWithNext Bestimmt, ob Seitenumbrüche zwischen Absätzen im Bereich zulässig sind.
ITextPara::GetLeftIndent Ruft den Abstand ab, der zum Einrücken aller Zeilen mit Ausnahme der ersten Zeile eines Absatzes verwendet wird. Der Abstand ist relativ zum linken Rand.
ITextPara::GetLineSpacing Ruft den Zeilenabstandswert für den Textbereich ab.
ITextPara::GetLineSpacingRule Ruft die Zeilenabstandsregel für den Textbereich ab.
ITextPara::GetListAlignment Ruft die Art der Ausrichtung ab, die für Aufzählungszeichen und nummerierte Listen verwendet werden soll.
ITextPara::GetListLevelIndex Ruft den Index auf Listenebene ab, der mit Absätzen verwendet wird.
ITextPara::GetListStart Ruft den Startwert oder Code einer Listennummerierungssequenz ab.
ITextPara::GetListTab Ruft die Einstellung der Listenregisterkarte ab, d. h. der Abstand zwischen dem ersten Zeileneinzug und dem Text in der ersten Zeile. Der nummerierte Oder Aufzählungstext ist linksrechtig, zentriert oder rechtsgeschützt am Ersten-Zeilen-Einzugswert.
ITextPara::GetListType Ruft die Art der Nummerierung ab, die mit Absätzen verwendet werden soll.
ITextPara::GetNoLineNumber Bestimmt, ob die Absatznummerierung aktiviert ist.
ITextPara::GetPageBreakBefore Bestimmt, ob jeder Absatz im Bereich auf einer neuen Seite beginnen muss.
ITextPara::GetRightIndent Ruft die Größe des rechten Randeinzugs eines Absatzes ab.
ITextPara::GetSpaceAfter Ruft die Menge des vertikalen Abstands unter einem Absatz ab.
ITextPara::GetSpaceBefore Ruft die Menge des vertikalen Abstands über einem Absatz ab.
ITextPara::GetStyle Ruft das Formathandle zu den Absätzen im angegebenen Bereich ab.
ITextPara::GetTab Ruft Registerkartenparameter (Verschiebung, Ausrichtung und Führungsstil) für eine angegebene Registerkarte ab.
ITextPara::GetTabCount Ruft die Registerkartenanzahl ab.
ITextPara::GetWidowControl Ruft den Witwen- und verwaisten Kontrollstatus für die Absätze in einem Bereich ab.
ITextPara::Isequal Bestimmt, ob der aktuelle Bereich die gleichen Eigenschaften wie ein angegebener Bereich aufweist.
ITextPara::Reset Setzt die Absatzformatierung auf eine Auswahl von Standardwerten zurück.
ITextPara::SetAlignment Legt die Absatzausrichtung fest.
ITextPara::SetDuplicate Legt die Formatierung für einen vorhandenen Absatz fest, indem ein bestimmtes Format kopiert wird.
ITextPara::SetHyphenation Steuert die Silbentrennung für die Absätze im Bereich.
ITextPara::SetIndents Legt den Einzug der ersten Zeile, den linken Einzug und den rechten Einzug für einen Absatz fest.
ITextPara::SetKeepTogether Steuert, ob Seitenumbrüche innerhalb eines Absatzes in einem Bereich zulässig sind.
ITextPara::SetKeepWithNext Steuert, ob Seitenumbrüche zwischen den Absätzen in einem Bereich zulässig sind.
ITextPara::SetLineSpacing Legt die Absatzzeilenabstandsregel und den Zeilenabstand für einen Absatz fest.
ITextPara::SetListAlignment Legt die Ausrichtung von Aufzählungszeichen oder nummeriertem Text fest, der für Absätze verwendet wird.
ITextPara::SetListLevelIndex Legt den Index auf Listenebene fest, der für Absätze verwendet wird.
ITextPara::SetListStart Legt die Startnummer oder den Unicode-Wert für eine nummerierte Liste fest.
ITextPara::SetListTab Legt die Einstellung der Listenregisterkarte fest, d. h. der Abstand zwischen dem ersten Einzug und dem Anfang des Texts in der ersten Zeile.
ITextPara::SetListType Legt den Listentyp fest, der für Absätze verwendet werden soll.
ITextPara::SetNoLineNumber Bestimmt, ob die Zeilennummerierung von Absätzen in einem Bereich unterdrückt werden soll.
ITextPara::SetPageBreakBefore Steuert, ob vor jedem Absatz in einem Bereich ein Seitenwechsel vorhanden ist.
ITextPara::SetRightIndent Legt den rechten Rand des Absatzes fest.
ITextPara::SetSpaceAfter Legt den Speicherplatz fest, der einem Absatz folgt.
ITextPara::SetSpaceBefore Legt den Platz vor einem Absatz fest.
ITextPara::SetStyle Legt die Absatzformatvorlage für die Absätze in einem Bereich fest.
ITextPara::SetWidowControl Steuert die Unterdrückung von Witwen und Waisen.

Hinweise

Die Schnittstellen ITextFont und ITextPara kapseln die Funktionalität der Dialogfelder Microsoft Word Format Font bzw. Absatz. Beide Schnittstellen enthalten eine doppelte Eigenschaft (Value), die ein Duplikat der Attribute in einem Bereichsobjekt zurückgeben oder einen Satz von Attributen in einen Bereich übertragen kann. Daher wirken sie wie programmierbare Formatmaler. Sie könnten beispielsweise alle Attribute aus dem Bereich r1 in den Bereich r2 übertragen, mit Ausnahme von r2 fett und der Schriftgrad 12 Punkte, indem Sie die folgende Unterroutine verwenden.

Sub AttributeCopy(r1 As ITextRange, r2 As ITextRange)
    Dim tf As ITextFont
    tf = r1.Font                ' Value is the default property    
    tf.Bold = tomTrue           ' You can make some modifications
    tf.Size = 12
    tf.Animation = tomSparkleText
    r2.Font = tf                ' Apply font attributes all at once
End Sub

Ein ähnliches Beispiel, das in C++ geschrieben wurde, finden Sie unter SetFont .

Die ITextPara-Schnittstelle kapselt das Dialogfeld Word Absatz. Alle Messungen werden in Gleitkommapunkten angegeben. Das Rich-Edit-Steuerelement kann alle ITextPara-Eigenschaften intakt (d. h. ohne Änderung) akzeptieren und zurückgeben, sowohl über TOM als auch über die RTF-Konverter (Rich Text Format). Die folgenden Eigenschaften haben jedoch keine Auswirkungen auf die Anzeige des Steuerelements:

• DoNotHyphen
• KeepTogether
• KeepWithNext
• Zeilenabstand
• LineSpacingRule
• NoLineNumber
• PageBreakBefore
• Registerkartenausrichtung
• Registerkartenformate (außer tomAlignLeft und tomSpaces)
• Style WidowControl

Anforderungen

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

Siehe auch

Konzept

IDispatch

Textobjektmodell

Verwenden des Textobjektmodells