Práce s odstavci
Odstavec je sada znaků kombinovaná do logického bloku a končící speciálním znakem - paragraph break. V Aspose.Words je odstavec reprezentován třídou Paragraph.
Vložit odstavec
Chcete-li do dokumentu vložit nový odstavec, musíte do něj vložit znak přerušení odstavce. DocumentBuilder.Writeln vloží do dokumentu nejen řetězec textu, ale také přidá konec odstavce.
Aktuální formátování písma je také určeno vlastností Font a aktuální formátování odstavce je určeno vlastností ParagraphFormat. V další části se podíváme podrobněji na formátování odstavců.
Následující příklad kódu ukazuje, jak vložit odstavec do dokumentu:
Formát Odstavce
Formátování aktuálního odstavce je reprezentováno objektem ParagraphFormat, který je vrácen vlastností ParagraphFormat. Tento objekt zapouzdřuje různé vlastnosti formátování odstavců dostupné v Microsoft Word. Můžete snadno resetovat formátování odstavce na výchozí na normální styl, zarovnané doleva bez odsazení, bez mezer, bez ohraničení a bez stínování voláním ClearFormatting.
Následující příklad kódu ukazuje, jak nastavit formátování odstavců:
Použít Styl Odstavce
Některé formátovací objekty, jako je Písmo nebo ParagraphFormat, podporují styly. Jeden vestavěný nebo uživatelem definovaný styl je reprezentován Style objektem, který obsahuje odpovídající vlastnosti stylu, jako je název, základní styl, formátování písma a odstavců stylu atd.
Objekt Style dále poskytuje vlastnost StyleIdentifier, která vrací identifikátor stylu nezávislý na národním prostředí představovaný hodnotou výčtu StyleIdentifier. Jde o to, že názvy vestavěných stylů v Microsoft Word jsou lokalizovány pro různé jazyky. Pomocí identifikátoru stylu můžete najít správný styl Bez ohledu na Jazyk dokumentu. Hodnoty výčtu odpovídají Microsoft Word vestavěným stylům ,jako jsou Normal, Heading 1, Heading 2 atd. Všem uživatelem definovaným stylům je přiřazena hodnota StyleIdentifier.User.
Následující příklad kódu ukazuje, jak použít styl odstavce:
Vložte oddělovač stylů a vložte různé styly odstavců
Oddělovač stylů lze přidat na konec odstavce pomocí klávesové zkratky Ctrl + Alt + Enter do MS Word. Tato funkce umožňuje dva různé styly odstavců používané v jednom logickém tištěném odstavci. Pokud chcete, aby se nějaký text od začátku konkrétního nadpisu zobrazoval v obsahu, ale nechcete, aby se v obsahu zobrazoval celý Nadpis, můžete tuto funkci použít.
Následující příklad kódu ukazuje, jak vložit oddělovač stylů tak, aby vyhovoval různým stylům odstavců:
Identifikujte Oddělovač Stylu Odstavce
Aspose.Words poskytuje veřejnou vlastnost BreakIsStyleSeparator do třídy Paragraph umožňuje identifikaci odstavce oddělovače stylů, jak je znázorněno v příkladu uvedeném níže:
Použití ohraničení a stínování na odstavec
Hranice v Aspose.Words jsou reprezentovány třídou BorderCollection - toto je kolekce objektů Border, ke kterým se přistupuje indexem nebo typem ohraničení. Typ ohraničení je reprezentován výčtem BorderType. Některé hodnoty výčtu jsou použitelné pro několik nebo pouze jeden prvek dokumentu. Například BorderType.Bottom je použitelný pro buňku odstavce nebo tabulky, zatímco BorderType.DiagonalDown určuje diagonální okraj pouze v buňce tabulky.
Kolekce ohraničení i každé samostatné ohraničení mají podobné atributy, jako je barva, styl čáry, šířka čáry, vzdálenost od textu a volitelný stín. Jsou reprezentovány vlastnostmi stejného jména. Kombinací hodnot vlastností můžete dosáhnout různých typů ohraničení. Objekty BorderCollection I Border navíc umožňují resetovat tyto hodnoty na výchozí voláním metody ClearFormatting.
Aspose.Words má také třídu Shading obsahuje atributy stínování pro prvky dokumentu. Můžete nastavit požadovanou texturu stínování a barvy, které se použijí na pozadí a popředí prvku.
Textura stínování je nastavena s hodnotou výčtu TextureIndex, která umožňuje aplikaci různých vzorů na objekt Shading. Chcete-li například nastavit barvu pozadí pro prvek dokumentu, použijte hodnotu TextureIndex.TextureSolid a podle potřeby nastavte barvu stínování popředí.
Následující příklad kódu ukazuje, jak použít ohraničení a stínování na odstavec: