Shape

ภาพรวม

Shape เป็นคลาสใน Aspose.Words FOSS สำหรับ .NET. สืบทอดจาก: ShapeBase, ITextBox, IStrokable.

เป็นออบเจ็กต์ในเลเยอร์การวาด, เช่น AutoShape, กล่องข้อความ, รูปฟรีฟอร์ม, วัตถุ OLE, คอนโทรล ActiveX, หรือรูปภาพ.

คลาสนี้ให้ 29 เมธอดสำหรับทำงานกับออบเจ็กต์ Shape ในโปรแกรม .NET. เมธอดที่มีรวมถึง: Accept, AcceptEnd, AcceptStart, AdjustWithEffects, AppendChild, Clone, CreateNavigator, GetAncestor, GetAncestorOf, GetChild, GetChildNodes, GetEnumerator, และเมธอดเพิ่มเติมอีก 17 รายการ. สมาชิกสาธารณะทั้งหมดสามารถเข้าถึงได้จากแอปพลิเคชัน .NET ใด ๆ หลังจากติดตั้งแพ็กเกจ Aspose.Words FOSS สำหรับ .NET. คุณสมบัติ: Adjustments, AllowOverlap, AlternativeText, AnchorLocked, AspectRatioLocked, BehindText, และอีก 93 รายการ.

คุณสมบัติ

