Clase Range - área contigua en un documento (Word VBA)

La clase Range representa un área contigua en un documento.

Las siguientes clases dan acceso a la clase Range Field, Footnote, FormField, Frame, HeaderFooter, HTMLDivision, Hyperlink, Index, InlineShape, Line, List, MailMergeField, OMath, OMathBreak, OMathFunction, Paragraph, Rectangle, RepeatingSectionItem, Revision, Row, Section, Selection, Series, Shape, Subdocument, Table, TableOfAuthorities, TableOfContents, TableOfFigures, TextFrame, Window, XMLNode.

Para usar una variable de clase Range, primero debe ser instanciado, por ejemplo

Dim rng as Range
Set rng = ActiveDocument.Range()
Los siguientes procedimientos se pueden usar para establecer variables de clase Range : AutoTextEntry.Insert, Bookmark.Range, Break.Range, BuildingBlock.Insert, Cell.Range, Characters.First, Characters.Item, Characters.Last, CoAuthLock.Range, CoAuthUpdate.Range, Comment.Range, Comment.Reference, Comment.Scope, Conflict.Range ...ContentControl.Range, Document.Content, Document.GoTo, Document.Range, Editor.NextRange, Editor.Range, Endnote.Range, Endnote.Reference, Endnotes.ContinuationNotice, Endnotes.ContinuationSeparator, Endnotes.Separator, Envelope.Address, Envelope.ReturnAddress, Field.Code, Field.Result, Footnote.Range, Footnote.Reference, Footnotes.ContinuationNotice, Footnotes.ContinuationSeparator, Footnotes.Separator, FormField.Range, Frame.Range, HeaderFooter.Range, HTMLDivision.Range, Hyperlink.Range, Index.Range, InlineShape.Range, Line.Range, List.Range, MailMergeField.Code, OMath.Range, OMathBreak.Range, OMathFunction.Range, OMaths.Add, Paragraph.Range, ProofreadingErrors.Item, Duplicate, FormattedText, GoTo, GoToEditableRange, GoToNext, GoToPrevious, Next, NextStoryRange, Previous, Rectangle.Range, RepeatingSectionItem.Range, Revision.MovedRange, Revision.Range, Row.ConvertToText, Row.Range, Rows.ConvertToText, Section.Range, Selection.FormattedText, Selection.GoTo, Selection.GoToEditableRange, Selection.GoToNext, Selection.GoToPrevious, Selection.Next, Selection.Previous, Selection.Range, Sentences.First, Sentences.Item, Sentences.Last, Series.Values, Series.XValues, Shape.Anchor, ShapeRange.Anchor, StoryRanges.Item, Subdocument.Range, Table.ConvertToText, Table.Range, TableOfAuthorities.Range, TableOfContents.Range, TableOfFigures.Range, TextFrame.ContainingRange, TextFrame.TextRange, Window.RangeFromPoint, Words.First, Words.Item, Words.Last, XMLNode.Range.

For Each

A continuación, se muestra un ejemplo de cómo procesar los elementos Range en una colección.

Dim rngCharacter As Range
Dim iFontSize As Integer: iFontSize = 8
For Each rngCharacter In ActiveDocument.Words(1).Characters
    rngCharacter.Font.Size = iFontSize
    iFontSize = iFontSize + 2
Next rngCharacter

Métodos

AutoFormat - Da formato automáticamente a un documento.

Calculate - Calcula una expresión matemática dentro de un intervalo o selección.

CheckGrammar - Inicia una revisión ortográfica y gramatical del intervalo especificado.

CheckSpelling - Inicia una revisión ortográfica del documento o intervalo especificado.

CheckSynonyms - Muestra el cuadro de diálogo Sinónimos, que enumera las opciones de palabras alternativas o sinónimos para el texto del intervalo especificado.

Collapse - Contrae un intervalo o una selección a la posición inicial o final.

ComputeStatistics - Devuelve un Long que representa una estadística basada en el contenido del intervalo especificado.

ConvertHangulAndHanja - Convierte el intervalo especificado de hangul en hanja o viceversa.

ConvertToTable - Convierte texto dentro de un intervalo en una tabla.

