C# .NETのMAUIにおけるPDFの表示

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF ビューア バナー

クロスプラットフォーム開発の現代において、ユーザーがアプリ内で直接PDFドキュメントを表示できる機能を提供することは、単なる便利さではなく、必要不可欠です。 IronPDF Viewerを使用すると、PDF閲覧機能をMAUIアプリケーションに埋め込むことができます。

この記事では、ユーザーがPDFを表示、保存、および印刷できるようにするために、MAUIアプリケーション内で IronPDF Viewer を統合する方法について学びます。


概要


IronPDFビューワーライブラリをダウンロードしてインストール

今日から無料トライアルでIronPDFをあなたのプロジェクトで使い始めましょう。

最初のステップ:
green arrow pointer

Visual Studio - NuGetパッケージマネージャー

Visual Studioで、プロジェクトのソリューションエクスプローラーを右クリックし、『NuGet パッケージの管理...』を選択します。そこからIronPdf.Viewer.Mauiを検索し、最新バージョンをソリューションにインストールします。 または、ツール > NuGet パケット マネージャー > パッケージ マネージャー コンソールに移動し、NuGet パッケージ マネージャー コンソールを開いて、次のコマンドを入力することもできます:

Install-Package IronPdf.Viewer.Maui

MAUIアプリケーションにIronPDF Viewerを統合する

以下のセクションでは、デフォルトのMAUIアプリケーションにIronPDFビューアを統合する方法を示します。

セットアップ

MAUIプロジェクトにIronPDF Viewerを追加する前に、まずiOSおよびAndroidプラットフォームを対象としていないことを確認してください。 プロジェクトファイルを右クリックして「プロパティ」を選択することでこれを確認できます。 以下の画像で下線が引かれている、Target the iOS Platform および Target the Android platform のチェックボックスが既にチェックされていない場合は、チェックを外してください。 この変更を正常に実装するためには、チェックを外した後プロジェクトを保存し、Visual Studioを再起動する必要があるかもしれません。

プロパティスクリーン

iOSとAndroidプラットフォームのターゲットを解除した後、_MauiProgram.cs_ファイルに以下のコードを追加してビューアを初期化します:

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-1.cs
using IronPdf.Viewer.Maui;

public static class MauiProgram
{
    public static MauiApp CreateMauiApp()
    {
        var builder = MauiApp.CreateBuilder();
        builder
            .UseMauiApp<App>()
            // other configuration options ...
            .ConfigureIronPdfView(); // configure the viewer on app start-up

        return builder.Build();
    }
}
Imports IronPdf.Viewer.Maui

Public Module MauiProgram
	Public Function CreateMauiApp() As MauiApp
		Dim builder = MauiApp.CreateBuilder()
		builder.UseMauiApp(Of App)().ConfigureIronPdfView() ' configure the viewer on app start-up

		Return builder.Build()
	End Function
End Module
VB   C#

デフォルトでは、IronPDF Viewerはビューの右下にバナーを表示します。 このビューを削除するには、IronPDF を追加してください(または Iron Suite)ConfigureIronPdfView にライセンスキーを次のように渡します:

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-2.cs
.ConfigureIronPdfView("YOUR-LICENSE-KEY");
IRON VB CONVERTER ERROR developers@ironsoftware.com
VB   C#

PDFビューアーページを追加

このセクションでは、PDFビューワーページの作成、IronPDF Viewerの統合、およびMAUIアプリケーションでのタブの作成方法について学びます。 これをXAMLとC#のContentPageの両方で行う方法を示します。

手順

  1. 次の手順で新しいページをプロジェクトに追加してください:プロジェクトを右クリックし、「追加 > 新しい項目...」に進みます。

    新しい項目を追加

  2. 次に.NET MAUIセクションに移動してください。 XAMLページを作成するには、.NET MAUI ContentPageを選択します。(XAML). C#ファイルの場合、.NET MAUI ContentPageを選択(C#). ファイルに_PdfViewerPage_という名前を付けて、Addをクリックしてください。

    .NET MAUI `ContentPage`

  3. XAMLファイルに以下のコードを追加して保存してください。
<?xml version="1.0" encoding="utf-8" ?>
<ContentPage ...
    xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
    ...>
    <ipv:IronPdfView x:Name="pdfView"/>
</ContentPage>
XML

以下のコードを追加し、保存してください。:

