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 Selectiontype Selection = interfacePublic 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 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 |
| 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 |
| 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. |