الفئة Pen

Pen class

يحدد كائنًا يُستخدم لرسم الخطوط والمنحنيات والأشكال.

public class Pen : TransparencySupporter

المنشئات

الاسمالوصف
Pen(Brush)ينشئ مثيلًا جديدًا من الفئة Pen باستخدام الـBrush.
Pen(Color)ينشئ مثيلًا جديدًا من الفئة Pen باستخدام اللون المحدد.
Pen(Brush, float)ينشئ مثيلًا جديدًا من الفئة Pen باستخدام الـBrush وWidth المحددين.
Pen(Color, float)ينشئ مثيلًا جديدًا من الفئة Pen باستخدام خصائص الـColor وWidth المحددة.

الخصائص

الاسمالوصف
Alignment { get; set; }يحصل أو يضبط المحاذاة لهذا Pen.
Brush { get; set; }يحصل أو يضبط الـBrush الذي يحدد سمات هذا Pen.
Color { get; set; }يحصل أو يضبط لون هذا Pen.
CompoundArray { get; set; }يحصل أو يضبط مصفوفة من القيم التي تحدد قلمًا مركبًا. القلم المركب يرسم خطًا مركبًا مكوّنًا من خطوط متوازية ومسافات.
CustomEndCap { get; set; }يحصل أو يضبط غطاءً مخصصًا لاستخدامه في نهاية الخطوط المرسومة بهذا Pen.
CustomStartCap { get; set; }يحصل أو يضبط غطاءً مخصصًا لاستخدامه في بداية الخطوط المرسومة بهذا Pen.
DashCap { get; set; }يحصل أو يضبط نمط الغطاء المستخدم في نهاية الشرطات التي تشكل الخطوط المتقطعة المرسومة بهذا Pen.
DashOffset { get; set; }يحصل أو يضبط المسافة من بداية الخط إلى بداية نمط الشرطة.
DashPattern { get; set; }يحصل أو يضبط مصفوفة من الشرطات والمسافات المخصصة.
DashStyle { get; set; }يحصل أو يضبط النمط المستخدم للخطوط المتقطعة المرسومة بهذا Pen.
EndCap { get; set; }يحصل أو يضبط نمط الغطاء المستخدم في نهاية الخطوط المرسومة بهذا Pen.
LineJoin { get; set; }يحصل أو يضبط نمط الوصل لنهايات خطين متتاليين مرسومين بهذا Pen.
MiterLimit { get; set; }يحصل أو يضبط حد سمك الوصل عند زاوية مائلة.
Opacity { get; set; }يحصل أو يعيّن شفافية الكائن. يجب أن تكون القيمة بين 0 و 1. القيمة 0 تعني أن الكائن مرئي بالكامل، والقيمة 1 تعني أن الكائن غير شفاف تمامًا.
PenType { get; }يحصل على نمط الخطوط المرسومة بهذا Pen.
StartCap { get; set; }يحصل أو يضبط نمط الغطاء المستخدم في بداية الخطوط المرسومة بهذا Pen.
Transform { get; set; }يحصل أو يضبط نسخة من التحويل الهندسي لهذا Pen.
Width { get; set; }يحصل أو يضبط عرض هذا Pen، بوحدات كائن Graphics المستخدم للرسم.

الطرق

