ShapeType enumeration

ShapeType enumeration

Specifies the type of shape in a Microsoft Word document.

Members

NameDescription
IMAGEThe shape is an image.
TEXT_BOXThe shape is a textbox. Note that shapes of many other types can also have text inside them too. A shape does not have to have this type to contain text.
GROUPThe shape is a group shape.
OLE_OBJECTThe shape is an OLE object. You cannot create shapes of this type in the document.
OLE_CONTROLThe shape is an ActiveX control. You cannot create shapes of this type in the document.
NON_PRIMITIVEA shape drawn by user and consisting of multiple segments and/or vertices (curve, freeform or scribble). You cannot create shapes of this type in the document.
RECTANGLERectangle.
ROUND_RECTANGLERound rectangle.
ELLIPSEEllipse.
DIAMONDDiamond.
TRIANGLETriangle.
RIGHT_TRIANGLERight triangle.
PARALLELOGRAMParallelogram.
TRAPEZOIDTrapezoid.
HEXAGONHexagon.
OCTAGONOctagon.
PLUSPlus.
STARStar.
ARROWArrow.
THICK_ARROWThick arrow.
HOME_PLATEHome plate.
CUBECube.
BALLOONBalloon.
SEALSeal.
ARCArc.
LINELine.
PLAQUEPlaque.
CANCan.
DONUTDonut.
TEXT_SIMPLEText simple.
TEXT_OCTAGONText octagon.
TEXT_HEXAGONText hexagon.
TEXT_CURVEText curve.
TEXT_WAVEText wave.
TEXT_RINGText ring.
TEXT_ON_CURVEText on curve.
TEXT_ON_RINGText on ring.
STRAIGHT_CONNECTOR1A straight connector shape.
BENT_CONNECTOR2A bent connector shape with two segments.
BENT_CONNECTOR3A bent connector shape with three segments.
BENT_CONNECTOR4A bent connector shape with four segments.
BENT_CONNECTOR5A bent connector shape with five segments.
CURVED_CONNECTOR2A curved connector shape with two segments.
CURVED_CONNECTOR3A curved connector shape with three segments.
CURVED_CONNECTOR4A curved connector shape with four segments.
CURVED_CONNECTOR5A curved connector shape with five segments.
CALLOUT1A callout shape with one arrow.
CALLOUT2A callout shape with two arrows.
CALLOUT3A callout shape with three arrows.
ACCENT_CALLOUT1An accent callout shape with one arrow.
ACCENT_CALLOUT2An accent callout shape with two arrows.
ACCENT_CALLOUT3An accent callout shape with three arrows.
BORDER_CALLOUT1Border callout 1.
BORDER_CALLOUT2Border callout 2.
BORDER_CALLOUT3Border callout 3.
ACCENT_BORDER_CALLOUT1Accent border callout 1.
ACCENT_BORDER_CALLOUT2Accent border callout 2.
ACCENT_BORDER_CALLOUT3Accent border callout 3.
RIBBONRibbon.
RIBBON2Ribbon 2.
CHEVRONChevron.
PENTAGONPentagon.
NO_SMOKINGNoSmoking.
SEAL8Eight-pointed star.
SEAL1616-pointed star.
SEAL3232-pointed star.
WEDGE_RECT_CALLOUTWedge rect callout.
WEDGE_R_RECT_CALLOUTWedge R rect callout.
WEDGE_ELLIPSE_CALLOUTWedge ellipse callout.
WAVEWave.
FOLDED_CORNERFolded corner.
LEFT_ARROWLeft arrow.
DOWN_ARROWDown arrow.
UP_ARROWUp arrow.
LEFT_RIGHT_ARROWLeft right arrow.
UP_DOWN_ARROWUp down arrow.
IRREGULAR_SEAL1Irregular seal 1.
IRREGULAR_SEAL2Irregular seal 2.
LIGHTNING_BOLTLightning bolt.
HEARTHeart.
QUAD_ARROWQuad arrow.
LEFT_ARROW_CALLOUTLeft arrow callout.
RIGHT_ARROW_CALLOUTRight arrow callout
UP_ARROW_CALLOUTUp arrow callout.
DOWN_ARROW_CALLOUTDown arrow callout.
LEFT_RIGHT_ARROW_CALLOUTLeft right arrow callout.
UP_DOWN_ARROW_CALLOUTUp down arrow callout.
QUAD_ARROW_CALLOUTQuad arrow callout.
BEVELBevel.
LEFT_BRACKETLeft bracket.
RIGHT_BRACKETRight bracket.
LEFT_BRACELeft brace.
RIGHT_BRACERight brace.
LEFT_UP_ARROWLeft up arrow.
BENT_UP_ARROWBent up arrow.
BENT_ARROWBent arrow.
SEAL2424-pointed star.
STRIPED_RIGHT_ARROWStriped right arrow.
NOTCHED_RIGHT_ARROWNotched right arrow.
BLOCK_ARCBlock arc.
SMILEY_FACESmiley face.
VERTICAL_SCROLLVertical scroll.
HORIZONTAL_SCROLLHorizontal scroll.
CIRCULAR_ARROWCircular arrow.
CUSTOM_SHAPEThis shape type seems to be set for shapes that are not part of the standard set of the auto shapes in Microsoft Word. For example, if you insert a new auto shape from ClipArt. You cannot create shapes of this type in the document.
UTURN_ARROWUturn arrow.
CURVED_RIGHT_ARROWCurved right arrow.
CURVED_LEFT_ARROWCurved left arrow.
CURVED_UP_ARROWCurved up arrow
CURVED_DOWN_ARROWCurved down arrow.
CLOUD_CALLOUTCloud callout.
ELLIPSE_RIBBONEllipse ribbon.
ELLIPSE_RIBBON2Ellipse ribbon 2.
FLOW_CHART_PROCESSFlow chart process.
FLOW_CHART_DECISIONFlow chart decision.
FLOW_CHART_INPUT_OUTPUTFlow chart input output.
FLOW_CHART_PREDEFINED_PROCESSFlow chart predefined process
FLOW_CHART_INTERNAL_STORAGEFlow chart internal storage.
FLOW_CHART_DOCUMENTFlow chart document.
FLOW_CHART_MULTIDOCUMENTFlow chart multi document.
FLOW_CHART_TERMINATORFlow chart terminator.
FLOW_CHART_PREPARATIONFlow chart preparation.
FLOW_CHART_MANUAL_INPUTFlow chart manual input.
FLOW_CHART_MANUAL_OPERATIONFlow chart manual operation.
FLOW_CHART_CONNECTORFlow chart connector.
FLOW_CHART_PUNCHED_CARDFlow chart punched card.
FLOW_CHART_PUNCHED_TAPEFlow chart punched tape.
FLOW_CHART_SUMMING_JUNCTIONFlow chart summing junction.
FLOW_CHART_ORFlow chart or.
FLOW_CHART_COLLATEFlow chart collate.
FLOW_CHART_SORTFlow chart sort.
FLOW_CHART_EXTRACTFlow chart extract.
FLOW_CHART_MERGEFlow chart merge.
FLOW_CHART_OFFLINE_STORAGEFlow chart off-line storage.
FLOW_CHART_ONLINE_STORAGEFlow chart on-line storage.
FLOW_CHART_MAGNETIC_TAPEFlow char magnetic tape.
FLOW_CHART_MAGNETIC_DISKFlow chart magnetic disk.
FLOW_CHART_MAGNETIC_DRUMFlow chart magnetic drum.
FLOW_CHART_DISPLAYFlow chart display.
FLOW_CHART_DELAYFlow chart delay.
TEXT_PLAIN_TEXTPlain-text, WordArt object.
TEXT_STOPStop, WordArt object.
TEXT_TRIANGLETriangle, WordArt object.
TEXT_TRIANGLE_INVERTEDTriangle inverted, WordArt object.
TEXT_CHEVRONChevron, WordArt object.
TEXT_CHEVRON_INVERTEDChevron inverted, WordArt object.
TEXT_RING_INSIDERing inside, WordArt object.
TEXT_RING_OUTSIDERing outside, WordArt object.
TEXT_ARCH_UP_CURVEArch up curve, WordArt object.
TEXT_ARCH_DOWN_CURVEArch down curve, WordArt object.
TEXT_CIRCLE_CURVECircle curve, WordArt object.
TEXT_BUTTON_CURVEButton curve, WordArt object.
TEXT_ARCH_UP_POURArch up pour, WordArt object.
TEXT_ARCH_DOWN_POURArch down pour, WordArt object.
TEXT_CIRCLE_POURCircle pour, WordArt object.
TEXT_BUTTON_POURButton pour, WordArt object.
TEXT_CURVE_UPCurve up, WordArt object.
TEXT_CURVE_DOWNCurve down, WordArt object.
TEXT_CASCADE_UPCascade up, WordArt object.
TEXT_CASCADE_DOWNCascade down, WordArt object.
TEXT_WAVE1Wave 1, WordArt object.
TEXT_WAVE2Wave 2, WordArt object.
TEXT_WAVE3Wave 3, WordArt object.
TEXT_WAVE4Wave 4, WordArt object.
TEXT_INFLATEInflate, WordArt object.
TEXT_DEFLATEDeflate, WordArt object.
TEXT_INFLATE_BOTTOMInflate bottom, WordArt object.
TEXT_DEFLATE_BOTTOMDeflate bottom, WordArt object.
TEXT_INFLATE_TOPInflate top, WordArt object.
TEXT_DEFLATE_TOPDeflate top, WordArt object.
TEXT_DEFLATE_INFLATEDeflate inflate, WordArt object.
TEXT_DEFLATE_INFLATE_DEFLATEDeflate inflate deflate, WordArt object.
TEXT_FADE_RIGHTFade right, WordArt object.
TEXT_FADE_LEFTFade left, WordArt object.
TEXT_FADE_UPFade up, WordArt object.
TEXT_FADE_DOWNFade down, WordArt object.
TEXT_SLANT_UPSlant up, WordArt object.
TEXT_SLANT_DOWNSlant down, WordArt object.
TEXT_CAN_UPCan up, WordArt object.
TEXT_CAN_DOWNCan down, WordArt object.
FLOW_CHART_ALTERNATE_PROCESSFlow chart alternate process.
FLOW_CHART_OFFPAGE_CONNECTORFlow chart off page connector.
CALLOUT90Callout 90.
ACCENT_CALLOUT90Accent callout 90.
BORDER_CALLOUT90Border callout 90.
ACCENT_BORDER_CALLOUT90Accent border callout 90.
LEFT_RIGHT_UP_ARROWLeft right up arrow.
SUNSun.
MOONMoon.
BRACKET_PAIRBracket pair.
BRACE_PAIRBrace pair
SEAL4Four-pointed star.
DOUBLE_WAVEDouble wave.
ACTION_BUTTON_BLANKAction button blank.
ACTION_BUTTON_HOMEAction button home.
ACTION_BUTTON_HELPAction button help.
ACTION_BUTTON_INFORMATIONAction button information.
ACTION_BUTTON_FORWARD_NEXTAction button forward next.
ACTION_BUTTON_BACK_PREVIOUSAction button back previous.
ACTION_BUTTON_ENDAction button end.
ACTION_BUTTON_BEGINNINGAction button beginning.
ACTION_BUTTON_RETURNAction button return.
ACTION_BUTTON_DOCUMENTAction button document.
ACTION_BUTTON_SOUNDAction button sound.
ACTION_BUTTON_MOVIEAction button movie.
SINGLE_CORNER_SNIPPEDSnip single corner rectangle object.
TOP_CORNERS_SNIPPEDSnip same side corner rectangle.
DIAGONAL_CORNERS_SNIPPEDSnip diagonal corner rectangle.
TOP_CORNERS_ONE_ROUNDED_ONE_SNIPPEDSnip and round single corner rectangle.
SINGLE_CORNER_ROUNDEDRound single corner rectangle.
TOP_CORNERS_ROUNDEDRound same side corner rectangle.
DIAGONAL_CORNERS_ROUNDEDRound diagonal corner rectangle.
HEPTAGONHeptagon.
CLOUDCloud.
SEAL6Six-pointed star.
SEAL7Seven-pointed star.
SEAL10Ten-pointed star.
SEAL12Twelve-pointed star.
SWOOSH_ARROWSwoosh arrow.
TEARDROPTeardrop.
SQUARE_TABSSquare tabs.
PLAQUE_TABSPlaque tabs.
PIEPie.
WEDGE_PIEWedge pie.
INVERSE_LINEInverse line.
MATH_PLUSMath plus.
MATH_MINUSMath minus.
MATH_MULTIPLYMath multiply.
MATH_DIVIDEMath divide.
MATH_EQUALMath equal.
MATH_NOT_EQUALMath not equal.
NON_ISOSCELES_TRAPEZOIDNon-isosceles trapezoid.
LEFT_RIGHT_CIRCULAR_ARROWLeft-right circular arrow.
LEFT_RIGHT_RIBBONLeft-right ribbon.
LEFT_CIRCULAR_ARROWLeft circular arrow.
FRAMEFrame.
HALF_FRAMEHalf frame.
FUNNELFunnel.
GEAR6Six-tooth gear.
GEAR9Nine-tooth gear.
DECAGONDecagon.
DODECAGONDodecagon.
DIAGONAL_STRIPEDiagonal stripe.
CORNERCorner.
CORNER_TABSCorner tabs.
CHORDChord.
CHART_PLUSChart plus.
CHART_STARChart star.
CHART_XChart X.
MIN_VALUEReserved for the system use.

