GrapeCity ActiveReports for .NET 16.0J のセクションレポート(SectionReport) 開発手順 v3

.Net Core側のWindowsフォーム画面から入力した値を、セクションレポートへ表示するように改良した前回作成したサンプルを、A4用紙へ印刷する一般的な帳票の形式へ変更しました。
ソースコードは GitHub で公開しています。

レポートデザイナ編集用 .Net Framework系統のプロジェクト
リリース用 .Net Core系統のプロジェクト
補足
1. 用紙サイズ設定
2. groupHeader追加
関連記事

レポートデザイナ編集用 .Net Framework系統のプロジェクト

ソースコードの変更内容を解説

/SectionReportApplication1/SectionReportApplication1.csproj

DataModel1データクラスを、ReportDataModelデータクラスへ変更。


  <ItemGroup>
    <Compile Include="ReportDataModel.cs" />

/SectionReportApplication1/DataModel1.cs /SectionReportApplication1/ReportDataModel.cs

DataModel1データクラスを、ReportDataModelデータクラスへ変更。
セクションレポートに追加した項目に対応するデータ項目を追加しています。


using System.Collections.Generic;

namespace SectionReportApplication1
{
    public class ReportDataModel
    {
        public string ReportNo { get; set; }
        public string Date { get; set; }
        public string Title { get; set; }
        public string Description { get; set; }
        public List<ReportDataModelDetail1> ReportDetailList { get; set; } = new List<ReportDataModelDetail1>();
    }

    public class ReportDataModelDetail1
    {
        public string Test1 { get; set; }
        public string Test2 { get; set; }
        public string Test3 { get; set; }
    }
}

using System.Collections.Generic;

namespace SectionReportApplication1

{

public class ReportDataModel

{

public string ReportNo { get; set; }

public string Date { get; set; }

public string Title { get; set; }

public string Description { get; set; }

public List<ReportDataModelDetail1> ReportDetailList { get; set; } = new List<ReportDataModelDetail1>();

}

public class ReportDataModelDetail1

{

public string Test1 { get; set; }

public string Test2 { get; set; }

public string Test3 { get; set; }

}

/SectionReportApplication1/Form1.cs

DataModel1データクラスを、ReportDataModelデータクラスへ変更。


using System;
using System.Windows.Forms;

namespace SectionReportApplication1
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
        }

        private void Form1_Load(object sender, EventArgs e)
        {
            var reportDataModel = new ReportDataModel
            {
                Text1 = "test"
            };

            viewer1.LoadDocument(new SectionReport1(reportDataModel));
        }
    }
}

using System;

using System.Windows.Forms;

namespace SectionReportApplication1

{

public partial class Form1 : Form

{

public Form1()

{

InitializeComponent();

}

private void Form1_Load(object sender, EventArgs e)

{

var reportDataModel = new ReportDataModel

{

Text1 = "test"

};

viewer1.LoadDocument(new SectionReport1(reportDataModel));

}

/SectionReportApplication1/SectionReport1.Designer.cs /SectionReportApplication1/SectionReport1.resx

レポートのレイアウトを、ヘッダーと詳細で構成される一般的な帳票の形へ変更しています。

pageHederは、全ページに出力されるエリア。
今回は、「ReportNo」「Date」欄を設けています。

groupHeader1は、プロパティで「RepeatStyle=None」を設定していることで、1ページ目にだけ出力されるエリア。
今回は、「Title」「Description」欄を設けています。

groupHeader2は、プロパティで「RepeatStyle=All」を設定していることで、全ページに出力されるエリア。
今回は、detailエリアに出力する詳細データの列タイトルを、固定文字列で設けています。

detailは、全ページに出力される表エリア。
今回は、詳細データを3列にしています。

detailセクションの線は、groupHeader1セクションの線と同様にツールボックスの Lineオブジェクトを使って引いています。
detailセクションは1行分の出力を実装していて、1行分の線を実装すれば2行目以降は線を繰り返し表示してくれます。

pageFooterは、全ページに出力されるエリア。
今回は、カレントのページ数と、全ページ数を表示しています。

/SectionReportApplication1/SectionReport1.cs

セクションレポートに追加した項目を、ReportDataModelデータクラスと対応付け。


using System.Windows.Forms;

namespace SectionReportApplication1
{
    /// <summary>
    /// NewActiveReport1 の概要の説明です。
    /// </summary>
    public partial class SectionReport1 : GrapeCity.ActiveReports.SectionReport
    {

