Microsoft Métodos de conector do Word
Os métodos do conector Microsoft do Word permitem que você execute várias tarefas diárias com documentos do Microsoft Word e as automatize. Por exemplo, adicione um rodapé de página.
Aberto
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| Caminho do arquivo | Especifica o caminho para o arquivo do Word Microsoft no disco local. | Dados em | Cadeia de caracteres |
| Tempo limite | Especifica o tempo após o qual a operação expira. | Dados em | Números inteiros |
| Senha | Use uma senha se o documento estiver protegido por senha. | Dados em | Cadeia de caracteres |
| Retornar | Retorna o valor booliano com base no resultado da operação. Se for verdadeiro, o arquivo será aberto. Else, se falso, o arquivo falhou ao abrir. | Saída de dados | Booliano |
Para obter detalhes sobre os problemas relacionados ao método Open, consulte o artigo da base de conhecimento KB1123558 e o artigo da base de conhecimento KB1123548.
AdicionarRodapé
Adiciona um rodapé ao documento do Word Microsoft no tamanho de fonte especificado.
Para usar este método, forneça o texto a ser adicionado ao parâmetro Text e o tamanho da fonte em que o texto do rodapé precisa ser exibido para o parâmetro FontSize. O valor padrão do parâmetro FontSize é 12.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| Texto | Especifica o texto no rodapé. | Dados em | Cadeia de caracteres |
| Tamanho da fonte | Especifica o tamanho da fonte do texto no rodapé. O valor padrão é 12. | Dados em | Números inteiros |
Para fornecer entradas, consulte Configurar propriedades da porta
AdicionarCabeçalho
Adiciona um cabeçalho a um documento do Word Microsoft no tamanho de fonte especificado.
Para usar este método, forneça o texto a ser adicionado ao parâmetro Text e o tamanho da fonte em que o texto do cabeçalho precisa ser exibido para o parâmetro FontSize. O valor padrão do parâmetro FontSize é 12.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| Texto | Especifica o texto no cabeçalho. | Dados em | Cadeia de caracteres |
| Tamanho da fonte | Especifica o tamanho da fonte do texto no cabeçalho. O valor padrão é 12. | Dados em | Números inteiros |
Cópia de célula
Copia o conteúdo de uma célula de tabela identificada usando o índice de linha e o índice de coluna da tabela em um documento Microsoft Palavra.
Para usar este método, forneça o índice de linha para o parâmetro RowIndex e o índice de coluna para o parâmetro ColumnIndex. O valor padrão para RowIndex e ColumnIndex é -1 cada.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| ÍndiceDeLinha | Índice da linha da célula que precisa ser copiada. O valor do índice de linha deve ser igual ou maior que zero. O valor padrão é -1, o que significa que não há célula disponível. | Dados em | Números inteiros |
| ColumnIndex | Índice da coluna da célula que precisa ser copiada. O índice da coluna deve ser igual ou maior que zero. O valor padrão é -1, o que significa que não há célula disponível. | Dados em | Números inteiros |
ColarCélula
cola o conteúdo da célula da tabela copiada em uma célula da tabela identificada usando o índice de linha e o índice de coluna da tabela em um documento Microsoft Palavra.
Para usar este método, forneça o índice de linha para o parâmetro RowIndex e o índice de coluna para o parâmetro ColumnIndex. O valor padrão para RowIndex e ColumnIndex é -1 cada.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| ÍndiceDeLinha | Índice da linha da célula para a qual os dados precisam ser colados. O valor do índice de linha deve ser igual ou maior que zero. O valor padrão é -1, o que significa que não há linha disponível para colar dados. | Dados em | Números inteiros |
| ColumnIndex | Índice da coluna da célula para a qual os dados precisam ser colados. O índice da coluna deve ser igual ou maior que zero. O valor padrão é -1, o que significa que não há coluna disponível para colar dados. | Dados em | Números inteiros |
Encerrar
Encerra o último Microsoft Palavra documento aberto. Ao fechar o documento, é opcional salvar as mudanças.
Se a modificação feita no documento do Word precisar ser salva, defina o parâmetro booliano saveChanges como Verdadeiro, caso contrário, defina-o como Falso. Por padrão, o parâmetro booliano saveChanges é definido como Verdadeiro.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| salvarMudanças | Especifica se as mudanças feitas no documento do Word devem ser salvas antes de fechar. Por padrão, está definido como Verdadeiro, o que significa que as mudanças serão salvas antes do fechamento. Se as mudanças não precisarem ser salvas antes do fechamento, defina como Falso. | Dados em | Booliano |
ExcluirColuna
Exclui uma coluna de uma tabela com base em um valor de índice especificado da coluna em um documento Microsoft Palavra.
Para usar este método, forneça o índice da coluna que precisa ser excluída para o parâmetro ColumnIndex. O valor padrão é -1.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| ColumnIndex | Índice da coluna que precisa ser excluída. O índice da coluna deve ser igual ou maior que zero. O valor padrão é -1, o que significa que não há coluna disponível para ser excluída. | Dados em | Números inteiros |
Excluir página
Exclui uma página com base em um valor de índice especificado de um documento Microsoft Palavra.
Para usar este método, forneça o valor de índice da página que precisa ser excluída para o parâmetro PageIndex.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| PageIndex | Especifica o número de índice da página que precisa ser removida ou excluída. Se você não fornecer nenhum número de índice, o método excluirá a primeira página por padrão. |
Dados em | Números inteiros |
Excluir linha
Exclui uma linha com base no valor de índice especificado de uma tabela em um documento Microsoft Palavra.
Para usar este método, forneça o índice da linha que precisa ser excluída para o parâmetro RowIndex. O valor padrão é -1.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| ÍndiceDeLinha | Índice da linha que precisa ser excluída. O valor do índice de linha deve ser igual ou maior que zero. O valor padrão é -1, o que significa que não há linha disponível para ser excluída. | Dados em | Números inteiros |
Excluir tabela
Exclui uma tabela de um documento Microsoft Palavra.
Se o documento tiver várias tabelas, o método excluirá a primeira tabela do documento.
Exportar para PDF
Exporta um documento Microsoft Palavra para um documento PDF em um caminho especificado.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| Caminho do arquivo | Especifica o caminho da pasta em que o documento do Word é exportado para PDF. | Dados em | Cadeia de caracteres |
Localizar
Encontra o texto especificado em um documento Microsoft Palavra e retorna uma resposta booliana.
Para usar este método, forneça o texto que você deseja encontrar no documento para o parâmetro Texto.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| Texto | Texto a ser encontrado no documento do Word. | Dados em | Cadeia de caracteres |
| Retornar | Retorna um valor verdadeiro/falso que indica se o texto foi encontrado no documento do Word. | Saída de dados | Booliano |
ObterValorCélulaPorIndex
Retorna o valor de uma célula em uma tabela em um documento Microsoft Palavra.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| ÍndiceDeCélula | Índice de uma célula para recuperar o valor. | Dados em | Cadeia de caracteres |
| Retornar | Retorna o valor presente na célula necessária. | Saída de dados | Cadeia de caracteres |
ObterTextoRodapé
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| Retornar | Retorna o texto do rodapé no formato de cadeia de caracteres. | Saída de dados | Cadeia de caracteres |
ObterTextoCabeçalho
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| Retornar | Retorna o texto do cabeçalho no formato de cadeia de caracteres. | Saída de dados | Cadeia de caracteres |
GetPageCount
Retorna o número total de páginas em um documento Microsoft Palavra.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| Retornar | Retorna o número inteiro ou o valor numérico do total de páginas em um documento do Word. | Saída de dados | Números inteiros |
GetRowIndexByValue
Retorna o valor de índice de uma linha com base no valor especificado de uma célula na linha.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| Tabela | Objeto de tabela no documento do Word como referência para executar outras ações nele. | Dados em | Objeto |
| Valor | Texto de pesquisa que corresponde a uma determinada linha na tabela. | Dados em | Cadeia de caracteres |
ObterTabela
Retorna os dados em uma tabela de um documento do Word Microsoft como um objeto de tabela e uma tabela de dados. Se o documento contiver várias tabelas, você poderá especificar o índice da tabela para identificar a tabela para o método. Você também pode especificar o tipo de tabela, se necessário.
Para usar este método, forneça o índice da tabela esperada para o parâmetro TableIndex. Defina o parâmetro FirstRowIsHeader como verdadeiro se a primeira linha precisar ser tratada como cabeçalho, caso contrário, será definido como falso.
- Clique no ícone de configurações de método (
).
- Selecione o tipo de tabela.
- Clique em OK.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| Dados em | |||
| ÍndiceTabela | Índice de uma tabela em um Microsoft documento do Word. | Dados em | Cadeia de caracteres |
| FirstRowIsHeader | Valor booliano para indicar se o método deve tratar a primeira linha como um cabeçalho da tabela. Por padrão, ele é definido como Verdadeiro, o que significa que a primeira linha é considerada um cabeçalho. Se a primeira linha não for cabeçalho, defina este parâmetro como Falso. |
Dados em | Booliano |
| Tabela | Retorna os dados em uma tabela como um objeto. | Saída de dados | Objeto |
| Dados | Retorna os dados na tabela. | Saída de dados | Dados |
ObterValoresDeCélulaTabela
Retorna os valores em uma ou mais células da tabela.
Para usar este método, forneça os índices das células da tabela cujo valor é necessário na janela de configuração.
- Clique no ícone de configurações de método (
).
- Clique em (
).
- Insira os valores de índice para as células.
- Repita as etapas para adicionar mais valores de índice.
- Clique em OK.
ObterContagemDeTabela
Retorna o número de tabelas em um documento Microsoft Palavra. Opcionalmente, você pode especificar o tipo de tabela para o método identificar.
Selecione o tipo de tabela na janela de configuração. Se você esperar receber o número total de tabelas em um documento do Word, o tipo de tabela será definido como "Padrão". Se uma contagem de tabelas aninhadas em uma célula de uma tabela for esperada, defina o tipo de tabela como "Aninhado". Forneça o índice da tabela que tem tabelas aninhadas para o parâmetro TableIndex e o índice de célula da tabela a partir do qual a contagem de tabelas aninhadas é esperada para o parâmetro cellIndex.
- Clique no ícone de configurações de método (
).
- Selecione o tipo de tabela.
- Clique em OK.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| Retornar | Retorna o valor inteiro do número total de tabelas no documento do Word. | Dados em | Números inteiros |
ObterDadosTableRow
- Clique no ícone de configurações de método (
).
- Clique no ícone para adicionar valor de índice (
).
- Insira o valor de índice da célula.
- Repita as etapas para adicionar mais valores de índice.
- Clique em OK.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| ÍndiceDeLinha | Índice da linha da qual os dados precisam ser recuperados. O valor padrão é 0, o que significa que os dados serão obtidos da primeira linha. | Dados em | Números inteiros |
ObterTexto
Retorna todo o conteúdo de texto em um Microsoft documento do Word.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| Retornar | Retorna o texto do documento completo em um formato de cadeia de caracteres. | Saída de dados | Cadeia de caracteres |
InserirNovaColuna
Insere uma nova coluna na primeira tabela do documento com base no valor de índice especificado.
Para usar este método, forneça o número do índice no qual uma nova coluna precisa ser inserida no parâmetro ColumnIndex. O valor padrão é -1, o que significa que uma coluna é inserida antes da primeira coluna.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| ColumnIndex | Índice no qual a nova coluna deve ser inserida. O valor padrão é -1, o que significa que não há colunas na tabela. | Dados em | Números inteiros |
InserirNovaLinha
Insere uma nova linha com base no valor do índice.
Para usar este método, forneça o número de índice no qual uma nova linha precisa ser inserida no parâmetro RowIndex. O valor padrão é -1, o que significa que uma linha é inserida antes da primeira linha.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| ÍndiceDeLinha | Índice no qual a nova linha deve ser inserida. O valor padrão é -1, o que significa que não há linhas na tabela. | Dados em | Números inteiros |
Inserir imagem
Insere uma imagem no documento Microsoft Palavra a partir do caminho do arquivo fornecido em um marcador específico.
Para usar este método, forneça o caminho do arquivo da imagem que precisa ser inserida no parâmetro ImageFilePath. Forneça o local de identificação em que a imagem precisa ser inserida no documento do Word para o parâmetro Marcador.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| ImageFilePath | Caminho da pasta do sistema para a imagem que precisa ser inserida. | Dados em | Cadeia de caracteres |
| Marcador | Ponto em que a imagem precisa ser adicionada. | Dados em | Cadeia de caracteres |
Inserir tabela
Insere uma tabela em um documento Microsoft Palavra. Opcionalmente, você pode personalizar o documento configurando-o antes de inserir.
Para usar este método, o ponto em que a tabela precisa ser adicionada é fornecido para o parâmetro Marcador e a tabela que precisa ser adicionada deve ser passada para o parâmetro Dados.
- Clique no ícone de configurações de método (
).
- Selecione Incluir cabeçalhos.
- Selecione o estilo de borda e o comportamento de ajuste automático.
- Selecione Incluir linhas vazias.
- Para ignorar colunas específicas, clique no ícone para adicionar valor de índice (
).
- Insira o valor de índice da coluna.
- Clique em OK.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| Marcador | Posição específica no documento do Word em que a tabela será inserida. Antes de inserir a tabela, você deve adicionar um marcador. |
Dados em | Cadeia de caracteres |
| Dados | Dados da tabela que serão inseridos no ponto do marcador. | Dados em | Dados |
Inserir texto
Insere texto no início do documento Microsoft Palavra.
Para usar este método, forneça um valor que precise ser inserido no parâmetro de texto.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| texto | Valor de texto que precisa ser inserido. | Entrada de dados | Cadeia de caracteres |
Está aberto
Verifica se um documento Microsoft Palavra está aberto.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| Caminho do arquivo | Caminho da pasta do sistema para documento ou arquivo do Word. | Dados em | Cadeia de caracteres |
| Retornar | Caminho da pasta do sistema para documento ou arquivo do Word. | Saída de dados | Booliano |
MesclarPorIndicesDeCélula
Mescla o intervalo de células especificado na forma de intervalo de valores de índice.
Para usar este método, forneça o valor do índice da célula inicial para o parâmetro StartCellIndex e o valor do índice da célula final para o parâmetro EndCellIndex.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| IniciarCélulaIndex | Índice de ponto de célula inicial para iniciar a mesclagem de células. | Dados em | Números inteiros |
| EndCcellIndex | Índice do ponto de célula final para finalizar a mesclagem de células. | Dados em | Números inteiros |
MesclarPorRinhaCol
Mescla um intervalo de células de uma tabela em um documento Microsoft Palavra.
Para usar este método, forneça o índice de linha inicial para o parâmetro StartRowIndex, o índice de linha final para o parâmetro EndRowIndex e o índice de coluna inicial para o parâmetro StartColIndex e o índice de coluna final para o parâmetro EndColIndex.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| StartRowIndex | Índice da linha inicial. | Dados em | Números inteiros |
| StartColIndex | Índice da coluna inicial. | Dados em | Números inteiros |
| EndRowIndex | Índice da linha final. | Dados em | Números inteiros |
| EndColIndex | Índice da coluna final. | Dados em | Números inteiros |
Substituir Marcador
Substitui um marcador em um documento Microsoft Palavra pelo texto especificado.
Para usar este método, forneça o marcador de identificação ao parâmetro Marcador com o texto a ser substituído fornecido para o parâmetro SubstituirTexto.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| Marcador | Marcador de identificação no documento do Word. | Dados em | Cadeia de caracteres |
| Substituir texto | Substitua o texto no local marcado como favorito pelo novo valor fornecido. | Dados em | Cadeia de caracteres |
SubstituirMarcadores
Localiza e substitui vários marcadores em um documento Microsoft Palavra pelo texto especificado.
Para usar este método, forneça um valor para o(s) campo(s) adicionado(s), que é o texto pelo qual o marcador precisa ser substituído.
- Clique duas vezes no componente.
- Na caixa de diálogo FORNECER RÓTULOS/MARCADORES, clique no ícone de clique para adicionar rótulo (
) e insira o marcador para substituí-lo.
Repita esta etapa para adicionar mais marcadores.
- Clique em OK.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| Texto | Texto a ser substituído em um documento Microsoft Palavra. | Dados em | Cadeia de caracteres |
SubstituirTextoRodapé
Localiza e substitui o texto do rodapé em um documento Microsoft Palavra pelo texto especificado.
Forneça o valor do texto do rodapé original que está presente no documento do Word para o parâmetro FindText e o texto com o qual o texto do rodapé original deve ser substituído para o parâmetro SubstituirTexto.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| LocalizarTexto | Valor atual que está presente no rodapé. | Dados em | Cadeia de caracteres |
| Substituir texto | Valor necessário para substituir o valor de FindText pelo, no rodapé. | Dados em | Cadeia de caracteres |
Substituir texto do cabeçalho
Localiza e substitui o texto do cabeçalho em um documento Microsoft Palavra pelo texto especificado.
Forneça o valor do texto do cabeçalho original que está presente no documento do Word para o parâmetro FindText e o texto com o qual o texto do cabeçalho original deve ser substituído para o parâmetro SubstituaTexto.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| LocalizarTexto | Valor atual que está presente no cabeçalho. | Dados em | Cadeia de caracteres |
| Substituir texto | Valor necessário para substituir o valor de FindText pelo, no cabeçalho. | Dados em | Cadeia de caracteres |
Substituir textoestático
Localiza e substitui o texto em um documento Microsoft Palavra pelo texto especificado. Substitui marcadores, títulos ou qualquer texto com base na configuração.
Para usar este método, forneça um valor ao campo adicionado que é o texto com o qual o rótulo/marcador precisa ser substituído.
- Clique no ícone de configurações de método (
).
- Clique no ícone adicionar texto (
)
- Insira o título, o marcador ou o texto que você deseja substituir.
- Repita as etapas para inserir mais texto.
- Clique em OK.
Substituir texto
Localiza e substitui o texto em um documento Microsoft Palavra pelo texto especificado.
Forneça o valor de texto original que está presente no documento do Word para o parâmetro FindText e o texto com o qual o texto original deve ser substituído para o parâmetro SubstituirTexto.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| LocalizarTexto | Valor atual que está presente no documento do Word. | Dados em | Cadeia de caracteres |
| Substituir texto | Valor necessário para substituir o valor de FindText pelo, no documento do Word. | Dados em | Cadeia de caracteres |
Redimensionar
Redimensiona a janela de um documento Microsoft Palavra de acordo com os parâmetros esquerdo, superior, largura e altura.
Para usar este método, especifique as margens Esquerda e Superior e os parâmetros Largura e Altura para o conteúdo.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| Esquerda | Margem esquerda do conteúdo no documento do Word. | Dados em | Números inteiros |
| Superior | Margem superior do conteúdo em documento do Word. | Dados em | Números inteiros |
| Largura | Largura do documento do Word. | Dados em | Números inteiros |
| Altura | Altura do documento do Word. | Dados em | Números inteiros |
Salvar
Salva o documento Microsoft Palavra aberto.
Salvar como
Salva uma cópia do documento Microsoft Palavra aberto com outro nome em um local fornecido no parâmetro Filepath.
Para usar este método, forneça o novo local no qual o documento Microsoft Palavra precisa ser salvo no parâmetro Filepath. Se o arquivo precisar ser protegido por senha, passe o valor para o parâmetro Senha.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| Caminho do arquivo | Caminho da pasta do sistema para o documento ou arquivo do Word. | Dados em | Cadeia de caracteres |
| Senha | Abra um documento do Word protegido por senha com a senha fornecida. O valor padrão está vazio. | Dados em | Cadeia de caracteres |
Definir tabela
Define uma tabela em um documento Microsoft Palavra.
Para usar este método, é necessário passar o objeto de tabela para o parâmetro Tabela.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| Tabela | Tabela que precisa ser definida no documento do Word. | Dados em | Objeto |
DefinirValoresDeCélulaTabela
Define o conteúdo de uma célula de tabela em um documento Microsoft Palavra.
Para usar este método, forneça os índices das células da tabela cujo valor precisa ser definido na janela de configuração.
- Clique duas vezes no componente.
- Na caixa de diálogo FORNECER ÍNDICE DE CÉLULA, clique no ícone de clique para adicionar índice de célula (
), insira um índice de célula e selecione um tipo de valor.
Repita esta etapa para adicionar mais índices de célula e tipos de valor.
- Clique em OK.
SetTableRowData
Define o conteúdo em uma linha de uma tabela em um documento Microsoft Palavra.
- Entrada
- ÍndiceDeLinha Forneça o índice da coluna da seguinte forma:
- Clique duas vezes no componente.
- Na caixa de diálogo FORNECER ÍNDICE DE COLUNA, clique no ícone de clique para adicionar índice de célula (
) e insira um índice de coluna.
- Clique em OK.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| ÍndiceDeLinha | Índice da linha em que os dados precisam ser definidos. O valor padrão é 0, o que significa que os dados serão definidos para a primeira linha. | Dados em | Números inteiros |