Selection Interface

Esta página é útil?

Algum comentário adicional?

Os comentários serão enviados à Microsoft: quando você pressionar o botão Enviar, seus comentários serão usados para aprimorar os produtos e os serviços da Microsoft. Política de Privacidade.

Definição

Namespace:

Microsoft.Office.Interop.Word

Assembly:

Microsoft.Office.Interop.Word.dll

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

GuidAttribute

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 Selection propriedade, o Microsoft Word retornará a seleção do painel ativo da janela de documento ativa.

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 para um ponto de inserção, ela não está necessariamente vazia. Por exemplo, a Text Propriedade ainda retornará o caractere à direita do ponto de inserção; este caractere também aparece na Characters coleção do Selection objeto. No entanto, chamar métodos como Cut() ou Copy() a partir 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 tecla ALT com o mouse). Como o comportamento de tal seleção pode ser imprevisível, talvez você queira incluir uma etapa no código que verifica a Type propriedade de uma seleção antes de realizar qualquer operação nele. 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 indicará se uma seleção está dentro de uma tabela.

Como Range os objetos compartilham muitos dos mesmos métodos e propriedades que os Selection objetos, o uso de Range 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 no painel ou janela especificada 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 um indicador correspondente.
Bookmarks	Retorna uma Bookmarks coleção que representa todos os indicadores de 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 da 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 filhas de uma seleção.
Columns	Retorna uma Columns coleção que representa todas as colunas da 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 fim em uma seleção.
Endnotes	Retorna uma Endnotes coleção que representa todas as notas de fim 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 estendido está ativo.
Fields	Retorna uma coleção somente leitura Fields que representa todos os campos da 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 caractere do objeto especificado.
FootnoteOptions	Retorna um FootnoteOptions objeto que representa as propriedades de 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 da seleção.
Frames	Retorna uma Frames coleção que representa todos os quadros de uma seleção.
HasChildShapeRange	Determina se a seleção contém formas filhas.
HeaderFooter	Retorna um HeaderFooter objeto da seleção especificada.
HTMLDivisions	Retorna um HTMLDivisions objeto que representa uma divisão de 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 o intervalo especificado.
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 quebra para a próxima linha.
IsEndOfRowMark	Determina se a seleção especificada está 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 OMaths coleção que representa os OMath objetos dentro da 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 que está 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 da seleção especificada ou retorna 0 (zero) se não houver um indicador correspondente.
Range	Retorna um Range objeto que representa a parte de um documento que está contida 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 da seleção especificada.
Sentences	Retorna uma Sentences coleção que representa todas as frases da seleção.
Shading	Retorna um Shading objeto referente à formatação de sombreamento do objeto especificado.
ShapeRange	Retorna uma ShapeRange coleção que representa todos os Shape objetos no intervalo ou seleção especificada.
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 externo da seleção atual.
Type	Retorna o tipo de seleção.
WordOpenXML	Retorna uma cadeia de caracteres que representa o XML contido dentro da seleção no formato Microsoft Office Word Open XML. Somente leitura.
Words	Retorna uma Words coleção que representa todas as palavras de 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 caractere (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 pelas 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 o texto dentro de 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 Extend ou estende a seleção para a próxima unidade maior de texto se o modo Extend 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 modificada 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 um local especificado.
HomeKey(Object, Object)	Move ou estende a seleção para 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 oculta especial que permite que o Microsoft Word ingresse 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á no mesmo texto 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 foram movidas.
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 foram movidas.
MoveRight(Object, Object, Object)	Move a seleção para a direita e retorna o número de unidades que foram movidas.
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 foram movidas.
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 relativa à seleção especificada.
NextField()	Seleciona o próximo campo.
NextRevision(Object)	Localiza e retorna a próxima alteração controlada 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 para a 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 controlada 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 linhas de tabela ou parágrafos 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 da seleção.
StartOf(Object, Object)	Move ou estende a posição inicial da seleção especificada para 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.