Partilhar via

Criar o seu primeiro suplemento de conteúdo do PowerPoint

  • Artigo

Neste artigo, irá percorrer o processo de criação de um suplemento de conteúdo do PowerPoint com o Visual Studio.

Pré-requisitos

  • Visual Studio 2019 ou posterior com a carga de trabalho Desenvolvimento Office/SharePoint instalada.

    Observação

    Se você já instalou o Visual Studio, use o Instalador do Visual Studio para garantir que a carga de trabalho de desenvolvimento do Office/SharePoint esteja instalada.

  • Office conectado a uma assinatura Microsoft 365 (incluindo o Office na web).

Criar o projeto do suplemento

  1. No Visual Studio, escolha Criar um novo projeto.

  2. Usando a caixa de pesquisa, insira suplemento. Escolha Suplemento do PowerPoint Web , em seguida, selecione Próximo.

  3. Nomeie seu projeto e selecione Criar.

  4. Na janela de diálogo Criar Suplemento do Office , selecione Inserir conteúdo nos diapositivos do PowerPoint e, em seguida, selecione Concluir para criar o projeto.

  5. O Visual Studio cria uma solução, e os dois projetos dele aparecem no Gerenciador de Soluções. O arquivo Home.html é aberto no Visual Studio.

Explorar a solução do Visual Studio

Ao concluir o assistente, o Visual Studio cria uma solução que contém dois projetos.

Project Descrição
Projeto de suplemento Contém apenas um ficheiro de manifesto apenas de suplemento com formato XML, que contém todas as definições que descrevem o seu suplemento. As configurações ajudam o aplicativo do Office a determinar quando o suplemento deverá ser ativado e onde ele deverá aparecer. O Visual Studio gera o conteúdo desse arquivo para que você possa executar o projeto e usar o suplemento imediatamente. Altere estas definições em qualquer altura ao modificar o ficheiro XML.
Projeto de aplicativo Web Contém as páginas de conteúdo do suplemento, incluindo todos os arquivos e referências de arquivo de que você precisa para desenvolver páginas HTML e JavaScript com reconhecimento do Office. Enquanto você desenvolve o suplemento, o Visual Studio hospeda o aplicativo Web no servidor IIS local. Quando estiver pronto para publicar, você precisará implantar este projeto de aplicativo Web em um servidor Web.

Atualizar o código

  1. Home.html especifica o HTML que será renderizado no painel de tarefas do suplemento. No Home.html, localize o <p> elemento que contém o texto "Este exemplo irá ler a seleção do documento atual" e o <button> elemento em id que é "get-data-from-selection". Substitua estes elementos inteiros pela seguinte marcação e, em seguida, guarde o ficheiro.

    <p class="ms-font-m-plus">This example will get some details about the current slide.</p>

<button class="Button Button--primary" id="get-data-from-selection">
    <span class="Button-icon"><i class="ms-Icon ms-Icon--plus"></i></span>
    <span class="Button-label">Get slide details</span>
    <span class="Button-description">Gets and displays the current slide's details.</span>
</button>

  2. Abra o arquivo Home.js na raiz do projeto do aplicativo Web. Este arquivo especifica o script do suplemento. Localize a getDataFromSelection função e substitua toda a função pelo seguinte código e, em seguida, guarde o ficheiro.

    // Gets some details about the current slide and displays them in a notification.
function getDataFromSelection() {
    if (Office.context.document.getSelectedDataAsync) {
        Office.context.document.getSelectedDataAsync(Office.CoercionType.SlideRange,
            function (result) {
                if (result.status === Office.AsyncResultStatus.Succeeded) {
                    showNotification('Some slide details are:', '"' + JSON.stringify(result.value) + '"');
                } else {
                    showNotification('Error:', result.error.message);
                }
            }
        );
    } else {
        app.showNotification('Error:', 'Reading selection data is not supported by this host application.');
    }
}

Atualizar o manifesto

  1. Abra o ficheiro de manifesto apenas do suplemento no projeto de suplemento. Este arquivo define as configurações e os recursos do suplemento.

  2. O elemento ProviderName tem um valor de espaço reservado. Substitua-o com seu nome.

  3. O atributo DefaultValue do elemento DisplayName tem um espaço reservado. Substitua-o pelo suplementos do My Office.

  4. O atributo DefaultValue do elemento Description tem um espaço reservado. Substitua-o por Um suplemento de conteúdo para o PowerPoint..

  5. Salve o arquivo. As linhas atualizadas devem ter um aspeto semelhante ao seguinte exemplo de código.

    ...
<ProviderName>John Doe</ProviderName>
<DefaultLocale>en-US</DefaultLocale>
<!-- The display name of your add-in. Used on the store and various places of the Office UI such as the add-ins dialog. -->
<DisplayName DefaultValue="My Office Add-in" />
<Description DefaultValue="A content add-in for PowerPoint."/>
...

Experimente

  1. Com o Visual Studio, teste o suplemento do PowerPoint recentemente criado ao premir F5 ou ao selecionar o botão Iniciar para iniciar o PowerPoint com o suplemento de conteúdo apresentado no diapositivo.

  2. No PowerPoint, selecione o botão Obter detalhes do diapositivo no suplemento de conteúdo para obter detalhes sobre o diapositivo atual.

    Os conteúdos do suplemento são abertos no PowerPoint.

Observação

Para ver o console.log output, você precisará de um conjunto separado de ferramentas para desenvolvedores para um console de JavaScript. Para saber mais sobre as ferramentas F12 e o Microsoft Edge DevTools, visite Depurar suplementos usando ferramentas de desenvolvedor para Internet Explorer, Depurar suplementos usando ferramentas de desenvolvedor para a Versão Prévia do Microsoft Edge ou Depurar suplementos usando ferramentas de desenvolvedor no Microsoft Edge (baseado em Chromium).

Próximas etapas

Parabéns, criou com êxito um suplemento de conteúdo do PowerPoint! Em seguida, saiba mais sobre como desenvolver suplementos do Office com o Visual Studio.

Solução de problemas

  • Se o suplemento mostrar um erro (por exemplo, "Não foi possível iniciar este suplemento. Feche esta caixa de diálogo para ignorar o problema ou clique em "Reiniciar" para tentar novamente.") quando prime F5 ou seleciona Depurar>Iniciar Depuração no Visual Studio, consulte Depurar Suplementos do Office no Visual Studio para obter outras opções de depuração.

Confira também