مستطیل

مستطیل

نمای کلی

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، و ۵ مورد دیگر.

ویژگی‌ها

NameTypeAccessDescription
LLXdoubleRead/Writeدریافت یا تنظیم llx.
LLYdoubleRead/Writeدریافت یا تنظیم lly.
URXdoubleRead/Writeدریافت یا تنظیم urx.
URYdoubleRead/Writeدریافت یا تنظیم ury.
WidthdoubleReadدریافت عرض.
HeightdoubleReadدریافت ارتفاع.
EmptyRectangleReadیک مستطیل خالی (تمام مختصات صفر).
TrivialRectangleReadمستطیل ساده/ sentinel (-1, -1, -1, -1) که توسط Aspose.PDF به عنوان نشانگر «بدون مقدار» استفاده می‌شود.
IsPointboolReadدرست وقتی این مستطیل عرض صفر و ارتفاع صفر دارد (LLX == URX و LLY == URY).
IsTrivialboolReadدرست وقتی این مستطیل برابر با sentinel ساده (-1, -1, -1, -1) است که توسط کتابخانه PDF به عنوان نشانگر «بدون مقدار» استفاده می‌شود.
IsEmptyboolReadمقدار 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 تبدیل می‌کند.

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

 فارسی