すべて展開

すべて折りたたむ

ActiveReportsのレポートは、WordRenderingExtensionクラスを使用してMSWordのネイティブ形式で描画することができます。ページレポート／RDLレポートは、FileFormatプロパティを使用することで、Officeオープンxml (OOXML)形式（.Docx）やWord HTML形式（.Doc）でエクスポートすることができます。

Officeオープンxml形式（.Docx）は以下のシナリオでの使用に適しています。

• エクスポートしたレポートを複数のアプリケーションで開く: エクスポートしたWordドキュメントは、次のいずれかのアプリケーションで開くか、修正することができます。
  • Microsoft Office 2007 - 2013
  • Mac 2008 - 2011用のMicrosoft Office
  • iWord、およびv4以降のOS X用Pages
  • Apache OpenOffice
  • Android版Google Quickoffice
  • 文書無料 Documents Free (Mobile Office Suite)

    注意: ActiveReportsのWordRenderingExtensionクラスを使用してエクスポートした.Docxファイルは、.Docx形式をサポートするアプリケーションであれば、上記以外のものでも正常に動作する場合があります。

• エクスポート後にレポートをカスタマイズする: エクスポートしたドキュメントにレポート要素の位置と配置を実装するには、Officeオープンxml (.Docx)形式を使用します。OOXML形式は、エクスポートしたドキュメントの編集において自然なドキュメントフローを提供します。
• Word Automation機能を使用する: OOXML(.Docx)形式のWord Automation機能を使用することで、これまで手動で調整する必要のあったエクスポート後のドキュメントのタスクが自動処理されます。ページヘッダ、ページフッタ、式、見出しレベル、あるいは目次といったレポート要素は自動でOOXML(.Docx)形式に変換されます。
  
• 互換モードを設定する: DocumentCompatibleVersionプロパティを使用することで、レポートをMS Word 2007-2010、およびWord2013と互換性のあるWordドキュメントとして描画することができます。
  

以下は、レポートをMicrosoft Word形式でエクスポートする手順の一例です。

1. Visual Studioで新しいプロジェクトを作成します。
2. ［新しいプロジェクト］ダイアログが表示されます。［ActiveReports 11.0J ページレポートアプリケーション］を選択し、［名前］フィールドにファイル名を入力します。
3. ［OK］をクリックするとActiveReports 11 ページレポートアプリケーションが新規作成されます。デフォルトでページレポートがプロジェクトに追加されます。
4. プロジェクトに「GrapeCity.ActiveReports.Export.Word.v11.dll」アセンブリを追加します。
5. Form.cs、またはForm.vbが開いたら、タイトルバーをダブルクリックしてForm_Loadイベントを作成します。
6. 以下のコードをForm_Loadイベント内に追加し、レポートをOOXML形式、またはHTML形式でエクスポートします。

メモ: レポートをMicrosoft Word 97-2003形式（.Doc）でエクスポートするには、FileFormatプロパティを「OOXML」から「HTML」に変更します。  wordSetting.FileFormat = GrapeCity.ActiveReports.Export.Word.Page.FileFormat.HTML

レポートを.Docx形式にエクスポートするには

' 描画するページレポートを指定します。
Dim report As New GrapeCity.ActiveReports.PageReport()
Dim reportDocument As New GrapeCity.ActiveReports.Document.PageDocument(report)

' 出力先のディレクトリを作成します。
Dim outputDirectory As New System.IO.DirectoryInfo("C:\MyWord")
outputDirectory.Create()

' エクスポートの各種設定を行います。
Dim wordSetting As New GrapeCity.ActiveReports.Export.Word.Page.Settings()

' FileFormatプロパティを.OOXMLに設定します。
wordSetting.FileFormat = GrapeCity.ActiveReports.Export.Word.Page.FileFormat.OOXML

' RenderingExtensionを使用し、レポートをエクスポートします。
Dim wordRenderingExtension As New GrapeCity.ActiveReports.Export.Word.Page.WordRenderingExtension()
Dim outputProvider As New GrapeCity.ActiveReports.Rendering.IO.FileStreamProvider(outputDirectory, "Sample")

' 出力ファイルがすでに存在する場合は上書きします。
outputProvider.OverwriteOutputFile = True

reportDocument.Render(wordRenderingExtension, outputProvider, wordSetting)

// 描画するページレポートを指定します。
GrapeCity.ActiveReports.PageReport report = new GrapeCity.ActiveReports.PageReport();
GrapeCity.ActiveReports.Document.PageDocument reportDocument = new GrapeCity.ActiveReports.Document.PageDocument(report);

