Selection Interface

Definição

Representa a seleção atual em uma janela ou um painel.

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

Comentários

Uma seleção representa uma área selecionada (ou realçada) no documento, ou representa o ponto de inserção se nada no documento estiver selecionado. Só pode haver um Selection objeto por painel de janela de documento e apenas um Selection objeto em todo o aplicativo pode estar ativo.

Use a Selection propriedade para retornar o Selection objeto. Se nenhum qualificador de objeto for usado com a propriedade, a Selection Microsoft Word retornará a seleção do painel ativo da janela do documento ativo.

O documento não precisa estar ativo para acessar sua seleção atual.

Use a Text propriedade para definir ou retornar o texto na seleção atual.

O Selection objeto tem vários métodos e propriedades com os quais você pode:

Use propriedades como Flags, Information[WdInformation]e Type para retornar informações sobre a seleção atual.

Mesmo quando uma seleção é recolhida em um ponto de inserção, ela não é necessariamente vazia. Por exemplo, a Text propriedade ainda retornará o caractere à direita do ponto de inserção; esse caractere também aparece na Characters coleção do Selection objeto. No entanto, chamar métodos como Cut() ou Copy() de uma seleção recolhida causará um erro.

É possível que o usuário selecione uma região em um documento que não represente texto contíguo (por exemplo, ao usar a chave ALT com o mouse). Como o comportamento de tal seleção pode ser imprevisível, talvez você queira incluir uma etapa em seu código que verifique a Type propriedade de uma seleção antes de executar qualquer operação nela. Da mesma forma, as seleções que incluem células da tabela também podem levar a um comportamento imprevisível. A Information[WdInformation] propriedade informará se uma seleção está dentro de uma tabela.

Como Range os objetos compartilham muitos dos mesmos métodos e propriedades Selection que os objetos, o uso Range de objetos é preferível para manipular um documento quando não há uma razão para alterar fisicamente a seleção atual.

Propriedades

Active

Determina se a seleção na janela ou painel especificado está ativa.

Application

Retorna um _Application objeto que representa o aplicativo microsoft Word.

BookmarkID

Retorna o número do indicador que inclui o início da seleção especificada ou 0 (zero) se não houver nenhum indicador correspondente.

Bookmarks

Retorna uma Bookmarks coleção que representa todos os indicadores em uma seleção.

Borders

Retorna uma Borders coleção que representa todas as bordas do objeto especificado.

Cells

Retorna uma Cells coleção que representa as células de tabela em uma seleção.

Characters

Retorna uma Characters coleção que representa os caracteres em uma seleção.

ChildShapeRange

Retorna um ShapeRange objeto que representa as formas filho de uma seleção.

Columns

Retorna uma Columns coleção que representa todas as colunas de tabela na seleção.

ColumnSelectMode

Determina se o modo de seleção de coluna está ativo.

Comments

Retorna uma Comments coleção que representa todos os comentários na seleção especificada.

ContentControls

Retorna uma ContentControls coleção que representa os controles de conteúdo contidos em um intervalo. Somente leitura.

Creator

Retorna um inteiro de 32 bits que indica o aplicativo no qual o objeto especificado foi criado.

Document

Retorna um Document objeto associado à seleção especificada.

Editors

Retorna um Editors objeto que representa todos os usuários autorizados a modificar uma seleção em um documento.

End

Retorna ou define a posição de caractere final de uma seleção.

EndnoteOptions

Retorna um EndnoteOptions objeto que representa as notas de extremidade em uma seleção.

Endnotes

Retorna uma Endnotes coleção que representa todas as notas de extremidade em uma seleção.

EnhMetaFileBits

Retorna um Objeto que representa uma representação de imagem de como uma seleção de texto é exibida.

ExtendMode

Determina se o modo Estender está ativo.

Fields

Retorna uma coleção somente Fields leitura que representa todos os campos na seleção.

Find

Retorna um Find objeto que contém os critérios para uma operação de localização.

FitTextWidth

Retorna ou define a largura (em unidades de medida atual) em que o Microsoft Word ajusta o texto da seleção atual.

Flags

Retorna ou define as propriedades da seleção.

