Como alterar a orientação da página em documentos do Word usando Python

Alterar a orientação da página em documentos do Word usando Python

O termo orientação refere-se à direção em que um documento é exibido para impressão e leitura. O Word oferece suporte a dois tipos de orientação: retrato (vertical) e paisagem (horizontal). Normalmente, o tamanho de página padrão de um documento Word é “Carta” (8,5 x 11 polegadas) e a orientação de página padrão é “Retrato”. Você pode alterar a orientação padrão para criar um documento diferente, como um formulário de inscrição ou brochura. Em certos casos, você precisa alterar a orientação das páginas em um arquivo do Word, dependendo do conteúdo do documento do Word. Neste tutorial, mostrarei como alterar a orientação da página em documentos do Word usando Python.

Para saber como alterar a orientação da página para uma página ou várias páginas no Word para paisagem ou retrato, selecione os links apropriados abaixo:

API para alterar a orientação da página para paisagem ou retrato - instalação

Em um documento do Word, você pode definir a orientação da página como retrato ou paisagem para todo o documento, uma única página ou várias páginas, dependendo do conteúdo do projeto. Para alterar a orientação da página em um arquivo do Word para uma única página ou várias páginas de forma programática, usarei o Python SDK do GroupDocs.Merger Cloud API. Além de alterar a orientação do documento, esta API também permite mover, trocar, remover, dividir e extrair páginas de formato de documento compatível.

Você pode instalar a API GroupDocs.Merger Cloud em seu projeto Python usando o seguinte comando no console:

pip install groupdocs_merger_cloud

Agora colete o ID do cliente e o segredo do cliente no painel para seguir as etapas abaixo e os exemplos de código disponíveis. Depois de obter as credenciais do aplicativo, copie e cole o trecho de código abaixo em seu aplicativo Python, conforme mostrado abaixo:

# Importar SDK de fusão do groupdocs
import groupdocs_merger_cloud

# Obtenha app_sid e app_key em https://dashboard.groupdocs.cloud após o registro gratuito.
app_sid = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
app_key = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# Obter configurações de API de arquivo 
configuration = groupdocs_merger_cloud.Configuration(app_sid, app_key)
configuration.api_base_url = "https://api.groupdocs.cloud"
storage_name = "LocalStorage"

Em seguida, adicione o trecho de código do arquivo ao seu projeto para carregar o arquivo do Word na nuvem. O arquivo do Word carregado estará disponível na seção de arquivos do painel na nuvem. Até agora, você instalou a biblioteca Python e adicionou configurações ao seu aplicativo. Agora, você está pronto para alterar programaticamente a orientação da página do Word.

Como alterar a orientação da página para paisagem no documento do Word usando Python

Siga as etapas e o trecho de código mencionado abaixo para alterar programaticamente a orientação da página do Word para paisagem:

  • Primeiro, crie uma instância da classe PagesApi
  • Em seguida, crie uma instância da classe OrientationOptions
  • Agora, crie uma instância de FileInfo com o arquivo de entrada como parâmetro
  • Em seguida, defina o caminho do arquivo de saída na nuvem
  • Forneça números de página separados por vírgula para alterar a orientação
  • Defina o modo de orientação como Paisagem
  • Em seguida, crie uma instância de OrientationRequest
  • Por fim, altere a orientação da página chamando o método PagesApi.orientation() com as opções OrientationRequest como parâmetro.

O trecho de código Python a seguir é sobre como alterar a orientação de retrato para paisagem no documento do Word:

# Como alterar a orientação da página para paisagem no Word usando Python
try:
    # Crie uma instância da API de páginas
    pagesApi = groupdocs_merger_cloud.PagesApi.from_keys(app_sid, app_key)
     
    options = groupdocs_merger_cloud.OrientationOptions()
    options.file_info = groupdocs_merger_cloud.FileInfo("python-testing/sample-file.docx")
    options.output_path = "python-testing/output-file.docx"
    options.pages = [1, 3]
    options.mode = "Landscape"
    
    # Como mudar retrato para paisagem no word
    result = pagesApi.orientation(groupdocs_merger_cloud.OrientationRequest(options))
    print("Successfully changed word document orientation from Portrait to Landscape: ")
except groupdocs_merger_cloud.ApiException as e:
  print("Exception while calling API: {0}".format(e.message))
