シーオーリポーツ - 株式会社エイチ・オー・エス...Hos.CxCommon.dll シーオーリポーツ for .NET 共通ライブラリ配布について詳しい配布条件については、パッケージ添付の「使用許諾契約書」

シーオーリポーツ

for .NET

ビューコントロールマニュアル

第

章

第

章

第

章

第

章２

１
ご注意
1. 本ソフトウェア及び付属のドキュメントに関する所有権、知的財産権その他の権限は、特に記述しない限り株式会社エイチ・オー・エスが所有しています。

2. 本ソフトウェア及びマニュアルはソフトウェア使用許諾契約書に記載された内容に反して使用、複製することはできません。

3. 本マニュアルに記載されている事柄は、将来予告なしに変更することがあります。

4. 本ソフトウェア及びマニュアルを運用した結果の影響については、いっさい責任を負いかねますのでご了承ください。

5. 記述中の Microsoft®Windows XP 等は米国 Microsoft 社の登録商標です。その他、一

般にシステム名・会社名は各社の商標または登録商標であり、ここでは情報のみの目的で使用しています。本文中では、特に ® や ™ 等の記号は明記しません。

6. 本ソフトウェアの仕様は予告なしに変更することがあります。

7. 製品の内容については万全を期していますが、ご不審な点や誤り、マニュアルの記載もれなど、お気付きの点がございましたら、弊社までご連絡ください。

Copyright © 2005-2012　株式会社エイチ・オー・エス

2006 年 8 月 10 日　初版発行

2012 年 1 月 31 日　第 15 版発行

株式会社エイチ・オー・エス〒 456-0031 名古屋市熱田区神宮 3 丁目 7 番 1 号べんてんビル 4F

URL http://www.hos.co.jp//

第

章

第

章

第

章

第

章

２

１

第

章

第

章

第

章

第

章２

１

第

章

第

章

第

章

第

章

２

１

第

章

目次

第

章

第

章

第

章２

１

【備考】

本マニュアル内の記述例は、特に記載がない限り Microsoft Visual Basic .NET 2003 のものとします。

第 1 章概　要 .............................................................................................1

1.1 ビューコントロールとは .........................................................................3

1.2 ビューコントロールの利用 .....................................................................5

1.3 ソフトウェア使用許諾および制限 .......................................................7

1.4 必要システム .............................................................................................81.4.1 ハードウェア................................................................................................81.4.2 ソフトウェア................................................................................................8

1.5 オブジェクト階層 .....................................................................................9

第 2 章ビューコントロールの使用法 ...................................................11

2.1 スタンドアロンでの利用 .......................................................................132.1.1 ビューコントロールの貼り付け方法......................................................132.1.2 ビューコントロールの外観の設定..........................................................152.1.3 表示するドキュメントファイルの指定..................................................172.1.4 ページの移動ボタン..................................................................................182.1.5 印刷中の経過メッセージのカスタマイズ..............................................20

2.2 インターネットでの利用 .......................................................................212.2.1 ビューコントロールの貼り付け方法......................................................212.2.2 ビューコントロールの外観の設定..........................................................222.2.3 表示するドキュメントファイルの指定..................................................232.2.4 ページの移動ボタン..................................................................................242.2.5 ノータッチデプロイメントでの利用......................................................25

2.3 参照設定からの利用 ...............................................................................30

第 3 章ビューコントロールの外観 .......................................................31

3.1 メインバー ...............................................................................................33

3.2 ページバー ...............................................................................................36

3.3 スケールバー ...........................................................................................38

3.4 ステータスバー .......................................................................................39

第 4 章シーオーリポーツ for .NET での仕様変更..............................41

4.1 コントロールの仕様変更 .......................................................................434.1.1 オブジェクトの描画の違い......................................................................43

i

目次

第

章

第

章

第

章

第

章

２

１

4.1.2 メソッドの変更点......................................................................................454.1.3 プロパティの変更点..................................................................................464.1.4 機能制限......................................................................................................47

第 5 章メソッド....................................................................................... 49

5.1 メソッドの一覧 ...................................................................................... 51

5.2 メソッドの戻り値 .................................................................................. 53

5.3 CnView ..................................................................................................... 555.3.1 AboutBox .....................................................................................................555.3.2 CloseDocument ............................................................................................565.3.3 FindNext.......................................................................................................575.3.4 FindPrev .......................................................................................................585.3.5 FirstPage.......................................................................................................595.3.6 LastPage .......................................................................................................605.3.7 NextPage ......................................................................................................615.3.8 OpenDocument ............................................................................................625.3.9 OpenBase64Document.................................................................................635.3.10 PreviousPage ................................................................................................645.3.11 PrintOut ........................................................................................................655.3.12 Refresh .........................................................................................................675.3.13 SetDefaultKeyAssign...................................................................................685.3.14 ShowFindDialog ..........................................................................................705.3.15 ShowPageSetup............................................................................................715.3.16 ShowPrinterSetup.........................................................................................72

5.4 CnDocument ............................................................................................. 735.4.1 GetOffsetX ...................................................................................................735.4.2 SetOffsetX....................................................................................................745.4.3 GetOffsetY ...................................................................................................755.4.4 SetOffsetY....................................................................................................765.4.5 GetPrintPage ................................................................................................775.4.6 SetPrintPage .................................................................................................78

5.5 CnPrinter................................................................................................... 795.5.1 SetCustomPaperSize ....................................................................................79

第 6 章イベント....................................................................................... 81

6.1 イベントの一覧 ...................................................................................... 83

6.2 CnView ..................................................................................................... 846.2.1 DownLoaded................................................................................................846.2.2 Printing.........................................................................................................866.2.3 PageChanged................................................................................................88

ii

第

章

目次

第

章

第

章

第

章２

１

第 7 章プロパティ ...................................................................................85

7.1 プロパティの一覧 ...................................................................................87

7.2 CnView......................................................................................................897.2.1 Document .....................................................................................................897.2.2 DocumentFileName .....................................................................................907.2.3 DocumentPath ..............................................................................................917.2.4 Flags .............................................................................................................937.2.5 FormFrameColor..........................................................................................947.2.6 HardwareOffsetColor ...................................................................................957.2.7 Page ..............................................................................................................967.2.8 PreviewAtDesignLayer ................................................................................977.2.9 PrintMode.....................................................................................................987.2.10 Printer ...........................................................................................................997.2.11 ShowFormFrame........................................................................................1007.2.12 ShowHardwareOffset .................................................................................1017.2.13 ShowStatusBar ...........................................................................................1027.2.14 ShowToolBars............................................................................................1037.2.15 Unit.............................................................................................................1047.2.16 ViewScale ..................................................................................................1057.2.17 ViewScaleMode .........................................................................................1067.2.18 WorkPath....................................................................................................107

7.3 CnPrinters ................................................................................................1087.3.1 Count ..........................................................................................................1087.3.2 Item ............................................................................................................109

7.4 CnDocument............................................................................................1107.4.1 AllPages .....................................................................................................1107.4.2 DocumentName..........................................................................................111

7.5 CnPrinter..................................................................................................1127.5.1 BinName ....................................................................................................1137.5.2 Collate ........................................................................................................1147.5.3 Color...........................................................................................................1157.5.4 Copies.........................................................................................................1167.5.5 DefaultSource.............................................................................................1177.5.6 Duplex ........................................................................................................1187.5.7 Orientation..................................................................................................1197.5.8 PaperLength ...............................................................................................1207.5.9 PaperName .................................................................................................1217.5.10 PaperSize....................................................................................................1227.5.11 PaperWidth.................................................................................................1257.5.12 PrintQuality ................................................................................................1267.5.13 PrinterName ...............................................................................................127

iii

目次

第

章

第

章

第

章

第

章

２

１

7.5.14 YResolution ...............................................................................................128

索　引......................................................................................... 131

iv

第

章

第

章

第

章

第

章２

１
第 1 章　
概　要

1

第

章

1.1　ビューコントロールとは

第

章

第

章

第

章２

１


「シーオーリポーツビューコントロール for .NET」(Hos.CnView.dll 以降、「ビュー

ライブラリ」と記載 ) は、「シーオーリポーツ描画ライブラリ」 (Hos.CnDraw.dll 以降、「描画ライブラリ」と記載 ) で作成した「シーオーリポーツドキュメントファイ

ル」( 以降、「ドキュメントファイル」と記載 ) をプレビュー・印刷するための .NETFramework ユーザコントロール（以降、「ユーザコントロール」と記載）です。

図 1-1 ビューコントロールの位置付け

従来の描画ライブラリと「シーオーリポーツビュアー for .NET」( 以降、「ビュアー」

と記載 ) の組み合わせでは、以下のような不満がありました。

• プレビュー画面を作成したいが、どうすればよいのかよくわからない。

• カスタマイズしたビュアーを作成したい。

• ビュアーをクライアントに配布したいが、すべてのクライアントにインストールするのは大変。

• インターネットで使用する場合、プレビュー画面を出さずにダイレクトに印刷したい。

3

第

章


第

章

第

章

第

章

２

１

これらの点は、ユーザコントロールであるビューコントロールを使用することでほとんど解決できます。また、ビューコントロールは Web のページ内に貼り付けることも可能です。

シーオーリポーツドキュメントファイルとは

シーオーリポーツドキュメントファイルとは、描画ライブラリを利用して作成した帳票の印刷イメージをファイル出力したものです。出力ファイル形式は、独自バイナリファイル形式（拡張子 .rsi）とXML ファイル形式（拡張子 .rsx）がございます。

4

第

章

1.2　ビューコントロールの利用

第

章

第

章

第

章２

１


ビューコントロールはスタンドアロンで動作するアプリケーションだけでなく、インターネットアプリケーションからも利用できます。

• スタンドアロンでの利用

簡単な使用方法を「2.1 スタンドアロンでの利用」（P.13）で紹介しています。

図 1-2 スタンドアロンでの利用

• インターネットでの利用

簡単な使用方法を「2.2 インターネットでの利用」（P.21）で紹介しています。

図 1-3 インターネットでの利用

5

第

章


第

章

第

章

第

章

２

１
ノータッチデプロイメントと ClickOnce
ビューコントロールは、ノータッチデプロイメントと ClickOnce に対応しております。ノータッチデプロイメントについては、「2.2.5 ノータッチデプロイメントでの利用」（P.25）をご参照ください。ClickOnce については、関連書籍等をご参照ください。

6

第

章

1.3　ソフトウェア使用許諾および制限

第

章

第

章

第

章２

１

1.3　ソフトウェア使用許諾および制限

作成されたアプリケーションへ添付して配布する場合は、必ず次の事項を行なってください。

• 「製品名」および「Copyright」を、開発アプリケーションの「バージョン情

報」や「起動画面」などで明示してください。内容については以下のとおりです。レイアウトや形式は自由です。

ビューコントロールを使用したアプリケーションを作成した場合、アプリケーション作成者は下記のファイルを開発したアプリケーションに添付して無償で配布することができます。

Hos.CnView.dll Copyright © 2005-2009HOS Co., Ltd.

Hos.CnView.dll シーオーリポーツ for .NET ビューコントロール

Hos.CxCommon.dll シーオーリポーツ for .NET 共通ライブラリ

配布について

詳しい配布条件については、パッケージ添付の「使用許諾契約書」に記載されています。そちらを参照してください。

Hos.CnView.dll と Hos.CxCommon.dll

Hos.CnView.dll を配布する場合は、Hos.CxCommon.dll も一緒に配布してください。

7

第

章

1.4　必要システム

第

章

第

章

第

章

２

１

1.4　必要システム

本コントロールの稼動に必要な環境は以下のとおりです。

1.4.1　ハードウェア

1. コンピュータ本体

Pentium II 450 MHz 相当以上のプロセッサあるいは互換性のあるマイクロプ

ロセッサ（Pentium III 600 MHz 相当以上を推奨）

2. メモリ

最小 128MB 以上の RAM（256MB 以上を推奨）

3. ディスプレイ

1,024 × 768 pixcel 以上のディスプレイモニタあるいは 256 色以上の表示が可

能なディスプレイ（ハイカラー表示可能なディスプレイ装置推奨）

1.4.2　ソフトウェア

Microsoft Windows 2000 SP4

Microsoft Windows 2000 Server SP3

Microsoft Windows Server 2003

Microsoft Windows XP

Microsoft Windows Vista

Microsoft Windows Server 2008

.NET Framework 1.1

.NET Framework 2.0

.NET Framework 3.0

.NET Framework 3.5

（.NET Framework 3.5 Client Profile は対象外）

.NET Framework 4

（.NET Framework 4 Client Profile は対象外）

