Bookmark.GoToEditableRange (Método)
Obtiene un objeto Range que representa un área de un control Bookmark que el usuario o grupo de usuarios puede modificar.
Espacio de nombres: Microsoft.Office.Tools.Word
Ensamblado: Microsoft.Office.Tools.Word (en Microsoft.Office.Tools.Word.dll)
Sintaxis
'Declaración
Function GoToEditableRange ( _
ByRef EditorID As Object _
) As Range
Range GoToEditableRange(
ref Object EditorID
)
Parámetros
- EditorID
Tipo: System.Object%
Puede ser una cadena que representa el alias de correo electrónico del usuario (si se encuentra en el mismo dominio), una dirección de correo electrónico o una constante WdEditorType que representa un grupo de usuarios.Si se omite, selecciona todos los intervalos que todos los usuarios puedan modificar por contar con los permisos correspondientes.
Valor devuelto
Tipo: Microsoft.Office.Interop.Word.Range
Un objeto Range que representa un área de un control Bookmark que el usuario o grupo de usuarios puede modificar.
Comentarios
Parámetros opcionales
Para obtener información sobre parámetros opcionales, vea Parámetros opcionales en las soluciones de Office.
Ejemplos
El ejemplo de código siguiente agrega un control Bookmark con texto al primer párrafo del documento y agrega a todos los usuarios como editores de la cuarta palabra del marcador. A continuación, el ejemplo protege el documento contra revisiones. Por último, el código muestra el intervalo del marcador que se puede modificar en un cuadro de mensaje.
Se trata de un ejemplo para una personalización en el nivel del documento.
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());
}
}
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.