Shape
Tổng quan
Shape là một lớp trong Aspose.Words FOSS cho .NET. Kế thừa từ: ShapeBase, ITextBox, IStrokable.
Đại diện cho một đối tượng trong lớp vẽ, chẳng hạn như AutoShape, ô văn bản, hình dạng tự do, đối tượng OLE, điều khiển ActiveX, hoặc hình ảnh.
Lớp này cung cấp 29 phương thức để làm việc với các đối tượng Shape trong các chương trình .NET. Các phương thức khả dụng bao gồm: Accept, AcceptEnd, AcceptStart, AdjustWithEffects, AppendChild, Clone, CreateNavigator, GetAncestor, GetAncestorOf, GetChild, GetChildNodes, GetEnumerator, và 17 phương thức bổ sung. Tất cả các thành viên công khai đều có thể truy cập bởi bất kỳ ứng dụng .NET nào sau khi cài đặt gói Aspose.Words FOSS cho .NET. Thuộc tính: Adjustments, AllowOverlap, AlternativeText, AnchorLocked, AspectRatioLocked, BehindText, và 93 mục khác.
Thuộc tính
| Tên | Kiểu | Truy cập | Mô tả |
|---|---|---|---|
NodeType | NodeType | Đọc | Trả về Shape. |
StoryType | StoryType | Đọc | Trả về Textbox. |
ExtrusionEnabled | bool | Đọc | Trả về true nếu hiệu ứng extrusion được bật. |
ShadowEnabled | bool | Đọc | Trả về true nếu hiệu ứng bóng được bật. |
Stroke | Stroke | Đọc | Xác định một đường viền cho hình dạng. |
Stroked | bool | Đọc/Ghi | Xác định xem đường dẫn có được vẽ viền hay không. |
StrokeWeight | double | Đọc/Ghi | Xác định độ dày của cọ vẽ viền cho đường dẫn của hình dạng, tính bằng điểm. |
StrokeColor | Color | Đọc/Ghi | Xác định màu sắc của viền. |
Filled | bool | Đọc/Ghi | Xác định liệu đường bao kín của hình dạng có được tô đầy hay không. |
FillColor | Color | Đọc/Ghi | Xác định màu cọ dùng để tô đầy đường bao kín của hình dạng. |
HasImage | bool | Đọc | Trả về true nếu hình dạng có byte ảnh hoặc liên kết một ảnh. |
ImageData | ImageData | Đọc | Cung cấp quyền truy cập vào ảnh của hình dạng. |
OleFormat | OleFormat | Đọc | Cung cấp quyền truy cập vào dữ liệu OLE của một hình dạng. |
TextBox | TextBox | Đọc | Xác định các thuộc tính chỉ định cách văn bản được hiển thị trong một hình dạng. |
TextPath | TextPath | Đọc | Xác định văn bản của đường dẫn văn bản (của một đối tượng WordArt). |
FirstParagraph | Paragraph | Đọc | Lấy đoạn văn đầu tiên trong shape. |
LastParagraph | Paragraph | Đọc | Lấy đoạn văn cuối cùng trong Shape. |
HorizontalRuleFormat | HorizontalRuleFormat | Đọc | Cung cấp quyền truy cập vào các thuộc tính của hình dạng đường kẻ ngang. |
Adjustments | AdjustmentCollection | Đọc | Cung cấp quyền truy cập vào các giá trị thô điều chỉnh của một hình dạng. |
SignatureLine | SignatureLine | Đọc | Lấy đối tượng SignatureLine nếu shape là một dòng chữ ký. |
HasChart | bool | Đọc | Trả về true nếu Shape này có Chart. |
HasSmartArt | bool | Đọc | Trả về true nếu Shape này có một đối tượng SmartArt. |
Chart | Chart | Đọc | Cung cấp quyền truy cập vào các thuộc tính chart nếu shape này có Chart. |
Fill | Fill | Đọc | Lấy định dạng tô đầy cho shape. |
ShadowFormat | ShadowFormat | Đọc | Lấy định dạng bóng cho shape. |
Glow | GlowFormat | Đọc | Lấy định dạng phát sáng cho hình dạng. |
Reflection | ReflectionFormat | Đọc | Lấy định dạng phản chiếu cho hình dạng. |
SoftEdge | SoftEdgeFormat | Đọc | Lấy định dạng viền mềm cho hình dạng. |
ScreenTip | string | Đọc/Ghi | Xác định văn bản hiển thị khi con trỏ chuột di chuột qua hình dạng. |
HRef | string | Đọc/Ghi | Lấy hoặc đặt địa chỉ siêu liên kết đầy đủ cho một hình dạng. |
Target | string | Đọc/Ghi | Lấy hoặc đặt khung mục tiêu cho siêu liên kết hình dạng. |
AlternativeText | string | Đọc/Ghi | Xác định văn bản thay thế sẽ được hiển thị thay vì hình ảnh. |
IsDecorative | bool | Đọc/Ghi | Lấy hoặc đặt cờ cho biết liệu hình dạng có phải là trang trí trong tài liệu hay không. |
Title | string | Đọc/Ghi | Lấy hoặc đặt tiêu đề (chú thích) của đối tượng hình hiện tại. |
Name | string | Đọc/Ghi | Lấy hoặc đặt tên hình tùy chọn. |
IsInsertRevision | bool | Đọc | Lấy giá trị is insert revision. |
IsDeleteRevision | bool | Đọc | Lấy giá trị is delete revision. |
IsMoveFromRevision | bool | Đọc | Lấy giá trị IsMove từ revision. |
IsMoveToRevision | bool | Đọc | Lấy is move to revision. |
IsTopLevel | bool | Đọc | Trả về true nếu hình này không phải là con của một hình nhóm. |
IsGroup | bool | Đọc | Trả về true nếu đây là một hình nhóm. |
IsImage | bool | Đọc | Trả về true nếu hình dạng này là hình ảnh. |
IsHorizontalRule | bool | Đọc | Trả về true nếu hình dạng này là một đường kẻ ngang. |
IsWordArt | bool | Đọc | Trả về true nếu hình dạng này là một đối tượng WordArt. |
CanHaveImage | bool | Đọc | Trả về true nếu loại hình dạng cho phép hình dạng có một hình ảnh. |
AnchorLocked | bool | Đọc/Ghi | Xác định liệu neo của hình dạng có bị khóa hay không. |
AspectRatioLocked | bool | Đọc/Ghi | Xác định liệu tỷ lệ khung hình của hình dạng có bị khóa hay không. |
AllowOverlap | bool | Đọc/Ghi | Lấy hoặc đặt giá trị xác định liệu hình dạng này có thể chồng lên các hình dạng khác hay không. |
BehindText | bool | Đọc/Ghi | Xác định liệu hình dạng nằm dưới hay trên văn bản. |
IsInline | bool | Đọc | Cách nhanh để xác định xem hình này có được vị trí nội dòng với văn bản hay không. |
Left | double | Đọc/Ghi | Lấy hoặc đặt vị trí của cạnh trái của khối chứa của hình. |
Top | double | Đọc/Ghi | Lấy hoặc đặt vị trí của cạnh trên của khối chứa của hình dạng. |
Right | double | Đọc | Lấy vị trí của cạnh phải của khối chứa của hình dạng. |
Bottom | double | Đọc | Lấy vị trí của cạnh dưới của khối chứa của hình dạng. |
Width | double | Đọc/Ghi | Lấy hoặc đặt chiều rộng của khối chứa của hình dạng. |
Height | double | Đọc/Ghi | Lấy hoặc đặt chiều cao của khối chứa hình dạng. |
DistanceTop | double | Đọc/Ghi | Trả về hoặc đặt khoảng cách (tính bằng điểm) giữa văn bản tài liệu và cạnh trên của hình dạng. |
DistanceBottom | double | Đọc/Ghi | Trả về hoặc đặt khoảng cách (tính bằng điểm) giữa văn bản tài liệu và cạnh dưới của hình dạng. |
DistanceLeft | double | Đọc/Ghi | Trả về hoặc đặt khoảng cách (tính bằng điểm) giữa văn bản tài liệu và cạnh trái của hình. |
DistanceRight | double | Đọc/Ghi | Trả về hoặc đặt khoảng cách (tính bằng điểm) giữa văn bản tài liệu và cạnh phải của hình. |
Rotation | double | Đọc/Ghi | Xác định góc (theo độ) mà một hình dạng được xoay. |
ZOrder | int | Đọc/Ghi | Xác định thứ tự hiển thị của các hình dạng chồng lên nhau. |
ParentParagraph | Paragraph | Đọc | Trả về đoạn văn cha trực tiếp. |
Bounds | RectangleF | Đọc/Ghi | Lấy hoặc đặt vị trí và kích thước của khối chứa của hình. |
BoundsInPoints | RectangleF | Đọc | Lấy vị trí và kích thước của khối chứa của hình tính bằng điểm, tương đối với neo của hình trên cùng. |
BoundsWithEffects | RectangleF | Đọc | Lấy kích thước cuối cùng mà đối tượng hình này có sau khi áp dụng các hiệu ứng vẽ. |
ShapeType | ShapeType | Đọc | Lấy loại hình dạng. |
MarkupLanguage | ShapeMarkupLanguage | Đọc | Lấy MarkupLanguage được sử dụng cho đối tượng đồ họa này. |
SizeInPoints | SizeF | Đọc | Lấy kích thước của shape tính bằng points. |
FlipOrientation | FlipOrientation | Đọc/Ghi | Thay đổi hướng của một hình dạng. |
RelativeHorizontalPosition | RelativeHorizontalPosition | Đọc/Ghi | Xác định vị trí ngang của hình dựa trên gì. |
RelativeVerticalPosition | RelativeVerticalPosition | Đọc/Ghi | Xác định vị trí dọc của hình dựa trên gì. |
RelativeHorizontalSize | RelativeHorizontalSize | Đọc/Ghi | Lấy hoặc đặt giá trị của kích thước tương đối của hình dạng theo hướng ngang. |
RelativeVerticalSize | RelativeVerticalSize | Đọc/Ghi | Lấy hoặc đặt giá trị kích thước tương đối của hình dạng theo chiều dọc. |
LeftRelative | float | Đọc/Ghi | Lấy hoặc đặt giá trị đại diện cho vị trí trái tương đối của hình dạng tính bằng phần trăm. |
TopRelative | float | Đọc/Ghi | Lấy hoặc đặt giá trị biểu thị vị trí trên tương đối của hình dạng tính bằng phần trăm. |
HeightRelative | float | Đọc/Ghi | Lấy hoặc đặt giá trị biểu thị tỷ lệ phần trăm chiều cao tương đối của hình dạng. |
WidthRelative | float | Đọc/Ghi | Lấy hoặc đặt giá trị biểu thị tỷ lệ phần trăm chiều rộng tương đối của hình dạng. |
HorizontalAlignment | HorizontalAlignment | Đọc/Ghi | Xác định cách hình dạng được định vị theo chiều ngang. |
VerticalAlignment | VerticalAlignment | Đọc/Ghi | Xác định cách hình dạng được định vị theo chiều dọc. |
WrapType | WrapType | Đọc/Ghi | Xác định liệu hình dạng là nội dòng hay nổi. |
WrapSide | WrapSide | Đọc/Ghi | Xác định cách văn bản được bao quanh hình dạng. |
CoordOrigin | Point | Đọc/Ghi | Các tọa độ tại góc trên-trái của khối chứa của hình dạng này. |
CoordSize | Size | Đọc/Ghi | Chiều rộng và chiều cao của không gian tọa độ bên trong khối chứa của hình này. |
Font | Font | Đọc | Cung cấp quyền truy cập vào định dạng phông chữ của đối tượng này. |
IsSignatureLine | bool | Đọc | Cho biết rằng shape là một SignatureLine. |
IsLayoutInCell | bool | Đọc/Ghi | Lấy hoặc đặt một flag cho biết liệu shape có được hiển thị bên trong bảng hay bên ngoài nó. |
Hidden | bool | Đọc/Ghi | Lấy hoặc đặt một giá trị boolean cho biết liệu shape có hiển thị hay không. |
IsComposite | bool | Đọc | Trả về true vì node này có thể có các node con. |
HasChildNodes | bool | Đọc | Trả về true nếu nút này có bất kỳ nút con nào. |
FirstChild | Node | Đọc | Lấy phần tử con đầu tiên của node. |
LastChild | Node | Đọc | Lấy phần tử con cuối cùng của nút. |
Count | int | Đọc | Lấy số lượng các phần tử con trực tiếp của nút này. |
ParentNode | CompositeNode | Đọc | Lấy nút cha trực tiếp của nút này. |
Document | DocumentBase | Đọc | Lấy tài liệu mà nút này thuộc về. |
PreviousSibling | Node | Đọc | Lấy nút ngay trước nút này. |
NextSibling | Node | Đọc | Lấy node ngay sau node này. |
Range | Range | Đọc | Trả về một đối tượng Range đại diện cho phần của tài liệu được chứa trong nút này. |
CustomNodeId | int | Đọc/Ghi | Chỉ định định danh nút tùy chỉnh. |
Phương thức
| Chữ ký | Mô tả |
|---|---|
Shape(doc: DocumentBase, shapeType: ShapeType) | Tạo một đối tượng shape mới. |
Accept(visitor: DocumentVisitor) | Gọi VisitShapeStart, sau đó gọi Accept cho tất cả các nút con của shape và gọi VisitShapeEnd vào cuối. |
AcceptStart(visitor: DocumentVisitor) | Chấp nhận một visitor để thăm phần đầu của shape. |
AcceptEnd(visitor: DocumentVisitor) | Chấp nhận một visitor để thăm phần cuối của shape. |
LocalToParent(value: PointF) | Chuyển đổi một giá trị từ không gian tọa độ cục bộ sang không gian tọa độ của shape cha. |
AdjustWithEffects(source: RectangleF) | Thêm vào source rectangle các giá trị của effect extent và trả về final rectangle. |
GetText() | Lấy văn bản của nút này và của tất cả các nút con của nó. |
GetChildNodes(nodeType: NodeType, isDeep: bool) | Trả về một tập hợp các nút con khớp với loại được chỉ định. |
GetChild(nodeType: NodeType, index: int, isDeep: bool) | Trả về nút con thứ N khớp với loại được chỉ định. |
SelectNodes(xpath: string) | Chọn một danh sách các nút khớp với biểu thức XPath. |
SelectSingleNode(xpath: string) | Chọn Node đầu tiên phù hợp với biểu thức XPath. |
GetEnumerator() | Cung cấp hỗ trợ cho việc lặp kiểu for each trên các node con của node này. |
AppendChild(newChild: T) | Thêm node được chỉ định vào cuối danh sách các node con của node này. |
PrependChild(newChild: T) | Thêm node được chỉ định vào đầu danh sách các node con của node này. |
InsertAfter(newChild: T, refChild: Node) | Chèn nút được chỉ định ngay sau nút tham chiếu được chỉ định. |
InsertBefore(newChild: T, refChild: Node) | Chèn nút được chỉ định ngay trước nút tham chiếu được chỉ định. |
RemoveChild(oldChild: T) | Xóa nút con được chỉ định. |
RemoveAllChildren() | Xóa tất cả các nút con của nút hiện tại. |
RemoveSmartTags() | Xóa tất cả các nút con cháu SmartTag của nút hiện tại. |
IndexOf(child: Node) | Trả về chỉ mục của nút con được chỉ định trong mảng các nút con. |
CreateNavigator() | Tạo bộ điều hướng có thể được sử dụng để duyệt và đọc các nút. |
Clone(isCloneChildren: bool) | Bạn nên sử dụng overload Clone(bool, INodeCloningListener) khi việc sao chép nút là một phần của quá trình sao chép nút khác (thường là sao chép hợp thành). |
GetAncestor(ancestorType: Type) | Lấy tổ tiên đầu tiên của kiểu đối tượng được chỉ định. |
GetAncestorOf() | Gọi GetAncestorOf trên đối tượng Shape này. |
Remove() | Gỡ nó ra khỏi phần tử cha. |
NextPreOrder(rootNode: Node) | Lấy nút tiếp theo theo thuật toán duyệt cây theo thứ tự trước. |
PreviousPreOrder(rootNode: Node) | Lấy nút trước theo thuật toán duyệt cây theo thứ tự trước. |
ToString(saveFormat: SaveFormat) | Xuất nội dung của nút thành một chuỗi ở định dạng đã chỉ định. |
NodeTypeToString(nodeType: NodeType) | Một phương thức tiện ích chuyển đổi giá trị enum kiểu nút thành chuỗi thân thiện với người dùng. |