Работа с форми

Тази тема обсъжда как да се работи програмно с форми, използващи Aspose.Words.

Фигурите в Aspose.Words представляват обект в чертожния слой, като например AutoShape, текстово поле, свободна форма, OLE обект, контрола Активекс или картина. Документ Word може да съдържа една или повече различни фигури. Формите на документа са представени от клас Shape.

Вмъкване На Фигура С Помощта На Конструктор На Документи

Можете да вмъкнете вградена фигура с определен тип и размер и свободно плаваща фигура с определена позиция, размер и тип на обтичане на текст в документ, като използвате метода InsertShape. Методът InsertShape позволява вмъкване на DML фигура в модела на документа. Документът трябва да бъде записан във формат, който поддържа DML фигури, в противен случай такива възли ще бъдат преобразувани във Фигура VML, докато документът се записва.

Следващият пример за код показва как да вмъкнете тези типове фигури в документа:

For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
System::SharedPtr<Document> doc = System::MakeObject<Document>();
System::SharedPtr<DocumentBuilder> builder = System::MakeObject<DocumentBuilder>(doc);

//Free-floating shape insertion.
System::SharedPtr<Shape> shape = builder->InsertShape(ShapeType::TextBox, RelativeHorizontalPosition::Page, 100, RelativeVerticalPosition::Page, 100, 50, 50, WrapType::None);
shape->set_Rotation(30.0);

builder->Writeln();

//Inline shape insertion.
shape = builder->InsertShape(ShapeType::TextBox, 50, 50);
shape->set_Rotation(30.0);

System::SharedPtr<OoxmlSaveOptions> so = System::MakeObject<OoxmlSaveOptions>(SaveFormat::Docx);
// "Strict" or "Transitional" compliance allows to save shape as DML.
so->set_Compliance(OoxmlCompliance::Iso29500_2008_Transitional);

System::String outputPath = outputDataDir + u"WorkingWithShapes.InsertShapeUsingDocumentBuilder.docx";
// Save the document to disk.
doc->Save(outputPath, so);

Зададено Съотношение Заключено

Използвайки Aspose.Words, можете да укажете дали пропорцията на фигурата е заключена чрез свойството AspectRatioLocked.

Следният пример за код показва как да работите със свойството AspectRatioLocked:

For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
System::SharedPtr<Document> doc = System::MakeObject<Document>();
System::SharedPtr<DocumentBuilder> builder = System::MakeObject<DocumentBuilder>(doc);
System::SharedPtr<Shape> shape = builder->InsertImage(inputDataDir + u"Test.png");
shape->set_AspectRatioLocked(false);

System::String outputPath = outputDataDir + u"WorkingWithShapes.SetAspectRatioLocked.doc";

// Save the document to disk.
doc->Save(outputPath);

Задаване На Оформлението На Формата В Клетката

Можете също да укажете дали фигурата да се показва в таблица или извън нея, като използвате свойството IsLayoutInCell.

Следният пример за код показва как да работите със свойството IsLayoutInCell:

For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
System::SharedPtr<Document> doc = System::MakeObject<Document>(inputDataDir + u"LayoutInCell.docx");
System::SharedPtr<DocumentBuilder> builder = System::MakeObject<DocumentBuilder>(doc);

System::SharedPtr<Shape> watermark = System::MakeObject<Shape>(doc, ShapeType::TextPlainText);
watermark->set_RelativeHorizontalPosition(RelativeHorizontalPosition::Page);
watermark->set_RelativeVerticalPosition(RelativeVerticalPosition::Page);
watermark->set_IsLayoutInCell(true);
// Display the shape outside of table cell if it will be placed into a cell.

watermark->set_Width(300);
watermark->set_Height(70);
watermark->set_HorizontalAlignment(HorizontalAlignment::Center);
watermark->set_VerticalAlignment(VerticalAlignment::Center);

watermark->set_Rotation(-40);
watermark->get_Fill()->set_Color(System::Drawing::Color::get_Gray());
watermark->set_StrokeColor(System::Drawing::Color::get_Gray());

watermark->get_TextPath()->set_Text(u"watermarkText");
watermark->get_TextPath()->set_FontFamily(u"Arial");

watermark->set_Name(System::String::Format(u"WaterMark_{0}",System::Guid::NewGuid()));
watermark->set_WrapType(WrapType::None);

