Bookmark.GoToEditableRange - метод

Статья
08/11/2011

Возвращает объект 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 - пространство имен

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