Copy - Copia el intervalo especificado en el Portapapeles.

CopyAsPicture - El método CopyAsPicture funciona del mismo modo que el método Copy.

Cut - Elimina el objeto especificado del documento y lo coloca en el Portapapeles.

Delete - Elimina el número de caracteres o palabras especificado.

DetectLanguage - Analiza el texto especificado para determinar el idioma en que está escrito.

EndOf - Mueve o extiende la posición del carácter final de un intervalo al final de la unidad de texto más próxima.

Expand - Se expande el intervalo o selección especificados.

ExportAsFixedFormat - Guarda una parte de un documento en los formatos PDF o XPS.

ExportAsFixedFormat2 - Guarda una parte de un documento en los formatos PDF o XPS.

ExportFragment - Este método exporta el intervalo seleccionado en un documento para que se utilice como un fragmento de documento.

GetSpellingSuggestions - Devuelve una colección SpellingSuggestions que representa las palabras sugeridas como términos de reemplazo de la primera palabra del intervalo especificado.

GoTo - Devuelve un objeto Range que representa la posición inicial del elemento especificado, como una página, un marcador o un campo.

GoToEditableRange - Devuelve un objeto Range que representa un área de un documento que puede modificar el usuario o grupo de usuarios especificado.

GoToNext - Devuelve un objeto Range que hace referencia a la posición inicial del siguiente elemento o la ubicación especificada por el argumento What.

GoToPrevious - Devuelve un objeto Range que hace referencia a la posición inicial del elemento anterior o la ubicación especificada por el argumento What.

ImportFragment - Este método importa un fragmento de documento en el documento en el intervalo especificado.

InRange - Devuelve true si el intervalo al que se aplica el método se encuentra en el intervalo especificado por el argumento Range.

InsertAfter - Inserta el texto especificado al final de un intervalo.

InsertAlignmentTab - Inserta una tabulación absoluta que siempre se coloca en el mismo punto, que es relativo ya sea respecto a los márgenes o a las sangrías.

InsertAutoText - Intenta que coincida el texto del intervalo especificado o el texto que lo rodea con el nombre de un elemento de Autotexto.

InsertBefore - Inserta el texto especificado delante de un intervalo.

InsertBreak - Inserta un salto de página, de columna o de sección.

InsertCaption - Inserta un título inmediatamente antes o después del intervalo especificado.

InsertCrossReference - Inserta una referencia cruzada en un título, un marcador, una nota al pie o al final, o bien en un elemento para el que se ha definido un rótulo de título; por ejemplo, una ecuación, una figura o una tabla.

InsertDatabase - Recupera los datos de un origen de datos (por ejemplo, un documento de Microsoft Word diferente, una hoja de cálculo de Microsoft Excel o una base de datos de Microsoft Access) e inserta los datos como una tabla en lugar del intervalo especificado.

InsertDateTime - Inserta la fecha o la hora actual, o ambas, como texto o como campo TIME.

InsertFile - Inserta todo o parte del archivo especificado.

InsertParagraph - Reemplaza el intervalo especificado por un nuevo párrafo.

InsertParagraphAfter - Inserta una marca de párrafo a continuación de un intervalo.

InsertParagraphBefore - Inserta un nuevo párrafo delante del intervalo especificado.

InsertSymbol - Inserta un símbolo en lugar del intervalo especificado.

InsertXML - Este método inserta el XML especificado en el documento en el intervalo especificado, reemplazando cualquier texto que contenga el intervalo.

InStory - True si el rango al que se aplica este método se encuentra en el mismo artículo que el intervalo especificado por el argumento Range.

IsEqual - True si el intervalo al que se aplica este método es igual al intervalo especificado por el argumento Range.

LookupNameProperties - Busca un nombre en la lista de la libreta de direcciones global y muestra el cuadro de diálogo Propiedades, que incluye información sobre el nombre especificado.

ModifyEnclosure - Agrega, modifica o quita una forma del carácter o de los caracteres especificados.

Move - Contrae el intervalo especificado hasta la posición inicial o final y, a continuación, mueve el objeto contraído el número de unidades especificadas.