        public SectionReport1(ReportDataModel reportDataModel)
        {
            //
            // デザイナー サポートに必要なメソッドです。このメソッドの内容を
            //
            InitializeComponent();

            textReportNo.Text = reportDataModel.ReportNo;
            textDate.Text = reportDataModel.Date;
            textTitle.Text = reportDataModel.Title;
            textDescription.Text = reportDataModel.Description;

            DataSource = new BindingSource(reportDataModel.ReportDetailList, null);
        }
    }
}

using System.Windows.Forms;

namespace SectionReportApplication1

{

/// <summary>

/// NewActiveReport1 の概要の説明です。

/// </summary>

public partial class SectionReport1 : GrapeCity.ActiveReports.SectionReport

{

public SectionReport1(ReportDataModel reportDataModel)

{

// デザイナーサポートに必要なメソッドです。このメソッドの内容を

InitializeComponent();

textReportNo.Text = reportDataModel.ReportNo;

textDate.Text = reportDataModel.Date;

textTitle.Text = reportDataModel.Title;

textDescription.Text = reportDataModel.Description;

DataSource = new BindingSource(reportDataModel.ReportDetailList, null);

}

リリース用 .Net Core系統のプロジェクト

ソースコード変更内容を解説。

/WinFormsApp1/WinFormsApp1.csproj

リンクとして追加している DataModel1データクラスを、ReportDataModelデータクラスへ変更。


  <ItemGroup>
    <Compile Include="..\SectionReportApplication1\ReportDataModel.cs" Link="ReportDataModel.cs" />

/WinFormsApp1/Form1.Designer.cs

A4用のレポートが見易くなるよう、レポートビューアー画面のサイズを拡張。

/WinFormsApp1/Form1.cs

DataModel1データクラスを、ReportDataModelデータクラスへ変更。


using SectionReportApplication1;

namespace WinFormsApp1
{
    public partial class Form1 : Form
    {
        private ReportDataModel _ReportDataModel;

        public Form1(ReportDataModel reportDataModel)
        {
            _ReportDataModel = reportDataModel;

            InitializeComponent();
        }

        private void Form1_Load(object sender, EventArgs e)
        {
            viewer1.LoadDocument(new SectionReport1(_ReportDataModel));
        }
    }
}

using SectionReportApplication1;

namespace WinFormsApp1

{

public partial class Form1 : Form

{

private ReportDataModel _ReportDataModel;

public Form1(ReportDataModel reportDataModel)

{

_ReportDataModel = reportDataModel;

InitializeComponent();

}

private void Form1_Load(object sender, EventArgs e)

{

viewer1.LoadDocument(new SectionReport1(_ReportDataModel));

}

/WinFormsApp1/Form2.Designer.cs

レポートに項目が増えたのに伴い、入力画面にも項目を追加しています。
入力画面のどの項目が、セクションレポートのどの項目に対応しているかは、youtube動画を見ると分かり易いです。

/WinFormsApp1/Form2.cs

入力画面に追加した項目を、ReportDataModelデータクラスと対応付け。


using SectionReportApplication1;

namespace WinFormsApp1
{
    public partial class Form2 : Form
    {
        public Form2()
        {
            InitializeComponent();
        }

        private void Form2_Load(object sender, EventArgs e)
        {
            textReportNo.Text = "R-00001";
            textDate.Text = DateTime.Now.ToString("yyyy/MM/dd HH:mm:ss");
            textTitle.Text = "Report Title ABC";
            textDescription.Text = @"Report Description ABCDEFG
12345678890";

            textDetail1.Text = "Detail1 ABC ";
            textDetail2.Text = "Detail1 ABC ";
            textDetail3.Text = "Detail1 ABC ";
            textNumberOfLines.Text = "1";
        }

