FieldGoToButton
محتويات
[
يخفي
]FieldGoToButton class
ينفذ حقل GOTOBUTTON.
لمعرفة المزيد، قم بزيارةالعمل مع الحقول مقالة توثيقية.
public class FieldGoToButton : Field
المنشئون
| اسم | وصف | 
|---|---|
| FieldGoToButton() | Default_Constructor | 
الخصائص
| اسم | وصف | 
|---|---|
| DisplayResult { get; } | يحصل على النص الذي يمثل نتيجة الحقل المعروضة. | 
| DisplayText { get; set; } | يحصل على نص “الزر” الذي يظهر في المستند أو يعينه، بحيث يمكن تحديده لتنشيط القفزة. | 
| End { get; } | يحصل على العقدة التي تمثل نهاية الحقل. | 
| Format { get; } | يحصل على FieldFormatالكائن الذي يوفر الوصول المكتوب إلى تنسيق الحقل. | 
| IsDirty { get; set; } | يحصل على أو يحدد ما إذا كانت النتيجة الحالية للحقل لم تعد صحيحة (قديمة) بسبب التعديلات الأخرى التي تم إجراؤها على المستند. | 
| IsLocked { get; set; } | يحصل على أو يحدد ما إذا كان الحقل مقفلاً (لا ينبغي إعادة حساب نتيجته). | 
| LocaleId { get; set; } | يحصل على أو يعين LCID للحقل. | 
| Location { get; set; } | يحصل على اسم إشارة مرجعية أو رقم صفحة أو أي عنصر آخر للانتقال إليه أو يعينه. | 
| Result { get; set; } | يحصل على النص الموجود بين فاصل الحقل ونهاية الحقل أو يعينه. | 
| Separator { get; } | يحصل على العقدة التي تمثل فاصل الحقل. يمكن أن يكون باطل. | 
| Start { get; } | يحصل على العقدة التي تمثل بداية الحقل. | 
| virtual Type { get; } | يحصل على نوع حقل Microsoft Word. | 
طُرق
| اسم | وصف | 
|---|---|
| GetFieldCode() | يعيد النص بين بداية الحقل وفاصل الحقل (أو نهاية الحقل إذا لم يكن هناك فاصل). يتم تضمين كل من رمز الحقل ونتيجة الحقل للحقول الفرعية. | 
| GetFieldCode(bool) | إرجاع النص بين بداية الحقل وفاصل الحقل (أو نهاية الحقل إذا لم يكن هناك فاصل). | 
| Remove() | يُزيل الحقل من المستند. يُرجع عقدة بعد الحقل مباشرةً. إذا كانت نهاية الحقل هي آخر عقدة فرعية للعقدة الأصلية، تُرجع فقرته الأصلية. إذا كان الحقل قد حُذف مُسبقًا، تُرجع باطل. | 
| Unlink() | يقوم بإلغاء ربط الحقل. | 
| Update() | يُجري تحديث الحقل. يُطرح هذا الخطأ إذا كان الحقل قيد التحديث بالفعل. | 
| Update(bool) | يُجري تحديثًا للحقل. يُطرح هذا الخطأ إذا كان الحقل قيد التحديث بالفعل. | 
ملاحظات
يقوم بإدراج أمر انتقال، بحيث عندما يتم تنشيطه، يتم نقل نقطة إدراج المستند إلى الموقع المحدد.
أمثلة
يظهر لإدراج حقل GOTOBUTTON.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// أضف حقل GOTOBUTTON. عند النقر المزدوج على هذا الحقل في مايكروسوفت وورد،
//سيتم نقل مؤشر النص إلى الإشارة المرجعية التي يشير إليها خاصية الموقع.
FieldGoToButton field = (FieldGoToButton)builder.InsertField(FieldType.FieldGoToButton, true);
field.DisplayText = "My Button";
field.Location = "MyBookmark";
Assert.AreEqual(" GOTOBUTTON  MyBookmark My Button", field.GetFieldCode());
// أدخل إشارة مرجعية صالحة للحقل للإشارة إليه.
builder.InsertBreak(BreakType.PageBreak);
builder.StartBookmark(field.Location);
builder.Writeln("Bookmark text contents.");
builder.EndBookmark(field.Location);
doc.UpdateFields();
doc.Save(ArtifactsDir + "Field.GOTOBUTTON.docx");
أنظر أيضا
- class Field
- مساحة الاسم Aspose.Words.Fields
- المجسم Aspose.Words