Usando painéis de tarefas de extensão da Web

Introdução

Bem-vindo a este tutorial aprofundado sobre como usar Painéis de Tarefas de Extensão da Web em um documento do Word usando Aspose.Words para .NET. Se você sempre quis aprimorar seus documentos do Word com painéis de tarefas interativos, você está no lugar certo. Este guia o guiará por cada etapa para conseguir isso perfeitamente.

Pré-requisitos

Antes de começarmos, vamos garantir que você tenha tudo o que precisa:

  • Aspose.Words para .NET: Você pode baixá-loaqui.
  • Ambiente de desenvolvimento .NET: Visual Studio ou qualquer outro IDE de sua preferência.
  • Conhecimento básico de C#: Isso ajudará você a acompanhar os exemplos de código.
  • Licença para Aspose.Words: Você pode comprar umaaqui ou obter uma licença temporáriaaqui.

Importar namespaces

Antes de começar a codificar, certifique-se de ter os seguintes namespaces importados em seu projeto:

using Aspose.Words;
using Aspose.Words.WebExtensions;

Guia passo a passo

Agora, vamos dividir o processo em etapas fáceis de seguir.

Etapa 1: Configurando seu diretório de documentos

Primeiro, precisamos configurar o caminho para o diretório dos seus documentos. É aqui que seu documento do Word será salvo.

// O caminho para o diretório de documentos.
string dataDir = "YOUR DOCUMENT DIRECTORY";

Substituir"YOUR DOCUMENT DIRECTORY" com o caminho real para sua pasta de documentos.

Etapa 2: Criando um novo documento

Em seguida, criaremos um novo documento do Word usando o Aspose.Words.

Document doc = new Document();

Esta linha inicializa uma nova instância doDocument classe, que representa um documento do Word.

Etapa 3: Adicionar um painel de tarefas

Agora, adicionaremos um Painel de Tarefas ao nosso documento. Painéis de Tarefas são úteis para fornecer funcionalidades e ferramentas adicionais dentro de um documento do Word.

TaskPane taskPane = new TaskPane();
doc.WebExtensionTaskPanes.Add(taskPane);

Aqui, criamos um novoTaskPane objeto e adicioná-lo ao documentoWebExtensionTaskPanes coleção.

Etapa 4: Configurando o Painel de Tarefas

Para tornar nosso Painel de Tarefas visível e definir suas propriedades, usamos o seguinte código:

taskPane.DockState = TaskPaneDockState.Right;
taskPane.IsVisible = true;
taskPane.Width = 300;
  • DockState define onde o Painel de Tarefas aparecerá. Neste caso, é à direita.
  • IsVisible garante que o Painel de Tarefas esteja visível.
  • Width define a largura do Painel de Tarefas.

Etapa 5: Configurando a referência de extensão da Web

Em seguida, configuramos a Referência de Extensão da Web, que inclui o ID, a versão, o tipo de loja e a loja.

taskPane.WebExtension.Reference.Id = "wa102923726";
taskPane.WebExtension.Reference.Version = "1.0.0.0";
taskPane.WebExtension.Reference.StoreType = WebExtensionStoreType.OMEX;
taskPane.WebExtension.Reference.Store = "th-TH";
  • Idé um identificador exclusivo para a extensão da web.
  • Version especifica a versão da extensão.
  • StoreType indica o tipo de loja (neste caso, OMEX).
  • Store especifica o código de idioma/cultura da loja.

Etapa 6: Adicionando propriedades à extensão da Web

Você pode adicionar propriedades à sua extensão web para definir seu comportamento ou conteúdo.

taskPane.WebExtension.Properties.Add(new WebExtensionProperty("mailchimpCampaign", "mailchimpCampaign"));

Aqui, adicionamos uma propriedade chamadamailchimpCampaign.

Etapa 7: Vinculando a extensão da Web

Por fim, adicionamos bindings à nossa extensão web. Bindings permitem que você vincule a extensão a partes específicas do documento.

taskPane.WebExtension.Bindings.Add(new WebExtensionBinding("UnnamedBinding_0_1506535429545", WebExtensionBindingType.Text, "194740422"));
  • UnnamedBinding_0_1506535429545 é o nome da ligação.
  • WebExtensionBindingType.Text indica que a ligação é do tipo texto.
  • 194740422 é o ID da parte do documento à qual a extensão está vinculada.

Etapa 8: Salvando o documento

Depois de configurar tudo, salve seu documento.

doc.Save(dataDir + "WorkingWithWebExtension.UsingWebExtensionTaskPanes.docx");

Esta linha salva o documento no diretório especificado com o nome de arquivo fornecido.

Etapa 9: Carregando e exibindo informações do painel de tarefas

Para verificar e exibir as informações do painel de tarefas, carregamos o documento e iteramos pelos painéis de tarefas.

doc = new Document(dataDir + "WorkingWithWebExtension.UsingWebExtensionTaskPanes.docx");

Console.WriteLine("Task panes sources:\n");

foreach (TaskPane taskPaneInfo in doc.WebExtensionTaskPanes)
{
    WebExtensionReference reference = taskPaneInfo.WebExtension.Reference;
    Console.WriteLine($"Provider: \"{reference.Store}\", version: \"{reference.Version}\", catalog identifier: \"{reference.Id}\";");
}

Este código carrega o documento e imprime o provedor, a versão e o identificador de catálogo de cada painel de tarefas no console.

Conclusão

E é isso! Você adicionou e configurou com sucesso um Painel de Tarefas de Extensão da Web em um documento do Word usando o Aspose.Words para .NET. Esse recurso poderoso pode melhorar significativamente seus documentos do Word ao fornecer funcionalidades adicionais diretamente no documento.

Perguntas frequentes

O que é um Painel de Tarefas no Word?

Um Painel de Tarefas é um elemento de interface que fornece ferramentas e funcionalidades adicionais dentro de um documento do Word, melhorando a interação do usuário e a produtividade.

Posso personalizar a aparência do Painel de Tarefas?

Sim, você pode personalizar a aparência do Painel de Tarefas definindo propriedades comoDockState, IsVisible , eWidth.

O que são propriedades de extensão da Web?

Propriedades de extensão da Web são propriedades personalizadas que você pode adicionar a uma extensão da Web para definir seu comportamento ou conteúdo.

Como vincular uma extensão da Web a uma parte do documento?

Você pode vincular uma extensão da Web a uma parte do documento usando oWebExtensionBinding classe, especificando o tipo de ligação e o ID de destino.

Onde posso encontrar mais informações sobre o Aspose.Words para .NET?

Você pode encontrar documentação detalhadaaqui.