// 出力先のディレクトリを作成します。
System.IO.DirectoryInfo outputDirectory = new System.IO.DirectoryInfo(@"C:\MyWord");
outputDirectory.Create();

// エクスポートの各種設定を行います。
GrapeCity.ActiveReports.Export.Word.Page.Settings wordSetting = new GrapeCity.ActiveReports.Export.Word.Page.Settings(); 

// FileFormatプロパティを.OOXMLに設定します。
wordSetting.FileFormat = GrapeCity.ActiveReports.Export.Word.Page.FileFormat.OOXML;

// RenderingExtensionを使用し、レポートをエクスポートします。
GrapeCity.ActiveReports.Export.Word.Page.WordRenderingExtension wordRenderingExtension = new GrapeCity.ActiveReports.Export.Word.Page.WordRenderingExtension();
GrapeCity.ActiveReports.Rendering.IO.FileStreamProvider outputProvider = new GrapeCity.ActiveReports.Rendering.IO.FileStreamProvider(outputDirectory, "Sample");

// 出力ファイルがすでに存在する場合は上書きします。
outputProvider.OverwriteOutputFile = true;

reportDocument.Render(wordRenderingExtension, outputProvider, wordSetting);

Wordエクスポート（描画拡張機能）のプロパティ

ActiveReportsには、Microsoft Wordへのレポートのエクスポートを制御するオプションが用意されています。

共有のプロパティ (HTML形式 および OOXML形式)

HTML 形式

OOXML 形式

制限事項

HTML 形式

• コントロールの背景色はWordドキュメントにエクスポートされますが、本体、ページヘッダ、ページフッタなどのセクションの背景色はエクスポートされません。
• KeepTogetherプロパティはサポートされていません。
• 一部のFormattedTextタグはWordにエクスポートされません（例　<b>bi</b> 、 <s>es</s>）
• サポートされる画像配置はデフォルトのもの（HorizontalAlignment: Left　VerticalAlignment: Top）のみです。
• 画像レポートアイテムのEMFテキストはWordドキュメントにエクスポートするとぼやけて表示されます。

OOXML 形式

レポートプロパティ

• レポートのスタイルシートのLineSpacingプロパティ、レポートのStartPageNumberプロパティ、ページヘッダ、およびページフッタのPrintOnLastPageプロパティはサポートされていません。
• ページレポートでは、NumberingStyleプロパティの一部（見出しマップの設定）がサポートされていません。サポートされているのは、NumberingStyleプロパティの「Decimal」、「DecimalZero」、「LowerLetter」、「UpperLetter」、「LowerRoman」、「UpperRoman」です。
• BackgroundImageのBackgroundRepeatプロパティは、ページレポートのページ領域、およびRDLレポートの本体領域ではサポートされていません。
• RDLレポートでは、ページヘッダ、あるいはページフッタのBackgroundプロパティ、Borderプロパティがサポートされていません。
• Microsoft Wordは、列幅をドキュメントの幅から計算します。一方、RDLレポートは、本体領域の幅を基に列幅を計算します。そのため、エクスポートされるRDLレポートの列幅は、元のRDLレポートと異なる場合があります。
• Microsoft Wordでサポートされるページサイズの最大値は、幅22インチ（55.87 cm） × 高さ22インチ（55.87 cm）です。 出力されたレポートのサイズがこれより大きい場合、一部のデータが表示されない場合があります。
• Microsoft Wordでは、ひとつのテーブルが収容できる列数は最大で63列です。 エクスポートされるテーブルの列数が63列以上におよぶ場合、テーブルは分割されるため、エクスポートされるドキュメントは元のレポートとは異なる場合があります。
• 単一ページ内でのテーブルフッタの繰り返し表示（テーブルフッタのRepeatOnNewPageプロパティ）、あるいは複数のヘッダの繰り返し表示はサポートされていません。
• OverflowPlaceHolderコントロールはサポートされていません。
• ページヘッダ、あるいはページフッタのPrintOnFirstPageプロパティを「False」に設定した場合、エクスポートしたドキュメントの1ページ目にはページヘッダ、およびページフッタが表示されません。
• 複数テーマを適用したレポートはサポートされていません。

レポートコントロール

