PowerTools ActiveReports for .NET 11.0J > ActiveReportsユーザーガイド > 概念 > ページレポート/RDLレポートの概念 > スタイル > スタイルの操作 |
ActiveReports for .NET11.0Jでは、スタイルを作成してスタイルシートに保存することができます。そのスタイルシートはページレポートやRDLレポートへの追加が可能で、StyleNameプロパティを使用すれば選択したコントロールにスタイルを適用することができます。スタイルシートはローカル環境、あるいはActiveReports Serverへの保存や、レポートへの埋め込みも可能です。
スタイル機能は次の要素で構成されています。
以下はスタイルシートの操作方法に関する手引きのリンクです。
[プロパティ]ウィンドウのSourceプロパティとValueプロパティを使用してレポートのスタイルシートを定義します。サブレポート用にはInheritStyleSheetプロパティを使用します。
プロパティ | 説明 |
---|---|
Source |
スタイルシートのソースを定義します。オプションは次の通りです。 External - スタイルシート(*.rdlx-stylesファイル)をローカルファイルやhttpロケーション、カスタムリソースなどの外部ソースとして使用する場合はこのオプションを選択します。外部スタイルシートの作成方法については「外部スタイルシートを操作するには」を参照してください。 Embedded - スタイルシートをレポート内に埋め込んで使用する場合はこのオプションを選択します。作成した埋め込みスタイルシートの名前は、[レポートエクスプローラ]の[埋め込みスタイルシート]ノードの下に表示されます。埋め込みスタイルシートの作成方法については「埋め込みスタイルシートを操作するには」を参照してください。 |
Value |
レポートに適用するスタイルシートを定義します。オプションは次の通りです。 式 - [式エディタ]ダイアログを開いて式を作成します。 新規 - [スタイルシートの編集]ダイアログを開いて外部スタイルシート、あるいは埋め込みスタイルシートを作成します。 開く - [開く]ダイアログを開いてローカルスタイルシートへ移動します。このオプションは外部スタイルシートでのみ利用可能です 。 サーバーから開く - [サーバー共有スタイルシートを開く]ダイアログを開いて、ActiveReports Serverに保存した共有スタイルシートを開くことができます。これは外部スタイルシートでのみ利用可能なオプションです。 レポート内で利用可能な埋め込みスタイルシートの名前は[レポートエクスプローラ]にリスト化されます。 |
InheritStyleSheet |
サブレポートに継承するスタイルシートを定義します。InheritStyleSheetプロパティを「True」(既定値)に設定すると、メインレポートのスタイルシートがサブレポートでも使用可能になります。 |
メモ: フィールド値を[StyleSheet Value]、[StyleName]、[Styles]の式で使用する場合、その値は評価されません。 |
単体のデザイナやVisual Studioデザイナ上で[スタイルシートの編集]ダイアログを開くには、[レポート]メニューから[スタイルシートの編集]オプションを選択します。
[スタイルシートの編集]ダイアログは次の要素で構成されています。
要素 | 説明 |
---|---|
外部スタイルシートを開く | レポート外部のスタイルシート(*.rdlx-stylesファイル)を開きます。 |
埋め込みスタイルシートを開く | レポート内の埋め込みスタイルシートを開きます。 |
サーバーから開く | サーバーから共有スタイルシートを開きます。 |
ファイルに保存する | 現在のスタイルシートを外部スタイルシート(*.rdlx-stylesファイル)として保存します。 |
サーバーに保存する | 現在のスタイルシートを共有スタイルシート(*.rdlx-stylesファイル)として保存します。 |
スタイルシートを埋め込む | 現在のスタイルシートをレポートに埋め込みます。 |
新規スタイル | 現在のスタイルシートに新規のスタイルを作成します。 |
スタイルの削除 | 現在のスタイルシートからスタイルを削除します。 |
[プロパティ]ウィンドウ |
選択したスタイルのプロパティを変更します。スタイルのプロパティは選択したスタイルの種別によって異なります。ユーザーはスタイルを新規作成する際にスタイルの種別を選択することができます。 |
OK | 現在のスタイルを保存します。 |
キャンセル | 変更を保存せずにダイアログを閉じます。 |
メモ: スタイルシートで定義した値は[プロパティ]ウィンドウに上書きされ、太字で表示されます。 |
[新規スタイルの追加]ダイアログを開くには、[スタイルシートの編集]ダイアログで[新規スタイル]オプションをクリックします。
[新規スタイルの追加]ダイアログは次の要素で構成されています。
要素 | 説明 |
---|---|
名前 | 新規スタイルの名前を格納します。 |
種別 |
レポートに適用することのできるスタイルの種別を設定します。このスタイルの種別によって[スタイルシートの編集]ダイアログの[プロパティ]ウィンドウ内で利用可能となるオプションが決定します。
|
親 | 新規スタイルの親スタイルであることを表します。親スタイルを指定すると、指定した親スタイルからプロパティの値が引用されます(親スタイルの既定値は「None」)。 |
[スタイルシートを埋め込む]ダイアログを開くには、[スタイルシートの編集]ダイアログから[保存]オプションを選択したのち、[スタイルシートを埋め込む]オプションを選択します。
[スタイルシートを埋め込む]ダイアログは次の要素で構成されています。
要素 | 説明 |
---|---|
スタイルシート名 | 埋め込みスタイルシートの名前を入力するか、既存のスタイルシートの名前をドロップダウンリストから選んで上書きします。 |
[埋め込みスタイルシートを開く]ダイアログを開くには、[スタイルシートの編集]ダイアログから[スタイルシートを開く]オプションを選択したのち、[埋め込みスタイルシートを開く]オプションを選択します。
[埋め込みスタイルシートを開く]ダイアログは次の要素で構成されています。
要素 | 説明 |
---|---|
スタイルシート名 | ドロップダウンリストから既存のスタイルシートを選択して上書きします。ここに新たな名前を入力してシートの名前を書き換えることもできます。 |
[サーバー共有スタイルシートを開く]ダイアログを開くには、[スタイルシートの編集]ダイアログから[スタイルシートを開く]オプションを選択したのち、[サーバーから開く]オプションを選択します。
[サーバー共有スタイルシートを開く]ダイアログは次の要素で構成されています。
要素 | 説明 |
---|---|
スタイルシート | サーバーに保存したスタイルシートのリストを表示します。 |
OK | [スタイルシートの編集]ダイアログでスタイルシートを選択し、[OK]をクリックしてスタイルシートを開きます。 |
キャンセル | 変更を保存せずにダイアログを閉じます。 |
更新 | ActiveReports Serverに保存したスタイルシートのリストを更新します。 |
[サーバーに保存する]ダイアログを開くには、[スタイルシートの編集]ダイアログから[保存]オプションを選択したのちに、[サーバーに保存する]オプションを選択します。
[サーバーに保存する]ダイアログは次の要素で構成されています。
要素 | 説明 |
---|---|
スタイルシート名 | スタイルシートの名前を入力します。この名前はサーバー上で一意のものである必要があります。 |
説明 | スタイルシートの説明を加えることができます。 |
保存 | スタイルシートを保存します。 |
キャンセル | 変更を保存せずにダイアログを閉じます。 |
更新 | ActiveReports Serverに保存したスタイルシートのリストを更新します。 |
以下はスタイルシートの操作方法に関する手引きのリンクです。
次の操作のいずれかを行う前に、エディタでスタイルシートを開きます。
ヒント: スタイルの種別の詳細については「スタイルの操作」を参照してください。TableOfContentsコントロールと見出しレベルのスタイルを作成する方法については「TableOfContentsコントロールにスタイルを適用する」と「TableOfContentsレベルにスタイルを適用する」を参照してください。 |
ヒント: [プロパティ]ウィンドウのSourceとValueにアクセスすることもできます。SourceプロパティとValueプロパティの詳細については、「スタイルの操作」を参照してください。 |
ヒント: [レポートエクスプローラ]から[スタイルシートの編集]ダイアログへのアクセスは、緑色の[追加](+)ボタンをクリックしたのちに[埋め込みスタイルシート]を選択しても可能です。単体デザイナ、あるいはVisualStudioデザイナでは、[レポート]メニューから[スタイルシートの編集]を選択します。 |
保存が完了すると、スタイルシート名が[レポートエクスプローラ]の[埋め込みスタイルシート]ノードの下に表示されます。
保存が完了すると、スタイルシート名が[レポートエクスプローラ]の埋め込みスタイルシートノードの下に表示されます。
注意: 共有スタイルシートはProfessionalの機能です。Standardでは使用できません。 |
メモ: ActiveReports Serverに保存したスタイルシートへアクセスするには読み込み許可が必要です。 |
Visual Basic
Visual Basicコード(Form_Loadイベント内に貼り付けます) |
コードのコピー
|
---|---|
'ロードするページレポートのパスと名前を入力します。 Dim filePath As String = "C:\SampleReport.rdlx" Dim pageReport As New GrapeCity.ActiveReports.PageReport(New System.IO.FileInfo(filePath)) Dim reportDocument As New GrapeCity.ActiveReports.Document.PageDocument(pageReport) ' 外部スタイルシートを使用してスタイルシートのソースと値を設定します。 reportDocument.PageReport.Report.StyleSheetSource = GrapeCity.ActiveReports.PageReportModel.StyleSheetSource.External reportDocument.PageReport.Report.StyleSheetValue = "C:\ExternalStyle.rdlx-styles" ' 埋め込みスタイルシートを使用してスタイルシートのソースと値を設定します。 reportDocument.PageReport.Report.StyleSheetSource = GrapeCity.ActiveReports.PageReportModel.StyleSheetSource.Embedded reportDocument.PageReport.Report.StyleSheetValue = "EmbeddedStylesheet1 ' テキストボックスコントロールをひとつ追加して、スタイルを適用します。 Dim text As New GrapeCity.ActiveReports.PageReportModel.TextBox() text.Value = "サンプルテキスト" text.Style.StyleName = "Style1" pageReport.Report.Body.ReportItems.Add(text) viewer1.LoadDocument(reportDocument) |
C#
C#コード(Form_Loadイベント内に貼り付けます) |
コードのコピー
|
---|---|
// ロードするページレポートのパスと名前を入力します。 string filePath = @"C:\SampleReport.rdlx"; GrapeCity.ActiveReports.PageReport pageReport = new GrapeCity.ActiveReports.PageReport(new System.IO.FileInfo(filePath)); GrapeCity.ActiveReports.Document.PageDocument reportDocument = new GrapeCity.ActiveReports.Document.PageDocument(pageReport); // 外部スタイルシートを使用してスタイルシートのソースと値を設定します。 reportDocument.PageReport.Report.StyleSheetSource = GrapeCity.ActiveReports.PageReportModel.StyleSheetSource.External; reportDocument.PageReport.Report.StyleSheetValue = @"C:\ExternalStyle.rdlx-styles"; // 埋め込みスタイルシートを使用してスタイルシートのソースと値を設定します。 reportDocument.PageReport.Report.StyleSheetSource = GrapeCity.ActiveReports.PageReportModel.StyleSheetSource.Embedded; reportDocument.PageReport.Report.StyleSheetValue = "EmbeddedStylesheet1"; // テキストボックスコントロールをひとつ追加して、スタイルを適用します。 GrapeCity.ActiveReports.PageReportModel.TextBox text = new GrapeCity.ActiveReports.PageReportModel.TextBox(); text.Value = "サンプルテキスト"; text.Style.StyleName = "Style1"; pageReport.Report.Body.ReportItems.Add(text); viewer1.LoadDocument(reportDocument); |