MoveEnd - Mueve la posición del carácter final de un intervalo.

MoveEndUntil - Mueve la posición final del intervalo especificado hasta que se encuentre en el documento alguno de los caracteres especificados.

MoveEndWhile - Mueve la posición de carácter final de un intervalo mientras se encuentre en el documento alguno de los caracteres especificados.

MoveStart - Mueve la posición inicial del intervalo especificado.

MoveStartUntil - Mueve la posición inicial del intervalo especificado hasta que se encuentre en el documento alguno de los caracteres especificados.

MoveStartWhile - Mueve la posición inicial del intervalo especificado mientras se encuentre en el documento alguno de los caracteres especificados.

MoveUntil - Mueve el intervalo especificado hasta que se encuentre en el documento uno de los caracteres especificados.

MoveWhile - Mueve el intervalo especificado mientras se encuentre en el documento alguno de los caracteres especificados.

Next - Devuelve un objeto Range que representa la unidad especificada con respecto al rango especificado.

NextSubdocument - Mueve el intervalo al subdocumento siguiente.

Paste - Inserta el contenido del Portapapeles en el intervalo especificado.

PasteAndFormat - Pega las celdas de tabla seleccionadas y les aplica el formato especificado.

PasteAppendTable - Combina las celdas pegadas en una tabla existente insertando las filas pegadas entre las filas seleccionadas.

PasteAsNestedTable - Pega una celda o un grupo de celdas como una tabla anidada en el intervalo seleccionado.

PasteExcelTable - Pega y da formato a una tabla de Microsoft Excel.

PasteSpecial - Inserta el contenido del Portapapeles.

PhoneticGuide - Agrega guías fonéticas al intervalo especificado.

Previous - Devuelve el intervalo anterior con relación al intervalo especificado.

PreviousSubdocument - Mueve el intervalo al subdocumento anterior.

Relocate - En la vista Esquema mueve los párrafos dentro del intervalo especificado a continuación del siguiente párrafo visible o delante del anterior.

Select - Selecciona el intervalo especificado.

SetListLevel - Establece el nivel de lista de uno o varios elementos de una lista numerada.

SetRange - Establece las posiciones de carácter inicial y final de un intervalo existente.

Sort - Ordena los párrafos del intervalo especificado.

SortAscending - Ordena los párrafos o las filas de una tabla en orden alfanumérico ascendente.

SortByHeadings - Ordena los encabezados del intervalo especificado.

SortDescending - Ordena los párrafos en orden alfanumérico descendiente.

StartOf - Mueve o extiende la posición inicial del intervalo especificado o la selección al principio de la unidad de texto más cercano.

TCSCConverter - Convierte el intervalo especificado de chino tradicional en chino simplificado o viceversa.

WholeStory - Expande un intervalo para que incluya el artículo completo.

Propiedades

Text (Default member) - Devuelve o establece el texto de la selección o intervalo especificado.

Bold True si el intervalo tiene formato de negrita.

BoldBi True si la fuente o el intervalo tiene formato de negrita.

BookmarkID Devuelve el número del marcador que incluye el principio del intervalo especificado; Devuelve 0 (cero) si no hay ningún marcador correspondiente.

Bookmarks Devuelve una colección bookmarks que representa todos los marcadores de un documento, intervalo o selección.

Borders Devuelve una colección Borders que representa todos los bordes del objeto especificado.

Case Devuelve o establece una constante WdCharacterCase que representa los mayúsculas y minúsculas del texto en el intervalo especificado.

Cells Devuelve una colección Cells que representa las celdas de tabla en un rango.

Characters Devuelve una colección Characters que representa los caracteres de un intervalo.

CharacterStyle Devuelve una Variant que representa el estilo utilizado para dar formato a uno o más caracteres.

CharacterWidth Devuelve o establece el ancho de carácter del intervalo especificado.

Columns Devuelve una colección Columns que representa todas las columnas de tabla del rango.

CombineCharacters True si el rango especificado contiene caracteres combinados.

Comments Devuelve una colección Comments que representa todos los comentarios en el documento, la selección o el intervalo que se ha especificado.

Conflicts Devuelve un objeto de la colección Conflictos que contiene todos los objetos de conflicto en el rango.

