مستطیل
نمای کلی
Rectangle یک کلاس در Aspose.PDF FOSS برای .NET است.
نمایش یک مستطیل که توسط مختصات پایین‑چپ و بالا‑راست تعریف شده است (قواعد فضای کاربری PDF: Y به سمت بالا افزایش مییابد).
این کلاس ۲۵ متد برای کار با اشیاء Rectangle در برنامههای .NET فراهم میکند.
متدهای موجود شامل: Center، Clone، Contains، ContainsLine، ContainsPoint، Equals، FromRect، GetHashCode، Intersect، IsIntersect، Join، MoveBy، و ۷ متد دیگر.
تمام اعضای عمومی پس از نصب بسته Aspose.PDF FOSS for .NET برای هر برنامه .NET قابل دسترسی هستند.
ویژگیها: Empty، Height، IsEmpty، IsPoint، IsTrivial، LLX، و ۵ مورد دیگر.
ویژگیها
| Name | Type | Access | Description |
|---|---|---|---|
LLX | double | Read/Write | دریافت یا تنظیم llx. |
LLY | double | Read/Write | دریافت یا تنظیم lly. |
URX | double | Read/Write | دریافت یا تنظیم urx. |
URY | double | Read/Write | دریافت یا تنظیم ury. |
Width | double | Read | دریافت عرض. |
Height | double | Read | دریافت ارتفاع. |
Empty | Rectangle | Read | یک مستطیل خالی (تمام مختصات صفر). |
Trivial | Rectangle | Read | مستطیل ساده/ sentinel (-1, -1, -1, -1) که توسط Aspose.PDF به عنوان نشانگر «بدون مقدار» استفاده میشود. |
IsPoint | bool | Read | درست وقتی این مستطیل عرض صفر و ارتفاع صفر دارد (LLX == URX و LLY == URY). |
IsTrivial | bool | Read | درست وقتی این مستطیل برابر با sentinel ساده (-1, -1, -1, -1) است که توسط کتابخانه PDF به عنوان نشانگر «بدون مقدار» استفاده میشود. |
IsEmpty | bool | Read | مقدار true را برمیگرداند وقتی مستطیل هیچ مساحت مثبتای ندارد — مختصات معکوس هستند (llx >= urx یا lly >= ury) یا عرض/ارتفاع صفر دارند. |
متدها
| امضا | توضیح |
|---|---|
Rectangle(llx: double, lly: double, urx: double, ury: double) | متد Rectangle را بر روی این نمونهٔ Rectangle فراخوانی میکند. |
Rectangle(llx: double, lly: double, urx: double, ury: double, normalizeCoordinates: bool) | یک مستطیل ایجاد میکند. |
Clone() | یک کپی سطحی از این مستطیل را برمیگرداند (مطابق با امضای استاندارد متد Clone() شی). |
Center() | مرکز هندسی مستطیل. |
ContainsPoint(x: double, y: double) | آزمون اینکه آیا x, y داخل مستطیل قرار دارد (شامل لبهها). |
Contains(point: Point, inclusive: bool) | آزمون اینکه آیا نقطه داخل مستطیل قرار دارد. |
ContainsLine(x1: double, y1: double, x2: double, y2: double) | آزمون اینکه آیا قطعه خط (x1,y1) → (x2,y2) به طور کامل در داخل مستطیل قرار دارد (هر دو نقطه انتهایی داخل، شامل لبهها). |
Contains(x: double, y: double) | متد Contains را بر روی این نمونهٔ Rectangle فراخوانی میکند. |
Contains(other: Rectangle) | |
Intersect(otherRect: Rectangle) | تقاطع هندسی. |
IsIntersect(otherRect: Rectangle) | در صورتی که این مستطیل هر مساحتی را با otherRect مشترک داشته باشد، درست است. |
MoveBy(dx: double, dy: double) | این مستطیل را به صورت درجا با (dx,dy) جابهجا میکند. |
Rotate(angle: Rotation) | این مستطیل را به صورت درجا با Rotation داده شده میچرخاند. |
Rotate(angle: int) | این مستطیل را به صورت درجا با زاویهٔ درجهای میچرخاند (معمولاً 0/90/180/270؛ برای زوایای دلخواه جعبهٔ محاطی نقاط گوشهٔ چرخیده محاسبه میشود). |
ToPoints() | چهار گوشهٔ مستطیل به ترتیب LL → LR → UR → UL. |
Parse(value: string) | یک مستطیل را از فرم استاندارد “LLX LLY URX URY” (جدا شده با فاصله یا کاما) تجزیه میکند. |
Equals(obj: object?) | متد Equals را بر روی این نمونهٔ Rectangle فراخوانی میکند. |
Equals(other: Rectangle?) | برابری مختصاتی با تحمل کوچک عدد شناور. |
GetHashCode() | متد GetHashCode را بر روی این نمونهٔ Rectangle فراخوانی میکند. |
NearEquals(other: Rectangle, delta: double) | بررسی اینکه آیا این مستطیل تقریباً برابر با مستطیل دیگر در محدودهٔ تحمل داده شده است. |
Join(otherRect: Rectangle) | اتحاد (جعبهٔ محاطی) این مستطیل و مستطیل دیگر را برمیگرداند. |
ToString() | متد ToString را بر روی این نمونهٔ Rectangle فراخوانی میکند. |
FromRect(src: System.Drawing.Rectangle) | تبدیل از System.Drawing.Rectangle (x, y, width, height) به PDF Rectangle (LLX/LLY/URX/URY). |
FromRect(src: System.Drawing.RectangleF) | تبدیل از System.Drawing.RectangleF. |
ToRect() | این PDF Rectangle را به System.Drawing.Rectangle تبدیل میکند. |