FieldSymbol

FieldSymbol class

ينفذ حقل SYMBOL.

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

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 - أضف حقل SYMBOL الذي يعرض رمز © (حقوق الطبع والنشر)، المحدد بواسطة رمز حرف 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 - أضف حقل SYMBOL الذي يعرض رمز ∞ (اللانهاية) وتعديل مظهره:
field = (FieldSymbol)builder.InsertField(FieldType.FieldSymbol, true);

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

// قم بتغيير خط الرمز الخاص بنا بعد استخدام Windows Character Map
// للتأكد من أن الخط يمكن أن يمثل هذا الرمز.
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 - أضف حقل SYMBOL الذي يعرض الحرف あ،
// بخط يدعم صفحة الرموز 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