Selection Interface

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 existir um Selection objeto por painel de janela do documento e apenas um Selection objeto em toda a aplicação pode estar ativo.

Utilize a Selection propriedade para devolver o Selection objeto. Se não for utilizado nenhum qualificador de objeto com a Selection propriedade , o Microsoft Word devolve a seleção a partir do painel ativo da janela do documento ativo.

O documento não tem de estar ativo para aceder à seleção atual.

Utilize a Text propriedade para definir ou devolver o texto na seleção atual.

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

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

Mesmo quando uma seleção é fechada para um ponto de inserção, não está necessariamente vazia. Por exemplo, a Text propriedade continuará a devolver o caráter à direita do ponto de inserção; este caráter também aparece na Characters coleção do Selection objeto. No entanto, chamar métodos como Cut() ou Copy() de uma seleção fechada causará um erro.

É possível que o utilizador selecione uma região num documento que não represente texto contíguo (por exemplo, ao utilizar a tecla ALT com o rato). Uma vez que o comportamento de tal seleção pode ser imprevisível, poderá querer incluir um passo no código que verifica a Type propriedade de uma seleção antes de efetuar quaisquer operações no mesmo. 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.

Uma Range vez que os objetos partilham muitos dos mesmos métodos e propriedades que Selection os objetos, a utilização Range de objetos é preferível para manipular um documento quando não existe 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	Devolve um _Application objeto que representa a aplicação microsoft Word.
BookmarkID	Devolve o número do marcador que inclui o início da seleção especificada ou 0 (zero) se não existir um marcador correspondente.
Bookmarks	Devolve uma Bookmarks coleção que representa todos os marcadores numa seleção.
Borders	Devolve uma Borders coleção que representa todos os limites do objeto especificado.
Cells	Devolve uma Cells coleção que representa as células da tabela numa seleção.
Characters	Devolve uma Characters coleção que representa os carateres numa seleção.
ChildShapeRange	Devolve um ShapeRange objeto que representa as formas subordinadas de uma seleção.
Columns	Devolve uma Columns coleção que representa todas as colunas da tabela na seleção.
ColumnSelectMode	Determina se o modo de seleção de colunas está ativo.
Comments	Devolve uma Comments coleção que representa todos os comentários na seleção especificada.
ContentControls	Devolve uma ContentControls coleção que representa os controlos de conteúdo contidos num intervalo. Somente leitura.
Creator	Retorna um inteiro de 32 bits que indica o aplicativo no qual o objeto especificado foi criado.
Document	Devolve um Document objeto associado à seleção especificada.
Editors	Devolve um Editors objeto que representa todos os utilizadores autorizados a modificar uma seleção num documento.
End	Retorna ou define a posição de caractere final de uma seleção.
EndnoteOptions	Devolve um EndnoteOptions objeto que representa as notas de fim numa seleção.
Endnotes	Devolve uma Endnotes coleção que representa todas as notas de fim numa seleção.
EnhMetaFileBits	Devolve um Objeto que representa uma representação de imagem de como é apresentada uma seleção de texto.
ExtendMode	Determina se o Modo de expansão está ativo.
Fields	Devolve uma coleção só Fields de leitura que representa todos os campos na seleção.
Find	Devolve 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	Devolve ou define um Font objeto que representa a formatação de carateres do objeto especificado.
FootnoteOptions	Devolve um FootnoteOptions objeto que representa as propriedades da nota de rodapé numa seleção.
Footnotes	Devolve uma Footnotes coleção que representa todas as notas de rodapé numa seleção.
FormattedText	Devolve ou define um Range objeto que inclui o texto formatado na seleção especificada.
FormFields	Devolve uma FormFields coleção que representa todos os campos de formulário na seleção.
Frames	Devolve uma Frames coleção que representa todos os fotogramas numa seleção.
HasChildShapeRange	Determina se a seleção contém formas subordinadas.
HeaderFooter	Devolve um HeaderFooter objeto para a seleção especificada.
HTMLDivisions	Devolve um HTMLDivisions objeto que representa uma divisão HTML num documento Web.
Hyperlinks	Devolve uma Hyperlinks coleção que representa todas as hiperligações na seleção especificada.
Information[WdInformation]	Devolve informações sobre a seleção ou intervalo especificado.
InlineShapes	Devolve uma InlineShapes coleção que representa todos os InlineShape objetos numa seleção.
IPAtEndOfLine	Determina se o ponto de inserção está no final de uma linha que molda para a linha seguinte.
IsEndOfRowMark	Determina se a seleção especificada está fechada e está localizada na marca de fim de linha numa 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	Devolve 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	Devolve um PageSetup objeto associado à seleção especificada.
ParagraphFormat	Devolve ou define um ParagraphFormat objeto que representa as definições de parágrafo para a seleção especificada.
Paragraphs	Devolve 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	Devolve um ContentControl objeto que representa o controlo de conteúdo principal para o intervalo especificado. Somente leitura.
PreviousBookmarkID	Devolve o número do último marcador que é iniciado antes ou no mesmo local que a seleção especificada ou devolve 0 (zero) se não existir um marcador correspondente.
Range	Devolve um Range objeto que representa a parte de um documento que está contida no objeto especificado.
Rows	Devolve uma Rows coleção que representa todas as linhas de tabela numa seleção.
Sections	Devolve uma Sections coleção que representa as secções na seleção especificada.
Sentences	Devolve uma Sentences coleção que representa todas as frases na seleção.
Shading	Devolve um Shading objeto que se refere à formatação de sombreado do objeto especificado.
ShapeRange	Devolve uma ShapeRange coleção que representa todos os Shape objetos no intervalo ou seleção especificado.
SmartTags	Devolve um SmartTags objeto que representa uma etiqueta inteligente num 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	Devolve uma Tables coleção que representa todas as tabelas na seleção especificada.
Text	Retorna ou define o texto da seleção especificada.
TopLevelTables	Devolve uma Tables coleção que representa as tabelas no nível de aninhamento mais exterior na seleção atual.
Type	Retorna o tipo de seleção.
WordOpenXML	Devolve uma Cadeia que representa o XML contido na seleção no formato Open XML do Microsoft Office Word. Somente leitura.
Words	Devolve uma Words coleção que representa todas as palavras numa 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 carateres (formatação que foi aplicada manualmente através dos botões no Friso ou através das 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 (utilizando os botões no Friso ou através das 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 numa seleção numa 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 expande a posição do caráter final de uma seleção para o fim 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)	Guarda a seleção atual como formato PDF ou XPS. .
Extend(Object)	Ativa o modo de expansão ou expande a seleção para a próxima unidade maior de texto se o modo Expandir já estiver ativado.
GoTo(Object, Object, Object, Object)	Move o ponto de inserção para a posição do caráter imediatamente antes do item especificado.
GoToEditableRange(Object)	Devolve um Range objeto que representa uma área de um documento que pode ser modificada pelo utilizador ou grupo de utilizadores especificado.
GoToNext(WdGoToItem)	Devolve um Range objeto que se refere à posição inicial do item seguinte ou localização especificada pelo What argumento.
GoToPrevious(WdGoToItem)	Devolve um Range objeto que se refere à posição inicial do item anterior ou a uma localização especificada.
HomeKey(Object, Object)	Move ou expande a seleção para o início da unidade especificada.
InRange(Range)	Determina se a seleção à qual o método é aplicado está contida num 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_2002(Object, WdReferenceKind, Object, Object, Object)	Reservado para uso interno.
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).
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 à Microsoft Word associar parágrafos formatados com estilos de parágrafo diferentes.
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 este método é aplicado está no mesmo bloco que o intervalo especificado.
IsEqual(Range)	Determina se a seleção à qual este 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 devolve o número de unidades que foram movidas.
MoveEnd(Object, Object)	Move a posição de caráter 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 devolve o número de unidades que foi movida.
MoveRight(Object, Object, Object)	Move a seleção para a direita e devolve o número de unidades que 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 devolve 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)	Devolve um Range objeto que representa a unidade especificada relativamente à seleção especificada.
NextField()	Seleciona o próximo campo.
NextRevision(Object)	Localiza e devolve a alteração registada seguinte 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)	Devolve um Range objeto relativo à seleção especificada.
PreviousField()	Seleciona o campo anterior.
PreviousRevision(Object)	Localiza e devolve a alteração registada 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()	Desseleciona todos, exceto o texto selecionado mais recentemente, quando uma seleção contém múltiplas seleções não ligadas.
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)	Ordena os cabeçalhos na seleção especificada.
SortDescending()	Ordena parágrafos ou linhas de tabela por ordem alfanumérica descendente.
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 expande 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.