ContentPage 内容 = new ContentPage
{
    Title = "ページのタイトル",
    Content = new StackLayout
    {
        Children =
        {
            new Label { Text = "ようこそ、IronPDF for .NETへ!" },
            new Button { Text = "クリックしてください" }
        }
    }
};
ContentPage 内容 = new ContentPage
{
    Title = "ページのタイトル",
    Content = new StackLayout
    {
        Children =
        {
            new Label { Text = "ようこそ、IronPDF for .NETへ!" },
            new Button { Text = "クリックしてください" }
        }
    }
};
Dim 内容 As New ContentPage With {
	.Title = "ページのタイトル",
	.Content = New StackLayout With {
		.Children = {
			New Label With {.Text = "ようこそ、IronPDF for .NETへ!"},
			New Button With {.Text = "クリックしてください"}
		}
	}
}
VB   C#
:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-3.cs
using IronPdf.Viewer.Maui;

public class MainPage : ContentPage
{
    private readonly IronPdfView pdfView;

    public MainPage()
    {
        InitializeComponent();

        this.pdfView = new IronPdfView { Options = IronPdfViewOptions.All };

        Content = this.pdfView;
    }
}
Imports IronPdf.Viewer.Maui

Public Class MainPage
	Inherits ContentPage

	Private ReadOnly pdfView As IronPdfView

	Public Sub New()
		InitializeComponent()

		Me.pdfView = New IronPdfView With {.Options = IronPdfViewOptions.All}

		Content = Me.pdfView
	End Sub
End Class
VB   C#
  1. AppShell.xaml ファイルに、以下を追加してください:
<?xml version="1.0" encoding="UTF-8" ?>
<Shell ...
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
    ...>
  <TabBar x:Name="AppTabBar">
      <Tab Title="Home">
        <ShellContent ContentTemplate="{DataTemplate local:MainPage}" Route="MainPage"/>
      </Tab>
      <Tab Title="PDF Viewer">
        <ShellContent ContentTemplate="{DataTemplate local:PdfViewerPage}" Route="PDFViewer"/>
    </Tab>
  </TabBar>
</Shell>
XML
  1. プロジェクトを保存し、次にビルドして実行してください。 以下のように左上隅にタブが表示されるはずです。「PDF Viewer」タブをクリックすると、IronPDF Viewerが開くはずです。

    IronPDFビューアーデフォルト

スタートアップ時にPDFをロード

アプリケーションの起動時、IronPDFビューアはデフォルトでユーザーにPDFを開くように促します。 それが起動時にPDFを自動的に開くことも可能です。 PDFを起動時に読み込む方法は3つあります:ファイル名による方法、バイト配列による方法、およびストリームによる方法です。

ファイル名で読み込む

PDFをファイル名で読み込むには、XAMLファイルの IronPdfView タグでPDFファイルのソースを指定することができます。以下にその例を示します:

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage ...
    xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
    ...>
    <ipv:IronPdfView Source="C:/path/to/my/example.pdf" />
</ContentPage>
XML

また、C#のContentPageIronPdfViewSource.FromFileメソッドを使用して、ファイル名からPDFをロードすることもできます:

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-4.cs
// We assume an IronPdfView instance is created previously called pdfView
pdfView.Source = IronPdfViewSource.FromFile("C:/path/to/my/example.pdf");
' We assume an IronPdfView instance is created previously called pdfView
pdfView.Source = IronPdfViewSource.FromFile("C:/path/to/my/example.pdf")
VB   C#

バイト配列を介して読み込む

いくつかのユースケースでは、PDFのバイト配列を読み込むことが望ましい場合があります。 これはXAMLでは不可能ですが、C#では可能です。 この目的を達成するには、 IronPdfViewSource.FromBytes メソッドを使用するだけです。 このメソッドの使用方法の例を以下に示します:

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-5.cs
pdfView.Source = IronPdfViewSource.FromBytes(File.ReadAllBytes("~/Downloads/example.pdf"));
pdfView.Source = IronPdfViewSource.FromBytes(File.ReadAllBytes("~/Downloads/example.pdf"))
VB   C#

ストリームを介して読み込み

同様に、いくつかの使用事例では、PDFをストリームを通してロードすることがより望ましい場合があります。 これはXAMLでは不可能ですが、C#では可能です。 この操作は、単に IronPdfViewSource.FromStream メソッドを使用することによって達成できます。 このメソッドの使用方法の例を以下に示します:

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-6.cs
pdfView.Source = IronPdfViewSource.FromStream(File.OpenRead("~/Downloads/example.pdf"));
pdfView.Source = IronPdfViewSource.FromStream(File.OpenRead("~/Downloads/example.pdf"))
VB   C#

ツールバーの設定

