SignatureLine

SignatureLine class

يوفر الوصول إلى خصائص سطر التوقيع.

public class SignatureLine

الخصائص

اسم وصف
AllowComments { get; set; } الحصول على أو تعيين قيمة تشير إلى أن الموقّع يمكنه إضافة تعليقات في مربع حوار التوقيع . القيمة الافتراضية لهذه الخاصية هي خاطئة .
DefaultInstructions { get; set; } الحصول على قيمة أو تعيينها للإشارة إلى أن الإرشادات الافتراضية تظهر في مربع حوار التوقيع . القيمة الافتراضية لهذه الخاصية هي حقيقي .
Email { get; set; } الحصول على أو تعيين عنوان البريد الإلكتروني للموقّع المقترح. القيمة الافتراضية لهذه الخاصية هي سلسلة فارغة (Empty ) .
Id { get; set; } الحصول على أو تعيين معرف لسطر التوقيع هذا.
Instructions { get; set; } الحصول على التعليمات أو تعيينها للموقِّع التي يتم عرضها عند توقيع سطر التوقيع. يتم تجاهل هذه الخاصية إذاDefaultInstructions تم تعيين. القيمة الافتراضية لهذه الخاصية هي سلسلة فارغة (Empty ) .
IsSigned { get; } يشير إلى أن سطر التوقيع موقّع بالتوقيع الرقمي.
IsValid { get; } يشير إلى أن سطر التوقيع موقّع بالتوقيع الرقمي وأن هذا التوقيع الرقمي صالح.
ProviderId { get; set; } الحصول على أو تعيين معرف موفر التوقيع لسطر التوقيع هذا . القيمة الافتراضية هي “{00000000-0000-0000-0000-000000000000}” .
ShowDate { get; set; } الحصول على أو تعيين قيمة تشير إلى أن تاريخ التوقيع يظهر في سطر التوقيع. القيمة الافتراضية لهذه الخاصية هي حقيقي .
Signer { get; set; } الحصول على أو تعيين المُوقِّع المقترح لسطر التوقيع . القيمة الافتراضية لهذه الخاصية هي سلسلة فارغة (Empty ) .
SignerTitle { get; set; } الحصول على أو تعيين عنوان الموقّع المقترح (على سبيل المثال ، المدير) . القيمة الافتراضية لهذه الخاصية هي سلسلة فارغة (Empty ) .

أمثلة

يوضح كيفية إنشاء سطر للتوقيع وإدراجه في مستند.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

SignatureLineOptions options = new SignatureLineOptions
{
    AllowComments = true,
    DefaultInstructions = true,
    Email = "john.doe@management.com",
    Instructions = "Please sign here",
    ShowDate = true,
    Signer = "John Doe",
    SignerTitle = "Senior Manager"
};

// أدخل شكلًا يحتوي على سطر توقيع ، سنظهر مظهره
// تخصيص باستخدام كائن "SignatureLineOptions" الذي أنشأناه أعلاه.
// إذا أدخلنا شكلًا تنشأ إحداثياته في الركن الأيمن السفلي من الصفحة ،
// سنحتاج إلى توفير إحداثيات سالبة س و ص لإبراز الشكل.
Shape shape = builder.InsertSignatureLine(options, RelativeHorizontalPosition.RightMargin, -170.0, 
        RelativeVerticalPosition.BottomMargin, -60.0, WrapType.None);

Assert.True(shape.IsSignatureLine);

// تحقق من خصائص خط التوقيع الخاص بنا عبر كائن الشكل الخاص به.
SignatureLine signatureLine = shape.SignatureLine;

Assert.AreEqual("john.doe@management.com", signatureLine.Email);
Assert.AreEqual("John Doe", signatureLine.Signer);
Assert.AreEqual("Senior Manager", signatureLine.SignerTitle);
Assert.AreEqual("Please sign here", signatureLine.Instructions);
Assert.True(signatureLine.ShowDate);
Assert.True(signatureLine.AllowComments);
Assert.True(signatureLine.DefaultInstructions);

doc.Save(ArtifactsDir + "Shape.SignatureLine.docx");

أنظر أيضا