.NETワードAPI（開発者向けの動作）

ドキュメント構造

Word の読み取りと編集: IronWord を使用すると、編集用にテキストを抽出したり、他の場所で使用する必要がある可能性のある画像を再利用して取得するなど、Word 文書から特定の情報を取り出すことができます。 この機能は、Wordドキュメントを結合し、既存のDOCXファイルに含まれる情報を処理することを目的としたアプリケーションにとって重要です。

複数の形式: IronWord は幅広いファイル形式をサポートしており、.NET アプリケーション内での Word 文書の変換における有用性を高めています。

ページ設定の編集: IronWord を使用すると、Word 文書の物理的なレイアウトを簡単にカスタマイズできます。 さまざまなMS Wordファイルの用紙サイズを標準またはカスタムの寸法に調整し、ドキュメントの異なるセクションの向きを変更し、適切な整列を確保するためにマージンを設定し、また美観を考慮してセクションを強調するために背景色を変更することができます。

段落の追加: IronWord では、段落内のテキスト ランの追加と削除が可能です。これは、テキストの大きなセクションを編集および書式設定するのに不可欠です。 さらに、画像や図形を直接テキストに挿入して段落を向上させ、デザイン仕様に合わせてスタイルを調整し、洗練された外観のために配置を設定することができます。 項目符号や番号付きリストの追加も、より効果的にコンテンツを整理するのに役立ちます。

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Load docx
        WordDocument doc = new WordDocument();
        // Create and add styled text to a paragraph
        Paragraph paragraph = new Paragraph();

        // Adding regular text
        paragraph.AddTextRun(new TextRun("Exploring text styles within a document."));

        // Adding italic text
        paragraph.AddTextRun(new TextRun("An example in italic.", new TextStyle { IsItalic = true }));

        // Adding bold text
        paragraph.AddTextRun(new TextRun("An example in bold.", new TextStyle { IsBold = true }));

        // Add paragraph to the document and export docx
        doc.AddParagraph(paragraph);
        doc.SaveAs("newdocument.docx");
    }
}

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Load docx
        WordDocument doc = new WordDocument();
        // Create and add styled text to a paragraph
        Paragraph paragraph = new Paragraph();

        // Adding regular text
        paragraph.AddTextRun(new TextRun("Exploring text styles within a document."));

        // Adding italic text
        paragraph.AddTextRun(new TextRun("An example in italic.", new TextStyle { IsItalic = true }));

        // Adding bold text
        paragraph.AddTextRun(new TextRun("An example in bold.", new TextStyle { IsBold = true }));

        // Add paragraph to the document and export docx
        doc.AddParagraph(paragraph);
        doc.SaveAs("newdocument.docx");
    }
}

表の追加:表はDOCX ファイルの重要なコンポーネントであり、IronWord で簡単に操作でき、動的なドキュメント生成をサポートします。 行と列の追加や削除が可能であり、データ量が変動する動的なドキュメント生成において重要な操作です。 セルの結合および分割により、複雑なテーブルをフォーマットする柔軟性を提供し、境界線やレイアウト寸法をカスタマイズすることで、洗練されたプロフェッショナルな外観を実現します。

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Create a table cell with a paragraph containing text
        TableCell cell = new TableCell(new Paragraph(new TextRun("Sample text")));

        // Configure a common border style for the table
        BorderStyle borderStyle = new BorderStyle
        {
            BorderColor = new IronColor(IronSoftware.Drawing.Color.Black),
            BorderValue = IronWord.Models.Enums.BorderValues.Thick,
            BorderSize = 5
        };

        // Apply the border style to the cell
        cell.Borders = new TableBorders
        {
            TopBorder = borderStyle,
            RightBorder = borderStyle,
            BottomBorder = borderStyle,
            LeftBorder = borderStyle
        };

        // Create a table row and add the same cell twice
        TableRow row = new TableRow();
        row.AddCell(cell);
        row.AddCell(cell);

        // Create a table, add the row, then create and export the Word document
        Table table = new Table();
        table.AddRow(row);
        WordDocument doc = new WordDocument(table);
        doc.SaveAs("Document.docx");
    }
}

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Create a table cell with a paragraph containing text
        TableCell cell = new TableCell(new Paragraph(new TextRun("Sample text")));

        // Configure a common border style for the table
        BorderStyle borderStyle = new BorderStyle
        {
            BorderColor = new IronColor(IronSoftware.Drawing.Color.Black),
            BorderValue = IronWord.Models.Enums.BorderValues.Thick,
            BorderSize = 5
        };

        // Apply the border style to the cell
        cell.Borders = new TableBorders
        {
            TopBorder = borderStyle,
            RightBorder = borderStyle,
            BottomBorder = borderStyle,
            LeftBorder = borderStyle
        };

        // Create a table row and add the same cell twice
        TableRow row = new TableRow();
        row.AddCell(cell);
        row.AddCell(cell);

        // Create a table, add the row, then create and export the Word document
        Table table = new Table();
        table.AddRow(row);
        WordDocument doc = new WordDocument(table);
        doc.SaveAs("Document.docx");
    }
}