• Shape以外のレポートコントロールには背景イメージはサポートされていません。
• BorderStyleプロパティの「Inset」オプションはサポートされていません。
• Map、Chart、Image、BarCode、SparkLine、Bullet、CustomControlの各レポートコントロールは、画像としてエクスポートされます。レポートコントロールでBorderColor、BorderStyle、BorderWidthプロパティに値を設定している場合、レポートはテーブルとしてエクスポートされます。
• エクスポートしたレポートコントロールのBorderWidthプロパティは、元のBorderWidthプロパティに設定した値と異なる可能性があります。
• 入れ子式のテーブル、およびセル内での改ページはサポートされていません。ルートされたテーブルセルにある改ページのみサポートします。
• ［式エディタ］のLineStyleプロパティで設定した線のスタイルは、「Solid」（実線）としてエクスポートされます。
• ShapeコントロールのBorderStyleプロパティを「Double」に設定した場合、罫線は「Solid」としてエクスポートされます。
• BandedListデータ領域で繰り返し表示が可能なのはBandedListヘッダのみです。BandedListのフッタ、グループヘッダやグループフッタはサポートされていません。
• Tablixデータ領域は、水平分割されていない単一のテーブルとしてエクスポートされます。
• Tablix、Tableの各データ領域がMS Wordでサポートされるテーブル幅は最大22インチ（55.87 cm）です。この幅に収まりきらない列はすべてサポートされません。
• iWordアプリケーションでは、水平方向に並べた画像が重なって表示される場合があります。
• ImageコントロールのSizingプロパティを「Clip」に設定した場合、Border、およびPaddingプロパティはサポートされません。
• Containerレポートコントロールの角丸（RoundingRadiusプロパティ）はサポートされません。

  FormattedText

  • FormattedTextはそのままエクスポートされます。HTML、およびCSS機能はサポートされません。
  • href属性、<abbr>タグ、<q>タグが含まれない<a>タグは単純なテキストとしてエクスポートされます。
  • BackgroundColor、BackgroundImage、BorderColor、BorderStyleおよびBorderWidthプロパティはサポートされません。
  • href属性のアンカータグはハイパーリンクとしてエクスポートされます。
  • h1、h2等のヘッダは、対応するMicrosoft Wordの組み込みヘッダスタイルとしてエクスポートされます。

  TableOfContents

  • TextAlign、DisplayPageNumber、TextIndent、Overline TextDecorationおよびDisplayPageNumberプロパティはサポートされていません。

  • 見出しマップのSourceプロパティは、HeadingsOnlyオプションのみがサポートされています。 
  • レポートに複数のTableOfContentsコントロールを使用している場合、一つ目のTableOfContentsコントロールのプロパティ設定は、エクスポートしたドキュメント内で他のTableOfContentsコントロールにも適用されます。
  • TableOfContentsコントロールのLevel設定のFillCharacterプロパティは「Dot」（点線）としてエクスポートされます。

  TextBox/CheckBox

  • Formatプロパティを「Numeric」、または「Date」に設定した場合、TextBoxは右揃えでエクスポートされます。それ以外のフォーマット値は左揃えでエクスポートされます。
  • テキスト背景の透明色は白色としてエクスポートされます。
  • 番号付きリスト用のUnderline、DirectionプロパティのRTL (右から左)オプション、Angleプロパティ、ShrinkToFitプロパティ、TextDecorationプロパティのOverLineはサポートされていません。
  • ［レポートに移動］オプションはサポートされていません。
  • WritingModeプロパティの「tb-rl」（vertical text）オプションはサポートされていません。WritingModeプロパティを「tb-rl」に設定したテキストボックスは「lr-tb」としてエクスポートされます。
  • WrapModeプロパティの「NoWrap」オプションはサポートされていません。
  • Microsoft Wordでは、行間はレポートコントロールのフォントサイズ値と行間値を基に計算されます。そのため、エクスポートした文書のLineSpacingプロパティは、元レポートと異なる場合があります。
  • CheckBoxコントロールでは、CheckAlignmentプロパティの「TopRight」、「MiddleRight」、「BottomRight」オプションは「MiddleRight」としてエクスポートされます。その他のCheckAlignmentのオプションは「MiddleLeft」としてエクスポートされます。
  • Paddingsが31インチを超える場合、罫線スペースとしてエクスポートされます。

対話的な機能

HTML 形式

Word形式でレンダリングされたレポートは、ブックマークとハイパーリンクをサポートします。ただし、（ドリルダウンレポートで見られるような）表示／非表示の切り替えが不可欠な場合は、HTML描画拡張機能の使用を推奨します。また、見出しマップが不可欠な場合は、PDF描画拡張機能の使用を推奨します。

OOXML 形式

• ハイパーリンク - TextBoxとImageコントロールに追加したハイパーリンクは、Wordドキュメントでハイパーリンクとして描画されます。
• ブックマーク - レポートのブックマークは、Microsoft Wordのブックマークとして描画されます。ブックマークリンクは、文書内のブックマークラベルにリンクするハイパーリンクとして描画されます。
• TOC AutoUpdate - TableofContentsコントロールは、Microsoft Wordの目次として描画されます。

©2003-2017 GrapeCity inc. All rights reserved.