IronPDF Viewerでは、ツールバーに表示するオプションを選択できます。 利用可能なオプションは次のとおりです:

  • サムネイル表示
  • ファイル名表示
  • テキスト検索
  • ページ番号ナビゲーション
  • ズーム
  • 幅に合わせる
  • 高さに合わせる
  • 時計回りに回転
  • 反時計回りに回転
  • ファイルを開く
  • ファイルをダウンロード
  • ファイルの印刷
  • 注釈を表示
  • 二ページ表示

    デフォルトでは、IronPDF Viewerは以下のツールバーを表示します:

    デフォルトツールバー

    デフォルトビューでは、ファイル名の表示、テキスト検索、および反時計回りの回転オプションがすべて無効になっています。 すべてを表示するには、XAML 内の IronPdfView タグの Option パラメーターを All に設定してください。

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage ...
    xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
    ...>
    <ipv:IronPdfView x:Name="pdfView" Options="All"/>
</ContentPage>
XML

代わりに、C#で同じことを達成することもできます:

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-7.cs
pdfView.Options = IronPdfViewOptions.All;
pdfView.Options = IronPdfViewOptions.All
VB   C#

次のように表示されます:

全ツールバー

表示したくない場合は、オプションをNoneに設定してください。 Options がこのように設定されている場合、ツールバーは表示されません:

ツールバーなし

表示する特定のオプションを選択できます。 例えば、サムネイルとファイルを開くオプションのみを表示したい場合、XAMLでIronPdfViewOptionsパラメータを次のように変更します:

<ipv:IronPdfView x:Name="pdfView" Options="Thumbs, Open"/>
XML

同様に、C#では次のようになります:

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-8.cs
pdfView.Options = IronPdfViewOptions.Thumbs | IronPdfViewOptions.Open;
pdfView.Options = IronPdfViewOptions.Thumbs Or IronPdfViewOptions.Open
VB   C#

次のように表示されます:

サムネイルおよびファイルを開くオプション付きツールバー

結論

このチュートリアルでは、IronPDF ViewerをMAUIアプリケーションに統合し、ツールバーをニーズに合わせてカスタマイズする方法を学びました。

このビューワーは、IronPDF製品に付属しています。 機能のリクエストをしたい場合やIronPDF Viewerに関する一般的な質問がある場合は(または IronPDF)以下の内容を日本語に翻訳してください:


Iron Softwareは、さまざまな企業に強力かつ柔軟なツールを提供することに注力しています。特に注目すべき製品には、IronPDF、IronOCR、IronXL、IronBarcode、IronQR、IronZIP、IronPrint、IronWord、IronWebScraperが含まれます。これらのツールは、.NET、Java、Python、Node.jsなど複数のプラットフォームで利用でき、ソフトウェア開発プロセスを簡素化し、効率化します。

IronPDF:

IronPDFは、PDFの生成、編集、変換、レンダリングを簡単に行うための強力なライブラリです。スマートなテンプレートと直感的なAPIを利用して効率的なPDF操作を実現します。

IronOCR:

IronOCRは、光学式文字認識(OCR)機能を提供し、スキャンされた文書や画像からテキストを抽出します。高精度な認識機能により、多言語対応も可能です。

IronXL:

IronXLは、Excelファイルの読み取り、作成、編集を行うためのライブラリです。複雑なファイル処理を簡素化し、迅速なデータ操作をサポートします。

IronBarcode:

IronBarcodeは、バーコードの生成と読み取りを行うためのツールです。幅広いバーコード形式に対応し、業務プロセスの自動化に貢献します。

IronQR:

IronQRは、QRコードの生成と読み取りを行うためのライブラリです。高精度で迅速な処理能力により、リアルタイム認識が可能です。

IronZIP:

IronZIPは、圧縮および解凍機能を提供するライブラリです。効率的なデータ圧縮とアーカイブ作成が可能です。

IronPrint:

IronPrintは、プリントタスクの実行を簡素化するツールで、プリントジョブのカスタマイズをサポートします。

IronWord:

IronWordは、Word文書の生成、編集、変換を行うためのライブラリです。さまざまなドキュメントフォーマットの操作が簡単に行えます。

IronWebScraper:

IronWebScraperは、Webデータの抽出と分析を行うためのツールです。効率的なデータ収集とクレンジングを行い、ビジネスインサイトを提供します。


Iron Softwareの製品群は、Lite Licenseから始まり、Plus License、Professional License、Unlimited Licenseまで、さまざまなニーズに対応するライセンスオプションがあります。Iron Suite for .NETやIron Suite Unlimitedなどのパッケージも用意されており、包括的なソリューションを提供します。サポートチームに連絡する. 喜んでお手伝いいたします。