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 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。