EditorType

EditorType enumeration

Anger uppsättningen av möjliga alias (eller redigeringsgrupper) som kan användas som alias för att avgöra om den aktuella användaren ska tillåtas redigera ett enstaka intervall definierat av ett redigerbart intervall inom ett dokument.

public enum EditorType

Värderingar

namnVärdeBeskrivning
Unspecified0Betyder att editortyp inte är specificerad.
Administrators1Anger att användare som är associerade med administratörsgruppen ska tillåtas redigera redigerbara intervall med denna redigeringstyp när dokumentskydd är aktiverat.
Contributors2Anger att användare som är kopplade till gruppen Bidragsgivare ska tillåtas redigera redigerbara intervall med denna redigeringstyp när dokumentskydd är aktiverat.
Current3Anger att användare som är associerade med den aktuella gruppen ska tillåtas redigera redigerbara intervall med denna redigeringstyp när dokumentskydd är aktiverat.
Editors4Anger att användare som är associerade med Redaktörsgruppen ska tillåtas redigera redigerbara intervall med denna redigeringstyp när dokumentskydd är aktiverat.
Everyone5Anger att alla användare som öppnar dokumentet ska tillåtas redigera redigerbara intervall med denna typ editing när dokumentskydd är aktiverat.
None6Anger att ingen av användarna som öppnar dokumentet ska tillåtas redigera redigerbara intervall med denna redigeringstyp när dokumentskydd är aktiverat.
Owners7Anger att användare som är associerade med ägaregruppen ska tillåtas redigera redigerbara intervall med denna redigeringstyp när dokumentskydd är aktiverat.
Default0Samma somUnspecified .

Exempel

Visar hur man begränsar redigeringsrättigheterna för redigerbara intervall till en specifik grupp/användare.

public void Visitor()
{
    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.");

    // När vi skrivskyddar dokument tillåter redigerbara intervall oss att välja specifika områden som användare kan redigera.
    // Det finns två ömsesidigt uteslutande sätt att begränsa listan över tillåtna redigerare.
    // 1 - Ange en användare:
    EditableRange editableRange = builder.StartEditableRange().EditableRange;
    editableRange.SingleUser = "john.doe@myoffice.com";
    builder.Writeln($"This paragraph is inside the first editable range, can only be edited by {editableRange.SingleUser}.");
    builder.EndEditableRange();

    Assert.AreEqual(EditorType.Unspecified, editableRange.EditorGroup);

    // 2 - Ange en grupp som tillåtna användare är associerade med:
    editableRange = builder.StartEditableRange().EditableRange;
    editableRange.EditorGroup = EditorType.Administrators;
    builder.Writeln($"This paragraph is inside the first editable range, can only be edited by {editableRange.EditorGroup}.");
    builder.EndEditableRange();

    Assert.AreEqual(string.Empty, editableRange.SingleUser);

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

    // Skriv ut detaljer och innehåll för varje redigerbart område i dokumentet.
    EditableRangePrinter editableRangePrinter = new EditableRangePrinter();

    doc.Accept(editableRangePrinter);

    Console.WriteLine(editableRangePrinter.ToText());
}

/// <summary>
/// Samlar egenskaper och innehåll för besökta redigerbara intervall i en sträng.
/// </summary>
public class EditableRangePrinter : DocumentVisitor
{
    public EditableRangePrinter()
    {
        mBuilder = new StringBuilder();
    }

    public string ToText()
    {
        return mBuilder.ToString();
    }

    public void Reset()
    {
        mBuilder.Clear();
        mInsideEditableRange = false;
    }

    /// <summary>
    /// Anropas när en EditableRangeStart-nod påträffas i dokumentet.
    /// </summary>
    public override VisitorAction VisitEditableRangeStart(EditableRangeStart editableRangeStart)
    {
        mBuilder.AppendLine(" -- Editable range found! -- ");
        mBuilder.AppendLine("\tID:\t\t" + editableRangeStart.Id);
        if (editableRangeStart.EditableRange.SingleUser == string.Empty)
            mBuilder.AppendLine("\tGroup:\t" + editableRangeStart.EditableRange.EditorGroup);
        else
            mBuilder.AppendLine("\tUser:\t" + editableRangeStart.EditableRange.SingleUser);
        mBuilder.AppendLine("\tContents:");

        mInsideEditableRange = true;

        return VisitorAction.Continue;
    }

    /// <summary>
    /// Anropas när en EditableRangeEnd-nod påträffas i dokumentet.
    /// </summary>
    public override VisitorAction VisitEditableRangeEnd(EditableRangeEnd editableRangeEnd)
    {
        mBuilder.AppendLine(" -- End of editable range --\n");

        mInsideEditableRange = false;

        return VisitorAction.Continue;
    }

    /// <summary>
    /// Anropas när en körnod påträffas i dokumentet. Den här besökaren registrerar bara körningar som ligger inom redigerbara intervall.
    /// </summary>
    public override VisitorAction VisitRun(Run run)
    {
        if (mInsideEditableRange) mBuilder.AppendLine("\t\"" + run.Text + "\"");

        return VisitorAction.Continue;
    }

    private bool mInsideEditableRange;
    private readonly StringBuilder mBuilder;
}

Se även