Lucrul cu forme
Acest subiect discută cum să lucrați programatic cu forme folosind Aspose.Words.
Formele din Aspose.Words reprezintă un obiect din stratul de desen, cum ar fi un obiect AutoShape, textbox, freeform, OLE, control ActiveX sau imagine. Un document Word poate conține una sau mai multe forme diferite. Formele documentului sunt reprezentate de clasa Shape.
Inserarea Formelor Folosind Document Builder
Puteți insera forma inline cu tipul și dimensiunea specificate și forma liberă plutitoare cu poziția specificată, dimensiunea și tipul de înfășurare a textului într-un document folosind metoda insert_shape. Metoda insert_shape permite inserarea formei DML în modelul documentului. Documentul trebuie salvat în format, care acceptă forme DML, în caz contrar, astfel de noduri vor fi convertite în formă VML, în timp ce se salvează documentul.
Următorul exemplu de cod arată cum să inserați aceste tipuri de forme în document:
Setați Raportul De Aspect Blocat
Folosind Aspose.Words, Puteți specifica dacă raportul de aspect al formei este blocat prin proprietatea aspect_ratio_locked.
Următorul exemplu de cod arată cum să lucrați cu proprietatea AspectRatioLocked:
Setați Aspectul Formei În Celulă
De asemenea, puteți specifica dacă forma este afișată în interiorul unui tabel sau în afara acestuia folosind proprietatea is_layout_in_cell.
Următorul exemplu de cod arată cum să lucrați cu proprietatea IsLayoutInCell:
Creați Un Dreptunghi De Colț Snip
Puteți crea un dreptunghi de colț snip folosind Aspose.Words. Tipurile de forme sunt SINGLE_CORNER_SNIPPED, TOP_CORNERS_SNIPPED, DIAGONAL_CORNERS_SNIPPED, TOP_CORNERS_ONE_ROUNDED_ONE_SNIPPED, SINGLE_CORNER_ROUNDED, TOP_CORNERS_ROUNDED, și DIAGONAL_CORNERS_ROUNDED.
Forma DML este creată folosind metoda insert_shape cu aceste tipuri de forme. Aceste tipuri nu pot fi folosite pentru a crea forme VML. Încercarea de a crea formă folosind constructorul public al clasei Shape ridică excepția “NotSupportedException”.
Următorul exemplu de cod arată cum să inserați aceste tipuri de forme în document:
Obțineți Puncte Reale Ale Limitelor Formei
Folosind Aspose.Words API, puteți obține locația și dimensiunea formei care conține blocul în puncte, în raport cu ancora formei superioare. Pentru a face acest lucru, utilizați proprietatea bounds_in_points.
Următorul exemplu de cod arată cum să lucrați cu proprietatea BoundsInPoints:
Specificați Ancora Verticală
Puteți specifica alinierea verticală a textului într-o formă folosind proprietatea vertical_anchor.
Următorul exemplu de cod arată cum să lucrați cu proprietatea VerticalAnchor:
Detectează Forma SmartArt
Aspose.Words permite, de asemenea, detectarea dacă forma are un obiect SmartArt. Pentru a face acest lucru, utilizați proprietatea has_smart_art property.
Următorul exemplu de cod arată cum să lucrați cu proprietatea HasSmartArt:
Introduceți regula orizontală în Document
Puteți insera forma regulii orizontale într-un document folosind metoda insert_horizontal_rule.
Următorul exemplu de cod arată cum se face acest lucru:
Aspose.Words API oferă proprietatea horizontal_rule_format pentru a accesa proprietățile formei regulii orizontale. Clasa HorizontalRuleFormat expune proprietăți de bază precum height, color, no_shade etc. pentru formatarea unei reguli orizontale.
Următorul exemplu de cod demonstrează cum să setați HorizontalRuleFormat:
Introduceți OLE obiect ca pictogramă
Aspose.Words API oferă funcția Shape.insert_ole_object_as_icon pentru a insera un obiect OLE încorporat sau legat ca pictogramă în document. Această funcție permite specificarea fișierului pictogramă și legenda. Tipul de Obiect OLE va fi detectat folosind extensia de fișier.
Următorul exemplu de cod demonstrează modul de setare a obiectului insert OLE ca pictogramă în document:
Importați forme cu matematica XML ca forme în DOM
Puteți utiliza proprietatea convert_shape_to_office_math pentru a converti formele cu EquationXML în obiecte Office Math. Valoarea implicită a acestei proprietăți corespunde MS comportamentul cuvântului, adică formele cu ecuația XML nu sunt convertite în obiecte Office math.
Următorul exemplu de cod arată cum să convertiți formele în obiecte Office Math: