FieldSubject
محتويات
[
يخفي
]FieldSubject class
ينفذ حقل الموضوع.
لمعرفة المزيد، قم بزيارةالعمل مع الحقول مقالة توثيقية.
public class FieldSubject : Field
المنشئون
اسم | وصف |
---|---|
FieldSubject() | Default_Constructor |
الخصائص
اسم | وصف |
---|---|
DisplayResult { get; } | يحصل على النص الذي يمثل نتيجة الحقل المعروضة. |
End { get; } | يحصل على العقدة التي تمثل نهاية الحقل. |
Format { get; } | يحصل علىFieldFormat الكائن الذي يوفر الوصول المكتوب إلى تنسيق الحقل. |
IsDirty { get; set; } | يحصل على أو يحدد ما إذا كانت النتيجة الحالية للحقل لم تعد صحيحة (قديمة) بسبب التعديلات الأخرى التي تم إجراؤها على المستند. |
IsLocked { get; set; } | يحصل على أو يحدد ما إذا كان الحقل مقفلاً (لا ينبغي إعادة حساب نتيجته). |
LocaleId { get; set; } | يحصل على أو يعين LCID للحقل. |
Result { get; set; } | يحصل على النص الموجود بين فاصل الحقل ونهاية الحقل أو يعينه. |
Separator { get; } | يحصل على العقدة التي تمثل فاصل الحقل. يمكن أن يكونباطل . |
Start { get; } | يحصل على العقدة التي تمثل بداية الحقل. |
Text { get; set; } | يحصل على نص الموضوع أو يعينه. |
virtual Type { get; } | يحصل على نوع حقل Microsoft Word. |
طُرق
اسم | وصف |
---|---|
GetFieldCode() | يعيد النص بين بداية الحقل وفاصل الحقل (أو نهاية الحقل إذا لم يكن هناك فاصل). يتم تضمين كل من رمز الحقل ونتيجة الحقل للحقول الفرعية. |
GetFieldCode(bool) | إرجاع النص بين بداية الحقل وفاصل الحقل (أو نهاية الحقل إذا لم يكن هناك فاصل). |
Remove() | يُزيل الحقل من المستند. يُرجع عقدة بعد الحقل مباشرةً. إذا كانت نهاية الحقل هي آخر عقدة فرعية للعقدة الأصلية، تُرجع فقرته الأصلية. إذا كان الحقل قد حُذف مُسبقًا، تُرجعباطل . |
Unlink() | يقوم بإلغاء ربط الحقل. |
Update() | يُجري تحديث الحقل. يُطرح هذا الخطأ إذا كان الحقل قيد التحديث بالفعل. |
Update(bool) | يُجري تحديثًا للحقل. يُطرح هذا الخطأ إذا كان الحقل قيد التحديث بالفعل. |
ملاحظات
يسترد، ويحدد بشكل اختياري، موضوع المستند، كما هو مسجل فيموضوع خاصية خصائص المستند المضمنة .
أمثلة
يوضح كيفية استخدام حقل الموضوع.
Document doc = new Document();
// تعيين قيمة لخاصية "الموضوع" المضمنة في المستند.
doc.BuiltInDocumentProperties.Subject = "My subject";
// قم بإنشاء حقل SUBJECT لعرض قيمة تلك الخاصية المضمنة.
DocumentBuilder builder = new DocumentBuilder(doc);
FieldSubject field = (FieldSubject)builder.InsertField(FieldType.FieldSubject, true);
field.Update();
Assert.AreEqual(" SUBJECT ", field.GetFieldCode());
Assert.AreEqual("My subject", field.Result);
// إذا أعطينا قيمة خاصية النص لحقل الموضوع وقمنا بتحديثها، فسيصبح الحقل
// استبدال القيمة الحالية للخاصية المضمنة "الموضوع" بقيمة خاصية النص الخاصة بها،
//ثم عرض القيمة الجديدة.
field.Text = "My new subject";
field.Update();
Assert.AreEqual(" SUBJECT \"My new subject\"", field.GetFieldCode());
Assert.AreEqual("My new subject", field.Result);
Assert.AreEqual("My new subject", doc.BuiltInDocumentProperties.Subject);
doc.Save(ArtifactsDir + "Field.SUBJECT.docx");
أنظر أيضا
- class Field
- مساحة الاسم Aspose.Words.Fields
- المجسم Aspose.Words