ContentControls Devuelve una colección ContentControls que representa los controles de contenido contenidos en un intervalo.

DisableCharacterSpaceGrid True si Microsoft Word omite el número de caracteres por línea del objeto Range correspondiente.

Document Devuelve un objeto Document asociado con el rango especificado.

Duplicate Devuelve un objeto Range de sólo lectura que representa todas las propiedades del intervalo especificado.

Editors Devuelve un objeto Editors que representa a todos los usuarios autorizados para modificar una selección o un intervalo de un documento.

EmphasisMark Devuelve o establece la marca de énfasis de un carácter o cadena de caracteres designada.

End Devuelve o establece la posición del carácter final de un intervalo.

EndnoteOptions Devuelve un objeto EndnoteOptions que representa las notas al final de un intervalo.

Endnotes Devuelve una colección Endnotes que representa todas las notas al final de un intervalo.

EnhMetaFileBits Devuelve un valor Variant que representa una representación gráfica de cómo aparece un intervalo de texto.

Fields Devuelve una colección Fields que representa todos los campos del intervalo.

Find Devuelve un objeto Find que contiene los criterios para una operación de búsqueda.

FitTextWidth Devuelve o establece el ancho (en las unidades de medida actuales) al que Microsoft Word ajusta el texto en el intervalo o selección actual.

Font Devuelve o establece un objeto Font que representa el formato de carácter del objeto especificado.

FootnoteOptions Devuelve un objeto FootnoteOptions que representa las notas al pie en una selección o un intervalo.

Footnotes Devuelve una colección Footnotes que representa todas las notas al pie en un intervalo.

FormattedText Devuelve o establece un objeto Range que incluye el texto con formato del intervalo o selección especificados.

FormFields Devuelve una colección FormFields que representa todos los campos de formulario del intervalo.

Frames Devuelve una colección Frames que representa todos los marcos de un intervalo.

GrammarChecked True si se ha ejecutado una revisión gramatical en el documento o intervalo especificado.

GrammaticalErrors Devuelve una colección ProofreadingErrors que representa las oraciones que no superaron la revisión gramatical del documento o intervalo especificado.

HighlightColorIndex Devuelve o establece el color para resaltar del intervalo especificado.

HorizontalInVertical Devuelve o establece el formato de texto horizontal colocado dentro de texto vertical.

HTMLDivisions Devuelve un objeto HTMLDivisions que representa una división HTML en un documento Web.

Hyperlinks Devuelve una colección Hyperlinks que representa todos los hipervínculos del intervalo especificado.

ID Devuelve o establece el nombre de identificación para el rango especificado.

Information Devuelve información sobre el intervalo especificado.

InlineShapes Devuelve una colección InlineShapes que representa todos los objetos InlineShape de un intervalo.

IsEndOfRowMark True si el intervalo especificado está contraído y se encuentra en la marca de final de fila en una tabla.

Italic True si la fuente o el intervalo tiene formato de cursiva.

ItalicBi True si la fuente o el intervalo tiene formato de cursiva.

Kana Devuelve o establece si el intervalo especificado del texto en japonés es hiragana o katakana.

LanguageDetected Devuelve o establece un valor que especifica si Microsoft Word ha detectado el idioma del texto especificado.

LanguageID Devuelve o establece una constante WdLanguageID que representa el idioma del intervalo especificado.

LanguageIDFarEast Devuelve o establece un idioma del este asiático para el objeto especificado.

LanguageIDOther Devuelve o establece el idioma para el rango especificado.

ListFormat Devuelve un objeto ListFormat que representa todas las características de formato de lista de un intervalo.

ListParagraphs Devuelve una colección ListParagraphs que representa todos los párrafos numerados del intervalo.

ListStyle Devuelve una Variant que representa el estilo utilizado para dar formato a una lista con viñetas o lista numerada.

Locks Devuelve un objeto de colección CoAuthLocks que representa todos los bloqueos del intervalo.

NextStoryRange Devuelve un objeto Range que hace referencia al siguiente artículo.

NoProofing True si el corrector ortográfico y gramatical omite el texto especificado.

