Ein Text "hart" formartieren, bedeutet das man den Text selbst formatiert
und dies nicht mit der
Hilfe von Formatvorlagen macht. Dadurch werden die Formatangaben direkt mitr dem
Textverbunden. Vor allem wenn es um Absätze geht sollte man dies vermeiden und
Formatvorlagen verwenden. Diese haben den wesentlichen Vorteil das Änderungen an den
Vorlagen automatisch von an allen Textteilen durchgeführt, die diese Vorlage verwenden.
Aber trotzdem gibt es natürlich Fälle wo eine harte Formatierung sinn macht. Vor allem
wenn
es um einzele Textstellen geht, die man zum Beispiel kursiv, fett oder in einer anderen Schrift
darstellen möchte.
Um Text zu formatieren muss das Textobjekt den Service
com.sun.star.style.CharacterProperties unterstützen. Dieser beihaltet dann die Einstellungen
für die Schrift.
Der Service com.sun.star.style.CharacterProperties wird unter anderem von Cursorn,
Absätzen, Satzteilen, Zellen und Zellbereichen unterstützt.
Die wichtigsten Properties hierbei sind:
CharFontName - Der Schriftname
CharHeight - Die Schriftgröße
CharWeight und CharPosture - Der Schriftschnitt ( fett, kursiv etc.)
CharColor - Schriftfarbe
CharBacKColor -Hintergrundfarbe
CharUnderline - Unterstreichung
Der folgende Code fomratiert den Text als ComicSansiff, schwarz, Größe 20, einfach
unterstrichen, kursiv und fett.
myDoc=thisComponent
myViewCursor=myDoc.GetCurrentController.ViewCursor
myViewCursor.CharFontName="ComicSansif"
myViewCursor.CharHeight="20"
myViewCursor.charcolor=&H000000
myViewCursor.CharUnderline=com.sun.star.awt.FontUnderline.SINGLE
myViewCursor.CharWeight=com.sun.star.awt.FontWeight.BOLD
myViewCursor.CharPosture=com.sun.star.awt.FontSlant.ITALIC
Um einen Text kursiv und fett darzustellen müssen beide Paramter gesetzt werden:
CharWeight und CharPosture.
Achtung nicht jeder Schrifttyp unterstützt alle Fomartierungen!
Die wichtigsten Parameter für CharWeight sind
(weitere stehen in der Referenz)
com.sun.star.awt.FontWeight.NORMAL
|
|
com.sun.star.awt.FontWeight.BOLD
|
|
Die wichtigsten Parameter für CharPosture sind
(weitere stehen in der Referenz)
com.sun.star.awt.FontSlant.NONE
|
keine einstellung
|
com.sun.star.awt.FontSlant.ITALIC
|
kursiv
|
com.sun.star.awt.FontSlant.OBLIQUE
|
Oblique
|
Die wichtigsten Parameter für CharUnderline sind:
(weitere stehen in der Referenz)
com.sun.star.awt.FontUnderline.None
|
Keine
|
com.sun.star.awt.FontUnderline.SINGLE
|
einfach
|
com.sun.star.awt.FontUnderline.DOUBLE
|
doppelt
|
com.sun.star.awt.FontUnderline.DOTTED
|
gepunkted
|
com.sun.star.awt.FontUnderline.DASH
|
gestrichelt
|
com.sun.star.awt.FontUnderline.LONGDASH
|
lang gestrichelt
|
com.sun.star.awt.FontUnderline.DASHDOT
|
strich punkt
|
com.sun.star.awt.FontUnderline.WAVE
|
Welle
|
com.sun.star.awt.FontUnderline.DOUBLEWAVE
|
doppelte Welle
|
com.sun.star.awt.FontUnderline.BOLD
|
einfach Fett
|
com.sun.star.awt.FontUnderline.BOLDDOTTED
|
gepunkted fett
|
com.sun.star.awt.FontUnderline.BOLDDASH
|
gestrichelt fett
|
com.sun.star.awt.FontUnderline.BOLDLONGDASH
|
lang gestrichelt
|
com.sun.star.awt.FontUnderline.BOLDWAVE
|
Welle fett
|