Font

Retorna ou define um Font objeto que representa a formatação de caracteres do objeto especificado.

FootnoteOptions

Retorna um FootnoteOptions objeto que representa as propriedades da nota de rodapé em uma seleção.

Footnotes

Retorna uma Footnotes coleção que representa todas as notas de rodapé em uma seleção.

FormattedText

Retorna ou define um Range objeto que inclui o texto formatado na seleção especificada.

FormFields

Retorna uma FormFields coleção que representa todos os campos de formulário na seleção.

Frames

Retorna uma Frames coleção que representa todos os quadros em uma seleção.

HasChildShapeRange

Determina se a seleção contém formas filho.

HeaderFooter

Retorna um HeaderFooter objeto para a seleção especificada.

HTMLDivisions

Retorna um HTMLDivisions objeto que representa uma divisão HTML em um documento Da Web.

Hyperlinks

Retorna uma Hyperlinks coleção que representa todos os hiperlinks na seleção especificada.

Information[WdInformation]

Retorna informações sobre a seleção ou intervalo especificados.

InlineShapes

Retorna uma InlineShapes coleção que representa todos os InlineShape objetos em uma seleção.

IPAtEndOfLine

Determina se o ponto de inserção está no final de uma linha que é encapsulada para a próxima linha.

IsEndOfRowMark

Determina se a seleção especificada foi recolhida e está localizada na marca de fim de linha em uma tabela.

LanguageDetected

Retorna ou define um valor que especifica se o Microsoft Word detectou o idioma do texto especificado.

LanguageID

Retorna ou define o idioma do objeto especificado.

LanguageIDFarEast

Retorna ou define um idioma do Leste Asiático para o objeto especificado.

LanguageIDOther

Retorna ou define o idioma do objeto especificado.

NoProofing

Determina se o verificador ortográfico e gramatical ignora o texto especificado.

OMaths

Retorna uma coleção OMaths que representa os OMath objetos na seleção atual. Somente leitura.

Orientation

Retorna ou define a orientação do texto em uma seleção quando o recurso de direção do texto é habilitado.

PageSetup

Retorna um PageSetup objeto associado à seleção especificada.

ParagraphFormat

Retorna ou define um ParagraphFormat objeto que representa as configurações de parágrafo para a seleção especificada.

Paragraphs

Retorna uma Paragraphs coleção que representa todos os parágrafos na seleção especificada.

Parent

Retorna um objeto que representa o objeto pai do objeto especificado.

ParentContentControl

Retorna um ContentControl objeto que representa o controle de conteúdo pai para o intervalo especificado. Somente leitura.

PreviousBookmarkID

Retorna o número do último indicador que começa antes ou no mesmo local que a seleção especificada ou retorna 0 (zero) se não houver nenhum indicador correspondente.

Range

Retorna um Range objeto que representa a parte de um documento contido no objeto especificado.

Rows

Retorna uma Rows coleção que representa todas as linhas de tabela em uma seleção.

Sections

Retorna uma Sections coleção que representa as seções na seleção especificada.

Sentences

Retorna uma Sentences coleção que representa todas as frases na seleção.

Shading

Retorna um Shading objeto que se refere à formatação de sombreamento do objeto especificado.

ShapeRange

Retorna uma ShapeRange coleção que representa todos os Shape objetos no intervalo ou seleção especificados.

SmartTags

Retorna um SmartTags objeto que representa uma marca inteligente em um documento.

Start

Retorna ou define a posição do caractere inicial de uma seleção.

StartIsActive

Determina se o início da seleção está ativo.

StoryLength

Retorna o número de caracteres do texto que contém a seleção especificada.

StoryType

Retorna o tipo de texto da seleção especificada.

Style

Retorna ou define o estilo do objeto especificado.

Tables

Retorna uma Tables coleção que representa todas as tabelas na seleção especificada.

Text

Retorna ou define o texto da seleção especificada.

TopLevelTables

Retorna uma Tables coleção que representa as tabelas no nível de aninhamento mais externo na seleção atual.

Type

Retorna o tipo de seleção.

WordOpenXML

