Selection Interfaz

Definición

Representa la selección actual en una ventana o panel.

public interface class Selection
[System.Runtime.InteropServices.Guid("00020975-0000-0000-C000-000000000046")]
public interface Selection
type Selection = interface
Public Interface Selection
Atributos

Comentarios

Una selección representa un área seleccionado (o resaltado) del documento o bien el punto de inserción si no hay nada seleccionado en el documento. Solo puede haber un Selection objeto por panel de ventana de documento y solo un Selection objeto de toda la aplicación puede estar activo.

Utilice la Selection propiedad para devolver el Selection objeto . Si no se usa ningún calificador de objeto con la Selection propiedad , Microsoft Word devuelve la selección del panel activo de la ventana de documento activa.

El documento no tiene que estar activo para acceder a su selección actual.

Utilice la Text propiedad para establecer o devolver el texto de la selección actual.

El Selection objeto tiene varios métodos y propiedades con los que puede:

Use propiedades como Flags, Information[WdInformation]y Type para devolver información sobre la selección actual.

Incluso cuando una selección se contrae a un punto de inserción, no está necesariamente vacía. Por ejemplo, la Text propiedad seguirá devolviendo el carácter a la derecha del punto de inserción; este carácter también aparece en la Characters colección del Selection objeto. Sin embargo, si se llama a métodos como Cut() o Copy() desde una selección contraída, se producirá un error.

Es posible que el usuario seleccione una región de un documento que no represente texto contiguo (por ejemplo, al usar la tecla ALT con el mouse). Dado que el comportamiento de dicha selección puede ser imprevisible, es posible que desee incluir un paso en el código que compruebe la Type propiedad de una selección antes de realizar cualquier operación en ella. De forma similar, las selecciones que incluyen celdas de tabla pueden tener también un comportamiento inesperado. La Information[WdInformation] propiedad le indicará si una selección está dentro de una tabla.

Dado que Range los objetos comparten muchos de los mismos métodos y propiedades que Selection los objetos, el uso Range de objetos es preferible para manipular un documento cuando no hay una razón para cambiar físicamente la selección actual.

Propiedades

Active

Determina si la selección en la ventana o panel especificada está activa.

Application

Devuelve un _Application objeto que representa la aplicación microsoft Word.

BookmarkID

Devuelve el número del marcador que incluye el principio de la selección especificada o 0 (cero) si no hay ningún marcador correspondiente.

Bookmarks

Devuelve una Bookmarks colección que representa todos los marcadores de una selección.

Borders

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

Cells

Devuelve una Cells colección que representa las celdas de tabla de una selección.

Characters

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

ChildShapeRange

Devuelve un ShapeRange objeto que representa las formas secundarias de una selección.

Columns

Devuelve una Columns colección que representa todas las columnas de tabla de la selección.

ColumnSelectMode

Determina si el modo de selección de columnas está activo.

Comments

Devuelve una Comments colección que representa todos los comentarios de la selección especificada.

ContentControls

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

Creator

Devuelve un entero de 32 bits que indica la aplicación en la que se creó el objeto especificado.

Document

Devuelve un Document objeto asociado a la selección especificada.

Editors

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

End

Devuelve o establece la posición del carácter final de una selección.

EndnoteOptions

Devuelve un EndnoteOptions objeto que representa las notas al final de una selección.

Endnotes

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

EnhMetaFileBits

Devuelve un objeto Object que representa una representación de imagen de cómo aparece una selección de texto.

ExtendMode

Determina si el modo Extender está activo.

Fields

Devuelve una colección de solo Fields lectura que representa todos los campos de la selección.

Find

Devuelve un Find objeto 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 de la selección actual.

Flags

Devuelve o establece las propiedades de la selección.

Font

Devuelve o establece un Font objeto que representa el formato de caracteres del objeto especificado.

FootnoteOptions

