Bookmark.GoToEditableRange 方法

  • 项目

获取一个 Range 对象，该对象表示可由用户或用户组修改的 Bookmark 控件的区域。

命名空间：  Microsoft.Office.Tools.Word
程序集：  Microsoft.Office.Tools.Word（在 Microsoft.Office.Tools.Word.dll 中）

语法

声明
Function GoToEditableRange ( _
    ByRef EditorID As Object _
) As Range

Range GoToEditableRange(
    ref Object EditorID
)

参数

  • EditorID
    类型：System.Object%
    可以是一个表示用户的电子邮件别名的字符串（如果在同一域中）、一个电子邮件地址或一个表示一组用户的 WdEditorType 常数。如果省略，则选择所有用户都有权限编辑的所有范围。

返回值

类型：Microsoft.Office.Interop.Word.Range
一个 Range 对象，表示可由用户或用户组修改的 Bookmark 控件的区域。

备注

可选参数

有关可选参数的信息，请参见Office 解决方案中的可选参数。

示例

下面的代码示例向文档的第一个段落添加一个带有文本的 Bookmark 控件，并将所有用户添加为该书签中第四个单词的编辑者。然后该示例保护该文档不被修订。最后，该代码在消息框中显示该书签的可编辑范围。

此示例针对的是文档级自定义项。

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 安全性

请参见

参考

Bookmark 接口

Microsoft.Office.Tools.Word 命名空间