System::SharedPtr<Run> run = System::DynamicCast_noexcept<Run>(doc->GetChildNodes(NodeType::Run, true)->idx_get(doc->GetChildNodes(NodeType::Run, true)->get_Count() - 1));

builder->MoveTo(run);
builder->InsertNode(watermark);
doc->get_CompatibilityOptions()->OptimizeFor(MsWordVersion::Word2010);

System::String outputPath = outputDataDir + u"WorkingWithShapes.SetShapeLayoutInCell.docx";

// Save the document to disk.
doc->Save(outputPath);

Създаване На Ъглов Правоъгълник

Можете да създадете правоъгълник за изрязване на ъгъла, като използвате Aspose.Words. Формите са SingleCornerSnipped, TopCornersSnipped, DiagonalCornersSnipped, TopCornersOneRoundedOneSnipped, SingleCornerRounded, TopCornersRounded, и DiagonalCornersRounded.

Форма DML се създава с помощта на InsertShape Метод с тези типове фигури. Тези типове не могат да се използват за създаване на VML фигури. Опит за създаване на фигура с помощта на публичния конструктор на класа " фигура “повдига изключението” NotSupportedException".

Следващият пример за код показва как да вмъкнете този тип фигури в документа:

For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
System::SharedPtr<Document> doc = System::MakeObject<Document>();
System::SharedPtr<DocumentBuilder> builder = System::MakeObject<DocumentBuilder>(doc);
System::SharedPtr<Shape> shape = builder->InsertShape(ShapeType::TopCornersSnipped, 50, 50);

System::SharedPtr<OoxmlSaveOptions> so = System::MakeObject<OoxmlSaveOptions>(SaveFormat::Docx);
so->set_Compliance(OoxmlCompliance::Iso29500_2008_Transitional);
System::String outputPath = outputDataDir + u"WorkingWithShapes.AddCornersSnipped.docx";

//Save the document to disk.
doc->Save(outputPath, so);

Получете Точки За Действителни Граници На Формата

Използвайки Aspose.Words API, можете да получите местоположението и размера на формата, съдържаща блок в точки, спрямо котвата на най-горната форма. За да направите това, използвайте функцията BoundsInPoints.

Следният пример за код показва как да работите със свойството BoundsInPoints:

For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
System::SharedPtr<Document> doc = System::MakeObject<Document>();
System::SharedPtr<DocumentBuilder> builder = System::MakeObject<DocumentBuilder>(doc);
System::SharedPtr<Shape> shape = builder->InsertImage(inputDataDir + u"Test.png");
shape->set_AspectRatioLocked(false);
std::cout << "Gets the actual bounds of the shape in points." << shape->GetShapeRenderer()->get_BoundsInPoints().ToString().ToUtf8String() << std::endl;

Формат На Хоризонталното Правило

Aspose.Words API предоставя свойството HorizontalRuleFormat за достъп до свойствата на фигурата на хоризонталното правило. HorizontalRuleFormat класът излага основни свойства като височина, цвят, сянка и т.н. за форматиране на хоризонтално правило.

Следващият пример за код показва как да зададете HorizontalRuleFormat:

For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
auto doc = MakeObject<Document>();
auto builder = MakeObject<DocumentBuilder>(doc);

builder->Writeln(u"Insert a horizontal rule shape into the document.");
builder->InsertHorizontalRule();

doc->Save(ArtifactsDir + u"AddContentUsingDocumentBuilder.InsertHorizontalRule.docx");

Вмъкване на OLE обект като икона

Aspose.Words API осигурява Shape → InsertOleObjectAsIcon функция за вмъкване на вграден или свързан OLE обект като икона в документа. Тази функция позволява задаване на икона файл и надпис. Типът OLE обект се открива с помощта на разширението на файла.

Следващият пример за код показва как да зададете вмъкване на обект OLE като икона в документа:

For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
System::SharedPtr<Document> doc = System::MakeObject<Document>();

System::SharedPtr<DocumentBuilder> builder = System::MakeObject<DocumentBuilder>(doc);
System::SharedPtr<Shape> shape = builder->InsertOleObjectAsIcon(inputDataDir + u"embedded.xlsx", false, inputDataDir + u"icon.ico", u"My embedded file");

doc->Save(outputDataDir + u"WorkingWithShapes.InsertOLEObjectAsIcon.docx");

std::cout << "The document has been saved with OLE Object as an Icon." << std::endl;

Максималният размер на иконата трябва да бъде 32х32 за правилното показване.