Práce s tvary

Toto téma pojednává o tom, jak programově pracovat s tvary pomocí Aspose.Words.

Tvary v Aspose.Words představují objekt ve vrstvě výkresu, například AutoShape, textové pole, volný tvar, OLE objekt, ovládací prvek ActiveX nebo obrázek. Word dokument může obsahovat jeden nebo více různých tvarů. Tvary dokumentu jsou reprezentovány třídou Shape.

Vložení Tvaru Pomocí Nástroje Pro Tvorbu Dokumentů

Vložený obrazec se zadaným typem a velikostí a volně plovoucí obrazec se zadanou pozicí, velikostí a typem zalamování textu můžete do dokumentu vložit metodou InsertShape. Metoda InsertShape umožňuje vložení tvaru DML do modelu dokumentu. Dokument musí být uložen ve formátu, který podporuje tvary DML, jinak budou tyto uzly převedeny na tvar VML při ukládání dokumentu.

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

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);

Nastavit Poměr Stran Uzamčen

Pomocí Aspose.Words můžete určit, zda je poměr stran obrazce uzamčen pomocí vlastnosti AspectRatioLocked.

Následující příklad kódu ukazuje, jak pracovat s vlastností 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);

Nastavit Rozložení Tvaru V Buňce

Pomocí vlastnosti IsLayoutInCell můžete také určit, zda se obrazec zobrazuje uvnitř tabulky nebo mimo ni.

Následující příklad kódu ukazuje, jak pracovat s vlastností 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);

Vytvořit Snip Rohový Obdélník

Rohový obdélník můžete vytvořit pomocí Aspose.Words. Typy tvarů jsou SingleCornerSnipped, TopCornersSnipped, DiagonalCornersSnipped, TopCornersOneRoundedOneSnipped, SingleCornerRounded, TopCornersRounded, a DiagonalCornersRounded.

Tvar DML je vytvořen pomocí metody InsertShape s těmito typy tvarů. Tyto typy nelze použít k vytvoření tvarů VML. Pokus o vytvoření obrazce pomocí veřejného konstruktoru třídy " tvar “vyvolá výjimku” NotSupportedException".

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

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);

Získat Aktuální Tvar Hranice Body

Pomocí Aspose.Words API můžete získat umístění a velikost tvaru obsahujícího blok v bodech vzhledem ke kotvě Nejvyššího tvaru. Chcete-li to provést, použijte vlastnost BoundsInPoints.

Následující příklad kódu ukazuje, jak pracovat s vlastností 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;

Formát Horizontálního Pravidla

Aspose.Words API poskytuje vlastnost HorizontalRuleFormat pro přístup k vlastnostem tvaru horizontálního pravidla. Třída HorizontalRuleFormat odhaluje základní vlastnosti, jako je výška, barva, odstín atd. pro formátování horizontálního pravidla.

Následující příklad kódu ukazuje, jak nastavit 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");

Vložit OLE objekt jako ikonu

Aspose.Words API poskytuje funkci Shape → InsertOleObjectAsIcon pro vložení vloženého nebo propojeného objektu OLE jako ikony do dokumentu. Tato funkce umožňuje zadat soubor ikon a titulek. Typ objektu OLE se zjišťuje pomocí přípony souboru.

Následující příklad kódu ukazuje, jak nastavit vložit OLE objekt jako ikonu do dokumentu:

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;

Maximální velikost ikony musí být 32x32 pro správné zobrazení.