Retorna uma Cadeia de Caracteres que representa o XML contido na seleção no formato Microsoft Office Word Open XML. Somente leitura.

Words

Retorna uma Words coleção que representa todas as palavras em uma seleção.

XML[Boolean]

Retorna uma cadeia de caracteres que representa o texto XML no objeto especificado.

XMLNodes

This object, member, or enumeration is deprecated and is not intended to be used in your code.

XMLParentNode

This object, member, or enumeration is deprecated and is not intended to be used in your code.

Métodos

BoldRun()

Adiciona a formatação de caracteres em negrito ou remove-a da sequência atual.

Calculate()

Calcula uma expressão matemática dentro de uma seleção.

ClearCharacterAllFormatting()

Remove toda a formatação do caractere (formatação aplicada através dos estilos de caractere ou aplicada manualmente) do texto selecionado.

ClearCharacterDirectFormatting()

Remove a formatação de caracteres (formatação que foi aplicada manualmente usando os botões na Faixa de Opções ou nas caixas de diálogo) do texto selecionado.

ClearCharacterStyle()

Remove a formatação do caractere que foi aplicada por meio dos estilos de caractere do texto selecionado.

ClearFormatting()

Remove a formatação de parágrafo e texto de uma seleção.

ClearParagraphAllFormatting()

Remove toda a formatação do parágrafo (formatação aplicada através dos estilos de parágrafo ou aplicada manualmente) do texto selecionado.

ClearParagraphDirectFormatting()

Remove a formatação de parágrafo que foi aplicada manualmente (usando os botões na Faixa de Opções ou nas caixas de diálogo) do texto selecionado.

ClearParagraphStyle()

Remove a formatação do paragráfo que foi aplicada por meio dos estilos de parágrafo do texto selecionado.

Collapse(Object)

Recolhe uma seleção para a posição inicial ou final.

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

Converte texto em uma seleção em uma tabela.

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

Reservado para uso interno.

Copy()

Copia o objeto especificado para a Área de transferência.

CopyAsPicture()

Copia o objeto especificado para a Área de transferência.

CopyFormat()

Copia a formatação de caractere do primeiro caractere do texto selecionado.

CreateAutoTextEntry(String, String)

Adiciona um novo AutoTextEntry objeto à AutoTextEntries coleção, com base na seleção atual.

CreateTextbox()

Adiciona uma caixa de texto de tamanho padrão ao redor da seleção.

Cut()

Remove o objeto especificado do documento e o coloca na área de transferência.

Delete(Object, Object)

Sintaxe 3: Exclui o número especificado de caracteres ou palavras.

DetectLanguage()

Analisa o texto especificado para determinar o idioma em que está escrito.

EndKey(Object, Object)

Move ou estende a seleção até o final da unidade especificada.

EndOf(Object, Object)

Move ou estende a posição de caractere final de uma seleção até o final da unidade de texto especificada mais próxima.

EscapeKey()

Cancela um modo, como estender ou seleção de coluna (equivalente ao pressionamento da tecla ESC).

Expand(Object)

Expande a seleção especificada.

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

Salva a seleção atual como formato PDF ou XPS. .

Extend(Object)

Ativa o modo de extensão ou estende a seleção para a próxima unidade maior de texto se o modo Estender já estiver ativado.

GoTo(Object, Object, Object, Object)

Move o ponto de inserção para a posição de caractere imediatamente anterior ao item especificado.

GoToEditableRange(Object)

Retorna um Range objeto que representa uma área de um documento que pode ser modificado pelo usuário ou grupo de usuários especificado.

GoToNext(WdGoToItem)

Retorna um Range objeto que se refere à posição inicial do próximo item ou local especificado pelo What argumento.

GoToPrevious(WdGoToItem)

Retorna um Range objeto que se refere à posição inicial do item anterior ou a um local especificado.

HomeKey(Object, Object)

Move ou estende a seleção até o início da unidade especificada.

InRange(Range)

Determina se a seleção à qual o método é aplicado está contida em um intervalo especificado.

InsertAfter(String)

Insere o texto especificado no final de uma seleção.

InsertBefore(String)

Insere o texto especificado antes da seleção especificada.