Devuelve un FootnoteOptions objeto que representa las propiedades de nota al pie de una selección.

Footnotes

Devuelve una Footnotes colección que representa todas las notas al pie de una selección.

FormattedText

Devuelve o establece un Range objeto que incluye el texto con formato en la selección especificada.

FormFields

Devuelve una FormFields colección que representa todos los campos de formulario de la selección.

Frames

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

HasChildShapeRange

Determina si la selección contiene formas secundarias.

HeaderFooter

Devuelve un HeaderFooter objeto para la selección especificada.

HTMLDivisions

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

Hyperlinks

Devuelve una Hyperlinks colección que representa todos los hipervínculos de la selección especificada.

Information[WdInformation]

Devuelve información sobre la selección o el intervalo especificados.

InlineShapes

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

IPAtEndOfLine

Determina si el punto de inserción está al final de una línea que se ajusta a la línea siguiente.

IsEndOfRowMark

Determina si la selección especificada está contraída y se encuentra en la marca de final de fila de una tabla.

LanguageDetected

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

LanguageID

Devuelve o establece el idioma del objeto especificado.

LanguageIDFarEast

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

LanguageIDOther

Devuelve o establece el idioma del objeto especificado.

NoProofing

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

OMaths

Devuelve una OMaths colección que representa los OMath objetos de la selección actual. Solo lectura.

Orientation

Devuelve o establece la orientación del texto de una selección cuando está habilitada la característica de dirección del texto.

PageSetup

Devuelve un PageSetup objeto asociado a la selección especificada.

ParagraphFormat

Devuelve o establece un ParagraphFormat objeto que representa la configuración de párrafo de la selección especificada.

Paragraphs

Devuelve una Paragraphs colección que representa todos los párrafos de la selección especificada.

Parent

Devuelve un objeto que representa el objeto primario del objeto especificado.

ParentContentControl

Devuelve un ContentControl objeto que representa el control de contenido primario para el intervalo especificado. Solo lectura.

PreviousBookmarkID

Devuelve el número del último marcador que comienza antes o en el mismo lugar que la selección especificada o devuelve 0 (cero) si no hay ningún marcador correspondiente.

Range

Devuelve un Range objeto que representa la parte de un documento contenido en el objeto especificado.

Rows

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

Sections

Devuelve una Sections colección que representa las secciones de la selección especificada.

Sentences

Devuelve una Sentences colección que representa todas las oraciones de la selección.

Shading

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

ShapeRange

Devuelve una ShapeRange colección que representa todos los Shape objetos del intervalo o selección especificados.

SmartTags

Devuelve un SmartTags objeto que representa una etiqueta inteligente en un documento.

Start

Devuelve o establece la posición del carácter inicial de una selección.

StartIsActive

Determina si el principio de la selección está activo.

StoryLength

Devuelve el número de caracteres del artículo que contiene la selección especificada.

StoryType

Devuelve el tipo de artículo de la selección especificada.

Style

Devuelve o establece el estilo para el objeto especificado.

Tables

Devuelve una Tables colección que representa todas las tablas de la selección especificada.

Text

Devuelve o establece el texto de la selección especificada.

TopLevelTables

Devuelve una Tables colección que representa las tablas en el nivel de anidamiento más externo de la selección actual.

Type

Devuelve el tipo de selección.

WordOpenXML

Devuelve una cadena que representa el XML contenido en la selección en el formato De Microsoft Office Word Open XML. Solo lectura.

Words

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

XML[Boolean]

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

XMLNodes

Este objeto, miembro o enumeración está en desuso y no debería usarse en el código.

XMLParentNode

Este objeto, miembro o enumeración está en desuso y no debería usarse en el código.

Métodos

BoldRun()

Agrega el formato de negrita o lo quita de la secuencia actual de caracteres.

Calculate()

Calcula una expresión matemática dentro de una selección.

ClearCharacterAllFormatting()