ドキュメント要素

TextRuns の追加:この機能は、テキスト コンテンツのきめ細かな制御に重点を置いています。 テキストを追加、付加、分割することができ、これは動的なドキュメント作成に不可欠です。 スタイルオプションは豊富で、フォントファミリー、サイズ、色の変更、太字、イタリックなどのテキスト装飾の追加が含まれます。 テキストランに画像を埋め込むこともでき、リッチで視覚的に魅力的なドキュメントを作成します。

画像の追加: IronWord を使用すると、Word 文書内で包括的な画像操作が可能になります。 さまざまなソースから画像をロードし、それらの周りにスムーズにテキストを配置し、レイアウトに合わせて寸法を調整することができます。 位置オフセットを設定し、ドキュメントのコーナーからの距離を設定することで、常に完璧に配置されます。

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        WordDocument doc = new WordDocument();

        // Load and configure the image
        IronWord.Models.Image image = new IronWord.Models.Image("your-image.jpg")
        {
            Width = 200, // In unit pixels
            Height = 200 // In unit pixels
        };

        // Create paragraph, add image, add paragraph to document, and export
        Paragraph paragraph = new Paragraph();
        paragraph.AddImage(image);

        // Add paragraph containing the image to the document
        doc.AddParagraph(paragraph);
        doc.SaveAs("save_document.docx");
    }
}

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        WordDocument doc = new WordDocument();

        // Load and configure the image
        IronWord.Models.Image image = new IronWord.Models.Image("your-image.jpg")
        {
            Width = 200, // In unit pixels
            Height = 200 // In unit pixels
        };

        // Create paragraph, add image, add paragraph to document, and export
        Paragraph paragraph = new Paragraph();
        paragraph.AddImage(image);

        // Add paragraph containing the image to the document
        doc.AddParagraph(paragraph);
        doc.SaveAs("save_document.docx");
    }
}

図形の追加:図形はドキュメントに大きな視覚的インパクトを与えることができます。IronWord には、図形を正確に挿入してカスタマイズするためのツールが用意されています。 長方形、円、矢印などの図形タイプを設定し、図形周りのテキストの配置方法を決定し、正確な寸法と位置を指定し、望ましい視覚的効果を得るために図形を回転させることもできます。

.NETバージョンとプロジェクトタイプ

IronWordは、.NETエコシステムでの幅広い互換性を念頭に設計されており、.NET Core、.NET Standard、.NET Frameworkを含むさまざまな.NETバージョンでC#、VB.NET、F#をサポートします。 これにより、最新のアプリケーションおよびレガシーアプリケーションの両方での有用性が保障されます。 ライブラリの多用途性は、Blazor、WebForms、Xamarin、MAUI、WPF、コンソールアプリケーションとの統合を介して、ウェブ、モバイル、デスクトップアプリケーションをサポートします。

アプリケーション環境

アプリケーション環境の観点から、IronWordはWindows、Linux、iOS、Androidプラットフォームに適応でき、Docker、Azure、AWSでのコンテナ化およびクラウド展開の特定のサポートも含まれています。 この広範なサポートにより、さまざまな環境での開発が容易になります。

OSとIDE

IronWordはMicrosoft Visual Studio、ReSharper、Riderなどの主要な統合開発環境（IDE）と互換性があり、開発者にツールの柔軟な選択肢を提供します。 最終的に、さまざまなオペレーティングシステムおよびプロセッサアーキテクチャ（x64、x86、ARM）をサポートし、多様なハードウェア構成での効率的なパフォーマンスを保証します。

Liteライセンス

このオプションは、プロジェクトで一人で働く個別の開発者向けに調整されています。 この価格は$799で、単一の場所にいる1人の開発者をカバーします。

Plusライセンス

小規模チームを対象としており、$plusLicenseのこのライセンスは最大3人の開発者を収容し、3つのプロジェクトで3か所での使用に適用されます。

Professionalライセンス

より大規模なチーム向けに、Professionalライセンスは$professionalLicenseで販売され、最大10人の開発者をサポートします。 より大規模な運用を対象として設計されており、プレミアムサポート機能を含んでいます。