OMaths Devuelve una colección OMaths que representa los objetos OMath del intervalo especificado.

Orientation Devuelve o establece la orientación del texto en un intervalo cuando se habilita la característica dirección del texto.

PageSetup Devuelve un objeto PageSetup que está asociado con el intervalo especificado.

ParagraphFormat Devuelve o establece un objeto ParagraphFormat que representa la configuración de párrafo del intervalo especificado.

Paragraphs Devuelve una colección Paragraphs que representa todos los párrafos del intervalo especificado.

ParagraphStyle Devuelve una Variant que representa el estilo utilizado para dar formato a un párrafo.

Parent Devuelve un objeto Object que representa el objeto primario del objeto Range especificado.

ParentContentControl Devuelve un objeto ContentControl que representa el control de contenido primario del intervalo especificado.

PreviousBookmarkID Devuelve el número del último marcador que comienza antes o en el mismo lugar que el intervalo especificado.

ReadabilityStatistics Devuelve una colección ReadabilityStatistics que representa las estadísticas de legibilidad del documento o intervalo especificado.

Revisions Devuelve una colección Revisions que representa los cambios realizados en el intervalo.

Rows Devuelve una colección Rows que representa todas las filas de tabla de un intervalo.

Scripts Devuelve una colección scripts que representa la colección de secuencias de comandos HTML del objeto especificado.

Sections Devuelve una colección Sections que representa las secciones del intervalo especificado.

Sentences Devuelve una colección Sentences que representa todas las oraciones del intervalo.

Shading Devuelve un objeto shading que hace referencia al formato de sombreado del objeto especificado.

ShapeRange Devuelve una colección ShapeRange que representa todos los objetos Shape del intervalo especificado.

ShowAll True si se muestran todos los caracteres no imprimibles (como texto oculto, marcas de tabulación, marcas de espacios y marcas de párrafo).

SpellingChecked True si la ortografía se ha revisado en el intervalo o documento especificado.

SpellingErrors Devuelve una colección ProofreadingErrors que representa las palabras identificadas como errores ortográficos en el intervalo especificado.

Start Devuelve o establece la posición del carácter inicial de un intervalo.

StoryLength Devuelve el número de caracteres del artículo que contiene el rango especificado.

StoryType Devuelve el tipo de artículo del intervalo, la selección o el marcador especificado.

Style Devuelve o establece el estilo para el objeto especificado.

Subdocuments Devuelve una colección Subdocuments que representa todos los subdocumentos del intervalo o documento especificado.

SynonymInfo Devuelve un objeto SynonymInfo que contiene información del Diccionario de sinónimos acerca de sinónimos, antónimos o palabras o expresiones relacionadas del contenido de un intervalo.

Tables Devuelve una colección tables que representa todas las tablas del intervalo especificado.

TableStyle Devuelve una Variant que representa el estilo utilizado para dar formato a una tabla.

TextRetrievalMode Devuelve un objeto TextRetrievalMode que controla el modo en que se recupera el texto del rangoespecificado.

TextVisibleOnScreen Devuelve un Long que indica si el texto del intervalo especificado está visible en la pantalla.

TopLevelTables Devuelve una colección tables que representa las tablas del nivel de anidamiento más exterior en el intervalo actual.

TwoLinesInOne Devuelve o establece si Microsoft Word establece dos líneas de texto en una y especifica los caracteres que rodean el texto, si hay alguno.

Underline Devuelve o establece el tipo de subrayado aplicado a un intervalo.

Updates Devuelve un objeto de colección CoAuthUpdates que representa todas las actualizaciones que se han combinado en el rango especificado en la última vez que guardó explícita.

WordOpenXML Devuelve una cadena que representa el XML incluido dentro del intervalo en el formato XML abierto de Microsoft Word.

Words Devuelve una colección Words que representa todas las palabras de un intervalo.

XML Devuelve una cadena que representa el texto XML en el objeto especificado.

Bookmarks - Colección de objetos Bookmark que representan los marcadores de la selección, intervalo o documento especificados.

Borders - Una colección de objetos Border que representan los bordes de un objeto.