الاسمالوصف
override Equals(object)تحقق مما إذا كانت الكائنات متساوية.
override GetHashCode()احصل على قيمة التجزئة للكائن الحالي.
MultiplyTransform(Matrix)يضرب مصفوفة التحويل لهذا Pen بالـMatrix.
MultiplyTransform(Matrix, MatrixOrder)يضرب مصفوفة التحويل لهذا Pen بالـMatrix المحدد بالترتيب المحدد.
ResetTransform()يعيد تعيين مصفوفة التحويل الهندسي لهذا Pen إلى هوية.
RotateTransform(float)يدور التحويل الهندسي المحلي بالزاوية المحددة. هذه الطريقة تسبق الدوران في التحويل.
RotateTransform(float, MatrixOrder)يدور التحويل الهندسي المحلي بالزاوية المحددة بالترتيب المحدد.
ScaleTransform(float, float)يقوم بتكبير التحويل الهندسي المحلي بالعوامل المحددة. هذه الطريقة تسبق مصفوفة التكبير في التحويل.
ScaleTransform(float, float, MatrixOrder)يقوم بتكبير التحويل الهندسي المحلي بالعوامل المحددة بالترتيب المحدد.
SetLineCap(LineCap, LineCap, DashCap)يضبط القيم التي تحدد نمط الغطاء المستخدم لإنهاء الخطوط المرسومة بهذا Pen.
TranslateTransform(float, float)يترجم التحويل الهندسي المحلي بالأبعاد المحددة. هذه الطريقة تسبق الترجمة في التحويل.
TranslateTransform(float, float, MatrixOrder)يترجم التحويل الهندسي المحلي بالأبعاد المحددة وفقًا للترتيب المحدد.

أمثلة

يوضح هذا المثال إنشاء واستخدام كائنات Pen. ينشئ المثال صورة جديدة ويرسم مستطيلات على سطح الصورة.

[C#]

//أنشئ مثيلاً من BmpOptions وعيّن خصائصه المتنوعة
Aspose.Imaging.ImageOptions.BmpOptions bmpOptions = new Aspose.Imaging.ImageOptions.BmpOptions();
bmpOptions.BitsPerPixel = 24;

//أنشئ مثيلاً من FileCreateSource وعيّنها كمصدر للمثيل من BmpOptions
//المعامل المنطقي الثاني يحدد ما إذا كان الملف الذي سيُنشأ مؤقتًا أم لا
bmpOptions.Source = new Aspose.Imaging.Sources.FileCreateSource(@"C:\temp\sample.bmp", false);

//أنشئ مثيلاً من Image في المسار المحدد
using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Create(bmpOptions, 500, 500))
{
    //أنشئ مثيلاً من Graphics وابدأه باستخدام كائن Image
    Aspose.Imaging.Graphics graphics = new Aspose.Imaging.Graphics(image);

    //امسح سطح Graphics باللون الأبيض
    graphics.Clear(Aspose.Imaging.Color.White);

    //أنشئ مثيلاً من Pen باللون الأحمر وعرض 5
    Aspose.Imaging.Pen pen = new Aspose.Imaging.Pen(Aspose.Imaging.Color.Red, 5f);

    //أنشئ مثيلاً من HatchBrush وعيّن خصائصه
    Aspose.Imaging.Brushes.HatchBrush brush = new Aspose.Imaging.Brushes.HatchBrush();
    brush.BackgroundColor = Aspose.Imaging.Color.Wheat;
    brush.ForegroundColor = Aspose.Imaging.Color.Red;

    //أنشئ مثيلاً من Pen
    //ابدأه بكائن HatchBrush والعرض
    Aspose.Imaging.Pen brusedpen = new Pen(brush, 5);

    //ارسم مستطيلات بتحديد كائن Pen
    graphics.DrawRectangles(pen, new[]
    {
        new Aspose.Imaging.Rectangle(new Aspose.Imaging.Point(210, 210), new Aspose.Imaging.Size(100, 100)),
        new Aspose.Imaging.Rectangle(new Aspose.Imaging.Point(110, 110), new Aspose.Imaging.Size(100, 100)),
        new Aspose.Imaging.Rectangle(new Aspose.Imaging.Point(310, 310), new Aspose.Imaging.Size(100, 100))
    });

    //ارسم مستطيلات بتحديد كائن Pen
    graphics.DrawRectangles(brusedpen, new[]
    {
        new Aspose.Imaging.Rectangle(new Aspose.Imaging.Point(310, 110), new Aspose.Imaging.Size(100, 100)),
        new Aspose.Imaging.Rectangle(new Aspose.Imaging.Point(110, 310), new Aspose.Imaging.Size(100, 100))
    });

    // احفظ جميع التغييرات.
    image.Save();
}

انظر أيضًا

تعداد PdfComplianceVersion تعداد PenAlignment