ชื่อ	ประเภท	การเข้าถึง	คำอธิบาย
`NodeType`	`NodeType`	อ่าน	คืนค่า Shape.
`StoryType`	`StoryType`	อ่าน	คืนค่า Textbox.
`ExtrusionEnabled`	`bool`	อ่าน	คืนค่า true หากเอฟเฟกต์ extrusion ถูกเปิดใช้งาน.
`ShadowEnabled`	`bool`	อ่าน	คืนค่า true หากเอฟเฟกต์ shadow ถูกเปิดใช้งาน.
`Stroke`	`Stroke`	อ่าน	กำหนด stroke สำหรับรูปร่าง.
`Stroked`	`bool`	อ่าน/เขียน	กำหนดว่าพาธจะถูกวาดเส้นหรือไม่.
`StrokeWeight`	`double`	อ่าน/เขียน	กำหนดความหนาของแปรงที่วาดเส้นพาธของรูปทรงเป็นหน่วยจุด.
`StrokeColor`	`Color`	อ่าน/เขียน	กำหนดสีของเส้น.
`Filled`	`bool`	อ่าน/เขียน	กำหนดว่าพาธปิดของรูปร่างจะถูกเติมสีหรือไม่.
`FillColor`	`Color`	อ่าน/เขียน	กำหนดสีของแปรงที่ใช้เติมพาธปิดของรูปร่าง.
`HasImage`	`bool`	อ่าน	Returns true if the shape has image bytes or links an image.
`ImageData`	`ImageData`	อ่าน	Provides access to the image of the shape.
`OleFormat`	`OleFormat`	อ่าน	Provides access to the OLE data of a shape.
`TextBox`	`TextBox`	อ่าน	กำหนดแอตทริบิวต์ที่ระบุวิธีการแสดงข้อความในรูปทรง.
`TextPath`	`TextPath`	อ่าน	กำหนดข้อความของเส้นทางข้อความ (ของออบเจกต์ WordArt).
`FirstParagraph`	`Paragraph`	อ่าน	ดึงย่อหน้าแรกใน shape.
`LastParagraph`	`Paragraph`	อ่าน	รับย่อหน้าสุดท้ายในรูปร่าง.
`HorizontalRuleFormat`	`HorizontalRuleFormat`	อ่าน	ให้การเข้าถึงคุณสมบัติของรูปร่างเส้นแนวนอน.
`Adjustments`	`AdjustmentCollection`	อ่าน	ให้การเข้าถึงค่าการปรับดิบของรูปร่าง.
`SignatureLine`	`SignatureLine`	อ่าน	รับอ็อบเจกต์ SignatureLine หากรูปทรงเป็นบรรทัดลายเซ็น.
`HasChart`	`bool`	อ่าน	คืนค่า true หาก Shape นี้มี Chart.
`HasSmartArt`	`bool`	อ่าน	คืนค่า true หาก Shape นี้มีวัตถุ SmartArt.
`Chart`	`Chart`	อ่าน	ให้การเข้าถึงคุณสมบัติของ chart หาก shape นี้มี Chart.
`Fill`	`Fill`	อ่าน	รับการจัดรูปแบบการเติมสีสำหรับรูปทรง.
`ShadowFormat`	`ShadowFormat`	อ่าน	รับการจัดรูปแบบเงาสำหรับ shape.
`Glow`	`GlowFormat`	อ่าน	รับการจัดรูปแบบเรืองแสงสำหรับรูปร่าง.
`Reflection`	`ReflectionFormat`	อ่าน	รับการจัดรูปแบบการสะท้อนสำหรับรูปทรง.
`SoftEdge`	`SoftEdgeFormat`	อ่าน	รับการจัดรูปแบบขอบนุ่มของรูปร่าง.
`ScreenTip`	`string`	อ่าน/เขียน	กำหนดข้อความที่จะแสดงเมื่อเคอร์เซอร์เมาส์เคลื่อนที่เหนือรูปทรง.
`HRef`	`string`	อ่าน/เขียน	รับหรือกำหนดที่อยู่ไฮเปอร์ลิงก์เต็มสำหรับรูปทรง.
`Target`	`string`	อ่าน/เขียน	รับหรือกำหนดกรอบเป้าหมายสำหรับไฮเปอร์ลิงก์ของรูปทรง.
`AlternativeText`	`string`	อ่าน/เขียน	กำหนดข้อความทางเลือกที่จะแสดงแทนกราฟิก.
`IsDecorative`	`bool`	อ่าน/เขียน	รับหรือกำหนดค่าสถานะที่ระบุว่ารูปร่างเป็นการตกแต่งในเอกสารหรือไม่.
`Title`	`string`	อ่าน/เขียน	รับหรือกำหนดชื่อ (คำบรรยาย) ของวัตถุรูปร่างปัจจุบัน.
`Name`	`string`	อ่าน/เขียน	รับหรือกำหนดชื่อรูปทรงที่เป็นตัวเลือก.
`IsInsertRevision`	`bool`	อ่าน	รับค่า is insert revision.
`IsDeleteRevision`	`bool`	อ่าน	รับค่า is delete revision.
`IsMoveFromRevision`	`bool`	อ่าน	รับค่า `is move` จาก `revision`.
`IsMoveToRevision`	`bool`	อ่าน	รับค่า `IsMoveToRevision`.
`IsTopLevel`	`bool`	อ่าน	คืนค่า true หากรูปร่างนี้ไม่ใช่ลูกของรูปกลุ่ม.
`IsGroup`	`bool`	อ่าน	คืนค่า true หากเป็นรูปกลุ่ม.
`IsImage`	`bool`	อ่าน	คืนค่า true หากรูปทรงนี้เป็นรูปทรงภาพ.
`IsHorizontalRule`	`bool`	อ่าน	คืนค่า true หากรูปทรงนี้เป็นเส้นแนวนอน.
`IsWordArt`	`bool`	อ่าน	คืนค่า true หากรูปร่างนี้เป็นวัตถุแบบ WordArt object.
`CanHaveImage`	`bool`	อ่าน	คืนค่า true หากประเภทของรูปร่างอนุญาตให้รูปร่างมีรูปภาพ.
`AnchorLocked`	`bool`	อ่าน/เขียน	ระบุว่าจุดยึดของรูปร่างถูกล็อกหรือไม่.
`AspectRatioLocked`	`bool`	อ่าน/เขียน	ระบุว่าความอัตราส่วนของรูปทรงถูกล็อคหรือไม่.
`AllowOverlap`	`bool`	อ่าน/เขียน	รับหรือกำหนดค่าที่ระบุว่ารูปทรงนี้สามารถทับซ้อนกับรูปทรงอื่นได้หรือไม่.
`BehindText`	`bool`	อ่าน/เขียน	ระบุว่ารูปทรงอยู่ด้านล่างหรือด้านบนของข้อความ.
`IsInline`	`bool`	อ่าน	วิธีรวดเร็วในการกำหนดว่ารูปร่างนี้อยู่ในแนวเดียวกับข้อความหรือไม่.
`Left`	`double`	อ่าน/เขียน	รับหรือกำหนดตำแหน่งของขอบซ้ายของบล็อกที่บรรจุรูปร่าง.
`Top`	`double`	อ่าน/เขียน	รับหรือกำหนดตำแหน่งของขอบบนของบล็อกที่บรรจุ shape.
`Right`	`double`	อ่าน	รับตำแหน่งของขอบขวาของบล็อกที่บรรจุ shape.
`Bottom`	`double`	อ่าน	รับตำแหน่งของขอบล่างของบล็อกที่บรรจุ shape.
`Width`	`double`	อ่าน/เขียน	รับหรือกำหนดความกว้างของบล็อกที่บรรจุรูปทรง.
`Height`	`double`	อ่าน/เขียน	รับหรือกำหนดความสูงของบล็อกที่บรรจุรูปร่าง.
`DistanceTop`	`double`	อ่าน/เขียน	คืนค่า หรือกำหนดระยะ (หน่วยจุด) ระหว่างข้อความของเอกสารกับขอบบนของรูปร่าง.
`DistanceBottom`	`double`	อ่าน/เขียน	คืนค่า หรือกำหนดระยะ (หน่วยจุด) ระหว่างข้อความของเอกสารกับขอบล่างของรูปร่าง.
`DistanceLeft`	`double`	อ่าน/เขียน	คืนค่าหรือกำหนดระยะห่าง (เป็นจุด) ระหว่างข้อความในเอกสารกับด้านซ้ายของรูปร่าง.
`DistanceRight`	`double`	อ่าน/เขียน	คืนค่าหรือกำหนดระยะห่าง (เป็นจุด) ระหว่างข้อความในเอกสารกับด้านขวาของรูปร่าง.
`Rotation`	`double`	อ่าน/เขียน	กำหนดมุม (เป็นองศา) ที่รูปทรงถูกหมุน.
`ZOrder`	`int`	อ่าน/เขียน	กำหนดลำดับการแสดงผลของรูปทรงที่ทับซ้อนกัน.
`ParentParagraph`	`Paragraph`	อ่าน	คืนย่อหน้าพาเรนต์โดยตรง.
`Bounds`	`RectangleF`	อ่าน/เขียน	รับหรือกำหนดตำแหน่งและขนาดของบล็อกที่บรรจุรูปร่าง.
`BoundsInPoints`	`RectangleF`	อ่าน	รับตำแหน่งและขนาดของบล็อกที่บรรจุรูปร่างเป็นจุด โดยอิงตามจุดยึดของรูปร่างที่อยู่บนสุด.
`BoundsWithEffects`	`RectangleF`	อ่าน	รับขนาดสุดท้ายที่วัตถุรูปร่างนี้มีหลังจากใช้เอฟเฟกต์การวาด.
`ShapeType`	`ShapeType`	อ่าน	รับประเภทของรูปทรง.
`MarkupLanguage`	`ShapeMarkupLanguage`	อ่าน	รับ MarkupLanguage ที่ใช้สำหรับวัตถกราฟิกนี้.
`SizeInPoints`	`SizeF`	อ่าน	รับขนาดของ shape ในหน่วย points.
`FlipOrientation`	`FlipOrientation`	อ่าน/เขียน	สลับการวางแนวของรูปร่าง.
`RelativeHorizontalPosition`	`RelativeHorizontalPosition`	อ่าน/เขียน	ระบุว่ารูปร่างวางตำแหน่งแนวนอนสัมพันธ์กับอะไร.
`RelativeVerticalPosition`	`RelativeVerticalPosition`	อ่าน/เขียน	ระบุว่ารูปร่างวางตำแหน่งแนวตั้งสัมพันธ์กับอะไร.
`RelativeHorizontalSize`	`RelativeHorizontalSize`	อ่าน/เขียน	รับหรือกำหนดค่าขนาดสัมพัทธ์ของรูปในแนวนอน.
`RelativeVerticalSize`	`RelativeVerticalSize`	อ่าน/เขียน	รับหรือกำหนดค่าขนาดสัมพัทธ์ของรูปร่างในแนวตั้ง.
`LeftRelative`	`float`	อ่าน/เขียน	รับหรือกำหนดค่าที่แสดงตำแหน่งซ้ายสัมพัทธ์ของรูปร่างเป็นเปอร์เซ็นต์.
`TopRelative`	`float`	อ่าน/เขียน	รับหรือกำหนดค่าที่แสดงตำแหน่งบนสัมพัทธ์ของรูปเป็นเปอร์เซ็นต์.
`HeightRelative`	`float`	อ่าน/เขียน	รับหรือกำหนดค่าที่แสดงเปอร์เซ็นต์ของความสูงสัมพัทธ์ของรูป.
`WidthRelative`	`float`	อ่าน/เขียน	รับหรือกำหนดค่าที่แสดงเปอร์เซ็นต์ของความกว้างสัมพัทธ์ของรูป.
`HorizontalAlignment`	`HorizontalAlignment`	อ่าน/เขียน	ระบุว่ารูปร่างถูกจัดตำแหน่งในแนวนอนอย่างไร.
`VerticalAlignment`	`VerticalAlignment`	อ่าน/เขียน	ระบุว่ารูปร่างถูกจัดตำแหน่งในแนวตั้งอย่างไร.
`WrapType`	`WrapType`	อ่าน/เขียน	กำหนดว่ารูปร่างเป็น inline หรือ floating.
`WrapSide`	`WrapSide`	อ่าน/เขียน	ระบุวิธีที่ข้อความห่อหุ้มรอบรูปทรง.
`CoordOrigin`	`Point`	อ่าน/เขียน	พิกัดที่มุมซ้ายบนของบล็อกที่บรรจุรูปทรงนี้.
`CoordSize`	`Size`	อ่าน/เขียน	ความกว้างและความสูงของพื้นที่พิกัดภายในบล็อกที่บรรจุรูปร่างนี้.
`Font`	`Font`	อ่าน	ให้การเข้าถึงการจัดรูปแบบฟอนต์ของอ็อบเจ็กต์นี้.
`IsSignatureLine`	`bool`	อ่าน	ระบุว่า shape เป็น SignatureLine.
`IsLayoutInCell`	`bool`	อ่าน/เขียน	รับหรือกำหนดค่าสถานะที่บ่งบอกว่ารูปทรงจะแสดงภายในตารางหรืออยู่นอกตาราง.
`Hidden`	`bool`	อ่าน/เขียน	รับหรือกำหนดค่าบูลีนที่บ่งบอกว่ารูปทรงมองเห็นได้หรือไม่.
`IsComposite`	`bool`	อ่าน	คืนค่า true เนื่องจากโหนดนี้สามารถมีโหนดลูกได้.
`HasChildNodes`	`bool`	อ่าน	คืนค่า true หากโหนดนี้มีโหนดลูกใด ๆ.
`FirstChild`	`Node`	อ่าน	รับลูกแรกของโหนด.
`LastChild`	`Node`	อ่าน	รับบุตรสุดท้ายของโหนด.
`Count`	`int`	อ่าน	รับจำนวนลูกโดยตรงของโหนดนี้.
`ParentNode`	`CompositeNode`	อ่าน	รับผู้ปกครองโดยตรงของโหนดนี้.
`Document`	`DocumentBase`	อ่าน	รับเอกสารที่โหนดนี้เป็นส่วนของ.
`PreviousSibling`	`Node`	อ่าน	รับโหนดที่อยู่ก่อนหน้าโหนดนี้โดยตรง.
`NextSibling`	`Node`	อ่าน	รับโหนดที่ตามมาทันทีหลังจากโหนดนี้.
`Range`	`Range`	อ่าน	ส่งคืนอ็อบเจ็กต์ Range ที่แสดงส่วนของเอกสารที่อยู่ในโหนดนี้.
`CustomNodeId`	`int`	อ่าน/เขียน	ระบุตัวระบุโหนดแบบกำหนดเอง.