Como alterar a orientação da página para paisagem no Word usando Python

Como alterar a orientação da página para paisagem no Word usando Python

Você também pode usar o exemplo de código acima para ver como criar uma página paisagem no Word. A orientação paisagem produz uma página que estica as margens da esquerda para a direita. Além disso, você pode usar snippet de código do arquivo de download para baixar o arquivo em seu sistema local.

Como alterar a orientação da página de paisagem para retrato no word em Python

Da mesma forma, você pode converter páginas de um documento do Word em orientação retrato. Siga as etapas e os trechos de código mencionados abaixo:

  • Primeiro, crie uma instância PagesApi
  • Em segundo lugar, crie a instância OrientationOptions
  • Em seguida, crie uma instância de FileInfo com um arquivo de entrada como parâmetro
  • Defina o caminho do arquivo de saída na nuvem
  • Forneça números de página separados por vírgula para alterar a orientação
  • Defina o modo de orientação para Retrato
  • Em seguida, crie uma instância de OrientationRequest
  • Por fim, altere a orientação da página chamando o método PagesApi.orientation() com as opções OrientationRequest como parâmetros.

O exemplo de código Python a seguir mostra como alterar a orientação de retrato para retrato no documento do Word:

# Como alterar a orientação de uma página no Word para retrato usando Python
try:
    # Crie uma instância da API de páginas
    pagesApi = groupdocs_merger_cloud.PagesApi.from_keys(app_sid, app_key)
     
    options = groupdocs_merger_cloud.OrientationOptions()
    options.file_info = groupdocs_merger_cloud.FileInfo("python-testing/sample-file.docx")
    options.output_path = "python-testing/output-file.docx"
    options.pages = [1, 3]
    options.mode = "Portrait"
    
    # Como converter a palavra paisagem para retrato online
    result = pagesApi.orientation(groupdocs_merger_cloud.OrientationRequest(options))
    print("Successfully changed word document orientation from Landscape to Portrait: ")
except groupdocs_merger_cloud.ApiException as e:
  print("Exception while calling API: {0}".format(e.message))
Como alterar a orientação de uma página no Word para retrato usando Python

Como alterar a orientação de uma página no Word para retrato usando Python

O exemplo de código acima alterará a orientação das páginas do Word de paisagem para retrato. Este exemplo de código também pode ser usado para alterar a orientação de uma página no documento do Word.

Resumindo

Este é o fim desta postagem no blog. Você pode ver como a orientação afeta a aparência e o espaçamento de texto e imagens. Neste artigo, você aprendeu:

  • como alterar a orientação da página para paisagem programaticamente em Python;
  • como alterar a orientação das páginas selecionadas para retrato no word usando Python;

Além disso, você pode tentar criar seu próprio aplicativo para criar uma paisagem de página única que pode alternar as páginas de palavras de orientação online. Para obter detalhes e outros recursos da API, você pode visitar as diretrizes da documentação.

Sugerimos que você siga nosso Guia de primeiros passos.

Por fim, groupdocs.cloud está escrevendo novos artigos de blog sobre diferentes soluções de formato de arquivo usando a API REST. Fique atento para as atualizações mais recentes.

Faça uma pergunta

Você pode nos informar sobre suas perguntas ou dúvidas sobre como alterar a orientação da página no Word neste Fórum.

perguntas frequentes

Como alterar a orientação de uma página no Word programaticamente?

Siga este link para aprender o trecho de código Python sobre como alterar a orientação de apenas uma página ou várias páginas em um documento do Word.

Como altero a orientação de um documento inteiro no Word em Python?

Crie uma instância de PagesApi, OrientationOptions, FileInfo, defina os valores de FileInfo e invoque o método PagesApi.orientation() com OrientationRequest para alterar a orientação de um documento inteiro.

Como instalar a biblioteca de download gratuito de orientação de página?

Você pode instalar o Word biblioteca Python de orientação de página para alterar a orientação de paisagem para retrato ou de retrato para paisagem programaticamente usando as etapas mencionadas aqui.

Como altero a orientação da página no Windows?

Visite este link para baixar a ferramenta de orientação de página gratuitamente. Este software off-line pode ser usado para alterar a orientação dos documentos com um único clique.

Veja também