Korzystanie z paneli zadań rozszerzeń internetowych

Wstęp

Witamy w tym dogłębnym samouczku dotyczącym korzystania z okienek zadań rozszerzeń internetowych w dokumencie Word przy użyciu Aspose.Words dla .NET. Jeśli kiedykolwiek chciałeś ulepszyć swoje dokumenty Word za pomocą interaktywnych okienek zadań, jesteś we właściwym miejscu. Ten przewodnik przeprowadzi Cię przez każdy krok, aby osiągnąć to bezproblemowo.

Wymagania wstępne

Zanim przejdziemy do konkretów, upewnijmy się, że masz wszystko, czego potrzebujesz:

  • Aspose.Words dla .NET: Można go pobraćTutaj.
  • Środowisko programistyczne .NET: Visual Studio lub inne preferowane środowisko IDE.
  • Podstawowa znajomość języka C#: Ułatwi Ci to śledzenie przykładów kodu.
  • Licencja na Aspose.Words: Możesz kupić jednąTutaj lub uzyskaj tymczasową licencjęTutaj.

Importuj przestrzenie nazw

Zanim zaczniesz kodować, upewnij się, że do projektu zaimportowano następujące przestrzenie nazw:

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

Przewodnik krok po kroku

Teraz podzielimy ten proces na łatwe do wykonania kroki.

Krok 1: Konfigurowanie katalogu dokumentów

Po pierwsze, musimy ustawić ścieżkę do katalogu dokumentów. To tutaj zostanie zapisany dokument Word.

// Ścieżka do katalogu dokumentów.
string dataDir = "YOUR DOCUMENT DIRECTORY";

Zastępować"YOUR DOCUMENT DIRECTORY" z rzeczywistą ścieżką do folderu z dokumentami.

Krok 2: Tworzenie nowego dokumentu

Następnie utworzymy nowy dokument Word za pomocą Aspose.Words.

Document doc = new Document();

Ta linia inicjuje nową instancjęDocument Klasa, która reprezentuje dokument Worda.

Krok 3: Dodawanie panelu zadań

Teraz dodamy Panel zadań do naszego dokumentu. Panele zadań są przydatne do zapewniania dodatkowych funkcjonalności i narzędzi w dokumencie Word.

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

Tutaj tworzymy nowyTaskPane obiekt i dodaj go do dokumentuWebExtensionTaskPanes kolekcja.

Krok 4: Konfigurowanie panelu zadań

Aby uczynić nasz Panel zadań widocznym i ustawić jego właściwości, używamy następującego kodu:

taskPane.DockState = TaskPaneDockState.Right;
taskPane.IsVisible = true;
taskPane.Width = 300;
  • DockState ustawia, gdzie pojawi się Panel zadań. W tym przypadku jest to po prawej stronie.
  • IsVisible zapewnia widoczność panelu zadań.
  • Width ustawia szerokość Panelu zadań.

Krok 5: Konfigurowanie rozszerzenia internetowego

Następnie konfigurujemy odniesienie do rozszerzenia internetowego, które obejmuje identyfikator, wersję, typ sklepu i sklep.

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";
  • Idjest unikalnym identyfikatorem rozszerzenia internetowego.
  • Version określa wersję rozszerzenia.
  • StoreType wskazuje rodzaj sklepu (w tym przypadku OMEX).
  • Store określa kod językowy/kulturowy sklepu.

Krok 6: Dodawanie właściwości do rozszerzenia internetowego

Możesz dodać właściwości do swojego rozszerzenia internetowego, aby zdefiniować jego zachowanie lub zawartość.

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

Tutaj dodajemy właściwość o nazwiemailchimpCampaign.

Krok 7: Powiązanie rozszerzenia internetowego

Na koniec dodajemy powiązania do naszego rozszerzenia internetowego. Powiązania pozwalają na łączenie rozszerzenia z określonymi częściami dokumentu.

taskPane.WebExtension.Bindings.Add(new WebExtensionBinding("UnnamedBinding_0_1506535429545", WebExtensionBindingType.Text, "194740422"));
  • UnnamedBinding_0_1506535429545 jest nazwą wiązania.
  • WebExtensionBindingType.Text oznacza, że powiązanie jest typu tekstowego.
  • 194740422 jest identyfikatorem części dokumentu, do której rozszerzenie jest powiązane.

Krok 8: Zapisywanie dokumentu

Po skonfigurowaniu wszystkich ustawień zapisz dokument.

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

Ten wiersz zapisuje dokument w określonym katalogu pod podaną nazwą pliku.

Krok 9: Ładowanie i wyświetlanie informacji w panelu zadań

Aby sprawdzić i wyświetlić informacje w panelu zadań, ładujemy dokument i przechodzimy przez panele zadań.

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}\";");
}

Ten kod ładuje dokument i drukuje dostawcę, wersję i identyfikator katalogu każdego panelu zadań w konsoli.

Wniosek

I to wszystko! Udało Ci się dodać i skonfigurować panel zadań rozszerzenia internetowego w dokumencie Word przy użyciu Aspose.Words dla .NET. Ta potężna funkcja może znacznie ulepszyć Twoje dokumenty Word, zapewniając dodatkowe funkcjonalności bezpośrednio w dokumencie.

Najczęściej zadawane pytania

Czym jest okienko zadań w programie Word?

Okienko zadań to element interfejsu, który udostępnia dodatkowe narzędzia i funkcjonalności w dokumencie programu Word, zwiększając interakcję użytkownika i jego produktywność.

Czy mogę dostosować wygląd Panelu zadań?

Tak, możesz dostosować wygląd Panelu zadań, ustawiając takie właściwości, jak:DockState, IsVisible , IWidth.

Czym są właściwości rozszerzeń internetowych?

Właściwości rozszerzenia internetowego to niestandardowe właściwości, które można dodać do rozszerzenia internetowego w celu zdefiniowania jego zachowania lub zawartości.

Jak powiązać rozszerzenie internetowe z częścią dokumentu?

Możesz powiązać rozszerzenie internetowe z częścią dokumentu za pomocąWebExtensionBinding Klasa, określająca typ powiązania i identyfikator docelowy.

Gdzie mogę znaleźć więcej informacji na temat Aspose.Words dla .NET?

Szczegółową dokumentację można znaleźćTutaj.