EndEditableRange

EndEditableRange()

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

public EditableRangeEnd EndEditableRange()

قيمة الإرجاع

عقدة نهاية النطاق القابلة للتحرير التي تم إنشاؤها للتو.

ملاحظات

يمكن للنطاق القابل للتحرير في مستند أن يتداخل ويمتد على أي نطاق. لإنشاء نطاق قابل للتحرير صالح، يجب عليك استدعاء كلٍّ منStartEditableRange وEndEditableRange أوEndEditableRange طُرق.

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

أمثلة

يوضح كيفية العمل مع نطاق قابل للتحرير.

Document doc = new Document();
doc.Protect(ProtectionType.ReadOnly, "MyPassword");

DocumentBuilder builder = new DocumentBuilder(doc);
builder.Writeln("Hello world! Since we have set the document's protection level to read-only," +
                " we cannot edit this paragraph without the password.");

// تسمح لنا النطاقات القابلة للتحرير بترك أجزاء من المستندات المحمية مفتوحة للتحرير.
EditableRangeStart editableRangeStart = builder.StartEditableRange();
builder.Writeln("This paragraph is inside an editable range, and can be edited.");
EditableRangeEnd editableRangeEnd = builder.EndEditableRange();

//يحتوي النطاق القابل للتحرير ذو التكوين الجيد على عقدة بداية وعقدة نهاية.
// تحتوي هذه العقد على معرفات متطابقة وتشمل عقدًا قابلة للتعديل.
EditableRange editableRange = editableRangeStart.EditableRange;

Assert.AreEqual(editableRangeStart.Id, editableRange.Id);
Assert.AreEqual(editableRangeEnd.Id, editableRange.Id);

// ترتبط أجزاء مختلفة من النطاق القابل للتحرير ببعضها البعض.
Assert.AreEqual(editableRangeStart.Id, editableRange.EditableRangeStart.Id);
Assert.AreEqual(editableRangeStart.Id, editableRangeEnd.EditableRangeStart.Id);
Assert.AreEqual(editableRange.Id, editableRangeStart.EditableRange.Id);
Assert.AreEqual(editableRangeEnd.Id, editableRange.EditableRangeEnd.Id);

// يمكننا الوصول إلى أنواع العقد لكل جزء كما يلي. النطاق القابل للتحرير ليس عقدة بحد ذاته.
// ولكن كيان يتكون من بداية ونهاية ومحتوياتهما المغلقة.
Assert.AreEqual(NodeType.EditableRangeStart, editableRangeStart.NodeType);
Assert.AreEqual(NodeType.EditableRangeEnd, editableRangeEnd.NodeType);

builder.Writeln("This paragraph is outside the editable range, and cannot be edited.");

doc.Save(ArtifactsDir + "EditableRange.CreateAndRemove.docx");

// إزالة نطاق قابل للتعديل. ستبقى جميع العقد الموجودة داخل النطاق سليمة.
editableRange.Remove();

أنظر أيضا

EndEditableRange(EditableRangeStart)

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

public EditableRangeEnd EndEditableRange(EditableRangeStart start)
معامليكتبوصف
startEditableRangeStartيبدأ هذا النطاق القابل للتحرير.

قيمة الإرجاع

عقدة نهاية النطاق القابلة للتحرير التي تم إنشاؤها للتو.

ملاحظات

استخدم هذا التحميل الزائد أثناء إنشاء نطاقات قابلة للتحرير متداخلة.

يمكن للنطاق القابل للتحرير في مستند أن يتداخل ويمتد على أي نطاق. لإنشاء نطاق قابل للتحرير صالح، يجب عليك استدعاء كلٍّ منStartEditableRange وEndEditableRange أوEndEditableRange طُرق.

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

أمثلة

يوضح كيفية إنشاء نطاقات قابلة للتحرير متداخلة.

Document doc = new Document();
doc.Protect(ProtectionType.ReadOnly, "MyPassword");

DocumentBuilder builder = new DocumentBuilder(doc);
builder.Writeln("Hello world! Since we have set the document's protection level to read-only, " +
                "we cannot edit this paragraph without the password.");

// إنشاء نطاقين متداخلين قابلين للتحرير.
EditableRangeStart outerEditableRangeStart = builder.StartEditableRange();
builder.Writeln("This paragraph inside the outer editable range and can be edited.");

EditableRangeStart innerEditableRangeStart = builder.StartEditableRange();
builder.Writeln("This paragraph inside both the outer and inner editable ranges and can be edited.");

// حاليًا، يتواجد مؤشر إدراج عقدة منشئ المستندات في أكثر من نطاق قابل للتحرير مستمر.
// عندما نريد إنهاء نطاق قابل للتحرير في هذه الحالة،
// نحتاج إلى تحديد النطاق الذي نرغب في إنهائه عن طريق تمرير عقدة EditableRangeStart الخاصة به.
builder.EndEditableRange(innerEditableRangeStart);

builder.Writeln("This paragraph inside the outer editable range and can be edited.");

builder.EndEditableRange(outerEditableRangeStart);

builder.Writeln("This paragraph is outside any editable ranges, and cannot be edited.");

// إذا كانت منطقة النص تحتوي على نطاقين قابلين للتحرير متداخلين مع مجموعات محددة،
// يتم منع المجموعة المجمعة من المستخدمين المستبعدين من قبل كلتا المجموعتين من تحريرها.
outerEditableRangeStart.EditableRange.EditorGroup = EditorType.Everyone;
innerEditableRangeStart.EditableRange.EditorGroup = EditorType.Contributors;

doc.Save(ArtifactsDir + "EditableRange.Nested.docx");

أنظر أيضا

DocumentBuilder.EndColumnBookmark DocumentBuilder.EndRow