Shape

نمای کلی

Shape یک کلاس در Aspose.Words FOSS برای .NET است. ارث‌بری از: ShapeBase، ITextBox، IStrokable.

نمایانگر یک شیء در لایهٔ رسم است، مانند AutoShape، جعبهٔ متن، فرم آزاد، شیء OLE، کنترل ActiveX یا تصویر.

این کلاس ۲۹ متد برای کار با اشیای Shape در برنامه‌های .NET فراهم می‌کند. متدهای موجود عبارتند از: Accept، AcceptEnd، AcceptStart، AdjustWithEffects، AppendChild، Clone، CreateNavigator، GetAncestor، GetAncestorOf، GetChild، GetChildNodes، GetEnumerator، و ۱۷ متد دیگر. تمام اعضای عمومی پس از نصب بسته Aspose.Words FOSS برای .NET به هر برنامهٔ .NET قابل دسترسی هستند. ویژگی‌ها: Adjustments، AllowOverlap، AlternativeText، AnchorLocked، AspectRatioLocked، BehindText، و ۹۳ مورد دیگر.

خواص

نام	نوع	دسترسی	توضیح
`NodeType`	`NodeType`	خواندن	Shape را برمی‌گرداند.
`StoryType`	`StoryType`	خواندن	Textbox را برمی‌گرداند.
`ExtrusionEnabled`	`bool`	خواندن	در صورتی که اثر برآمدگی فعال باشد، true برگردانده می‌شود.
`ShadowEnabled`	`bool`	خواندن	در صورتی که اثر سایه فعال باشد، true برگردانده می‌شود.
`Stroke`	`Stroke`	خواندن	یک stroke برای یک شکل تعریف می‌کند.
`Stroked`	`bool`	خواندن/نوشتن	مشخص می‌کند که آیا مسیر کشیده شود.
`StrokeWeight`	`double`	خواندن/نوشتن	ضخامت قلم‌مو را که مسیر یک شکل را به نقطه‌ها می‌کشد، تعریف می‌کند.
`StrokeColor`	`Color`	خواندن/نوشتن	رنگ یک خط را تعریف می‌کند.
`Filled`	`bool`	خواندن/نوشتن	تعیین می‌کند که آیا مسیر بسته شکل پر شود یا خیر.
`FillColor`	`Color`	خواندن/نوشتن	رنگ قلم‌مو را تعریف می‌کند که مسیر بسته شکل را پر می‌کند.
`HasImage`	`bool`	خواندن	در صورتی که شکل بایت‌های تصویر داشته باشد یا به تصویری لینک کند، true را برمی‌گرداند.
`ImageData`	`ImageData`	خواندن	دسترسی به تصویر شکل را فراهم می‌کند.
`OleFormat`	`OleFormat`	خواندن	دسترسی به داده‌های OLE یک شکل را فراهم می‌کند.
`TextBox`	`TextBox`	خواندن	ویژگی‌هایی را تعریف می‌کند که مشخص می‌کند متن چگونه در یک شکل نمایش داده شود.
`TextPath`	`TextPath`	خواندن	متن مسیر متن (از یک شیء WordArt) را تعریف می‌کند.
`FirstParagraph`	`Paragraph`	خواندن	Gets پاراگراف اول در shape.
`LastParagraph`	`Paragraph`	خواندن	آخرین پاراگراف را در شکل برمی‌گرداند.
`HorizontalRuleFormat`	`HorizontalRuleFormat`	خواندن	دسترسی به ویژگی‌های شکل خط افقی را فراهم می‌کند.
`Adjustments`	`AdjustmentCollection`	خواندن	دسترسی به مقادیر خام تنظیم یک شکل را فراهم می‌کند.
`SignatureLine`	`SignatureLine`	خواندن	شیء SignatureLine را دریافت می‌کند اگر شکل یک خط امضا باشد.
`HasChart`	`bool`	خواندن	اگر این Shape یک Chart داشته باشد، true برمی‌گرداند.
`HasSmartArt`	`bool`	خواندن	اگر این Shape یک شیء SmartArt داشته باشد، true برمی‌گرداند.
`Chart`	`Chart`	خواندن	اگر این shape یک Chart داشته باشد، دسترسی به خصوصیات نمودار را فراهم می‌کند.
`Fill`	`Fill`	خواندن	قالب پر کردن را برای شکل دریافت می‌کند.
`ShadowFormat`	`ShadowFormat`	خواندن	قالب سایه را برای شکل دریافت می‌کند.
`Glow`	`GlowFormat`	خواندن	قالب‌بندی درخشش را برای شکل دریافت می‌کند.
`Reflection`	`ReflectionFormat`	خواندن	قالب‌بندی بازتاب برای شکل را دریافت می‌کند.
`SoftEdge`	`SoftEdgeFormat`	خواندن	فرمت لبه نرم را برای شکل دریافت می‌کند.
`ScreenTip`	`string`	خواندن/نوشتن	متنی را که هنگام حرکت اشاره‌گر ماوس بر روی شکل نمایش داده می‌شود، تعریف می‌کند.
`HRef`	`string`	خواندن/نوشتن	آدرس کامل پیوند ابرمتنی را برای یک شکل دریافت یا تنظیم می‌کند.
`Target`	`string`	خواندن/نوشتن	قاب هدف را برای هایپرلینک شکل دریافت یا تنظیم می‌کند.
`AlternativeText`	`string`	خواندن/نوشتن	متن جایگزین را تعریف می‌کند که به جای یک گرافیک نمایش داده می‌شود.
`IsDecorative`	`bool`	خواندن/نوشتن	دریافت یا تنظیم پرچمی که مشخص می‌کند آیا شکل در سند تزئینی است یا خیر.
`Title`	`string`	خواندن/نوشتن	دریافت یا تنظیم عنوان (کپشن) شیء شکل فعلی.
`Name`	`string`	خواندن/نوشتن	دریافت یا تنظیم نام اختیاری شکل.
`IsInsertRevision`	`bool`	خواندن	دریافت می‌کند آیا بازنگری درج شده است.
`IsDeleteRevision`	`bool`	خواندن	دریافت مقدار `is delete revision`.
`IsMoveFromRevision`	`bool`	خواندن	دریافت مقدار `isMove` از بازنگری.
`IsMoveToRevision`	`bool`	خواندن	مقدار `is move to revision` را دریافت می‌کند.
`IsTopLevel`	`bool`	خواندن	اگر این شکل فرزند یک شکل گروهی نباشد، true را برمی‌گرداند.
`IsGroup`	`bool`	خواندن	در صورتی که این یک شکل گروهی باشد، مقدار true را برمی‌گرداند.
`IsImage`	`bool`	خواندن	در صورتی که این شکل یک شکل تصویر باشد، مقدار true را برمی‌گرداند.
`IsHorizontalRule`	`bool`	خواندن	در صورتی که این شکل یک خط افقی باشد، مقدار true را برمی‌گرداند.
`IsWordArt`	`bool`	خواندن	اگر این شکل یک شیء WordArt باشد، مقدار true را برمی‌گرداند.
`CanHaveImage`	`bool`	خواندن	در صورتی که نوع شکل اجازهٔ داشتن تصویر را بدهد، مقدار true برگردانده می‌شود.
`AnchorLocked`	`bool`	خواندن/نوشتن	مشخص می‌کند که آیا لنگر شکل قفل شده است یا خیر.
`AspectRatioLocked`	`bool`	خواندن/نوشتن	مشخص می‌کند که آیا نسبت ابعاد شکل قفل شده است یا خیر.
`AllowOverlap`	`bool`	خواندن/نوشتن	مقداری را دریافت یا تنظیم می‌کند که مشخص می‌کند آیا این شکل می‌تواند با سایر شکل‌ها همپوشانی داشته باشد یا نه.
`BehindText`	`bool`	خواندن/نوشتن	مشخص می‌کند که آیا شکل زیر متن است یا بالای آن.
`IsInline`	`bool`	خواندن	روشی سریع برای تعیین اینکه آیا این شکل به صورت درون‌خطی با متن قرار دارد یا خیر.
`Left`	`double`	خواندن/نوشتن	موقعیت لبهٔ چپ بلوک حاوی شکل را دریافت یا تنظیم می‌کند.
`Top`	`double`	خواندن/نوشتن	موقعیت لبهٔ بالایی بلوک حاوی شکل را دریافت یا تنظیم می‌کند.
`Right`	`double`	خواندن	موقعیت لبهٔ راست بلوک حاوی شکل را دریافت می‌کند.
`Bottom`	`double`	خواندن	موقعیت لبهٔ پایین بلوک حاوی شکل را دریافت می‌کند.
`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`	خواندن	اندازهٔ شکل را بر حسب نقاط دریافت می‌کند.
`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`	خواندن	نشان می‌دهد که شکل یک 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)`	یک شیء شکل جدید ایجاد می‌کند.
`Accept(visitor: DocumentVisitor)`	متد VisitShapeStart را فراخوانی می‌کند، سپس برای تمام گره‌های فرزند شکل متد Accept را فراخوانی می‌کند و در پایان VisitShapeEnd را فراخوانی می‌کند.
`AcceptStart(visitor: DocumentVisitor)`	یک بازدیدکننده را برای بازدید از ابتدای شکل می‌پذیرد.
`AcceptEnd(visitor: DocumentVisitor)`	یک بازدیدکننده را برای بازدید از انتهای شکل می‌پذیرد.
`LocalToParent(value: PointF)`	یک مقدار را از فضای مختصات محلی به فضای مختصات شکل والد تبدیل می‌کند.
`AdjustWithEffects(source: RectangleF)`	به مستطیل منبع مقادیر گسترش اثر را اضافه می‌کند و مستطیل نهایی را برمی‌گرداند.
`GetText()`	متن این گره و تمام فرزندان آن را دریافت می‌کند.
`GetChildNodes(nodeType: NodeType, isDeep: bool)`	مجموعه‌ای از گره‌های فرزند که با نوع مشخص شده مطابقت دارند را برمی‌گرداند.
`GetChild(nodeType: NodeType, index: int, isDeep: bool)`	گره فرزند nام که با نوع مشخص شده مطابقت دارد را برمی‌گرداند.
`SelectNodes(xpath: string)`	لیستی از گره‌هایی که با عبارت XPath مطابقت دارند را انتخاب می‌کند.
`SelectSingleNode(xpath: string)`	اولین گره‌ای که با عبارت 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)`	گره بعدی را بر اساس الگوریتم پیمایش پیش‌سفری درخت دریافت می‌کند.
`PreviousPreOrder(rootNode: Node)`	گره قبلی را بر اساس الگوریتم پیمایش پیش‌سفری درخت دریافت می‌کند.
`ToString(saveFormat: SaveFormat)`	محتویات گره را به یک رشته در قالب مشخص‌شده صادر می‌کند.
`NodeTypeToString(nodeType: NodeType)`	یک متد کمکی که مقدار enum نوع گره را به یک رشته کاربرپسند تبدیل می‌کند.

همچنین ببینید:

Aspose.Words for .NET — Enterprise API Reference