InsertBreak(Object)

Insere uma quebra de seção, coluna ou página.

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

Insere uma legenda imediatamente antes ou após a seleção especificada.

InsertCaptionXP(Object, Object, Object, Object)

Reservado para uso interno.

InsertCells(Object)

Adiciona células a uma tabela existente.

InsertColumns()

Insere colunas à esquerda da coluna que contém a seleção.

InsertColumnsRight()

Insere colunas à direita da seleção atual.

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

Insere uma referência cruzada para um título, indicador, nota de rodapé ou nota de fim, ou para um item para o qual um nome de legenda esteja definido (por exemplo, uma equação, figura ou índice).

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

Reservado para uso interno.

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

Insere a data ou hora atual, ou ambas, seja como texto ou como um campo TIME.

InsertDateTimeOld(Object, Object, Object)

Reservado para uso interno.

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

Insere todo o arquivo especificado ou parte dele.

InsertFormula(Object, Object)

Insere um campo = (Formula contendo uma fórmula na seleção.

InsertNewPage()

Insere uma nova página na posição do Ponto de Inserção.

InsertParagraph()

Substitui a seleção especificada por um novo parágrafo.

InsertParagraphAfter()

Insere uma marca de parágrafo após a seleção.

InsertParagraphBefore()

Insere um novo parágrafo antes da seleção especificada.

InsertRows(Object)

Insere o número especificado de novas linhas acima da linha que contém a seleção.

InsertRowsAbove(Object)

Insere linhas acima da seleção atual.

InsertRowsBelow(Object)

Insere linhas abaixo da seleção atual.

InsertStyleSeparator()

Insere uma marca de parágrafo oculto especial que permite à Microsoft Word ingressar parágrafos formatados usando diferentes estilos de parágrafo.

InsertSymbol(Int32, Object, Object, Object)

Insere um símbolo no lugar da seleção especificada.

InsertXML(String, Object)

Insere o texto XML especificado na seleção especificada.

InStory(Range)

Determina se a seleção à qual esse método é aplicado está na mesma história que o intervalo especificado.

IsEqual(Range)

Determina se a seleção à qual esse método é aplicado é igual ao intervalo especificado pelo Range argumento.

ItalicRun()

Adiciona a formatação de caracteres em itálico ou remove-a da sequência atual.

LtrPara()

Define o sentido de leitura e o alinhamento dos parágrafos especificados como da esquerda para a direita.

LtrRun()

Define o sentido de leitura e o alinhamento das sequências especificadas como da esquerda para direita.

Move(Object, Object)

Recolhe a seleção especificada para sua posição inicial ou final e move o objeto recolhido pelo número especificado de unidades.

MoveDown(Object, Object, Object)

Move a seleção para baixo e retorna o número de unidades que ela foi movida.

MoveEnd(Object, Object)

Move a posição de caractere final de uma seleção.

MoveEndUntil(Object, Object)

Move a posição final da seleção especificada até um dos caracteres especificados ser localizado no documento.

MoveEndWhile(Object, Object)

Move a posição de caractere final de uma seleção enquanto qualquer um dos caracteres especificados é localizado no documento.

MoveLeft(Object, Object, Object)

Move a seleção para a esquerda e retorna o número de unidades que ela foi movida.

MoveRight(Object, Object, Object)

Move a seleção para a direita e retorna o número de unidades que ela foi movida.

MoveStart(Object, Object)

Move a posição inicial da seleção especificada.

MoveStartUntil(Object, Object)

Move a posição inicial da seleção especificada até um dos caracteres especificados ser localizado no documento.

MoveStartWhile(Object, Object)

Move a posição inicial da seleção especificada enquanto um dos caracteres especificados for localizado no documento.

MoveUntil(Object, Object)

Move a seleção especificada até um dos caracteres especificados ser localizado no documento.

MoveUp(Object, Object, Object)

Move a seleção para cima e retorna o número de unidades que ela foi movida.

MoveWhile(Object, Object)

Move a seleção especificada enquanto um dos caracteres especificados é localizado no documento.

Next(Object, Object)

Retorna um Range objeto que representa a unidade especificada em relação à seleção especificada.

NextField()

Seleciona o próximo campo.

NextRevision(Object)

Localiza e retorna a próxima alteração rastreada como um Revision objeto.

NextSubdocument()

Move a seleção para o próximo subdocumento.

Paste()

Insere o conteúdo da área de transferência na seleção especificada.

PasteAndFormat(WdRecoveryType)

Cola as células selecionadas da tabela e as formata como especificado.

PasteAppendTable()

Mescla as células coladas em uma tabela existente inserindo as linhas coladas entre as linhas selecionadas.

PasteAsNestedTable()

Cola uma célula ou um grupo de células como uma tabela aninhada dentro do intervalo selecionado.

PasteExcelTable(Boolean, Boolean, Boolean)

Cola e formata uma tabela do Microsoft Excel.

PasteFormat()

Aplica a formatação copiada com o CopyFormat() método à seleção.

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

Insere o conteúdo da área de transferência.

Previous(Object, Object)

Retorna um Range objeto relativo à seleção especificada.

PreviousField()

Seleciona o campo anterior.

PreviousRevision(Object)

Localiza e retorna a alteração rastreada anterior como um Revision objeto.

PreviousSubdocument()

Move a seleção para o subdocumento anterior.

ReadingModeGrowFont()

Aumenta o tamanho do texto exibido um ponto do tamanho quando o documento é exibido no modo Leitura.

ReadingModeShrinkFont()

Diminui o tamanho do texto exibido um ponto do tamanho quando o documento é exibido no modo Leitura.

RtlPara()

Define o sentido de leitura e o alinhamento dos parágrafos especificados como da direita para esquerda.

RtlRun()

Define o sentido de leitura e o alinhamento da sequência especificada como da direita para a esquerda.

Select()

Seleciona o objeto especificado.

SelectCell()

Seleciona toda a célula contendo a seleção atual.

SelectColumn()

Seleciona a coluna que contém o ponto de inserção ou seleciona todas as colunas que contêm a seleção.

SelectCurrentAlignment()

Estende a seleção para frente até que seja encontrado um texto com um alinhamento de parágrafo diferente.

SelectCurrentColor()

Estende a seleção para frente até encontrar texto com uma cor diferente.

SelectCurrentFont()

Estende a seleção para frente até encontrar texto com uma fonte ou tamanho de fonte diferente.

SelectCurrentIndent()

Estende a seleção para frente até encontrar texto com recuos de parágrafo esquerdo ou direito diferentes.

SelectCurrentSpacing()

Estende a seleção para frente até que um parágrafo com um espaçamento entre linhas diferente seja encontrado.

SelectCurrentTabs()

Estende a seleção para frente até encontrar um parágrafo com tabulações diferentes.

SelectRow()

Seleciona a linha que contém o ponto de inserção ou seleciona todas as linhas que contêm a seleção.

SetRange(Int32, Int32)

Define as posições de caractere inicial e final da seleção.

Shrink()

Diminui a seleção para a menor unidade de texto seguinte.

ShrinkDiscontiguousSelection()

Desmarca todos, exceto o texto selecionado mais recentemente, quando uma seleção contém várias seleções não conectadas.

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

Classifica os parágrafos da seleção 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()

Classifica linhas de tabela ou parágrafos em ordem alfanumérica crescente.

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

Classifica os títulos na seleção especificada.

SortDescending()

Classifica parágrafos ou linhas de tabela em ordem alfanumérica decrescente.

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

Reservado para uso interno.

SplitTable()

Insere um parágrafo vazio acima da primeira linha na seleção.

StartOf(Object, Object)

Move ou estende a posição inicial da seleção especificada até o início da unidade de texto especificada mais próxima.

ToggleCharacterCode()

Alterna uma seleção entre caracteres Unicode e seu valor hexadecimal correspondente.

TypeBackspace()

Exclui o caractere que antecede uma seleção recolhida (um ponto de inserção).

TypeParagraph()

Insere um novo parágrafo, em branco.

TypeText(String)

Insere o texto especificado.

WholeStory()

Expande uma seleção para incluir o texto inteiro.

Aplica-se a