วิธีการ

ลายเซ็น	คำอธิบาย
`Shape(doc: DocumentBase, shapeType: ShapeType)`	สร้างอ็อบเจ็กต์ shape ใหม่.
`Accept(visitor: DocumentVisitor)`	เรียก VisitShapeStart, จากนั้นเรียก Accept สำหรับโหนดลูกทั้งหมดของ shape และเรียก VisitShapeEnd ในตอนท้าย.
`AcceptStart(visitor: DocumentVisitor)`	รับ visitor เพื่อเยี่ยมชมจุดเริ่มต้นของรูปร่าง.
`AcceptEnd(visitor: DocumentVisitor)`	รับ visitor เพื่อเยี่ยมชมจุดสิ้นสุดของรูปร่าง.
`LocalToParent(value: PointF)`	แปลงค่าจากระบบพิกัดท้องถิ่นเป็นระบบพิกัดของรูปร่างแม่.
`AdjustWithEffects(source: RectangleF)`	เพิ่มค่าขอบเขตของเอฟเฟกต์ลงในสี่เหลี่ยมต้นทางและคืนค่าสี่เหลี่ยมสุดท้าย.
`GetText()`	รับข้อความของโหนดนี้และของโหนดลูกทั้งหมด.
`GetChildNodes(nodeType: NodeType, isDeep: bool)`	คืน collection ของ child nodes ที่ตรงกับ type ที่ระบุ.
`GetChild(nodeType: NodeType, index: int, isDeep: bool)`	คืน Nth child node ที่ตรงกับ type ที่ระบุ.
`SelectNodes(xpath: string)`	เลือก list ของ nodes ที่ตรงกับ XPath expression.
`SelectSingleNode(xpath: string)`	เลือก Node แรกที่ตรงกับนิพจน์ XPath.
`GetEnumerator()`	ให้การสนับสนุนการทำซ้ำแบบ for each บนโหนดลูกของโหนดนี้.
`AppendChild(newChild: T)`	เพิ่มโหนดที่ระบุไปยังตำแหน่งท้ายของรายการโหนดลูกของโหนดนี้.
`PrependChild(newChild: T)`	เพิ่มโหนดที่ระบุไปยังตำแหน่งเริ่มต้นของรายการโหนดลูกของโหนดนี้.
`InsertAfter(newChild: T, refChild: Node)`	แทรกโหนดที่ระบุทันทีหลังจากโหนดอ้างอิงที่ระบุ.
`InsertBefore(newChild: T, refChild: Node)`	แทรกโหนดที่ระบุทันทีก่อนโหนดอ้างอิงที่ระบุ.
`RemoveChild(oldChild: T)`	ลบโหนดลูกที่ระบุ.
`RemoveAllChildren()`	ลบโหนดลูกทั้งหมดของโหนดปัจจุบัน.
`RemoveSmartTags()`	ลบโหนดทายาท SmartTag ทั้งหมดของโหนดปัจจุบัน.
`IndexOf(child: Node)`	คืนค่าดัชนีของโหนดลูกที่ระบุในอาเรย์โหนดลูก.
`CreateNavigator()`	สร้างตัวนำทางที่สามารถใช้เพื่อสำรวจและอ่านโหนด.
`Clone(isCloneChildren: bool)`	คุณควรใช้การโอเวอร์โหลด Clone(bool, INodeCloningListener) เมื่อการทำสำเนาโหนดเป็นส่วนหนึ่งของกระบวนการทำสำเนาโหนดอื่น (โดยทั่วไปคือโหนดเชิงประกอบ).
`GetAncestor(ancestorType: Type)`	รับบรรพบุรุษแรกของประเภทวัตถุที่ระบุ.
`GetAncestorOf()`	เรียก GetAncestorOf บนอินสแตนซ์ Shape นี้.
`Remove()`	ลบตัวเองออกจากโหนดแม่.
`NextPreOrder(rootNode: Node)`	ดึงโหนดถัดไปตามอัลกอริธึมการเดินต้นไม้แบบ pre-order.
`PreviousPreOrder(rootNode: Node)`	ดึงโหนดก่อนหน้าตามอัลกอริธึมการเดินต้นไม้แบบ pre-order.
`ToString(saveFormat: SaveFormat)`	ส่งออกเนื้อหาของโหนดเป็นสตริงในรูปแบบที่ระบุ.
`NodeTypeToString(nodeType: NodeType)`	utility method ที่แปลง node type enum value ให้เป็นสตริงที่เป็นมิตรต่อผู้ใช้.

ดูเพิ่มเติม

Aspose.Words for .NET — Enterprise API Reference