Este método quita del texto seleccionado todo el formato de caracteres (el formato aplicado mediante los estilos de carácter o el formato aplicado manualmente).

ClearCharacterDirectFormatting()

Quita el formato de caracteres (formato que se ha aplicado manualmente mediante los botones de la cinta de opciones o a través de los cuadros de diálogo) del texto seleccionado.

ClearCharacterStyle()

Este método quita del texto seleccionado el formato de caracteres aplicado mediante estilos de carácter.

ClearFormatting()

Quita el formato de texto y de párrafo de una selección.

ClearParagraphAllFormatting()

Este método quita del texto seleccionado todo el formato de párrafo (el formato aplicado mediante los estilos de párrafo o el formato aplicado manualmente).

ClearParagraphDirectFormatting()

Quita el formato de párrafo que se ha aplicado manualmente (con los botones de la cinta de opciones o a través de los cuadros de diálogo) del texto seleccionado.

ClearParagraphStyle()

Este método quita del texto seleccionado el formato de párrafo aplicado mediante estilos de párrafo.

Collapse(Object)

Contrae una selección a la posición inicial o final.

ConvertToTable(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)

Convierte el texto de una selección en una tabla.

ConvertToTableOld(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)

Reservado para uso interno.

Copy()

Copia el objeto especificado en el Portapapeles.

CopyAsPicture()

Copia el objeto especificado en el Portapapeles.

CopyFormat()

Copia el formato de carácter del primer carácter del texto seleccionado.

CreateAutoTextEntry(String, String)

Agrega un nuevo AutoTextEntry objeto a la AutoTextEntries colección, en función de la selección actual.

CreateTextbox()

Agrega un cuadro de texto de tamaño predeterminado alrededor de la selección.

Cut()

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

Delete(Object, Object)

Elimina el número de caracteres o palabras especificado.

DetectLanguage()

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

EndKey(Object, Object)

Mueve o extiende la selección al final de la unidad especificada.

EndOf(Object, Object)

Mueve o extiende la posición del carácter final de una selección al final de la unidad de texto especificada más cercana.

EscapeKey()

Cancela un modo, por ejemplo, el de extensión o de selección de columna (equivale a presionar la tecla ESC).

Expand(Object)

Expande la selección especificada.

ExportAsFixedFormat(String, WdExportFormat, Boolean, WdExportOptimizeFor, Boolean, WdExportItem, Boolean, Boolean, WdExportCreateBookmarks, Boolean, Boolean, Boolean, Object)

Guarda la selección actual como formato PDF o XPS. .

Extend(Object)

Activa el modo extender o extiende la selección a la siguiente unidad de texto más grande si el modo Extender ya está activado.

GoTo(Object, Object, Object, Object)

Mueve el punto de inserción a la posición del carácter inmediatamente anterior al elemento especificado.

GoToEditableRange(Object)

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

GoToNext(WdGoToItem)

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

GoToPrevious(WdGoToItem)

Devuelve un Range objeto que hace referencia a la posición inicial del elemento anterior o a una ubicación especificada.

HomeKey(Object, Object)

Mueve o extiende la selección al principio de la unidad especificada.

InRange(Range)

Determina si la selección a la que se aplica el método está contenida en un intervalo especificado.

InsertAfter(String)

Inserta el texto especificado al final de una selección.

InsertBefore(String)

Inserta el texto especificado antes de la selección especificada.

InsertBreak(Object)

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

InsertCaption(Object, Object, Object, Object, Object)

Inserta un título inmediatamente antes o después de la selección especificada.

InsertCaptionXP(Object, Object, Object, Object)

Reservado para uso interno.

InsertCells(Object)

Agrega celdas a una tabla existente.

InsertColumns()

Inserta columnas nuevas a la izquierda de la columna que contiene la selección.

InsertColumnsRight()

Inserta columnas a la derecha de la selección actual.

