класс Aspose::Words::ParagraphFormat

ParagraphFormat class

Представляет всё форматирование абзаца. Чтобы узнать больше, посетите статью документации Working with Paragraphs.

class ParagraphFormat : public Aspose::Words::IBorderAttrSource,
                        public Aspose::Words::IShadingAttrSource

Методы

МетодОписание
ClearFormatting()Сбрасывает форматирование абзаца к значениям по умолчанию.
get_AddSpaceBetweenFarEastAndAlpha()Получает или задаёт флаг, указывающий, автоматически ли регулируется межсимвольный интервал между областями латинского текста и областями восточноазиатского текста в текущем абзаце.
get_AddSpaceBetweenFarEastAndDigit()Получает или задаёт флаг, указывающий, автоматически ли регулируется межсимвольный интервал между областями цифр и областями восточноазиатского текста в текущем абзаце.
get_Alignment()Получает или задает выравнивание текста для абзаца.
get_BaselineAlignment()Получает или задает вертикальное положение шрифтов в строке.
get_Bidi()Получает или задает, является ли этот абзац направленным справа налево.
get_Borders()Получает коллекцию границ абзаца.
get_CharacterUnitFirstLineIndent()Получает или задает значение (в символах) для первого абзацного отступа или висячего отступа. Используйте положительные значения для установки первого абзацного отступа и отрицательные значения для установки висячего отступа.
get_CharacterUnitLeftIndent()Получает или задает значение левого отступа (в символах) для указанных абзацев.
get_CharacterUnitRightIndent()Получает или задает значение правого отступа (в символах) для указанных абзацев.
get_DropCapPosition()Получает или задает позицию текста с броской буквой.
get_FarEastLineBreakControl()Получает или задает флаг, указывающий, применяются ли правила разрыва строк для восточноазиатского текста к текущему абзацу.
get_FirstLineIndent()Получает или задает значение (в пунктах) для первого абзацного отступа или висячего отступа. Используйте положительные значения для установки первого абзацного отступа и отрицательные значения для установки висячего отступа.
get_HangingPunctuation()Получает или задает флаг, указывающий, включена ли висячая пунктуация для текущего абзаца.
get_IsHeading()Истина, когда стиль абзаца является одним из встроенных стилей заголовков.
get_IsListItem()Истина, когда абзац является элементом маркированного или нумерованного списка.
get_KeepTogether()Истина, если все строки в абзаце должны оставаться на одной странице.
get_KeepWithNext()Истина, если абзац должен оставаться на той же странице, что и следующий за ним абзац.
get_LeftIndent()Получает или задает значение (в пунктах), представляющее левый отступ для абзаца.
get_LineSpacing()Получает или задает межстрочный интервал (в пунктах) для абзаца.
get_LineSpacingRule()Получает или задает межстрочный интервал для абзаца.
get_LinesToDrop()Получает или задает количество строк текста абзаца, используемых для расчёта высоты броской буквы.
get_LineUnitAfter()Получает или задает величину интервала (в сеточных линиях) после абзацев.
get_LineUnitBefore()Получает или задает величину интервала (в сеточных линиях) перед абзацами.
get_MirrorIndents()Получает или задает флаг, указывающий, одинаковой ли ширины левый и правый отступы.
get_NoSpaceBetweenParagraphsOfSameStyle()Когда true, SpaceBefore и SpaceAfter будут игнорироваться между абзацами одного стиля.
get_OutlineLevel()Указывает уровень структуры абзаца в документе.
get_PageBreakBefore()Истина, если перед абзацем принудительно вставлен разрыв страницы.
get_RightIndent()Получает или задает значение (в пунктах), представляющее правый отступ абзаца.
get_Shading()Возвращает объект Shading, который относится к форматированию затенения абзаца.
get_SnapToGrid()Указывает, следует ли текущему абзацу использовать настройки линий сетки документа на страницу при размещении содержимого в абзаце.
get_SpaceAfter()Получает или задает величину интервала (в пунктах) после абзаца.
get_SpaceAfterAuto()True, если величина интервала после абзаца задается автоматически.
get_SpaceBefore()Получает или задает величину интервала (в пунктах) перед абзацем.
get_SpaceBeforeAuto()True, если величина интервала перед абзацем задается автоматически.
get_Style()Получает или задает стиль абзаца, применяемый к этому форматированию.
get_StyleIdentifier()Получает или задает независимый от локали идентификатор стиля абзаца, применяемый к этому форматированию.
get_StyleName()Получает или задает имя стиля абзаца, применяемого к этому форматированию.
get_SuppressAutoHyphens()Указывает, следует ли исключить текущий абзац из любой переноски слов, применяемой в настройках документа.
get_SuppressLineNumbers()Указывает, следует ли исключить строки текущего абзаца из нумерации строк, применяемой в родительском разделе.
get_TabStops()Получает коллекцию пользовательских табуляций, определённых для этого объекта.
get_WidowControl()True, если первая и последняя строки абзаца должны оставаться на той же странице, что и остальная часть абзаца.
get_WordWrap()Если это свойство имеет значение false, латинский текст в середине слова может переноситься в текущем абзаце. В противном случае латинский текст переносится целыми словами.
GetType() const override
Is(const System::TypeInfo&) const override
set_AddSpaceBetweenFarEastAndAlpha(bool)Сеттер для Aspose::Words::ParagraphFormat::get_AddSpaceBetweenFarEastAndAlpha.
set_AddSpaceBetweenFarEastAndDigit(bool)Сеттер для Aspose::Words::ParagraphFormat::get_AddSpaceBetweenFarEastAndDigit.
set_Alignment(Aspose::Words::ParagraphAlignment)Сеттер для Aspose::Words::ParagraphFormat::get_Alignment.
set_BaselineAlignment(Aspose::Words::BaselineAlignment)Сеттер для Aspose::Words::ParagraphFormat::get_BaselineAlignment.
set_Bidi(bool)Сеттер для Aspose::Words::ParagraphFormat::get_Bidi.
set_CharacterUnitFirstLineIndent(double)Сеттер для Aspose::Words::ParagraphFormat::get_CharacterUnitFirstLineIndent.
set_CharacterUnitLeftIndent(double)Сеттер для Aspose::Words::ParagraphFormat::get_CharacterUnitLeftIndent.
set_CharacterUnitRightIndent(double)Сеттер для Aspose::Words::ParagraphFormat::get_CharacterUnitRightIndent.
set_DropCapPosition(Aspose::Words::DropCapPosition)Сеттер для Aspose::Words::ParagraphFormat::get_DropCapPosition.
set_FarEastLineBreakControl(bool)Сеттер для Aspose::Words::ParagraphFormat::get_FarEastLineBreakControl.
set_FirstLineIndent(double)Установщик для Aspose::Words::ParagraphFormat::get_FirstLineIndent.
set_HangingPunctuation(bool)Установщик для Aspose::Words::ParagraphFormat::get_HangingPunctuation.
set_KeepTogether(bool)Установщик для Aspose::Words::ParagraphFormat::get_KeepTogether.
set_KeepWithNext(bool)Установщик для Aspose::Words::ParagraphFormat::get_KeepWithNext.
set_LeftIndent(double)Установщик для Aspose::Words::ParagraphFormat::get_LeftIndent.
set_LineSpacing(double)Установщик для Aspose::Words::ParagraphFormat::get_LineSpacing.
set_LineSpacingRule(Aspose::Words::LineSpacingRule)Установщик для Aspose::Words::ParagraphFormat::get_LineSpacingRule.
set_LinesToDrop(int32_t)Установщик для Aspose::Words::ParagraphFormat::get_LinesToDrop.
set_LineUnitAfter(double)Установщик для Aspose::Words::ParagraphFormat::get_LineUnitAfter.
set_LineUnitBefore(double)Установщик для Aspose::Words::ParagraphFormat::get_LineUnitBefore.
set_MirrorIndents(bool)Установщик для Aspose::Words::ParagraphFormat::get_MirrorIndents.
set_NoSpaceBetweenParagraphsOfSameStyle(bool)Установщик для Aspose::Words::ParagraphFormat::get_NoSpaceBetweenParagraphsOfSameStyle.
set_OutlineLevel(Aspose::Words::OutlineLevel)Установщик для Aspose::Words::ParagraphFormat::get_OutlineLevel.
set_PageBreakBefore(bool)Установщик для Aspose::Words::ParagraphFormat::get_PageBreakBefore.
set_RightIndent(double)Установщик для Aspose::Words::ParagraphFormat::get_RightIndent.
set_SnapToGrid(bool)Установщик для Aspose::Words::ParagraphFormat::get_SnapToGrid.
set_SpaceAfter(double)Установщик для Aspose::Words::ParagraphFormat::get_SpaceAfter.
set_SpaceAfterAuto(bool)Установщик для Aspose::Words::ParagraphFormat::get_SpaceAfterAuto.
set_SpaceBefore(double)Установщик для Aspose::Words::ParagraphFormat::get_SpaceBefore.
set_SpaceBeforeAuto(bool)Установщик для Aspose::Words::ParagraphFormat::get_SpaceBeforeAuto.
set_Style(const System::SharedPtr<Aspose::Words::Style>&)Установщик для Aspose::Words::ParagraphFormat::get_Style.
set_StyleIdentifier(Aspose::Words::StyleIdentifier)Установщик для Aspose::Words::ParagraphFormat::get_StyleIdentifier.
set_StyleName(const System::String&)Установщик для Aspose::Words::ParagraphFormat::get_StyleName.
set_SuppressAutoHyphens(bool)Установщик для Aspose::Words::ParagraphFormat::get_SuppressAutoHyphens.
set_SuppressLineNumbers(bool)Установщик для Aspose::Words::ParagraphFormat::get_SuppressLineNumbers.
set_WidowControl(bool)Сеттер для Aspose::Words::ParagraphFormat::get_WidowControl.
set_WordWrap(bool)Сеттер для Aspose::Words::ParagraphFormat::get_WordWrap.
static Type()

