Método Bookmark.GoToEditableRange

Artigo
05/21/2013

Obtém um objeto de Range que representa uma área de um controle de Bookmark que pode ser alterado pelo usuário ou pelo grupo de usuários.

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

Sintaxe

'Declaração
Function GoToEditableRange ( _
    ByRef EditorID As Object _
) As Range

Range GoToEditableRange(
    ref Object EditorID
)

Parâmetros

EditorID
Tipo: System.Object%
Pode ser uma cadeia de caracteres que representa o alias de email do usuário (se no mesmo domínio), um endereço de email, ou constante de WdEditorType que representa um grupo de usuários.Se omitido, selecione todos os intervalos para que todos os usuários têm a permissão para editar.

Valor de retorno

Tipo: Microsoft.Office.Interop.Word.Range
Um objeto de Range que representa uma área de um controle de Bookmark que pode ser alterado pelo usuário ou pelo grupo de usuários.

Comentários

Parâmetros Opcionais

Para obter informações sobre parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

Exemplos

O exemplo de código a seguir adiciona um controle de Bookmark com texto para o primeiro parágrafo no documento e adicione todos os usuários como editores de quartas palavra no indexador.O exemplo protege contra revisões no documento.Finalmente, o código exibirá o intervalo editável do indexador em uma caixa de mensagem.

Este exemplo é para uma personalização da nível.

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

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

Bookmark Interface

Namespace Microsoft.Office.Tools.Word

Compartilhar via