Internet Explorer 6.0 以降

※ 64 ビット OS にも対応

(2010 年 9 月現在 )

8

第

章

1.5　オブジェクト階層

第

章

第

章

第

章２

１


ビューコントロールは、以下のようなオブジェクトで構成されています。

図 1-4 オブジェクト階層図

Hos.CnView.CnView ビューコントロールオブジェクト

本コントロールを統合しているオブジェクトです。

Hos.CnView.CnDocument ドキュメントオブジェクト

CnView.DocumentFileName で指定しているドキュメントファイルのオブジェ

クトです。

Hos.CnView.CnPrinter ※ 1 標準プリンタオブジェクト

システムの標準のプリンタに設定されているプリンタに対応したプリンタオブジェクトです。用紙の変更・用紙の設定など、標準のプリンタに対しての変更を行なうことが可能です。

Hos.CnView.CnPrinters プリンタオブジェクトコレクション

プリンタオブジェクトのコレクションです。マシンに登録されているプリンタの一覧です。

Hos.CnView.CnPrinter ※ 2 プリンタオブジェクト

システムに登録されているプリンタに対応するプリンタオブジェクトです。

9

第

章


第

章

第

章

第

章

２

１

10

第

章

第

章

第

章

第

章２

１
第 2 章　
ビューコントロール

の使用法

11

　

第

章

2.1　スタンドアロンでの利用

第

章

第

章

第

章２

１


Microsoft Visual Basic .NET 2003( 以降、「VB.NET」と記載 ) でビューコントロール

を使用する方法を説明します。

2.1.1　ビューコントロールの貼り付け方法

ビューコントロールは以下の手順でフォームに貼り付けます。

（1） [ ツールボックス ] の [ コンポーネント ] で右クリックをし [ アイテムの追

加と削除 ] 選択します。

図 2-1 アイテムの追加と削除

（2） [ ツールボックスのカスタマイズ ] ダイアログが表示されますので、[.NETFramework コンポーネント ] タブ内の [ 参照 ] ボタンをクリックし、　インス

トール先にある Hos.CnView.dll を選択し、「開く」ボタンを押します。

（3） [.NET Framework コンポーネント ] タブ内に『CnView』が追加されます。

図 2-2 ツールボックスのカスタマイズダイアログ

13


第

章

第

章

第

章

第

章

２

１

（4）ツールボックスに追加された CnView ボタンを選択し、フォーム上に任意の

サイズで作成します。

図 2-3 ビューコントロールの作成

参照設定の確認

VB.NET の [ ソリューションエクスプローラ ] の [ 参照設定 ] で、「hos.cnview」と「Hos.CxCommon」の参照設定が行なわれていることを確認してください。参照されていない場合には右クリック [ 参照の追加 ] で追加してください。

図 2-4 参照設定

14

第

章


第

章

第

章

第

章２

１

2.1.2　ビューコントロールの外観の設定

ビューコントロールの外観 ( ツールバー・ステータスバー ) は、カスタマイズす

ることが可能です。

（1） VB.NET のフォーム上に作成したビューコントロールを選択します。

図 2-5 ビューコントロールの選択

ビューコントロールのサイズ

ビューコントロールのサイズは、プログラム上から変更することも可能です。プログラム上からビューコントロールのサイズを変更する場合は、CnView.Width プロパティおよび CnView.Height プロパティの値を変更してください。

15


第

章

第

章

第

章

第

章

２

１

（2）ビューコントロールのプロパティタブで、ツールバー・ステータスバーの表示を変更します。プロパティの詳細については、「7.2.14 ShowToolBars」

（P.103）,「7.2.13 ShowStatusBar」（P.102）を参照してください

図 2-6 プロパティタブ

ビューコントロールの外観

ビューコントロールの外観は、プログラム上から変更することも可能です。プログラム上からビューコントロールの外観を変更する場合は、CnView.ShowToolBars プロパティまたは CnView.ShowStatusBar プロパティの値を変更してください。

16

第

章


第

章

第

章

第

章２

１

2.1.3　表示するドキュメントファイルの指定

ビューコントロールに表示するドキュメントファイルは、CnView.DocumentFileName プロパティまたは CnView.OpenDocument メソッドにて

指定します。

なお、ファイル名にはローカルパス、URL(HTTP,HTTPS) を指定することができ

ます。詳しくは「2.2.3 表示するドキュメントファイルの指定」（P.23）を参照し

てください。

【プログラミング例】

（1）ビューコントロールを貼り付けたフォームのロードイベントに「〈図 2-7〉サンプルコード」のようにプログラムを記述します。

図 2-7 サンプルコード

（2）これで、フォームのロード時に「C:¥Cndoc1.rsx」を開く処理が実行されます。

ドキュメントパスの利用

CnView.DocumentPath プロパティにフォルダ名をあらかじめ指定することで、CnView.DocumentFileName プロパティに設定する値をファイル名のみにすることも可能です。詳しくは「7 .2 .3DocumentPath」（P.91）を参照してください。

17


第

章

第

章

第

章

第

章

２

１

2.1.4　ページの移動ボタン

ページの移動を行なうためには、ビューコントロールのページバーを利用する方法と独自にページ移動のボタンを作成する方法があります。

• ビューコントロール上のページバーを利用する

「2.1.2 ビューコントロールの外観の設定」（P.15）において、ページバーを表

示させることにより、プログラミングなしでページの移動ボタンが利用できます。ページバーの使用方法については、「3.2 ページバー」（P.36）を参照し

てください。

• CnView のメソッドを利用してページの移動ボタンを作成する

CnView.FirstPage , CnView.LastPage , CnView.PreviousPage , CnView.NextPageプロパティを呼び出すボタンを作成することで、ページを移動するボタンを作成することができます。

【プログラミング例】

（1） VB.NET のフォーム上にボタンオブジェクトを作成します。

図 2-8 ボタンオブジェクトの作成

18

第

章


第

章

第

章

第

章２

１

（2） (1) で作成したボタンオブジェクトの Text プロパティを「次ページ」にし

ます。

図 2-9Text プロパティ変更後

（3） (1) で作成したボタンオブジェクトをダブルクリックします。

（4）コードウィンドウが表示されますので、「〈図 2-10〉サンプルコード」のよう

に記述します。

図 2-10 サンプルコード

（5）これで、次のページへ移動するボタンができました。

ページの移動を行なうには

ページの移動を行なうためには、ページバーを表示させるかページの移動ボタンを作成する必要があります。ページバーもページの移動ボタンもない場合、ページの移動はできません。

19


第

章

第

章

第

章

第

章

２

１

2.1.5　印刷中の経過メッセージのカスタマイズ

「CnView.PrintOut」メソッド実行時に、印刷中ダイアログの表示を行なわなかっ

た場合、印刷実行中に「CnView.Printing」イベントが発生します。このイベント

を利用することで、独自の印刷経過ダイアログを作成することも可能です。

なお、イベントの詳細については「6.2.3 PageChanged」（P.88）を参照してください。

20

第

章

2.2　インターネットでの利用

第

章

第

章

第

章２

１


インターネット上でビューコントロールを使用する方法をご紹介します。HTML 内で .NET Framework のユーザコントロールを使用する場合は、object タグの

classid に使用するユーザコントロール（DLL ファイル）のパスと名称を指定する必

要があります。（以下を参照）

なお、サーバにはビューコントロールのモジュール（「Hos.CnView.dll」）の他に共

通ライブラリである「Hos.CxCommon.dll」も必要となります。

2.2.1　ビューコントロールの貼り付け方法

HTML の object タグを利用します。記述例は以下のとおりです。

• HTML 上に 640 × 480 のサイズでビューコントロールを貼り付ける

<object width=640 height=480 classid="http://SampleServer/CoReports/

Hos.CnView.dll#Hos.CnView.CnView" >

</object>

classid http:// サーバパス /Hos.CnView.dll#Hos.CnView.CnView

ブラウザの設定

HTML 上のビューコントロールを使用する場合、クライアントマシンのブラウザの設定は .NET Framework ユーザコントロールを使用できる設定にする必要があります。セキュリティの設定が異なると、正常に動作しないことがあります。詳細は「2.2.5.1 セキュリティ設定の変更」（P.25）,「2.2.5.2 インターネットオプションの変更」（P.28）を参照してください。

21


第

章

第

章

第

章

第

章

２

１

2.2.2　ビューコントロールの外観の設定

HTML の param タグを利用します。記述例は以下のとおりです。

• HTML 上にツールバーを表示しないビューコントロールを貼り付ける



 <param name="ShowToolBars" value="0"></object>

クライアントのスクリプトからの設定

ビューコントロールの外観の設定は、クライアントサイドのスクリプトを利用しても行なうことができます。スクリプト上から設定する場合は、「CnView.ShowToolBars」と「CnView.ShowStatusBar」の設定を変更してください。

22

第

章


第

章

第

章

第

章２

１

2.2.3　表示するドキュメントファイルの指定

ビューコントロールに表示するドキュメントファイルを指定するには、HTMLの param タグを利用する方法とスクリプト言語を利用する方法があります。

• HTML の param タグを利用する



 <param name="DocumentFileName" value="http://www.foo.co.jp/Cndoc1.rsx" ></object>

• スクリプト言語を使用する

「CnView.DocumentFileName」プロパティまたは「CnView.OpenDocument」メソッドを使用します。

なお、ファイル名にはローカルパス、URL(HTTP, HTTPS) を指定することが

できます。ただし、URL は以下のように記述する必要があります。

〔 HTTP プロトコルの場合〕

http:// サーバー名 / ファイルパス

※ FTP プロトコルには現在のところ対応しておりません。

23


第

章

第

章

第

章

第

章

２

１

2.2.4　ページの移動ボタン

ページの移動を行なうためには、ビューコントロールのページバーを利用する方法と独自にページ移動のボタンを作成する方法があります。

• ビューコントロール上のページバーを利用する

「2.2.2 ビューコントロールの外観の設定」（P.22）において、ページバーを表

示させることにより、スクリプト言語を使用せずにページの移動ボタンを利用することができます。

• CnView のメソッドを利用してページの移動ボタンを作成する

CnView.FirstPage , CnView.LastPage , CnView.PreviousPage , CnView.NextPageメソッドを利用することで、ページを移動するボタンを作成することができます。


ページの移動を行なうためには、ページバーを表示させるかページの移動ボタンを作成する必要があります。ページバーもページの移動ボタンもない場合、ページの移動はできません。

24

第

章


第

章

第

章

第

章２

１

2.2.5　ノータッチデプロイメントでの利用

ビューコントロールを組み込んだアプリケーションをノータッチデプロイメントで使用する際には、クライアントのセキュリティ設定とインターネットオプションの変更が必要になります。なお、サーバ側では設定変更はありません。

2.2.5.1　セキュリティ設定の変更

クライアントマシンのセキュリティ設定で、「信頼済みサイト」のセキュリティレベルを「完全な信頼」に変更する必要があります。

　　　・.NET Framework 構成ツールを使用して変更する方法

（1） [ コントロールパネル ] より [ 管理ツール ] を開きます。（下図は WindowsXPの [管理ツール ]画面です。OSによっては画面が異なる場合があります。）

図 2-11 管理ツール画面

管理ツール画面から [Microsoft .NET Framework 1.1 Configuration]をダブルクリッ

