Bookmark.GoToEditableRange-Methode

Artikel
08/10/2011

Ruft ein Range-Objekt ab, das einen Bereich eines Bookmark-Steuerelements darstellt, der vom Benutzer oder der Benutzergruppe geändert werden kann.

Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)

Syntax

'Declaration
Function GoToEditableRange ( _
    ByRef EditorID As Object _
) As Range

Range GoToEditableRange(
    ref Object EditorID
)

Parameter

EditorID
Typ: System.Object%
Kann eine Zeichenfolge sein, die den E-Mail-Alias des Benutzers (sofern es sich um die gleiche Domäne handelt), eine E-Mail-Adresse oder eine WdEditorType-Konstante darstellt, die für eine Benutzergruppe steht.Wenn diese weggelassen wird, werden alle Bereiche ausgewählt, für die alle Benutzer über Bearbeitungsberechtigungen verfügen.

Rückgabewert

Typ: Microsoft.Office.Interop.Word.Range
Ein Range-Objekt, das einen Bereich eines Bookmark-Steuerelements darstellt, der vom Benutzer oder der Benutzergruppe geändert werden kann.

Hinweise

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Lösungen.

Beispiele

Im folgenden Codebeispiel wird dem ersten Absatz im Dokument ein Bookmark-Steuerelement mit Text hinzugefügt. Außerdem werden alle Benutzer als Editoren des vierten Worts im Lesezeichen hinzugefügt. Im Beispiel wird dann das Dokument vor Überarbeitungen geschützt. Der Code zeigt schließlich den bearbeitbaren Bereich des Lesezeichens in einem Meldungsfeld an.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

Private Sub BookmarkEditors()

    Dim editor As Object = Word.WdEditorType.wdEditorEveryone
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim Bookmark1 As Microsoft.Office.Tools.Word.Bookmark = _
        Me.Controls.AddBookmark(Me.Paragraphs(1).Range, "Bookmark1")

    Bookmark1.Text = "This text cannot be edited."
    Bookmark1.Words(4).Editors.Add(editor)
    Me.Protect(Word.WdProtectionType.wdAllowOnlyReading)

    Dim range1 As Word.Range = Bookmark1.GoToEditableRange(editor)

    If Not (range1 Is Nothing) Then
        MessageBox.Show("The editable Range of Bookmark1 spans from " _
            & range1.Start.ToString & " to " & range1.End.ToString)
    End If

End Sub

private void BookmarkEditors()
{
    object editor = Word.WdEditorType.wdEditorEveryone;
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Bookmark bookmark1 =
        this.Controls.AddBookmark(this.Paragraphs[1].Range,
        "bookmark1");
    bookmark1.Text = "This text cannot be edited.";
    bookmark1.Words[4].Editors.Add(ref editor);
    this.Protect(Word.WdProtectionType.wdAllowOnlyReading,
        ref missing, ref missing, ref missing, ref missing);

    Word.Range range1 = bookmark1.GoToEditableRange(ref editor);

    if (range1 != null)
    {
        MessageBox.Show("The editable Range of bookmark1 spans from " +
            range1.Start.ToString() + " to " + range1.End.ToString());
    }
}

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

Bookmark Schnittstelle

Microsoft.Office.Tools.Word-Namespace

Freigeben über