InsertCrossReference(Object, WdReferenceKind, Object, Object, Object, Object, Object)

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.

InsertCrossReference_2002(Object, WdReferenceKind, Object, Object, Object)

Reservado para uso interno.

InsertDateTime(Object, Object, Object, Object, Object)

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

InsertDateTimeOld(Object, Object, Object)

Reservado para uso interno.

InsertFile(String, Object, Object, Object, Object)

Inserta todo o parte del archivo especificado.

InsertFormula(Object, Object)

Inserta en la selección un campo = (Fórmula) que contiene una fórmula.

InsertNewPage()

Inserta una nueva página en la posición del punto de inserción.

InsertParagraph()

Reemplaza la selección especificada por un nuevo párrafo.

InsertParagraphAfter()

Inserta una marca de párrafo a continuación de una selección.

InsertParagraphBefore()

Inserta un nuevo párrafo antes de la selección especificada.

InsertRows(Object)

Inserta el número especificado de filas nuevas sobre la fila que contiene la selección.

InsertRowsAbove(Object)

Inserta filas por encima de la selección actual.

InsertRowsBelow(Object)

Inserta filas debajo de la selección actual.

InsertStyleSeparator()

Inserta una marca de párrafo oculta especial que permite a Microsoft Word combinar párrafos con formato con estilos de párrafo diferentes.

InsertSymbol(Int32, Object, Object, Object)

Inserta un símbolo en lugar de la selección especificada.

InsertXML(String, Object)

Inserta el texto XML especificado en la selección especificada.

InStory(Range)

Determina si la selección a la que se aplica este método está en el mismo artículo que el intervalo especificado.

IsEqual(Range)

Determina si la selección a la que se aplica este método es igual al intervalo especificado por el Range argumento .

ItalicRun()

Agrega el formato de cursiva o lo quita de la secuencia actual de caracteres.

LtrPara()

Establece el orden de lectura y la alineación de los párrafos especificados de izquierda a derecha.

LtrRun()

Establece el orden de lectura y la alineación de la ejecución especificada en izquierda a derecha.

Move(Object, Object)

Se contrae la selección especificada a su posición inicial o final y, a continuación, mueve el objeto contraído el número especificado de unidades.

MoveDown(Object, Object, Object)

Mueve la selección hacia abajo y devuelve el número de unidades que se ha movido.

MoveEnd(Object, Object)

Mueve la posición del carácter final de una selección.

MoveEndUntil(Object, Object)

Mueve la posición final de la selección especificada hasta que se encuentre en el documento alguno de los caracteres especificados.

MoveEndWhile(Object, Object)

Mueve la posición de carácter final de una selección mientras se encuentre en el documento alguno de los caracteres especificados.

MoveLeft(Object, Object, Object)

Mueve la selección a la izquierda y devuelve el número de unidades que se ha movido.

MoveRight(Object, Object, Object)

Mueve la selección a la derecha y devuelve el número de unidades que se ha movido.

MoveStart(Object, Object)

Mueve la posición inicial de la selección especificada.

MoveStartUntil(Object, Object)

Mueve la posición inicial de la selección especificada hasta que se encuentre en el documento alguno de los caracteres especificados.

MoveStartWhile(Object, Object)

Mueve la posición inicial de la selección especificada mientras se encuentre en el documento alguno de los caracteres especificados.

MoveUntil(Object, Object)

Mueve la selección especificada hasta que se encuentre en el documento uno de los caracteres especificados.

MoveUp(Object, Object, Object)

Mueve la selección hacia arriba y devuelve el número de unidades que se ha movido.

MoveWhile(Object, Object)

Mueve la selección especificada mientras se encuentre en el documento alguno de los caracteres especificados.

Next(Object, Object)

Devuelve un Range objeto que representa la unidad especificada en relación con la selección especificada.

NextField()

Selecciona el siguiente campo.

NextRevision(Object)