Cells - Una colección de celdas objetos en una columna de tabla, una fila de tabla, una selección o un intervalo.

Characters - Una colección de caracteres en un documento, selección o intervalo.

CoAuthLocks - Una colección de objetos CoAuthLock .

CoAuthUpdates - Una colección de objetos CoAuthUpdate que representan las actualizaciones que se combinaron en el documento la última vez que se guardaron los cambios de forma explícita.

Columns - Colección de objetos Column que representa las columnas de una tabla.

Comments - Colección de objetos comment que representa los comentarios de una selección, intervalo o documento.

Conflicts - Una colección de objetos Conflict que representa los conflictos de un documento.

ContentControl - Un control de contenido individual.

ContentControls - Una colección de objetos ContentControl .

Document - Representa un documento.

Editors - Una colección de objetos Editor que representa una colección de usuarios o grupos de usuarios a los que se han concedido permisos específicos para editar partes de un documento.

EndnoteOptions - Representa las propiedades asignadas a un intervalo o una selección de notas al final en un documento.

Endnotes - Una colección de objetos EndNote que representa todas las notas al final de una selección, intervalo o documento.

Fields - Una colección de objetos Field que representan todos los campos de una selección, intervalo o documento.

Find - Representa los criterios de una operación de búsqueda.

Font - Contiene los atributos de fuente (como el nombre, el tamaño y el color de fuente) de un objeto.

FootnoteOptions - Representa las propiedades asignadas a un intervalo o una selección de notas al final de un documento.

Footnotes - Colección de objetos footnote que representan todas las notas al pie de la selección, el intervalo o el documento.

FormFields - Una colección de FormField objetos que representan todos los campos de formulario de una selección, intervalo o documento.

Frames - Referencia de modelos de objetos de Word

HTMLDivisions - Una colección de objetos HTMLDivision que representa los elementos div de HTML que existen en un documento Web.

Hyperlinks - Representa la colección de objetos HYPERLINK de un documento, intervalo o selección.

InlineShapes - Colección de objetos InlineShape que representa todas las formas entre líneas de un documento, intervalo o selección.

ListFormat - Representa los atributos de formato de lista que pueden aplicarse a los párrafos de un intervalo.

ListParagraphs - Colección de objetos Paragraph que representa los párrafos del documento, la lista o el intervalo especificados que tienen aplicado el formato de lista.

OMaths - Colección de ecuaciones.

PageSetup - Representa la descripción de la configuración de página.

ParagraphFormat - Representa todo el formato de un párrafo.

Paragraphs - Colección de objetos Paragraph de la selección, el intervalo o el documento.

ProofreadingErrors - Colección de errores ortográficos y gramaticales del documento o el intervalo especificado.

ReadabilityStatistics - Colección de objetos ReadabilityStatistic de un documento o intervalo.

Revisions - Colección de objetos revision que representa los cambios marcados con marcas de revisión de un intervalo o de un documento.

Rows - Colección de objetos Row que representa las filas de la tabla de la tabla, el intervalo o la selección especificada.

Sections - Colección de objetos section de una selección, intervalo o documento.

Sentences - Colección de objetos Range que representa todas las oraciones de la selección, el intervalo o el documento.

Shading - Contiene los atributos de sombreado de un objeto.

ShapeRange - Representa un intervalo de formas, que es un conjunto de formas de un documento.

SpellingSuggestions - Una colección de objetos SpellingSuggestion que representan todas las sugerencias para una palabra especificada o para la primera palabra del intervalo especificado.

Style - Representa un solo estilo integrado o definido por el usuario.

Subdocuments - Colección de objetos Subdocument que representa los subdocumentos de un intervalo o de un documento.

SynonymInfo - Representa la información acerca de sinónimos, antónimos, palabras o expresiones relacionadas del intervalo especificado o de una cadena dada.

Table - Representa una sola tabla.

Tables - Colección de objetos TABLE que representa las tablas de una selección, intervalo o documento.

TableStyle - Representa un solo estilo que se puede aplicar a una tabla.

TextRetrievalMode - Representa las opciones que controlan cómo se recupera el texto de un objeto Range .

Words - Una colección de palabras de un documento, selección o intervalo.