        private void button1_Click(object sender, EventArgs e)
        {
            var reportDataModel = new ReportDataModel
            {
                ReportNo = textReportNo.Text,
                Date = textDate.Text,
                Title = textTitle.Text,
                Description = textDescription.Text,
            };

            var max = int.Parse(textNumberOfLines.Text);
            for (var cnt = 0; cnt < max; cnt++)
            {
                reportDataModel.ReportDetailList.Add(new ReportDataModelDetail1
                {
                    Test1 = textDetail1.Text + $" cnt={cnt}",
                    Test2 = textDetail2.Text + $" cnt={cnt}",
                    Test3 = textDetail3.Text + $" cnt={cnt}",
                });
            }

            var form1 = new Form1(reportDataModel);
            form1.ShowDialog();
        }
    }
}

using SectionReportApplication1;

namespace WinFormsApp1

{

public partial class Form2 : Form

{

public Form2()

{

InitializeComponent();

}

private void Form2_Load(object sender, EventArgs e)

{

textReportNo.Text = "R-00001";

textDate.Text = DateTime.Now.ToString("yyyy/MM/dd HH:mm:ss");

textTitle.Text = "Report Title ABC";

textDescription.Text = @"Report Description ABCDEFG

12345678890";

textDetail1.Text = "Detail1 ABC ";

textDetail2.Text = "Detail1 ABC ";

textDetail3.Text = "Detail1 ABC ";

textNumberOfLines.Text = "1";

}

private void button1_Click(object sender, EventArgs e)

{

var reportDataModel = new ReportDataModel

{

ReportNo = textReportNo.Text,

Date = textDate.Text,

Title = textTitle.Text,

Description = textDescription.Text,

};

var max = int.Parse(textNumberOfLines.Text);

for (var cnt = 0; cnt < max; cnt++)

{

reportDataModel.ReportDetailList.Add(new ReportDataModelDetail1

{

Test1 = textDetail1.Text + $" cnt={cnt}",

Test2 = textDetail2.Text + $" cnt={cnt}",

Test3 = textDetail3.Text + $" cnt={cnt}",

});

}

var form1 = new Form1(reportDataModel);

form1.ShowDialog();

}

補足

用紙サイズ設定

A4、B5など、レポートが印刷対象とする用紙サイズの設定は、レポートデザイナでレポートの灰色エリアをクリックした際にプロパティに表示される「プロパティ設定ダイアログ」から、「レポートの設定」の「プリンタ設定 > 用紙サイズ」から設定できます。
今回は一般的な「A4」に設定しています。

groupHeader追加

groupHeaderは、レポートデザイナで背面を右クリックし「挿入 > グループヘッダ/フッタ」を選択することで追加できます。

GrapeCity ActiveReports for .NET 16.0J のセクションレポート(SectionReport) 開発手順 v1
GrapeCity ActiveReports for .NET 16.0J のセクションレポート(SectionReport) 開発手順 v2
GrapeCity ActiveReports for .NET 16.0J のセクションレポート(SectionReport) 開発手順 v3
GrapeCity ActiveReport よく使う機能
 GrapeCity.ActiveReports.SectionReportの CanGrow/CanShrinkプロパティを使う場合
 ActiveReports開発でデザイナが「値を Null にすることはできません。パラメーター名:instance」エラーになる場合

レポートデザイナ編集用 .Net Framework系統のプロジェクト

/SectionReportApplication1/SectionReportApplication1.csproj

/SectionReportApplication1/DataModel1.cs /SectionReportApplication1/ReportDataModel.cs

/SectionReportApplication1/Form1.cs

/SectionReportApplication1/SectionReport1.Designer.cs /SectionReportApplication1/SectionReport1.resx

/SectionReportApplication1/SectionReport1.cs

リリース用 .Net Core系統のプロジェクト

/WinFormsApp1/WinFormsApp1.csproj

/WinFormsApp1/Form1.Designer.cs

/WinFormsApp1/Form1.cs

/WinFormsApp1/Form2.Designer.cs

/WinFormsApp1/Form2.cs

補足

用紙サイズ設定

groupHeader追加

関連記事

コメント