.NET API a szövegszerkesztő dokumentumok kezeléséhez

A DocX használatának első lépései

Először is telepítenie kell a .NET framework 4.0-t és a Visual Studio 2010-et vagy újabbat a DocX zökkenőmentes használatához. 

A telepítés javasolt módja a NuGet

 Install-Package DocX -Version 1.5.0

Word-dokumentumok létrehozása és módosítása .NET API-kon keresztül

A nyílt forráskódú DocX API lehetővé teszi a szoftverfejlesztők számára, hogy új Word dokumentumokat hozzanak létre DOCX fájlformátumban. A könyvtár lehetővé teszi a meglévő Word dokumentumok módosítását is a felhasználó igényei szerint. Az API támogatja a kép hozzáadását, táblázat és hiperhivatkozások beszúrását, valamint bekezdések vagy felsorolásjeles listák és számozott lista hozzáadását a Word dokumentumokhoz.

using (DocX document = DocX.Create("fileformat.docx"))
{
  // Add a new Paragraph to the document.
  Paragraph pagagraph = document.InsertParagraph();
  // Append some text.
  pagagraph.Append("File Format Developer Guide").Font("Arial Black");
  // Save the document.
  document.Save();
}

Egyéni fejlécek/láblécek kezelése Word-fájlokban

A DocX API lehetővé teszi a szoftverfejlesztők számára, hogy egyéni fejléceket és lábléceket adjanak hozzá a Word DOCX dokumentumokhoz. Az API támogatja az egyéni fejlécek/láblécek hozzáadását táblázatokkal és képekkel, bekezdésekkel és diagramokkal. A dokumentum létrehozása után meghatározhatja az oldal fejlécének képét egy táblázatban. A páratlan és páros oldalakon ugyanazok a fejlécek lesznek. Leírhatja az oldal láblécének képét vagy szövegét egy táblázatban is.

//Create a document
using (DocX document = DocX.Create("FileFormat.docx"))
{
  // Add Header 
  document.AddHeaders();
  Header header = document.Headers.Odd;
  // Insert Paragraph in header
  Paragraph paragraph = header.InsertParagraph();
  paragraph.Append("File Format Developer Guide");
  // Add Footer 
  document.AddFooters();
  Footer footer = document.Footers.Odd;
  // Insert Paragraph in header
  Paragraph paragraph1 = footer.InsertParagraph();
  paragraph1.Append("File Format Develoer Guide");
  // Save Document
  document.Save();
}

Kép manipulálása Word-dokumentumban

A DocX API lehetővé teszi a szoftverfejlesztők számára, hogy programozottan kezeljék a Word DOCX dokumentumokba ágyazott képeket. Először is egy képnek kell lennie a Word dokumentumban. A kép manipulálásához először meg kell nyitnia a dokumentumot, és be kell írnia egy egyéni karakterláncot vagy más módosításokat, amelyeket alkalmazni szeretne a képen, majd mentse a dokumentumot.

using (DocX document = DocX.Load("FileFormat.docx"))
{
  //Read Image from word
  var image = document.Images[0];
  Bitmap bitmap = new Bitmap(image.GetStream(FileMode.Open, FileAccess.ReadWrite));
  Graphics graphics = Graphics.FromImage(bitmap);
  // Draw the string
  graphics.DrawString
  (
  "Manipulate Images using DocX",
  new System.Drawing.Font("Tahoma", 20),
  Brushes.Blue,
  new PointF(0, 0)
  );
  // Save document
  document.SaveAs("Output.docx");
}

Hiperhivatkozások kezelése Word dokumentumokban

A hiperhivatkozás a szövegszerkesztő dokumentumok nagyon hasznos része, amely lehetővé teszi a felhasználók számára, hogy közvetlenül a dokumentumból hozzáférjenek külső dokumentumokhoz vagy a meglévő dokumentumok belső részeihez, valamint külső webhelyekhez és e-mail címekhez. A nyílt forráskódú DocX API mindkét típusú hiperhivatkozást támogatja; a belső, amely egy könyvjelzőre mutat a dokumentumon belül, és a külső, amely a külső URL-re mutat.

// reating a bookmark
const chapter1 = new Paragraph({
  heading: HeadingLevel.HEADING_1,
  children: [
    new Bookmark({
      id: "anchorForChapter1",
      children: [
        new TextRun("Chapter 1"),
      ],
    }),
  ],
})
//Create an hyperlink 
const link = new InternalHyperlink({
  children: [
    new TextRun({
      text: "See Chapter 1",
      style: "Hyperlink",
    }),
  ],
  anchor: "anchorForChapter1",
})