Bookmark.GoToEditableRange Метод (2007 System)

Статья
11/16/2008

Обновлен: Ноябрь 2007

Возвращает объект Range, представляющий область элемента управления Bookmark, которую может изменять пользователь или группа пользователей.

Пространство имен: Microsoft.Office.Tools.Word
Сборка: Microsoft.Office.Tools.Word.v9.0 (в Microsoft.Office.Tools.Word.v9.0.dll)

Синтаксис

'Декларация
Public Function GoToEditableRange ( _
    ByRef EditorID As Object _
) As Range
'Применение
Dim instance As Bookmark
Dim EditorID As Object
Dim returnValue As Range

returnValue = instance.GoToEditableRange(EditorID)

public 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());
    }
}

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

Поделиться через