FieldSymbol

FieldSymbol class

ينفذ حقل الرمز.

لمعرفة المزيد، قم بزيارةالعمل مع الحقول مقالة توثيقية.

public class FieldSymbol : Field

المنشئون

اسموصف
FieldSymbol()Default_Constructor

الخصائص

اسموصف
CharacterCode { get; set; }يحصل على قيمة نقطة رمز الحرف أو يعينها بالنظام العشري أو السداسي عشر.
DisplayResult { get; }يحصل على النص الذي يمثل نتيجة الحقل المعروضة.
DontAffectsLineSpacing { get; set; }يحصل على أو يعين ما إذا كان الحرف الذي تم استرداده بواسطة الحقل يؤثر على تباعد أسطر الفقرة.
End { get; }يحصل على العقدة التي تمثل نهاية الحقل.
FontName { get; set; }يحصل على اسم الخط الخاص بالحرف الذي تم استرداده بواسطة الحقل أو يعينه.
FontSize { get; set; }يحصل على أو يعين حجم الخط بالنقاط للحرف الذي تم استرداده بواسطة الحقل.
Format { get; }يحصل علىFieldFormatالكائن الذي يوفر الوصول المكتوب إلى تنسيق الحقل.
IsAnsi { get; set; }يحصل على أو يحدد ما إذا كان يتم تفسير رمز الحرف كقيمة لحرف ANSI.
IsDirty { get; set; }يحصل على أو يحدد ما إذا كانت النتيجة الحالية للحقل لم تعد صحيحة (قديمة) بسبب التعديلات الأخرى التي تم إجراؤها على المستند.
IsLocked { get; set; }يحصل على أو يحدد ما إذا كان الحقل مقفلاً (لا ينبغي إعادة حساب نتيجته).
IsShiftJis { get; set; }يحصل على أو يحدد ما إذا كان يتم تفسير رمز الحرف كقيمة لحرف SHIFT-JIS.
IsUnicode { get; set; }يحصل على أو يحدد ما إذا كان يتم تفسير رمز الحرف كقيمة لحرف Unicode.
LocaleId { get; set; }يحصل على أو يعين LCID للحقل.
Result { get; set; }يحصل على النص الموجود بين فاصل الحقل ونهاية الحقل أو يعينه.
Separator { get; }يحصل على العقدة التي تمثل فاصل الحقل. يمكن أن يكونباطل .
Start { get; }يحصل على العقدة التي تمثل بداية الحقل.
virtual Type { get; }يحصل على نوع حقل Microsoft Word.

طُرق

اسموصف
GetFieldCode()يعيد النص بين بداية الحقل وفاصل الحقل (أو نهاية الحقل إذا لم يكن هناك فاصل). يتم تضمين كل من رمز الحقل ونتيجة الحقل للحقول الفرعية.
GetFieldCode(bool)إرجاع النص بين بداية الحقل وفاصل الحقل (أو نهاية الحقل إذا لم يكن هناك فاصل).
Remove()يُزيل الحقل من المستند. يُرجع عقدة بعد الحقل مباشرةً. إذا كانت نهاية الحقل هي آخر عقدة فرعية للعقدة الأصلية، تُرجع فقرته الأصلية. إذا كان الحقل قد حُذف مُسبقًا، تُرجعباطل .
Unlink()يقوم بإلغاء ربط الحقل.
Update()يُجري تحديث الحقل. يُطرح هذا الخطأ إذا كان الحقل قيد التحديث بالفعل.
Update(bool)يُجري تحديثًا للحقل. يُطرح هذا الخطأ إذا كان الحقل قيد التحديث بالفعل.

ملاحظات

يسترجع الحرف الذي تم تحديد قيمة نقطة الكود الخاصة به بالنظام العشري أو السداسي عشر.

أمثلة

يوضح كيفية استخدام حقل الرمز.

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

// فيما يلي ثلاث طرق لاستخدام حقل الرمز لعرض حرف واحد.
// 1 - أضف حقل رمز يعرض رمز © (حقوق الطبع والنشر)، المحدد بواسطة رمز حرف ANSI:
FieldSymbol field = (FieldSymbol)builder.InsertField(FieldType.FieldSymbol, true);

// رمز الحرف ANSI "U+00A9"، أو "169" في شكل عدد صحيح، مخصص لرمز حقوق النشر.
field.CharacterCode = 0x00a9.ToString();
field.IsAnsi = true;

Assert.AreEqual(" SYMBOL  169 \\a", field.GetFieldCode());

builder.Writeln(" Line 1");

// 2 - أضف حقل رمز يعرض رمز ∞ (اللانهاية)، وقم بتعديل مظهره:
field = (FieldSymbol)builder.InsertField(FieldType.FieldSymbol, true);

// في Unicode، يحتل رمز اللانهاية الكود "221E".
field.CharacterCode = 0x221E.ToString();
field.IsUnicode = true;

// تغيير خط رمزنا بعد استخدام خريطة أحرف Windows
// للتأكد من أن الخط يمكنه تمثيل هذا الرمز.
field.FontName = "Calibri";
field.FontSize = "24";

// يمكننا تعيين هذا العلم للرموز الطويلة حتى لا تضغط على بقية النص الموجود على سطرها.
field.DontAffectsLineSpacing = true;

Assert.AreEqual(" SYMBOL  8734 \\u \\f Calibri \\s 24 \\h", field.GetFieldCode());

builder.Writeln("Line 2");

// 3 - أضف حقل الرمز الذي يعرض الحرف あ،
// مع الخط الذي يدعم صفحة أكواد Shift-JIS (Windows-932):
field = (FieldSymbol)builder.InsertField(FieldType.FieldSymbol, true);
field.FontName = "MS Gothic";
field.CharacterCode = 0x82A0.ToString();
field.IsShiftJis = true;

Assert.AreEqual(" SYMBOL  33440 \\f \"MS Gothic\" \\j", field.GetFieldCode());

builder.Write("Line 3");

doc.Save(ArtifactsDir + "Field.SYMBOL.docx");

أنظر أيضا

FieldSubject Class FieldTA Class