クし起動します。.NET Framework2.0、3.0、3.5、4 で使用する場合は [Microsoft.NET Framework 2.0 Configuration] を起動します。(「Microsoft .NET Framework 2.0Configuration」が存在しない場合は、「Microsoft .NET Framework2.0 SDK」をイン

ストールしてください。）

.NET Framework 4で使用する場合は、クライアントマシンに .NET Framework 2.0、3.0、3.5 のいづれかをインストールすし、上記の設定を行ってください。

25


第

章

第

章

第

章

第

章

２

１

（2）画面左側より「ランタイムセキュリティポリシー」を選択し、画面右側より「ゾーンセキョリティの変更」を選択すると[セキュリティ設定変更ウィザー

ド ] が起動します。

図 2-12 Microsoft .NET Framework 11Configuration

（3） [ セキュリティ設定変更ウィザード ] ダイアログが表示されます。

図 2-13 セキュリティ設定変更ウィザードダイアログ

26

第

章


第

章

第

章

第

章２

１

（4）変更対象（これはどちらでも良くクライアントの環境に合わせる）を選択して次のページに移動（「次へ」をクリック）する。

[ セキュリティ変更ウィザード ] ダイアログ内の [ 各ゾーンでのセキュリティ

レベルの変更 ] が表示されますので、[ 信頼済みサイト ] を選択します。そし

て、信頼レベルを「完全な信頼」に変更し「次へ」をクリックしてください。

図 2-14 セキュリティレベルの変更

（5） [ 信頼済みサイト ] のセキュリティレベルが、「完全な信頼」に変更されてい

ることを確認し完了ボタンをクリックする。

図 2-15 ウィザードの完了

27


第

章

第

章

第

章

第

章

２

１

　　　・コマンドプロンプトを使用して変更する方法

　　　　　コマンドプロンプトに次のコマンドを入力します　　　　　　

2.2.5.2　インターネットオプションの変更

接続する Web サイト（ビューコントロールが設置されているアドレス）を、

セキュリティレベルを変更した「信頼済みサイト」に登録します。

（1） Internet Exproler のメニューの [ ツール ] より [ インターネットオプション ]を選択し、ダイアログを表示します。

図 2-16 インターネットオプションダイアログ

%SystemRoot%\Microsoft.NET\Framework\v2.0.50727\caspol.exe -q -m -cg Trusted_Zone FullTrust

28

第

章


第

章

第

章

第

章２

１

（2） [ セキュリティ ] タブをクリックし、[ 信頼済みサイト ] を選択後サイトボタ

ンをクリックします。

図 2-17 インターネットオプションダイアログ - セキュリティタブ

（3） [ 信頼済みサイト ] 登録ダイアログが開くので、「次の Web サイトをゾーン

に追加する」テキストボックスに接続 Web サイトのアドレスを入力して追

加ボタンを押します。また、「このゾーンのサイトにはすべてサーバーの確認 (https:) を必要とする」のチェックをはずします。すべて完了後、OK ボ

タンを押し登録を終了します。

図 2-18 信頼済みサイト登録ダイアログ

29

2.3　参照設定からの利用

第

章

第

章

第

章

第

章

２

１

2.3　参照設定からの利用

ビューコントロールは、フォームへの貼り付けを行なわずに利用することができます。以下に VB.NET での利用方法を記述します。

1．「Hos.CnView.dll」と「Hos.CxCommon.dll」を参照設定に追加します。詳細は「参照設定の確認」（P.14）をご参照ください。

2．以下のコードを記述し、ビューコントロールオブジェクトを作成します。

imports Hos.CnView ’CnViewの名前空間

Dim objCnView As CnView = New CnView ’CnViewオブジェクト

これ以降は、スタンドアロンで使用する場合と同様の記述をしていただくことができます。

30

第

章

第

章

第

章

第

章

３

１
第 3章　
ビューコントロールの外観

31

第

章

3.1　メインバー

第

章

第

章

第

章２

３


メインバーは、印刷の実行とプリンタの設定ダイアログの表示を行なうことができます。

「印刷」ボタン

印刷処理を実行します。このボタンをクリックした場合、デフォルトでは印刷ダイアログは表示されません。印刷ダイアログを表示させるには [CnView.Flags]プロパティに [ConFlags.ShowPrintDialog] を設定してください。また、印刷中の

経過ダイアログは表示されます。これは CnView.PrintOut メソッドの第 3 引数

「ProgressDialog」を設定した場合と同様の動作になります。

「ページの設定」ボタン

「〈図 3-2〉ページの設定ダイアログボックス」を開きます。CnView.ShowPageSetup メソッドと同様の動作になります。

図 3-1 メインバー

33


第

章

第

章

第

章

第

章

２

３

図 3-2 ページの設定ダイアログボックス

ページ番号と印刷許可

プレビューを行なっているページに対し、印刷許可を設定することができます。設定方法は、ページ番号選択後に「表示 / 非表示」ボタンを押下します。

用紙サイズ（ファイルを開くときの既存値）

ファイルオープン時の既存値を設定できます。この設定は CnView.PrintMode プロパティでも設定可能です。各設定値におけ

る具体的な動作については、「7.2.9 PrintMode」（P.98）を参照してください。

印刷を行なうには

印刷を行なうためには、メインバーを表示させるかCnView.PrintOut メソッドを呼び出すコードを記述する必要があります。メインバーを非表示にし、CnView.PrintOut メソッドを実行するコードの記述もない場合、印刷はできません。

34

第

章


第

章

第

章

第

章２

３

「検索」ボタン

「〈図 3-3〉文字列検索ダイアログボックス」を開きます。

図 3-3 文字列検索ダイアログボックス

•検索文字列検索したい文字列を入力します。最後に入力した検索文字列は、ビューコントロールを終了するまで保持されます。

•大文字／小文字を区別チェックボックスが「ON」の場合、検索文字列と大文字／小文字の区別

が一致する文字列のみを検索します。•完全に一致する単語のみチェックボックスが「ON」の場合、検索文字列と完全に一致する単語の

みが検索されます。単語の一部に検索文字列を含む箇所は検索されません。

•上検索上方向に検索を行ないます。検索の順番はオブジェクトの描画順（フォームエディタでオブジェクトが作成された順）の逆になります。

•下検索下方向に検索を行ないます。検索の順番はオブジェクトの描画順（フォームエディタでオブジェクトが作成された順）です。

•キャンセル〔文字列検索〕ダイアログボックスを閉じます。

35

3.2　ページバー

第

章

第

章

第

章

第

章

２

３


ページバーは、表示中のドキュメントファイルのページの移動を行なうことができます。

「先頭ページ」ボタン

表示中のドキュメントファイルのページを先頭のページへ移動します。CnView.FirstPage メソッドと同様の動作になります。

表示中のページより前のページが存在しない場合、使用することはできません。

「前ページ」ボタン

表示中のドキュメントファイルのページを 1 ページ前のページへ移動します。

CnView.PreviousPage メソッドと同様の動作になります。

表示中のページより前のページが存在しない場合、使用することはできません。

「次ページ」ボタン

表示中のドキュメントファイルのページを 1 ページ後のページへ移動します。

CnView.NextPage メソッドと同様の動作になります。

表示中のページより後のページが存在しない場合、使用することはできません。

「最終ページ」ボタン

表示中のドキュメントファイルのページを最後のページへ移動します。CnView.LastPage メソッドと同様の動作になります。

表示中のページより後のページが存在しない場合、使用することはできません。

ページ番号

表示中のドキュメントのページ番号（「現在のページ / 総ページ」）が表示されま

す。また、直接任意のページ番号を入力すると、任意ページへ移動します。ただし、存在しないページ番号を入力した場合、ページ移動は行なわれません。

総ページ数が 1 ページだった場合、使用することはできません。

図 3-4 ページバー

36

第

章


第

章

第

章

第

章２

３


ページの移動を行なうためには、ページバーを表示させるかページを移動するメソッドを呼び出すコードを記述する必要があります。ページバーを非表示にし、ページを移動するメソッドを実行するコードの記述もない場合、ページの移動はできません。。

37

3.3　スケールバー

第

章

第

章

第

章

第

章

２

３

3.3　スケールバー

スケールバーは、ドキュメントファイルの表示方法を変更することができます。

「拡大縮小率」コンボボックス

ドキュメントファイルの表示方法を拡大縮小率で設定します。CnView.ViewScaleMode プロパティに Value を設定し、CnView.ViewScale プロパ

ティに拡大縮小率を設定した場合と同様の動作になります。

「縦に合わせる」ボタン

ドキュメントファイル表示部分の高さとドキュメントファイルの高さを合わせて表示するように設定します。CnView.ViewScaleMode プロパティに FitToHeightを設定した場合と同様の動作になります。

「横に合わせる」ボタン

ドキュメントファイル表示部分の幅とドキュメントファイルの幅を合わせて表示するように設定します。CnView.ViewScaleMode プロパティに FitToWidth を設

定した場合と同様の動作になります。

「画面サイズに合わせる」ボタン

ドキュメントファイル表示部分にドキュメントの全体が表示されるように設定します。CnView.ViewScaleMode プロパティに FitToWhole を設定した場合と同様の動作に

なります。

図 3-5 スケールバー

38

第

章

3.4　ステータスバー

第

章

第

章

第

章２

３


ステータスバーには、ビューコントロールのステータスが表示されます。

• ステータス

ステータスバーの左の部分には、ドキュメントファイルダウンロード時の進捗状況などが表示されます。

• 用紙設定ステータス

ステータスバーの中央の部分には、印刷時の用紙サイズと用紙方向の情報が表示されます。

• ページステータス

ステータスバーの右の部分には、ドキュメントファイルの全ページ数と表示中のページ番号が表示されます。

図 3-6 ステータスバー

39


第

章

第

章

第

章

第

章

２

３

40

第

章

第

章

第

章

第

章２

１
第 4 章　
シーオーリポーツ

for .NET

での仕様変更(2007 年 6 月現在 )

41

第

章

4.1　コントロールの仕様変更

第

章

第

章

第

章２

４


ビューコントロール for .NET は、シーオーリポーツ Ver7.x 以降で使用されてきた

ActiveX コントロールからユーザコントロールとなり、それに伴い帳票の描画やメ

ソッド・プロパティ等の仕様が一部変更されました。以下でその変更点についてご説明いたします。

4.1.1　オブジェクトの描画の違い

1. 塗りつぶしパターンの描画

各オブジェクトの塗潰しパターンの描画が ActiveX コントロールとは異なり

ます。描画が変更された塗潰しパターンは網掛け系のみです。（他の塗潰しパターンでも、使用されている色によっては ActiveX コントロールでの描画と

は異なる場合がございます。）

図 4-1 塗潰しパターンの比較

塗潰しパターン ActiveX コントロールユーザコントロール

横線 →

縦線 →

斜線（左上から右下） →

斜線（左下から右上） →

43

第

章


第

章

第

章

第

章

２

４

2. プロポーショナルフォント ( 等幅フォント ) のフォント幅変更時

ラベルオブジェクト等でプロポーショナルフォントを使用している際、そのフォント幅を変更してプレビューすると、ActiveX コントロールとは異なる

フォント幅で描画される場合がございます。

図 4-2 プロポーショナルフォントの比較

クロス →

網掛け →

ActiveX コントロールユーザコントロール

■比較設定詳細両バージョンとも以下の設定で比較しています。

• Unit = Mm

• DefaultPitch = False

• HanFontWidth = 30

塗潰しパターン ActiveX コントロールユーザコントロール

44

第

章


第

章

第

章

第

章２

４

4.1.2　メソッドの変更点

ユーザコントロールより変更となったメソッド一覧を以下に記載いたします。（×は未対応メソッド）

オブジェクト ActiveX コントロールユーザコントロール

CnView ShowPrinterSetup ×

× ShowPageSetup

CnDocument × GetOffsetX

× SetOffsetX

× GetOffsetY

× SetOffsetY

× GetPrintPage

× SetPrintPage

CnPrinter SetFormSize ×

× SetCustomPaperSize

45

第

章


第

章

第

章

第

章

２

４

4.1.3　プロパティの変更点

ユーザコントロールより変更となったプロパティ一覧を以下に記載いたします。（×は未対応プロパティ）

オブジェクト ActiveX コントロールユーザコントロール

CnView RW AutoAddForm - ×

CnDocument RW OffsetX - ×

RW OffsetY - ×

RW PrintPage - ×

CnPrinter RW DeviceName - ×

RW PaperLength R- PaperLength

RW PaperName R- PaperName

RW PaperWidth R- PaperWidth

RW TTOption - ×

RW YResolution R- YResolution

プリンタプロパティの有効判定を行なわないプロパティ

CnView.Flags プロパティの PrinterCheck による「プリンタプロパティの設定値に対する有効判定」ですが、仕様変更により一部のプロパティで有効チェックがされなくなりましたので下記をご確認ください。

【プリンタプロパティの有効チェックがされないプロパティ】

•CnPrinter.Orientation プロパティ

•CnPrinter.PaperLength プロパティ

•CnPrinter.PaperName プロパティ

•CnPrinter.PaperWidth プロパティ

•CnPrinter.YResolution プロパティ

46

第

章


第

章

第

章

第

章２

４

4.1.4　機能制限

以下の機能はサポートされておりませんのでご注意ください。

• PDF417 オブジェクト

47

第

章


第

章

第

章

第

章

２

４

48

第

章

第

章

第

章

第

章

４

１
第 5 章　
メソッド

49

　　

第

章

5.1　メソッドの一覧

第

章

第

章

第

章

５

１


CnView

CnDocument

名称説明

AboutBox バージョン情報ダイアログ表示処理

CloseDocument ドキュメントファイルクローズ処理

FindNext 次の単語の検索処理

FindPrev 前の単語の検索処理

FirstPage 先頭ページへの移動処理

LastPage 最終ページへの移動処理

NextPage 次ページへの移動処理

OpenDocument ドキュメントファイルオープン処理

OpenBase64Document Base64 ドキュメント文字列オープン処理

PreviousPage 前ページへの移動処理

PrintOut ドキュメントファイル印刷処理

Refresh ページの再描画処理

SetDefaultKeyAssign 既存キー割り当ての有効 / 無効処理

ShowFindDialog 検索ダイアログ表示処理

ShowPageSetup ページの設定ダイアログ表示処理

ShowPrinterSetup プリンタの設定ダイアログ表示処理

名称説明

GetOffsetX 横方向オフセットの取得処理

SetOffsetX 横方向オフセットの設定処理

GetOffsetY 縦方向オフセットの取得処理

SetOffsetY 縦方向オフセットの設定処理

GetPrintPage ページ毎の印刷指定フラグ取得処理

51


第

章

第

章

第

章

第

章５

１

CnPrinter

SetPrintPage ページ毎の印刷指定フラグ設定処理

名称説明

SetCustomPaperSize ユーザ定義のサイズ設定処理

52

第

章

5.2　メソッドの戻り値

第

章

第

章

第

章

５

１


定義名値説明

IdCancel 2 キャンセルボタンが押された場合に返されます。

IdOk 1 OK ボタンが押された場合に返されます。

NoError 0 メソッドが正常に終了した場合に返されます。

ErrNotOpenDocument -1 ドキュメントファイルをオープンしていない状態で、ドキュメントファイルのクローズなどの操作をしようとした場合に返されます。

ErrAlreadyOpenDocument -2 ドキュメントファイルをオープンしてからクローズするまでの間に、もう一度ドキュメントファイルをオープンしようとした場合に返されます。

ErrOpenDocument -3 ドキュメントファイルのオープンに失敗した場合に返されます。

ErrReadDocument -5 ドキュメントファイルの読み込みに失敗した場合に返されます。

ErrAlreadyOpenPrinter -7 プリンタ出力処理が実行済みの場合に返されます。

ErrNoPrinter -9 プリンタが 1 つもインストールされていな

い場合に返されます。

ErrPrinterNotExists -10 指定したプリンタが存在しなかった場合に返されます。

ErrPrinterControl -18 印刷時にプリンタの設定に矛盾が発生した場合に返されます。

ErrObjectDraw -20 デバイスコンテキストに描画ができなかった場合に返されます。

53


第

章

第

章

第

章

第

章５

１

定義名値説明

ErrInvalidPaperSize -21 出力しようとした用紙サイズがプリンタで印刷可能なサイズより大きいもしくは小さい場合に返されます。

ErrNotPermittedPrint -23 印刷許可のないドキュメントを印刷しようとした場合に返されます。

ErrInvalidURL -30 URL 異常 (Download イベントステータスよ

り )

ErrReadError -31 URL リードエラー (Download イベントス

テータスより )

ErrInvalidFile -32 不正なファイル (Download イベントステー

タスより )

ErrNoPrintPages -102 印刷を行なうページがない場合に返されます。

ErrUserCancel -103 ユーザーによる印刷のキャンセルが行なわれた場合に返されます。

ErrInvalidPage -104 指定したページが存在しない場合に返されます。

ErrNoPreviousPage -105 現在表示中のページより前のページがない場合に返されます。

ErrNoNextPage -106 現在表示中のページより後のページがない場合に返されます。

ErrInvalidOption -107 不正なオプションが指定された場合に返されます。

54

第

章

5.3　CnView

第

章

第

章

第

章

５

１

5.3　CnView

5.3.1　AboutBox

【名前】

AboutBox - バージョン情報ダイアログ表示処理

【概要】

バージョン情報ダイアログを表示します。

【書式】

CnView.AboutBox()

【説明】

バージョン情報のダイアログボックスを表示します。

【戻り値】

なし

55

5.3　CnView

第

章

第

章

第

章

第

章５

１

5.3.2　CloseDocument

【名前】

CloseDocument - ドキュメントファイルクローズ処理

【概要】

ドキュメントファイルをクローズします。

【書式】

CnView.CloseDocument()

【説明】

CnView.OpenDocument メソッドで開いたドキュメントファイルをクローズします。

【戻り値】

Hos.CnView.ConError 列挙型

メンバ整数値内　容

NoError 0 正常終了

ErrNotOpenDocument -1 ドキュメントファイル未オープン

56

第

章

5.3　CnView

第

章

第

章

第

章

５

１

5.3.3　FindNext

【名前】

FindNext - 次の単語の検索処理

【概要】

次の単語の検索をします。

【書式】

CnView.FindNext()

【説明】

次の単語の検索をします。単語の入力がされていない場合は検索ダイアログボックスを表示します。

【戻り値】





57

5.3　CnView

第

章

第

章

第

章

第

章５

１

5.3.4　FindPrev

【名前】

FindPrev - 前の単語の検索処理

【概要】

前の単語の検索をします。

【書式】

CnView.FindPrev()

【説明】

前の単語の検索をします。単語の入力がされていない場合は検索ダイアログボックスを表示します。

【戻り値】





58

第

章

5.3　CnView

第

章

第

章

第

章

５

１

5.3.5　FirstPage

【名前】

FirstPage - 先頭ページへの移動処理

【概要】

先頭のページへ移動します。

【書式】

CnView.FirstPage()

【説明】

先頭ページへ移動します。

【戻り値】





ErrNoPreviousPage -105 現在表示中のページより前のページがない

59

5.3　CnView

第

章

第

章

第

章

第

章５

１

5.3.6　LastPage

【名前】

LastPage - 最終ページへの移動処理

【概要】

最終ページへ移動します。

【書式】

CnView.LastPage()

【説明】

最終ページへ移動します。

【戻り値】





ErrNoNextPage -106 現在表示中のページより後のページがない

60

第

章

5.3　CnView

第

章

第

章

第

章

５

１

5.3.7　NextPage

【名前】

NextPage - 次ページへの移動処理

【概要】

次ページへ移動します。

【書式】

CnView.NextPage()

【説明】

次ページへ移動します。

【戻り値】





ErrNoNextPage -106 現在表示中のページより後のページがない

61

5.3　CnView

第

章

第

章

第

章

第

章５

１

5.3.8　OpenDocument

【名前】

OpenDocument - ドキュメントファイルオープン処理

【概要】

ドキュメントファイルをオープンします。

【書式】

CnView.OpenDocument(DocumentFileName)

【説明】

ドキュメントファイルをオープンします。このメソッドの引数で設定したファイル名は、CnView.DocumentFileName プロパ

ティに設定されます。すでに、CnView.DocumentFileName プロパティにファイル名が設定されている場合、

もしくは CnView.OpenDocument メソッドが実行されている場合は、

「ErrAlreadyOpenDocument」が戻ります。

DocumentFileName

オープンするドキュメントファイル名を指定します。ドキュメントファイル名には、絶対パス、相対パス、URL(HTTP,HTTPS のみ ) を指定することがで

きます。

【戻り値】




ErrAlreadyOpenDocument -2 ドキュメントファイルオープン済み

ErrOpenDocument -3 ドキュメントファイルオープンエラー

ErrReadDocument -5 ドキュメントファイルリードエラー

ErrInvalidURL -30 URL 異常 (Download イベントステータスよ

り )

ErrReadError -31 URLリードエラー(Downloadイベントステー

タスより )

ErrInvalidFile -32 不正なファイル(Downloadイベントステータ

スより )

62

第

章

5.3　CnView

第

章

第

章

第

章

５

１

5.3.9　OpenBase64Document

【名前】

OpenBase64Document - Base64 ドキュメント文字列オープン処理

【概要】

Base64 にエンコードされたドキュメント文字列をオープンします。

【書式】

CnView.OpenBase64Document(Base64DocumenString)

【説明】

Base64 にエンコードされたドキュメント文字列をオープンします。

すでに、CnView.DocumentFileName プロパティにファイル名が設定されている場合、

もしくは CnView.OpenDocument メソッドが実行されている場合は、

「ErrAlreadyOpenDocument」が戻ります。

Base64DocumentString

オープンする Base64 にエンコードされたドキュメント文字列を指定します。

【戻り値】




ErrAlreadyOpenDocument -2 ドキュメントファイルオープン済み

ErrOpenDocument -3 ドキュメントファイルオープンエラー

63

5.3　CnView

第

章

第

章

第

章

第

章５

１

5.3.10　PreviousPage

【名前】

PreviousPage - 前ページへの移動処理

【概要】

前ページへ移動します。

【書式】

CnView.PreviousPage()

【説明】

前ページへ移動します。

【戻り値】





ErrNoPreviousPage -105 現在表示中のページより前のページがない

64

第

章

5.3　CnView

第

章

第

章

第

章

５

１

5.3.11　PrintOut

【名前】

PrintOut - ドキュメントファイル印刷処理

【概要】

ドキュメントファイルを印刷します。

【書式】

CnView.PrintOut(PrinterName)CnView.PrintOut(PrinterName, SpoolName)CnView.PrintOut(PrinterName, SpoolName, PrintFlags)

【説明】

ドキュメントファイルを出力先プリンタに出力します。

PrinterName

出力先のプリンタ名を文字列型で指定します。ここで設定されたプリンタ情報は、CnView.Printer プロパティに反映され、出

力先プリンタとして設定されます。ここに何も指定されなかった場合や "" が指定された場合は、CnView.Printer プロパティに設定されているプリンタが出

力先のプリンタになります。

SpoolName

印刷 JOB の帳票名を文字列型で指定します。印刷時にこの名前がスプーラー

上に表示されます。何も指定されなかった場合はドキュメントファイルのドキュメント名となります。

PrintFlags

印刷フラグを設定します。指定しなかった場合は「ProgressDialog」を設定した場合と同様の動作になります。

複数の値を設定する場合は論理和 (Or) で設定するようにしてください。

【設定値】

PrintFlags - 整数型

• NoOption 0 何も表示しない

• PrintDialog 1 印刷設定ダイアログを表示する

• ProgressDialog 2 印刷経過ダイアログを表示する

65

5.3　CnView

第

章

第

章

第

章

第

章５

１

【戻り値】



IdCancel 2 キャンセル処理



ErrNoPrinter -9 プリンタが1つもインストールされていない

ErrPrinterNotExists -10 指定されたプリンタがない

ErrPrinterControl -18 プリンタ制御が正常に行なわれなかった

ErrObjectDraw -20 描画オブジェクトの描画に失敗

ErrNotPermittedPrint -23 印刷許可がない

ErrNoPrintPages -102 印刷を行なうページがない

ErrUserCancel -103 ユーザーによる印刷のキャンセル

ErrInvalidOption -107 不正なオプションが指定された

印刷経過ダイアログと Printing イベント

PrintOut メソッドの第 3 引数に「ProgressDialog」を指定した場合は、ビューコントロールが印刷経過ダイアログを表示するため、Printing イベントは発生しません。独自の印刷経過ダイアログを表示させる場合は、「ProgressDialog」を指定しないでください。

66

第

章

5.3　CnView

第

章

第

章

第

章

５

１

5.3.12　Refresh

【名前】

Refresh - ページの再描画処理

【概要】

ページを再描画します。

【書式】

CnView.Refresh()

【説明】

ビューコントロールに表示されているページを再描画します。

【戻り値】

なし

67

5.3　CnView

第

章

第

章

第

章

第

章５

１

5.3.13　SetDefaultKeyAssign

【名前】

SetDefaultKeyAssign - 既存キー割り当ての有効 / 無効処理

【概要】

既存キー割り当ての有効 / 無効を設定します。

【書式】

CnView.SetDefaultKeyAssign(keyData, assign)

【説明】

ビューコントロールに既存キー割り当ての有効 / 無効を設定します。

keyData

キーコードを System.Windows.Forms.Keys 列挙型で指定します。

複数のキーコードを指定する場合は論理和 (Or) で指定します。

既存キー割り当て一覧

キー動作内容

Ctrl + F 文字列検索

F2 文字列検索　前へ

F3 文字列検索　次へ

PageUp 次ページ

PageDown 前ページ

Home 先頭ページ

End 最終ページ

Right( → ) 次ページ

Left( ← ) 前ページ

Top( ↑ ) 縦スクロール + 前ページ

Bottom( ↓ ) 縦スクロール + 次ページ

Shift + Right( → ) 横スクロール

Shift + Left( ← ) 横スクロール

68

第

章

5.3　CnView

第

章

第

章

第

章

５

１

assign

第一引数で指定した keyData に対してキー割り当ての有効 / 無効をブール型

で指定します。

・False 無効にする

・True 有効にする

【戻り値】

なし

69

5.3　CnView

第

章

第

章

第

章

第

章５

１

5.3.14　ShowFindDialog

【名前】

ShowFindDialog - 検索ダイアログ表示処理

【概要】

検索ダイアログを表示します。

【書式】

CnView.ShowFindDialog()

【説明】

検索ダイアログボックスを表示します。

【戻り値】





70

第

章

5.3　CnView

第

章

第

章

第

章

５

１

5.3.15　ShowPageSetup

【名前】

ShowPageSetup - ページの設定ダイアログ表示処理

【概要】

ページの設定ダイアログを表示します。

【書式】

CnView.ShowPageSetup(PrinterName)

【説明】

ページの設定ダイアログボックスを表示します。

PrinterName

ページの設定ダイアログボックスのプリンタ名を指定します。"" が指定された場合は、CnView.Printer プロパティに設定されているプリンタ

が指定されて、プリンタの設定ダイアログボックスが表示されます。

【戻り値】




IdOk 1 OK ボタンが押された

ErrPrinterNotExists -10 指定したプリンタない

71

5.3　CnView

第

章

第

章

第

章

第

章５

１

5.3.16　ShowPrinterSetup

【名前】

ShowPrinterSetup - プリンタの設定ダイアログ表示処理

【概要】

プリンタの設定ダイアログを表示します。

【書式】

CnView.ShowPrinterSetup(PrinterName)

【説明】

プリンタの設定ダイアログボックスを表示します。

PrinterName

プリンタの設定ダイアログボックスのプリンタ名を指定します。"" が指定された場合は、CnView.Printer プロパティに設定されているプリンタ

が指定されて、プリンタの設定ダイアログボックスが表示されます。

【戻り値】




IdOk 1 OK ボタンが押された

ErrNoPrinter -9 プリンタが1つもインストールされていない

ErrPrinterNotExists -10 指定したプリンタない

72

第

章

5.4　CnDocument

第

章

第

章

第

章

５

１

5.4　CnDocument

5.4.1　GetOffsetX

【名前】

GetOffsetX - 横方向オフセットの取得

【概要】

ドキュメントファイルのページ毎に横方向のオフセットを取得します。

【書式】

CnDocument.GetOffsetX(page)

【説明】

ドキュメントファイルのページ毎に横方向のオフセットを取得します。現在表示中のドキュメントファイルの 3ページ目に横方向のオフセットを取得する

場合には、CnView.Document.GetOffsetX(3) と記述してください。

本プロパティの値の単位は CnView オブジェクトのプロパティ「7.2.15 Unit」（P.104）で設定された単位になります。

page

取得を行なうページ数を指定します。

【戻り値】

横方向オフセット値 - 長整数型

73

5.4　CnDocument

第

章

第

章

第

章

第

章５

１

5.4.2　SetOffsetX

【名前】

SetOffsetX - 横方向オフセットの設定

【概要】

ドキュメントファイルのページ毎に横方向のオフセットを設定します。

【書式】

CnDocument.SetOffsetX(page, x)

【説明】

ドキュメントファイルのページ毎に横方向のオフセットを設定します。指定されたページのドキュメントファイルの表示を横方向に移動します。現在表示中のドキュメントファイルの 3ページ目に横方向のオフセットを設定する

場合には、CnView.Document.SetOffsetX(3, 20) と記述してください。


page

設定を行なうページ数を指定します。

x

横方向オフセット値

【戻り値】

なし

74

第

章

5.4　CnDocument

第

章

第

章

第

章

５

１

5.4.3　GetOffsetY

【名前】

GetOffsetY - 縦方向オフセット取得

【概要】

ドキュメントファイルのページ毎に縦方向のオフセットを取得します。

【書式】

CnDocument.GetOffsetY(page)

【説明】

ドキュメントファイルのページ毎に縦方向のオフセットを取得します。現在表示中のドキュメントファイルの 3ページ目に縦方向のオフセットを取得する

場合には、CnView.Document.GetOffsetY(3) と記述してください。


page


【戻り値】

縦方向オフセット値 - 長整数型

75

5.4　CnDocument

第

章

第

章

第

章

第

章５

１

5.4.4　SetOffsetY

【名前】

SetOffsetY - 縦方向オフセット設定

【概要】

ドキュメントファイルのページ毎に縦方向のオフセットを設定します。

【書式】

CnDocument.SetOffsetY(page, y)

【説明】

ドキュメントファイルのページ毎に縦方向のオフセットを設定します。指定されたページのドキュメントファイルの表示を縦方向に移動します。現在表示中のドキュメントファイルの 3ページ目に縦方向のオフセットを設定する

場合には、CnView.Document.SetOffsetY(3, 20) と記述してください。


page


y

縦方向オフセット値

【戻り値】

なし

76

第

章

5.4　CnDocument

第

章

第

章

第

章

５

１

5.4.5　GetPrintPage

【名前】

PrintPage - ページ毎の印刷指定フラグ取得

【概要】

ページ毎に印刷するか否かを取得します。

【書式】

CnDocument.GetPrintPage(page)

【説明】

ページ毎に印刷するか否かを取得します。現在表示中のドキュメントファイルの 3ページ目の印刷指定フラグを取得する場合

は、CnView.Document.GetPrintPage(3) と記述してください。

page


【戻り値】

ブール型

• False 印刷しない

• True 印刷する

77

5.4　CnDocument

第

章

第

章

第

章

第

章５

１

5.4.6　SetPrintPage

【名前】

SetPrintPage - ページ毎の印刷指定フラグ設定

【概要】

ページ毎に印刷するか否かを設定します。

【書式】

CnDocument.SetPrintPage(page, print)

【説明】

ページ毎に印刷するか否かを設定します。デフォルトでは、すべてのページを印刷する設定になっています。印刷不要なページが存在する場合は、該当ページのプロパティを False に設定してください。

現在表示中のドキュメントファイルの 3ページ目を印刷しないように設定する場合

は、CnView.Document.SetPrintPage(3, False) と記述してください。

page


print

印刷許可フラグ

【戻り値】

なし

78

第

章

5.5　CnPrinter

第

章

第

章

第

章

５

１

5.5　CnPrinter

5.5.1　SetCustomPaperSize

【名前】

SetCustomPaperSize - ユーザ定義サイズの設定

【概要】

ドキュメントファイルのユーザ定義サイズを設定します。

【書式】

CnPrinter.SetCustomPaperSize(width, length)

【説明】

ドキュメントファイルの用紙サイズがユーザ定義サイズであった場合に、その用紙長と用紙幅のサイズを設定します。本プロパティの値の単位は CnView オブジェクトのプロパティ「7.2.15 Unit」（P.104）で設定された単位になります。

width

用紙幅を指定します。

length

用紙長を指定します。

【戻り値】




ErrPrinterControl -18 プリンタ制御が正常に行なわれなかった

79

5.5　CnPrinter

第

章

第

章

第

章

第

章５

１

80

第

章

第

章

第

章

第

章２

１

第５

第 6 章　

イベント

81

章

　　　

第

章

第

章

6.1　イベントの一覧

第

章

第

章

第

章２

１

６

6.1　イベントの一覧

CnView

名称説明

DownLoaded ダウンロード終了イベント

Printing 印刷経過イベント

PageChanged 表示ページ変更イベント

83

6.2　CnView

第

章

第

章

第

章

第

章

２

１

３

第

章６

6.2　CnView

6.2.1　DownLoaded

【名前】

DownLoaded - ダウンロード終了イベント

【概要】

URL ファイルのダウンロード処理が実行された後に発生するイベントです。

【書式】

CnView.DownLoaded(sender, e)

【説明】

URL ファイルのダウンロード処理が実行された後に発生するイベントです。このイ

ベントは、CnView.OpenDocument メソッド、CnView.DocumentFileName プロパティ

のファイル名に URL を指定した場合に発生するファイルのダウンロード処理が実

行された場合にのみ発生します。本イベントは VBScript や JavaScript 等のスクリプト言語では使用することがでない

ため、CnView.OpenDocumen メソッドの戻り値で判断してください。

sender[object] イベントが発生したオブジェクト

e [DownloadedEventArgs]

• Status

ダウンロードの終了ステータスを確認することができます。

【使用例】

• VB.NET

Private Sub CnView_Downloaded(ByVal sender As System.Object,ByVal e As Hos.CnView.DownloadedEventArgs) Handles CnView.Downloaded　

’ 処理

End Sub

• C#

cnView.Downloaded +=new Hos.CnView.CnView.DownloadedEventHandler(cnView_Downloaded);

private void cnView_Downloaded(object sender, Hos.CnView.DownloadedEventArgs e){ // 処理

84

第

章

第

章

6.2　CnView

第

章

第

章

第

章２

１

６

}

【設定値】

Status - 整数型

• NoError 0 正常終了

• InvalidURL 1 URL 異常

• ReadError 2 URL リードエラー

• InvalidFile 3 不正なファイル

85

6.2　CnView

第

章

第

章

第

章

第

章

２

１

３

第

章６

6.2.2　Printing

【名前】

Printing - 印刷経過イベント

【概要】

印刷中に発生するイベントです。

【書式】

CnView.Printing(sender, e)

【説明】

印刷中に発生するイベントです。このイベントは、CnView.PrintOut メソッドの第 3引数に ProgressDialog を指定しなかった場合に発生します。

sender[object]イベントが発生したオブジェクト

e [PrintingEventArgs]

• Cancel

印刷を中止したい場合に True を設定します。True を設定した場合、プリン

トマネージャにスプールされた印刷データは破棄されます。ただし、プリントマネージャの設定やプリンタドライバの実装によっては、破棄されない場合もあります。

• Status

印刷中のステータスを確認することができます。

• Page

現在印刷中のページ番号を確認することができます。なお、印刷前に 1 度だ

けこの引数に 0 が代入されてイベントが発生します。このときに、印刷経過

用の準備を行なってください。

【使用例】

• VB.NET

Private Sub CnView1_Printing(ByVal sender As System.Object, ByVal e AsHos.CnView.PrintingEventArgs) Handles CnView1.Printing ’ 処理End Sub

• C#

cnView.Printing +=new Hos.CnView.CnView.PrintingEventHandler(cnView_Printing);

86

第

章

第

章

6.2　CnView

第

章

第

章

第

章２

１

６

private void cnView_Printing(object sender, Hos.CnView.PrintingEventArgs e){ // 処理}

【設定値】

Cancel - ブール型

Status - 整数型

• False 印刷続行

• True 印刷中止

• NoError 0 正常

• StatusError -1 OS 内部エラー

• UserAbort -3 ユーザーがプリントマネージャを使用してジョブを終了

• OutOfDisk -4 スプールに必要なディスク領域不足

• OutOfMemory -5 スプールに必要なメモリ不足

87

6.2　CnView

第

章

第

章

第

章

第

章

２

１

３

第

章６

6.2.3　PageChanged

【名前】

PageChange - 表示ページ変更イベント

【概要】

表示ページが変更された後に発生するイベントです。

【書式】

CnView.PageChanged(sender, e)

【説明】

表示ページが変更された後に発生するイベントです。変更後の表示中ページは CnView.Page プロパティで確認できます。sender[object]

イベントが発生したオブジェクト

e [EventArgs]イベントデータが格納されているクラス

【使用例】

• VB.NET

Private Sub CnView1_PageChanged(ByVal sender As System.Object, ByVal e As Sys-tem.EventArgs) Handles CnView1.PageChanged ’ 処理End Sub

• C#

cnView.PageChanged +=new Hos.CnView.CnView.PageChangedEventHandler(cnView_PageChanged);

private void cnView_PageChanged(object sender, System.EventArgs e){ // 処理}

88

第

章

第

章

第

章

第

章２

１

第２

第 7 章　

プロパティ

85

章

第

章６

　　　

第

章

7.1　プロパティの一覧

第

章

第

章

第

章２

４

第

章４

第

章７


　　属性　R: 読み取り可，W: 書き込み可

タブ　制御 : プロパティページの制御タブにて設定

　　　表示 : プロパティページの表示タブにて設定

CnView

CnPrinters

属性データ型名称概要タブ

R- CnDocument 型 Document CnDocument オブジェクト -

RW 文字列型 DocumentFileName ドキュメントファイル名 -

RW 文字列型 DocumentPath ドキュメントファイル格納ディレクトリ

制御

RW 整数型 Flags オプションフラグ -

RW Color 型 FormFrameColor 用紙枠の色表示

RW Color 型 HardwareOffsetColor 印刷不可領域の色表示

RW 整数型 Page 表示中のページ -

RW ブール型 PreviewAtDesignLayer プレビュー時に編集レイヤ表示

-

RW 整数型 PrintMode 印刷モードの設定制御

RW CnPrinter 型 Printer 出力先のプリンタオブジェクト

-

RW ブール型 ShowFormFrame 用紙枠の表示表示

RW ブール型 ShowHardwareOffset 印刷不可領域の表示表示

RW ブール型 ShowStatusBar ステータスバーの表示表示

RW 長整数型 ShowToolBars ツールバーの表示表示

RW 整数型 Unit 座標系単位指定制御

RW 整数型 ViewScale 拡大縮小率の設定表示

RW 整数型 ViewScaleMode 表示モードの設定表示

RW 文字列型 WorkPath 作業ディレクトリ名制御

属性データ型名称概要

R- 長整数型 Count コレクションに含まれるプリンタ数

87


第

章

第

章

第

章

第

章

２

４

第

章４

第

章７

CnDocument

CnPrinter

R- CnPrinter 型 Item 指定したプリンタオブジェクトの取得


R- 整数型 AllPages ドキュメントファイルの総ページ数

R- 文字列型 DocumentName ドキュメント名


R- 文字列型 BinName 用紙トレイ名

RW 整数型 Collate 複数部数のページ順

RW 整数型 Color カラーモード

RW 整数型 Copies コピー部数

RW 整数型 DefaultSource 用紙トレイ

RW 整数型 Duplex 両面印刷

RW 整数型 Orientation 用紙方向

R- 長整数型 PaperLength 用紙長

R- 文字列型 PaperName 用紙名

RW 整数型 PaperSize 用紙サイズ

R- 長整数型 PaperWidth 用紙幅

RW 整数型 PrintQuality プリンタの解像度

R- 文字列型 PrinterName プリンタ名

RW 長整数型 YResolution 縦方向の解像度

88

第

章

7.2　CnView

第

章

第

章

第

章２

４

第

章４

第

章７

7.2　CnView

7.2.1　Document

【名前】

Document - CnDocument オブジェクト

【概要】

開いている CnDocument オブジェクトを取得します。

【書式】

CnView.Document

【説明】

開いている CnDocument オブジェクトを取得します。開いていないときは、Nothingが返ります。

【設定値】

CnDocument 型

【摘要】

読み取り可

書き込み不可

89

7.2　CnView

第

章

第

章

第

章

第

章

２

４

第

章４

第

章７

7.2.2　DocumentFileName

【名前】

DocumentFileName - ドキュメントファイル名

【概要】

オープンするシーオーリポーツドキュメントのファイル名を設定します。

【書式】

CnView.DocumentFileName

【説明】

オープンするドキュメントファイル名を設定します。ドキュメントファイル名には、絶対パス、相対パス、URL(HTTP,HTTPS のみ ) を指定することができます。

URL を指定した場合には、CnView.DownLoaded イベントを使用してダウンロード

終了ステータスを取得してください。すでに、CnView.DocumentFileName プロパティまたは CnView.OpenDocument メソッ

ドでドキュメントファイルがオープン済みであっても、本プロパティに新たにファイル名を指定した場合は、オープン済みのドキュメントファイルはクローズされ、新しく指定されたドキュメントファイルがオープンされます。

【設定値】

文字列型

【摘要】

読み取り可

書き込み可

90

第

章

7.2　CnView

第

章

第

章

第

章２

４

第

章４

第

章７

7.2.3　DocumentPath

【名前】

DocumentPath - ドキュメントファイル格納ディレクトリ

【概要】

ドキュメントファイルが格納されているディレクトリ名です。

【書式】

CnView.DocumentPath

【説明】

ドキュメントファイルが格納されているディレクトリ名を設定します。初期値はブランクになっています。本プロパティがブランクの時は、本コントロールを使用しているアプリケーション実行時のカレントディレクトリが対象ディレクトリになります。本プロパティは、デザイン時に初期化する事も実行時に値を参照・設定する事も可能です。

本プロパティは、CnView.OpenDocument メソッドまたは CnView.DocumentFileNameプロパティで指定されるドキュメントファイルの検索パスに使用されます。

OpenDocument メソッドの引数および DocumentFileName プロパティにディレクト

リ情報を含まない相対パスでファイルを指定したときのみ、DocumentPath のディレ

クトリが参照されます。

＜例＞DocumentPath に絶対パスを指定し、OpenDocument の引数にディレクトリ情報を

含まない相対パスを指定した場合。

DocumentPath に "C:¥Document" を指定。

CnView.OpenDocument("Cordoc¥Sample.rsx") を指定

この場合、"C:¥Document¥Cordoc¥Sample.rsx" のドキュメントファイルを開きま

す。

＜例＞DocumentPath に URL を指定し、DocumentFileName にファイル名を指定した場

合。

DocumentPath に "http://www.foo.co.jp/" を指定。

CnView.DocumentFileName = "Sample.rsx" を指定

この場合、"http://www.foo.co.jp/Sample.rsx" のドキュメントファイルを開きます。

＜例＞OpenDocument の引数に絶対パスを指定した場合。

91

7.2　CnView

第

章

第

章

第

章

第

章

２

４

第

章４

第

章７


CnView.OpenDocument("D:¥Work¥Sample.rsx") を指定

この場合、"D:¥Work¥Sample.rsx" のドキュメントファイルを開きます。

＜例＞DocumentFileName に URL を指定した場合。


CnView.DocumentFileName = "http://www.foo.co.jp/Sample.rsx" を指定

この場合、"http://www.foo.co.jp/Sample.rsx" のドキュメントファイルを開きます。

【設定値】

文字列型

【摘要】

読み取り可

書き込み可

DocumentPath の指定

DocumentPathには複数のディレクトリを指定する事ができません。指定した場合、ドキュメントファイルオープン時にエラーとなります。

92

第

章

7.2　CnView

第

章

第

章

第

章２

４

第

章４

第

章７

7.2.4　Flags

【名前】

Flags - オプションフラグ

【概要】

オプション動作を設定します。

【書式】

CnView.Flags

【説明】

ビューコントロールのオプション動作を指定します。起動時にはフラグは何も設定されていません。

Unknown

指定なし

PrinterCheck

このフラグを設定した場合、プリンタプロパティの有効チェックを行ないます。プリンタのプロパティを設定する前に、その値が有効であるかどうかを判断します。値が無効であった場合は実行時エラーが発生します。

ShowPrintDialog

このフラグを設定した場合、メインバーの「印刷」ボタンを押下した際に印刷ダイアログが表示されます。

【設定値】

Hos.CnView.ConFlags 列挙型

【摘要】


Unknown 0 指定なし

PrinterCheck 2 プリンタプロパティ有効チェックを行なう

ShowPrintDialog 4 「印刷」ボタン押下時に印刷ダイアログを表示する

読み取り可

書き込み可

93

7.2　CnView

第

章

第

章

第

章

第

章

２

４

第

章４

第

章７

7.2.5　FormFrameColor

【名前】

FormFrameColor - 用紙枠の色

【概要】

用紙枠の線色を設定します。

【書式】

CnView.FormFrameColor

【説明】

ドキュメントファイルで設定されている用紙サイズの枠の色を設定します。色の種類はフルカラー ( 約 1677 万色 ) で設定可能です。Color 型の値を指定します。

【設定値】

Color 型

【摘要】

読み取り可

書き込み可

94

第

章

7.2　CnView

第

章

第

章

第

章２

４

第

章４

第

章７

7.2.6　HardwareOffsetColor

【名前】

HardwareOffsetColor - 印刷不可領域の色

【概要】

印刷不可領域の色を設定します。

【書式】

CnView.HardwareOffsetColor

【説明】

設定されているプリンタの印刷不可領域の色を設定します。色の種類はフルカラー( 約 1677 万色 ) で設定可能です。Color 型の値を指定します。

【設定値】

Color 型

【摘要】

読み取り可

書き込み可

95

7.2　CnView

第

章

第

章

第

章

第

章

２

４

第

章４

第

章７

7.2.7　Page

【名前】

Page - 表示中のページ

【概要】

表示するページを設定します。

【書式】

CnView.Page

【説明】

表示するページを設定します。

【設定値】

整数型

【摘要】

読み取り可

書き込み可

96

第

章

7.2　CnView

第

章

第

章

第

章２

４

第

章４

第

章７

7.2.8　PreviewAtDesignLayer

【名前】

PreviewAtDesignLayer - プレビュー時に編集レイヤ表示

【概要】

プレビュー時に編集レイヤを表示します。

【書式】

CnView.PreviewAtDesignLayer

【説明】

フォームエディタで [ 可視 - 編集時 ] のチェックボックスを [ON] にしたレイヤをプ

レビュー時に表示します。

【設定値】

ブール型

【摘要】

読み取り可

書き込み可

97

7.2　CnView

第

章

第

章

第

章

第

章

２

４

第

章４

第

章７

7.2.9　PrintMode

【名前】

PrintMode - 印刷モードの設定

【概要】

印刷モードを設定します。

【書式】

CnView.PrintMode

【説明】

印刷モードを設定します。初期値は DocumentDefault に設定されています。

[ ドキュメント既定値 ] とはバイナリ、XML ドキュメント内に保存されているプリ

ンタ情報です。

DocumentDefault

ドキュメント内のプリンタ情報より用紙サイズ、用紙方向を反映して印刷します。

AllReflecting

ドキュメント内のプリンタ情報よりプリンタ名以外の設定可能なプロパティをすべて反映して印刷します。

【設定値】

Hos.CnView.ConPrintMode 列挙型

【摘要】


DocumentDefault 0 ドキュメント既定値で印刷

PrinterDefault 1 プリンタ既定値で印刷

AutoScaling 2 プリンタ既定値に自動縮尺して印刷

AutoAdjustment 3 用紙方向をドキュメント既定値に変更して、プリンタ既定値の用紙に自動縮尺して印刷

AllReflecting 4 ドキュメント既定値を全反映して印刷

読み取り可

書き込み可

98

第

章

7.2　CnView

第

章

第

章

第

章２

４

第

章４

第

章７

7.2.10　Printer

【名前】

Printer - 出力先のプリンタオブジェクト

【概要】

出力先に設定されたプリンタオブジェクトです。

【書式】

CnView.Printer

【説明】

出力先に設定されたプリンタオブジェクトが設定されています。

【設定値】

CnPrinter 型

【摘要】

読み取り可

書き込み可

99

7.2　CnView

第

章

第

章

第

章

第

章

２

４

第

章４

第

章７

7.2.11　ShowFormFrame

【名前】

ShowFormFrame - 用紙枠の表示

【概要】

用紙枠の表示を設定します。

【書式】

CnView.ShowFormFrame

【説明】

用紙枠の表示 • 非表示を設定します。

【設定値】

ブール型

【摘要】

• False 非表示

• True 表示

読み取り可

書き込み可

100

第

章

7.2　CnView

第

章

第

章

第

章２

４

第

章４

第

章７

7.2.12　ShowHardwareOffset

【名前】

ShowHardwareOffset - 印刷不可領域の表示

【概要】

印刷不可領域の表示を設定します。

【書式】

CnView.ShowHardwareOffset

【説明】

印刷不可領域の表示 • 非表示を設定します。

【設定値】

ブール型

【摘要】

• False 非表示

• True 表示

読み取り可

書き込み可

101

7.2　CnView

第

章

第

章

第

章

第

章

２

４

第

章４

第

章７

7.2.13　ShowStatusBar

【名前】

ShowStatusBar - ステータスバーの表示

【概要】

ステータスバーの表示を設定します。

【書式】

CnView.ShowStatusBar

【説明】

ステータスバーの表示 • 非表示を設定します。

【設定値】

ブール型

【摘要】

• False 非表示

• True 表示

読み取り可

書き込み可

102

第

章

7.2　CnView

第

章

第

章

第

章２

４

第

章４

第

章７

7.2.14　ShowToolBars

【名前】

ShowToolBars - ツールバーの表示

【概要】

ツールバーの表示を設定します。

【書式】

CnView.ShowToolBars

【説明】

ツールバーの表示を設定します。複数の値を設定する場合は論理和 (Or) で設定するようにしてください。

本プロパティで非表示にしたツールバーは、右クリックメニューで表示・非表示を選択することができなくなります。

【設定値】

Hos.CnView.ConToolBars 列挙型

【摘要】


NoBars 0 何も表示しない

MainBar 1 メインバーを表示

PageBar 2 ページバーを表示

ScaleBar 4 スケールバーを表示

読み取り可

書き込み可

103

7.2　CnView

第

章

第

章

第

章

第

章

２

４

第

章４

第

章７

7.2.15　Unit

【名前】

Unit - 座標系単位指定

【概要】

設定座標の単位を指定します。

【書式】

CnView.Unit

【説明】

設定座標の単位を指定します。初期値は Mm100 に設定されています。

【設定値】

Hos.CnView.ConUnit 列挙型

[ 備考 ]各値は、内部値 (1/1000TWIP 単位 ) を指定された単位に変換し、小数点以下

の値を四捨五入して出力しています。各単位は以下のように変換できます。

1Inch = 25.4mm1TWIP = 1/1440Inch

【摘要】


Mm 0 1mm 単位で設定する

Mm100 1 1/100mm 単位で設定する

Point10 2 1/10Point 単位で設定する

Inch100 3 1/100Inch 単位で設定する

Twip 4 1TWIP 単位で設定する

CPI10 5 1/10CPI(Character Per Inch) 単位で設定する

LPI10 6 1/10LPI(Line Per Inch) 単位で設定する

読み取り可

書き込み可

104

第

章

7.2　CnView

第

章

第

章

第

章２

４

第

章４

第

章７

7.2.16　ViewScale

【名前】

ViewScale - 拡大縮小率の設定

【概要】

拡大縮小率を設定します。

【書式】

CnView.ViewScale

【説明】

拡大縮小率を設定します。ViewScaleMode プロパティが Value に設定されている場

合に、本プロパティに設定した値が反映されます。本プロパティに設定可能な範囲は、7 ～ 500 (％) となっています。

【設定値】

整数型

【摘要】

読み取り可

書き込み可

105

7.2　CnView

第

章

第

章

第

章

第

章

２

４

第

章４

第

章７

7.2.17　ViewScaleMode

【名前】

ViewScaleMode - 表示モードの設定

【概要】

表示モードを設定します。

【書式】

CnView.ViewScaleMode

【説明】

表示モードを設定します。初期値は Value が設定されています。

【設定値】

Hos.CnView.ConScaleMode 列挙型

【摘要】


FitToWidth 0 用紙の幅に合わせて表示

FitToHeight 1 用紙の高さに合わせて表示

FitToWhole 2 用紙全体に合わせて表示

Value 3 ViewScale プロパティの設定値で表示

読み取り可

書き込み可

106

第

章

7.2　CnView

第

章

第

章

第

章２

４

第

章４

第

章７

7.2.18　WorkPath

【名前】

WorkPath - 作業ディレクトリ名

【概要】

作業ディレクトリ名を設定します。

【書式】

CnView.WorkPath

【説明】

ビューコントロールでは、ドキュメントファイルのオープン時にテンポラリファイルを使用します。本プロパティでは、テンポラリファイルを格納するディレクトリ名を設定します。以下の順序で作業ディレクトリ名が決定されます。

1.WorkPath プロパティに設定されているディレクトリ

2. 環境変数 TMP で指定されているディレクトリ

3. 環境変数 TEMP で指定されているディレクトリ

4. カレントディレクトリ

初期値はブランクになっています。本プロパティにブランクおよびルートディレクトリが設定された場合は無視されます。本プロパティへ明示的にカレントディレクトリを設定する場合は "." を指定してください。

本プロパティは、デザイン時に初期化する事も実行時に値を参照・設定する事も可能です。

【設定値】

文字列型

【摘要】

読み取り可

書き込み可

WorkPath と作業ディレクトリの指定

WorkPath には複数のディレクトリを指定する事ができません。指定した場合、ドキュメントファイルオープン時にエラーとなります。作業ディレクトリには、オープンするドキュメントファイルの総ファイルサイズの５倍以上の空き容量があるドライブ上のディレクトリを指定してください。

107

7.3　CnPrinters

第

章

第

章

第

章

第

章

２

４

第

章４

第

章７

7.3　CnPrinters

7.3.1　Count

【名前】

Count - コレクションに含まれるプリンタ数

【概要】

実行時にその環境に登録されているプリンタの数を取得します。

【書式】

CnPrinters.Count

【説明】

実行時にその環境に登録されているプリンタの数を取得します。

【設定値】

長整数型

【摘要】

読み取り可

書き込み不可

108

第

章

7.3　CnPrinters

第

章

第

章

第

章２

４

第

章４

第

章７

7.3.2　Item

【名前】

Item - 指定したプリンタオブジェクトの取得

【概要】

指定したプリンタオブジェクトを取得します。

【書式】

CnPrinters.Item(Index)

【説明】

指定したプリンタオブジェクトを取得します。

Index

数式または文字列式による指定が可能です。必ず指定する必要があります。数式の場合は 0 オリジンで指定します。文字列式の場合は指定するプリンタ

の PrinterName プロパティを指定します。

【設定値】

CnPrinter 型

【サンプルソース】

'CnPrinter型のオブジェクトを宣言します。

Dim objPrm as Hos.CnView.CnPrinter'プリンタコレクションの0番目のプリンタを取得します。

objPrm = CnView1.CnPrinters.Item(0)'"LaserJet 4L"という名前のプリンタを取得します。

Set objPrm = CnView1.CnPrinters.Item("LaserJet 4L")

【摘要】

読み取り可

書き込み不可

109

7.4　CnDocument

第

章

第

章

第

章

第

章

２

４

第

章４

第

章７

7.4　CnDocument

7.4.1　AllPages

【名前】

AllPages - ドキュメントファイルの総ページ数

【概要】

ドキュメントファイルの総ページ数を取得します。

【書式】

CnDocument.AllPages

【説明】

ドキュメントファイルの総ページ数を取得します。

【設定値】

数値型

【摘要】

読み取り可

書き込み不可

110

第

章

7.4　CnDocument

第

章

第

章

第

章２

４

第

章４

第

章７

7.4.2　DocumentName

【名前】

DocumentName - ドキュメント名

【概要】

ドキュメントファイルのドキュメント名を取得します。

【書式】

CnDocument.DocumentName

【説明】

ドキュメントファイルのドキュメント名を取得します。

【設定値】

文字列型

【摘要】

読み取り可

書き込み不可

111

7.5　CnPrinter

第

章

第

章

第

章

第

章

２

４

第

章４

第

章７

7.5　CnPrinter

CnPrinter オブジェクトの各プロパティを設定する場合は、設定を行なうプリンタ ( プリンタドライバ ) がそのプロパティをサポートしていることを確認した上で、設定を

行なってください。プリンタ ( プリンタドライバ ) がサポートしていないプロパティに

対して設定を行なった場合は、設定は反映されません。

プリンタの機能の確認

弊社では、各プリンタがどのプロパティに対応しているかを確認するためのツールとして「プリンタ情報取得ツール」を提供しています。この「プリンタ情報取得ツール」を利用することで、各プリンタの設定可能なプロパティおよび設定可能な値を確認することができます。

「プリンタ情報取得ツール」は以下の方法で起動することができます。

《起動方法》1． Windows タスクバーの【スタート】ボタンをクリックし、[ プログラ

ム ] を選択します。

2．サブメニューが表示されますので、シーオーリポーツのインストール

時に「プログラムフォルダの選択」でインストール先に指定したフォ

ルダ（デフォルトでは「CoReports for .NET」）を選択します。

3．サブメニューから [ ツール ] を選択し、[ プリンタ情報取得ツール ] を

クリックします。

図 7-1 「プリンタ情報取得ツール」 Ver.1.1 の画面

112

第

章

7.5　CnPrinter

第

章

第

章

第

章２

４

第

章４

第

章７

7.5.1　BinName

【名前】

BinName - 用紙トレイ名称

【概要】

用紙トレイの名前を取得します。

【書式】

CnPrinter.BinName

【説明】

現在選択されている用紙トレイの名前を取得します。

【設定値】

文字列型

【摘要】

読み取り可

書き込み不可

113

7.5　CnPrinter

第

章

第

章

第

章

第

章

２

４

第

章４

第

章７

7.5.2　Collate

【名前】

Collate - 複数部数のページ順

【概要】

複数部数のページ順を設定します。

【書式】

CnPrinter.Collate

【説明】

複数部数のページ順を設定します。プロパティの設定値が無効な値の場合やプリンタドライバがサポートしていない場合、CnView.Flags プロパティによって設定された値により本コントロールの動作

が変わります。CnView.Flags プロパティに PrinterCheck が設定されている場合は、プリンタのプロ

パティを設定する前に、その値が有効であるかどうかを判断します。値が無効であった場合は実行時エラーが発生します。

【設定値】

Hos.CnView.ConCollate 列挙型

【摘要】


False 0 ページ順に揃えない

True 1 ページ順に揃える

読み取り可

書き込み可

114

第

章

7.5　CnPrinter

第

章

第

章

第

章２

４

第

章４

第

章７

7.5.3　Color

【名前】

Color - カラーモード

【概要】

カラーモードを設定します。

【書式】

CnPrinter.Color

【説明】

カラープリンタで印刷を行なう場合に、カラーで印刷するかモノクロで印刷するかを設定します。プロパティの設定値が無効な値の場合やプリンタドライバがサポートしていない場合、CnView.Flags プロパティによって設定された値により本コントロールの動作



【設定値】

Hos.CnView.ConColorMode 列挙型

【摘要】


Monochrome 1 モノクロ

Color 2 カラー

読み取り可

書き込み可

115

7.5　CnPrinter

第

章

第

章

第

章

第

章

２

４

第

章４

第

章７

7.5.4　Copies

【名前】

Copies - コピー部数

【概要】

コピー部数を設定します。

【書式】

CnPrinter.Copies

【説明】

コピー部数を設定します。プロパティの設定値が無効な値の場合やプリンタドライバがサポートしていない場合、CnView.Flags プロパティによって設定された値により本コントロールの動作



【設定値】

整数型

【摘要】

読み取り可

書き込み可

116

第

章

7.5　CnPrinter

第

章

第

章

第

章２

４

第

章４

第

章７

7.5.5　DefaultSource

【名前】

DefaultSource - 用紙トレイ

【概要】

用紙トレイを設定します。

【書式】

CnPrinter.DefaultSource

【説明】

用紙トレイは出力先のプリンタのサポートしている用紙トレイを設定してください。プロパティの設定値が無効な値の場合やプリンタドライバがサポートしていない場合、CnView.Flags プロパティによって設定された値により本コントロールの動作



【設定値】

整数型

【摘要】

読み取り可

書き込み可

117

7.5　CnPrinter

第

章

第

章

第

章

第

章

２

４

第

章４

第

章７

7.5.6　Duplex

【名前】

Duplex - 両面印刷

【概要】

両面印刷モードを設定します。

【書式】

CnPrinter.Duplex

【説明】

両面印刷モードを設定します。プロパティの設定値が無効な値の場合やプリンタドライバがサポートしていない場合、 CnView.Flags プロパティによって設定された値により本コントロールの動作



【設定値】

Hos.CnView.ConDuplex 列挙型

【摘要】


Simplex 1 なし ( 片面印刷 )

Vertical 2 上下に見開き印刷

Horizonal 3 左右に見開き印刷

読み取り可

書き込み可

118

第

章

7.5　CnPrinter

第

章

第

章

第

章２

４

第

章４

第

章７

7.5.7　Orientation

【名前】

Orientation - 用紙方向

【概要】

プリンタの用紙方向を設定します。

【書式】

CnPrinter.Orientation

【説明】

用紙方向を設定する場合に使用します。

※ ActiveX コントロールでは CnView.Flags プロパティに PrinterCheck を設定するこ

とで、本プロパティの設定値の有効判定が可能でした。しかし、ユーザコントロールでは仕様変更により、本プロパティでの有効確認が行なえません。

【設定値】

Hos.CnView.ConOrientation 列挙型

【摘要】


Vertical 1 縦

Horizontal 2 横

読み取り可

書き込み可

119

7.5　CnPrinter

第

章

第

章

第

章

第

章

２

４

第

章４

第

章７

7.5.8　PaperLength

【名前】

PaperLength - 用紙長

【概要】

用紙長を取得します。

【書式】

CnPrinter.PaperLength

【説明】

用紙長を取得する場合に使用します。本プロパティの値の表示は、CnView.Unit で設定された単位で行ないます。

なお、用紙サイズの変更は「7 . 5 . 1 0 P a p e r S i z e」（P. 1 2 2）もしくは「5 . 5 . 1SetCustomPaperSize」（P.79）にて行なってください。


とで、本プロパティの設定値の有効判定が可能でした。しかし、ユーザコントロールでは仕様変更により値の設定が不可となったため、本プロパティでの有効確認が行なえません。

【設定値】

整数型

【摘要】

読み取り可

書き込み不可

120

第

章

7.5　CnPrinter

第

章

第

章

第

章２

４

第

章４

第

章７

7.5.9　PaperName

【名前】

PaperName - 用紙名

【概要】

用紙名を取得します。

【書式】

CnPrinter.PaperName

【説明】

プリンタドライバによって定義されている用紙名を取得する場合に使用します。

【設定値】

文字列型

【摘要】

読み取り可

書き込み不可

121

7.5　CnPrinter

第

章

第

章

第

章

第

章

２

４

第

章４

第

章７

7.5.10　PaperSize

【名前】

PaperSize - 用紙サイズ

【概要】

用紙サイズを設定します。

【書式】

CnPrinter.PaperSize

【説明】

用紙番号による用紙サイズ変更を行ないます。関連するプロパティの優先度は備考の「プロパティの優先度」を参照してください。

【設定値】

Hos.CnView.ConPaperSize 列挙型


Letter 1 Letter 8 1/2 × 11 インチ

Lettersmall 2 Letter Small 8 1/2 × 11 インチ

Tabloid 3 Tabloid 11 × 17 インチ

Ledger 4 Ledger 17 × 11 インチ

Legal 5 Legal 8 1/2 × 14 インチ

Statement 6 Statement 5 1/2 × 8 1/2 インチ

Executive 7 Executive 7 1/4 × 10 1/2 インチ

A3 8 A3 シート 297 × 420mm

A4 9 A4 シート 210 × 297mm

A4small 10 A4 Small シート 210 × 297mm

A5 11 A5 シート 148 × 210mm

B4 12 B4 シート 250 × 354mm

B5 13 B5 シート 182 × 257mm

Folio 14 Folio 8 1/2 × 13 インチ

Quarto 15 Quarto 215 × 275mm

122

第

章

7.5　CnPrinter

第

章

第

章

第

章２

４

第

章４

第

章７

Sheet10X14 16 10×14インチシート 10 × 14 インチ

Sheet11X17 17 11×17インチシート 11 × 17 インチ

Note 18 Note 8 1/2 × 11 インチ

Env9 19 #9 Envelope 3 7/8 × 8 7/8 インチ

Env10 20 #10 Envelope 4 1/8 × 9 1/2 インチ

Env11 21 #11 Envelope 4 1/2 × 10 3/8 インチ

Env12 22 #12 Envelope 4 3/4 × 11 インチ

Env14 23 #14 Envelope 5 × 11 1/2 インチ

CSheet 24 C シート 17 × 22 インチ

DSheet 25 D シート 22 × 34 インチ

ESheet 26 E シート 34 × 44 インチ

EnvDL 27 DL Envelope 110 × 220mm

EnvC5 28 C5 Envelope 162 × 229mm





EnvB4 33 B4 Envelope 250 × 353mm



EnvItaly 36 Italy Envelope 110 × 230mm

EnvMonarch 37 Monarch Envelope 3 7/8 × 7 1/2 インチ

EnvPersonal 38 Personal Envelope 3 5/8 × 6 1/2 インチ

FanfoldUS 39 US Std Fanfold 14 7/8× 11 インチ

FanfoldStdGerman 40 German Std Fanfold 8 1/2 × 12 インチ

FanfoldLglGerman 41 German Lefal Fanfold 8 1/2 × 13 インチ

PostCard 43 はがき 100 × 148mm

User 256 ユーザ定義サイズ

123

7.5　CnPrinter

第

章

第

章

第

章

第

章

２

４

第

章４

第

章７

【摘要】

読み取り可

書き込み可

124

第

章

7.5　CnPrinter

第

章

第

章

第

章２

４

第

章４

第

章７

7.5.11　PaperWidth

【名前】

PaperWidth - 用紙幅

【概要】

用紙幅を取得します。

【書式】

CnPrinter.PaperWidth

【説明】

用紙幅を取得する場合に使用します。本プロパティの値の表示は、CnView.Unit で設定された単位で行ないます。

なお、用紙サイズの変更は「7 . 5 . 1 0 P a p e r S i ze」（P. 1 2 2）もしくは「5 . 5 . 1SetCustomPaperSize」（P.79）にて行なってください。



【設定値】

整数型

【摘要】

読み取り可

書き込み不可

125

7.5　CnPrinter

第

章

第

章

第

章

第

章

２

４

第

章４

第

章７

7.5.12　PrintQuality

【名前】

PrintQuality - プリンタの解像度

【概要】

プリンタの横方向の解像度を設定します。

【書式】

CnPrinter.PrintQuality

【説明】

PrintQuality プロパティに正の値が設定されると、インチ当たりのドット数 (DPI) を指定したことになります。プロパティの設定値が無効な値の場合やプリンタドライバがサポートしていない場合、CnView.Flags プロパティによって設定された値により本コントロールの動作



【設定値】

整数型

【摘要】

• High -4 高解像度

• Medium -3 中解像度

• Low -2 低解像度

• Draft -1 下書きモード

読み取り可

書き込み可

126

第

章

7.5　CnPrinter

第

章

第

章

第

章２

４

第

章４

第

章７

7.5.13　PrinterName

【名前】

PrinterName - プリンタ名

【概要】

プリンタの名称を取得します。

【書式】

CnPrinter.PrinterName

【説明】

プリンタの名称を取得します。

【設定値】

文字列型

【摘要】

読み取り可

書き込み不可

127

7.5　CnPrinter

第

章

第

章

第

章

第

章

２

４

第

章４

第

章７

7.5.14　YResolution

【名前】

YResolution - 縦方向の解像度

【概要】

プリンタの縦方向の解像度を取得します。

【書式】

CnPrinter.YResolution

【説明】

インチ当たりのドット数 (DPI)で取得する場合に取得します。



【設定値】

整数型

【摘要】

読み取り可

書き込み不可

128

第

章

第

章

第

章

第

章２

１

索　引

131

索引

第

章

第

章

第

章

第

章

２

１

索

引

AAboutBox ........................... 55AllPages ........................... 110AutoAddForm........................ 89

BBinName........................... 113

CCLASSID ........................... 21ClickOnce............................ 6CloseDocument ...................... 56

CnDocument オブジェクト ............ 89Collate............................. 114Color.............................. 115Copies............................. 116Count ............................. 108

DDefaultSource....................... 117Document ........................... 89DocumentFileName ................... 90DocumentName ..................... 111DocumentPath ....................... 91DownLoaded ........................ 84Duplex ............................ 118

FFindNext............................ 57FirstPage............................ 59Flags ............................... 93FormFrameColor ..................... 94

GGetOffsertX ......................... 73GetOffsertY ......................... 75GetPrintPage......................... 77

HHardwareOffsetColor .................. 95Hos.CnView.dll ....................... 7Hos.Common.dll....................... 7HTTP .............................. 23HTTPS ............................. 23

13

IItem .............................. 109

LLastPage ............................ 60

NNextPage ........................... 61

OOBJECT タグ ....................... 21OpenBase64Document................. 63OpenDocument ...................... 62Orientation ......................... 119

PPage ............................... 96PageChanged ........................ 88PaperLength ........................ 120PaperName ......................... 121PaperSize .......................... 122PaperWidth......................... 125

PARAM タグ................... 22, 23PreviewAtDesignLayer ................ 97PreviousPage ........................ 64Printer.............................. 99PrinterName ........................ 127Printing........................ 86, 88PrintMode........................... 98PrintOut ............................ 65PrintQuality ........................ 126

SSetCustomPaperSize .................. 79SetOffsetX .......................... 74SetOffsetY .......................... 76SetPrintPage ......................... 78ShowFindSetup ...................... 70ShowFormFrame .................... 100ShowHardwareOffset................. 101ShowPageSetup ................. 71, 72ShowPrinterSetup................ 71, 72ShowStatusBar ...................... 102ShowToolBars ...................... 103

2

第

章

索引

第

章

第

章

第

章２

１

索

引

UUnit ...............................104URL................................23

VViewScale ..........................105ViewScaleMode .....................106

WWorkPath...........................107

YYResolution.........................128

い印刷経過イベント............... 86, 88印刷中の経過メッセージ..............20印刷不可領域の色....................95印刷不可領域の表示.................101印刷ボタン..........................33印刷モードの設定....................98

おオートメーションオブジェクト........30オブジェクト階層.....................9オブジェクトの描画の違い............43

塗りつぶしパターンの描画 .........43プロポーショナルフォント(等幅フォント

) のフォント幅変更時 ......44オプションフラグ....................93オフセット

縦方向 ...................... 75, 76横方向 ...................... 73, 74

か拡大縮小率コンボボックス............38拡大縮小率の設定...................105カスタマイズ........................15画面サイズに合わせるボタン..........38カラーモード.......................115

け検索ダイアログの表示................70

次の単語の検索 ...................57前の単語の検索 ...................58

こ

さ

し

す

せ

そ

た

つ

と

13

コピー部数........................ 116コントロールの仕様変更............. 43

最終ページへの移動................. 60最終ページボタン................... 36再描画処理......................... 67作業ディレクトリ名................ 107座標系単位指定.................... 104参照設定の確認..................... 14

次ページへの移動................... 61次ページボタン..................... 36出力先のプリンタオブジェクト....... 99

スケールバー....................... 38ステータス......................... 39ステータスバー..................... 39ステータスバーの表示.............. 102

先頭ページへの移動................. 59先頭ページボタン................... 36前ページへの移動................... 64前ページボタン..................... 36

ソフトウェア使用許諾および制限...... 7

ダウンロード終了イベント........... 84縦に合わせるボタン................. 38縦方向オフセット...............75, 76縦方向の解像度.................... 128

ツールバーの表示.................. 103

ドキュメントパスの利用............. 17ドキュメントファイル

3

索引

第

章

第

章

第

章

第

章

２

１

索

引

印刷............................. 65オープン処理................ 62, 63格納ディレクトリ................. 91クローズ処理..................... 56総ページ数...................... 110ドキュメントファイル.......... 4, 6ドキュメントファイル名........... 90

ドキュメント名 .................... 111

のノータッチデプロイメント ............ 6ノータッチデプロイメントでの利用 ... 25

インターネットオプションの変更... 28セキュリティ設定の変更........... 25

はバージョン情報ダイアログ表示処理 ... 55配布 ................................ 7

ひ必要システム ........................ 8ビューコントロール .................. 3ビューコントールの位置付け .......... 3ビューコントロールの外観の設定

インターネットでの利用........... 22スタンドアロンでの利用........... 15

ビューコントロールの貼り付けインターネットでの利用........... 21スタンドアロンでの利用........... 13

ビューコントロールの利用 ............ 5表示するドキュメントファイルの指定

スタンドアロンでの利用........... 17インターネットでの利用........... 23

表示中のページ ..................... 96表示モードの設定 .................. 106

ふ複数部数のページ順 ................ 114ブラウザの設定 ..................... 21プリンタオブジェクトの取得 ........ 109プリンタ情報取得ツール ............ 112プリンタ数 ........................ 108プリンタの解像度 .................. 126プリンタ名 ........................ 127プレビュー時に編集レイヤ表示 ....... 97プロパティの変更点 ................. 46

13

へページ毎の印刷指定フラグ取得 ....... 77ページ毎の印刷指定フラグ設定 ....... 78ページステータス ................... 39ページの移動ボタン

インターネットでの利用........... 24スタンドアロンでの利用........... 18

ページの設定ダイアログ表示 .... 71, 72ページバー ......................... 36ページ番号 ......................... 36ページ番号と印刷許可 ............... 34

めメインバー ......................... 33メソッドの変更点 ................... 45

ゆユーザ定義サイズの設定 ............. 79

よ用紙サイズ ........................ 122用紙サイズ（ファイルを開くときの既存値）

34用紙設定ステータス ................. 39用紙長 ............................ 120用紙トレイ ........................ 117用紙トレイ名称 .................... 113用紙幅 ............................ 125用紙方向 .......................... 119用紙名 ............................ 121用紙枠の色 ......................... 94用紙枠の表示 ...................... 100横に合わせるボタン ................. 38横方向オフセット取得 ............... 73横方向オフセット設定 ............... 74

り両面印刷 .......................... 118

4

第

章

索引

第

章

第

章

第

章２

１

索

引

13
5

索引

第

章

第

章

第

章

第

章

２

１

索

引

13
6

Documents

シーオーリポーツ - 株式会社エイチ・オー・エス...Hos.CxCommon.dll シーオーリポーツ for .NET 共通ライブラリ 配布について 詳しい配布条件については、パッケージ添付の「使用許諾契約書」

シーオーリポーツ - 株式会社エイチ・オー・エス...Hos.CxCommon.dll シーオーリポーツ for .NET 共通ライブラリ配布について詳しい配布条件については、パッケージ添付の「使用許諾契約書」