Робота з параграфами
Пабзац є набором символів, що поєднуються в логічний блок і закінчуючи особливим характером – розбиттям *. У Aspose.Words, абзац представлений абзацом Paragraph клас.
Вставте прапор
Щоб вставити новий абзац в документ, по суті, потрібно вставити характер абзацу в нього. DocumentBuilder.writeln вставляє рядок тексту в документ, а також, крім того, він додає абзационну перерву.
Поточне форматування шрифтів також вказується font властивість та форматування абзаців визначається paragraph_format майно.
Приклад наступного коду показує, як вставити абзац в документ:
# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET | |
doc = aw.Document() | |
builder = aw.DocumentBuilder(doc) | |
font = builder.font | |
font.size = 16 | |
font.bold = True | |
font.color = drawing.Color.blue | |
font.name = "Arial" | |
font.underline = aw.Underline.DASH | |
paragraphFormat = builder.paragraph_format | |
paragraphFormat.first_line_indent = 8 | |
paragraphFormat.alignment = aw.ParagraphAlignment.JUSTIFY | |
paragraphFormat.keep_together = True | |
builder.writeln("A whole paragraph.") | |
doc.save(docs_base.artifacts_dir + "AddContentUsingDocumentBuilder.insert_paragraph.docx") |
Формати
Поточний форматування абзаців представлений ParagraphFormat об’єкт, який повертається paragraph_format майно. Цей об’єкт інкапсулює різні параметри форматування абзаців, доступні в Microsoft Wordй Ви можете легко скидати форматування абзацу за замовчуванням до нормального стилю, вирівнюється зліва, не відступаючи, ні спати, ні кордони і ні затінки за допомогою виклику clear_formattingй
Приклад коду показує, як встановити форматування абзаців:
# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET | |
doc = aw.Document() | |
builder = aw.DocumentBuilder(doc) | |
paragraphFormat = builder.paragraph_format | |
paragraphFormat.alignment = aw.ParagraphAlignment.CENTER | |
paragraphFormat.left_indent = 50 | |
paragraphFormat.right_indent = 50 | |
paragraphFormat.space_after = 25 | |
builder.writeln( | |
"I'm a very nice formatted paragraph. I'm intended to demonstrate how the left and right indents affect word wrapping.") | |
builder.writeln( | |
"I'm another nice formatted paragraph. I'm intended to demonstrate how the space after paragraph looks like.") | |
doc.save(docs_base.artifacts_dir + "DocumentFormatting.paragraph_formatting.docx") |
Застосувати Параграф стиль
Деякі форматування об’єктів, такі як Font або ParagraphFormat стилі підтримки. Одномісний вбудований або визначений стиль користувача представлений Style об’єкт, який містить відповідні властивості стилю, такі як ім’я, базовий стиль, шрифт і форматування абзаців стилю, і так далі.
До того ж Style об’єкт забезпечує Style.style_identifier майно, що повертає ідентифікатор локального стилю, представлений StyleIdentifier значення нумерації. Точка полягає в тому, що назви вбудованих стилів в Microsoft Word локалізуються для різних мов. Використовуючи ідентифікатор стилю, ви можете знайти правильний стиль незалежно від мови документа. Значення занурення відповідають значенням Microsoft Word вбудовані стилі, такі як Нормальний, Заголовок 1, Заголовок 2 і т.д. Всі стилі, призначені для користувача StyleIdentifier.USER значення
Приклад коду показує, як застосувати метод абзацу:
# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET | |
doc = aw.Document() | |
builder = aw.DocumentBuilder(doc) | |
builder.paragraph_format.style_identifier = aw.StyleIdentifier.TITLE | |
builder.write("Hello") | |
doc.save(docs_base.artifacts_dir + "DocumentFormatting.apply_paragraph_style.docx") |
Вставити стиль сепаратора для розміщення різних стилів
Сепаратор стилю можна додавати до кінця абзацу за допомогою Ctrl + Alt + Enter Keyboard Shortcut в MS Word. Ця функція дозволяє два різних абзаців, які використовуються в одному логічному друкованому пункті. Якщо ви хочете зробити текст з початку конкретного заголовка, щоб з’явитися в таблиці змісту, але не хочете весь заголовок в таблиці змісту, ви можете використовувати цю функцію
Наприклад, наступний код показує, як вставити сепаратор стилю для розміщення різних абзаців:
# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET | |
doc = aw.Document() | |
builder = aw.DocumentBuilder(doc) | |
paraStyle = builder.document.styles.add(aw.StyleType.PARAGRAPH, "MyParaStyle") | |
paraStyle.font.bold = False | |
paraStyle.font.size = 8 | |
paraStyle.font.name = "Arial" | |
# Append text with "Heading 1" style. | |
builder.paragraph_format.style_identifier = aw.StyleIdentifier.HEADING1 | |
builder.write("Heading 1") | |
builder.insert_style_separator() | |
# Append text with another style. | |
builder.paragraph_format.style_name = paraStyle.name | |
builder.write("This is text with some other formatting ") | |
doc.save(docs_base.artifacts_dir + "WorkingWithStylesAndThemes.insert_style_separator.docx") |
Визначення пункту Стиль сепаратор
Aspose.Words надає комунальні послуги break_is_style_separator в Paragraph клас дозволяє визначити параметри сепаратора стилю, як показано на прикладі нижче:
# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET | |
doc = aw.Document(docs_base.my_dir + "Document.docx") | |
for paragraph in doc.get_child_nodes(aw.NodeType.PARAGRAPH, True) : | |
paragraph = paragraph.as_paragraph() | |
if (paragraph.break_is_style_separator) : | |
print("Separator Found!") | |
Застосувати кордони та затінки до пункту
Прикордони представлені BorderCollectionй Це колекція Border об’єкти, які доступні за індексом або за типом кордону. Тип кордону представлений BorderType заохочення. Деякі значення генерації застосовуються до декількох або тільки одного елемента документа. Наприклад, BorderType.BOTTOM застосовується до абзацу або настільної комірки при BorderType.DIAGONALDOWN визначає діагональний кордон в таблиці тільки.
У кожному окремому кордоні є подібні атрибути, такі як колір, стиль лінії, ширина лінії, відстань від тексту та додаткові тіні. Вони представлені властивостями тієї ж назви. Ви можете досягти різних типів кордонів, поєднуючи значення нерухомості. Крім того, як BorderCollection і Border об’єкти дозволяють скидати ці значення за замовчуванням, викликаючи Border.clear_formatting метод.
Aspose.Words також має Shading Клас містить атрибути затінення для елементів документа. Ви можете встановити бажану текстуру затінення і кольори, які наносяться на фон і фон елемента.
Текстура затінення встановлюється з TextureIndex значення нумерації, що дозволяє застосувати різні візерунки до Shading об’єкт. Наприклад, для встановлення фонового кольору для елемента документа використовуйте TextureIndex.TEXTURE_SOLID значення і встановити колір фортепіано відповідно. Нижче наведено, як застосувати кордони та затінки до абзацу.
Приклад наступного коду показує, як застосувати кордони та затінки до пункту:
# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET | |
doc = aw.Document() | |
builder = aw.DocumentBuilder(doc) | |
borders = builder.paragraph_format.borders | |
borders.distance_from_text = 20 | |
borders.get_by_border_type(aw.BorderType.LEFT).line_style = aw.LineStyle.DOUBLE | |
borders.get_by_border_type(aw.BorderType.RIGHT).line_style = aw.LineStyle.DOUBLE | |
borders.get_by_border_type(aw.BorderType.TOP).line_style = aw.LineStyle.DOUBLE | |
borders.get_by_border_type(aw.BorderType.BOTTOM).line_style = aw.LineStyle.DOUBLE | |
shading = builder.paragraph_format.shading | |
shading.texture = aw.TextureIndex.TEXTURE_DIAGONAL_CROSS | |
shading.background_pattern_color = drawing.Color.light_coral | |
shading.foreground_pattern_color = drawing.Color.light_salmon | |
builder.write("I'm a formatted paragraph with double border and nice shading.") | |
doc.save(docs_base.artifacts_dir + "DocumentFormatting.apply_borders_and_shading_to_paragraph.doc") |