Selection Interface
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 |
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 |
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
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: ao longo de 2024, vamos eliminar problemas do GitHub como o mecanismo de comentários para conteúdo e substituí-lo por um novo sistema de comentários. Para obter mais informações, consulte:Enviar e exibir comentários de