Примеры

Показывает, как вручную построить документ Aspose.Words.

auto doc = System::MakeObject<Aspose::Words::Document>();

// Пустой документ содержит один раздел, одно тело и один абзац.
// Вызовите метод "RemoveAllChildren", чтобы удалить все эти узлы,
// и в результате получите узел документа без дочерних элементов.
doc->RemoveAllChildren();

// У этого документа теперь нет составных дочерних узлов, к которым мы могли бы добавить содержимое.
// Если мы захотим отредактировать его, нам потребуется заново заполнить его коллекцию узлов.
// Сначала создайте новый раздел, а затем добавьте его как дочерний элемент к корневому узлу документа.
auto section = System::MakeObject<Aspose::Words::Section>(doc);
doc->AppendChild<System::SharedPtr<Aspose::Words::Section>>(section);

// Установите некоторые свойства разметки страницы для раздела.
section->get_PageSetup()->set_SectionStart(Aspose::Words::SectionStart::NewPage);
section->get_PageSetup()->set_PaperSize(Aspose::Words::PaperSize::Letter);

// Разделу требуется тело, которое будет содержать и отображать всё его содержимое
// на странице между заголовком и нижним колонтитулом раздела.
auto body = System::MakeObject<Aspose::Words::Body>(doc);
section->AppendChild<System::SharedPtr<Aspose::Words::Body>>(body);

// Создайте абзац, задайте некоторые свойства форматирования и затем добавьте его как дочерний элемент к телу.
auto para = System::MakeObject<Aspose::Words::Paragraph>(doc);

para->get_ParagraphFormat()->set_StyleName(u"Heading 1");
para->get_ParagraphFormat()->set_Alignment(Aspose::Words::ParagraphAlignment::Center);

body->AppendChild<System::SharedPtr<Aspose::Words::Paragraph>>(para);

// Наконец, добавьте некоторое содержимое в документ. Создайте объект Run,
// задайте его внешний вид и содержимое, а затем добавьте его как дочерний элемент к абзацу.
auto run = System::MakeObject<Aspose::Words::Run>(doc);
run->set_Text(u"Hello World!");
run->get_Font()->set_Color(System::Drawing::Color::get_Red());
para->AppendChild<System::SharedPtr<Aspose::Words::Run>>(run);

ASSERT_EQ(u"Hello World!", doc->GetText().Trim());

doc->Save(get_ArtifactsDir() + u"Section.CreateManually.docx");

См. также

Класс Aspose::Words::ParagraphCollection Класс Aspose::Words::PhoneticGuide