Examples

Shows how to insert a shape with an image from the local file system into a document.

doc = aw.Document()

# The "Shape" class's public constructor will create a shape with "ShapeMarkupLanguage.VML" markup type.
# If you need to create a shape of a non-primitive type, such as SingleCornerSnipped, TopCornersSnipped, DiagonalCornersSnipped,
# TopCornersOneRoundedOneSnipped, SingleCornerRounded, TopCornersRounded, or DiagonalCornersRounded,
# please use DocumentBuilder.insert_shape.
shape = aw.drawing.Shape(doc, aw.drawing.ShapeType.IMAGE)
shape.image_data.set_image(IMAGE_DIR + "Windows MetaFile.wmf")
shape.width = 100
shape.height = 100

doc.first_section.body.first_paragraph.append_child(shape)

doc.save(ARTIFACTS_DIR + "Image.from_file.docx")

Shows how Aspose.Words identify shapes.

doc = aw.Document()
builder = aw.DocumentBuilder(doc)

builder.insert_shape(aw.drawing.ShapeType.HEPTAGON, aw.drawing.RelativeHorizontalPosition.PAGE, 0,
    aw.drawing.RelativeVerticalPosition.PAGE, 0, 0, 0, aw.drawing.WrapType.NONE)

builder.insert_shape(aw.drawing.ShapeType.CLOUD, aw.drawing.RelativeHorizontalPosition.RIGHT_MARGIN, 0,
    aw.drawing.RelativeVerticalPosition.PAGE, 0, 0, 0, aw.drawing.WrapType.NONE)

builder.insert_shape(aw.drawing.ShapeType.MATH_PLUS, aw.drawing.RelativeHorizontalPosition.RIGHT_MARGIN, 0,
    aw.drawing.RelativeVerticalPosition.PAGE, 0, 0, 0, aw.drawing.WrapType.NONE)

# To correct identify shape types you need to work with shapes as DML.
save_options = aw.saving.OoxmlSaveOptions(aw.SaveFormat.DOCX)

# "Strict" or "Transitional" compliance allows to save shape as DML.
save_options.compliance = aw.saving.OoxmlCompliance.ISO29500_2008_TRANSITIONAL

doc.save(ARTIFACTS_DIR + "Shape.shape_types.docx", save_options)
doc = aw.Document(ARTIFACTS_DIR + "Shape.shape_types.docx")

shapes = [node.as_shape() for node in doc.get_child_nodes(aw.NodeType.SHAPE, True)]

for shape in shapes:
    print(shape.shape_type)

See Also