Busca y devuelve el siguiente cambio al que se realiza el seguimiento como un Revision objeto.

NextSubdocument()

Mueve la selección al subdocumento siguiente.

Paste()

Inserta el contenido del Portapapeles en la selección especificada.

PasteAndFormat(WdRecoveryType)

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(Boolean, Boolean, Boolean)

Pega y da formato a una tabla de Microsoft Excel.

PasteFormat()

Aplica el formato copiado con el CopyFormat() método a la selección.

PasteSpecial(Object, Object, Object, Object, Object, Object, Object)

Inserta el contenido del Portapapeles.

Previous(Object, Object)

Devuelve un Range objeto relativo a la selección especificada.

PreviousField()

Selecciona el campo anterior.

PreviousRevision(Object)

Busca y devuelve el cambio del que se ha realizado un seguimiento anterior como un Revision objeto.

PreviousSubdocument()

Mueve la selección al subdocumento anterior.

ReadingModeGrowFont()

Este método aumenta en un punto el tamaño del texto que se muestra cuando el documento se muestra en modo Lectura.

ReadingModeShrinkFont()

Este método reduce en un punto el tamaño del texto que se muestra cuando el documento se muestra en modo Lectura.

RtlPara()

Establece el orden de lectura y la alineación de los párrafos especificados en derecha a izquierda.

RtlRun()

Establece el orden de lectura y la alineación de la ejecución especificada en derecha a izquierda.

Select()

Selecciona el objeto especificado.

SelectCell()

Selecciona toda la celda que contiene la selección actual.

SelectColumn()

Selecciona la columna que contiene el punto de inserción o todas las columnas que contienen la selección.

SelectCurrentAlignment()

Extiende la selección hacia delante hasta que encuentra texto con una alineación de párrafo distinta.

SelectCurrentColor()

Extiende la selección hacia delante hasta que encuentra texto con un color distinto.

SelectCurrentFont()

Extiende la selección hacia delante hasta que encuentra texto con una fuente distinta o con un tamaño de fuente diferente.

SelectCurrentIndent()

Extiende la selección hacia delante hasta que encuentra texto con una sangría de párrafo izquierda o derecha distinta.

SelectCurrentSpacing()

Extiende la selección hacia delante hasta que encuentra un párrafo con interlineado distinto.

SelectCurrentTabs()

Extiende la selección hacia delante hasta que encuentra un párrafo con tabulaciones distintas.

SelectRow()

Selecciona la fila que contiene el punto de inserción o todas las filas que contienen la selección.

SetRange(Int32, Int32)

Establece las posiciones de carácter inicial y final de la selección.

Shrink()

Comprime la selección hasta la unidad de texto inferior siguiente.

ShrinkDiscontiguousSelection()

Anula la selección de todo, excepto el texto seleccionado más recientemente, cuando una selección contiene varias selecciones no conectadas.

Sort(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)

Ordena los párrafos de la selección especificada.

Sort2000(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)

Reservado para uso interno.

SortAscending()

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

SortByHeadings(Object, Object, Object, Object, Object, Object, Object, Object, Object)

Ordena los encabezados de la selección especificada.

SortDescending()

Ordena párrafos o filas de tabla en orden alfanumérico descendente.

SortOld(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)

Reservado para uso interno.

SplitTable()

Inserta un párrafo vacío encima de la primera fila de la selección.

StartOf(Object, Object)

Mueve o extiende la posición inicial de la selección especificada al principio de la unidad de texto especificada más cercana.

ToggleCharacterCode()

Cambia una selección entre un carácter Unicode y su correspondiente valor hexadecimal.

TypeBackspace()

Elimina el carácter anterior a una selección contraída; es decir, un punto de inserción.

TypeParagraph()

Inserta un párrafo nuevo en blanco.

TypeText(String)

Inserta el texto especificado.

WholeStory()

Expande una selección para que incluya el artículo completo.

Se aplica a