Spolupráce s odstavci

Odstavec je soubor znaků v kombinaci s logickým blokem a končí speciálním znakem a bod zlom. In Aspose.Words, odstavec je zastoupen Paragraph třída.

Vložit odstavec

Chcete-li do dokumentu vložit nový odstavec, musíte do něj vložit znak zlomu odstavce. DocumentBuilder.Writeln do dokumentu vloží nejen řetězec textu, ale také přidá odstavec zlom.

Aktuální formátování písma je také specifikováno Font vlastnost a formátování aktuálního odstavce je určeno ParagraphFormat majetek. V další části se budeme podrobněji zabývat formátováním odstavců.

Následující příklad kódu ukazuje, jak vložit odstavec do dokumentu:

Formátovací odstavec

Formátování aktuálního odstavce představuje ParagraphFormat objekt, který je vrácen ParagraphFormat majetek. Tento objekt zapouzdřuje různé vlastnosti formátu odstavce dostupné v Microsoft Word. Můžete jednoduše resetovat formátování odstavce na jeho výchozí normální styl, levicový, bez odsazení, bez rozestupu, bez hranic, bez stínování, voláním ClearFormatting.

Následující příklad kódu ukazuje, jak nastavit formátování odstavce:

Použít odstavec styl

Některé formátující objekty, jako například Font nebo ParagraphFormat, podpůrné styly. Jeden vestavěný nebo uživatelsky definovaný styl představuje Style objekt, který obsahuje odpovídající styl vlastnosti, jako je název, základní styl, písmo, styl odstavce formátování, a tak dále.

Kromě toho Style objekt odhalí StyleIdentifier Vlastnost, která vrací identifikátor locale-nezávislý styl zastoupený StyleIdentifier hodnota výčtu. Faktem je, ž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í vestavěným hodnotám Microsoft Word styly jako Normal, Mířím 1,*Mířím 2 a tak dále. Všechny uživatelské styly jsou nastaveny na StyleIdentifier.User hodnota výčtu.

Následující příklad kódu ukazuje, jak použít odstavec:

Vložit stylový oddělovač pro různé odstíny

Na konec odstavce lze přidat oddělovač stylu pomocí klávesnice Ctrl+Alt+Enter Microsoft Word. Tato funkce umožňuje použít dva různé odstíny ve stejném logickém tištěném odstavci. Pokud chcete nějaký text od začátku určitého záhlaví, který se objeví v tabulce obsahu, ale nechcete, aby se celé záhlaví zobrazovalo v tabulce obsahu, můžete tuto funkci použít.

Následující příklad kódu ukazuje, jak vložit oddělovač stylu pro různé odstíny:

Identifikační odstavec Oddělovač stylu

Aspose.Words vystavuje BreakIsStyleSeparator veřejný majetek Paragraph třída pro identifikaci odstavce se oddělovačem stylu, jak je znázorněno v následujícím příkladu:

Použít hranice a stínění na odstavec

Hranice Aspose.Words jsou zastoupeny BorderCollection třído. Border objekty, které jsou přístupné podle indexu nebo typu hranice. Typ hranice je pak reprezentován BorderType vyjmenování. Některé hodnoty se vztahují na více nebo pouze jeden prvek dokumentu. Například: BorderType.Bottom platí pro odstavec nebo tabulku, zatímco BorderType.DiagonalDown určuje diagonální hranici pouze v buňce tabulky.

Sbírka hranic i každá samostatná hranice mají podobné vlastnosti, jako je barva, styl linie, šířka čáry, vzdálenost od textu a volitelný stín. Jsou reprezentovány vlastnostmi stejného jména. Můžete získat různé typy hranic kombinací hodnot nemovitostí. Kromě toho BorderCollection a Border objekty umožňují resetovat tyto hodnoty na jejich výchozí hodnoty voláním ClearFormatting metoda.

Aspose.Words má také Shading třída, která obsahuje znaky stínování prvků dokumentu. Můžete nastavit požadovanou stínovací strukturu a barvy, které jsou aplikovány na pozadí a popředí prvku pomocí TextureIndex hodnota výčtu. TextureIndex také umožňuje aplikovat různé vzory na Shading objekt. Například pro nastavení barvy pozadí prvku dokumentu použijte TextureIndex.TextureSolid hodnota a nastavit barvu stínování popředí podle potřeby.

Následující příklad kódu ukazuje, jak použít hranice a stínování na odstavec:

Počítejte paragrafy

Pokud chcete počítat počet řádků v odstavci pro jakýkoli dokument Word, lze použít tento vzorek kódu: