expPDFw

内容

1 メニュー情報
2 概要
3 追加の情報
4 コマンドラインでの使用法
5 変数
6 説明
1. 6.1 ダイアログ設定の詳細
7 サンプル
8 関連のXファンクション

メニュー情報

ファイル：エクスポート：マルチページPDF形式で...

概要

ワークシートを複数ページのPDFファイルとしてエクスポートします。

追加の情報

必要なOriginのバージョン:8.1SR0

コマンドラインでの使用法

1. expPDFw export:=book filename:=<Long Name> path:="C:\My PDF Files" overwrite:=ask;

2. expPDFw export:=active filename:="<long name>" path:=D:\ overwrite:=ask tr2.PDF.pdf.ColorTranslation:=0. tr2.PDF.pdf.LineMode:=0.tr2.PDF.Compression.ClrImageCompression:=0. tr2.MultiPage.CoverPage.Text:="My Report" tr3.Check.Chk_Horz_Grids:=0. tr3.Check.Chk_Vert_Grids:=0. tr3.Check.Chk_Frame:=33554432.;

変数

表示名	変数名	I/O とデータ型	デフォルト値	説明
シートを選択	export	入力 int	0	この変数は、エクスポートするページを指定するのに使用します。デフォルトは現在のシートです。オプションリスト active:現在のシート現在のワークシートがエクスポートされます。 book:ブック中のシートアクティブワークブック内のすべてのワークシートがエクスポートされます。 folder:フォルダ中のシート現在のフォルダ内のすべてのワークシートがエクスポートされますが、サブフォルダ内のシートは含まれません。 recursive:フォルダ中のシート(サブフォルダ適用) サブフォルダ内のシートを含み、現在のフォルダ内のすべてのワークシートがエクスポートされます。 project: プロジェクト中のシートプロジェクト内のすべてのワークシートがエクスポートされます。 Specified:特定ワークシートテキストボックス内で指定したワークシートをエクスポートします。
ワークシート	pages	入力 string	<active>	エクスポートするワークシートを一覧表示します。エクスポートドロップダウンリストで、特定が選択されている場合に、このフィールドが編集可能になります。また、参照ボタンが利用可になります。参照ボタンをクリックして、プロジェクトブラウザシートダイアログを開き、エクスポートするワークシートを選択します。
ファイル名	filename	入力 string		エクスポートするPDFファイルの名前を指定します。以下のオプションがあります。 <ロングネーム> グラフページのロングネームをファイル名として使います。 <ショートネーム> グラフページのショートネームをファイル名として使います。＜シート名＞シート名のショートネームをファイル名として使います。 wks## "wks + インデックス"をファイル名として使います。 wks<pound># "wks# + インデックス"と"#"の文字(<pound>で表現される)をファイル名とします。 Note: ファイル名はキーワードの組み合わせをサポートしています。例えば、「<ロングネーム>-multi」では、ワークシートのロングネームと文字列-multi がエクスポートするファイル名になります。 "#" を表す <pound> は、グラフインデックスの抱き合わせ以外にも使用できます。例えば、ファイル名を、Wks<pound>2 とすると、表示ファイル名はWks#2 になります。上記3つのオプションの1つから選択するだけでなく、目的のファイル名をキーボードから入力することもできます。
パス	path	入力 string		エクスポートされるPDFファイルを保存するファイルパス
上書き	overwrite	入力 int	3	同じパスに同じ名前を持つファイルが既に存在している場合のPDFファイルをエクスポートする方法を指定します。オプションリスト rename:自動名前変更エクスポートするPDFに番号を付けて自動的に名前を変更します。 replace:置換え既存のPDFファイルを上書きして置き換えます。 skip:スキップ PDFファイルのエクスポートを避け、既存のファイルをそのままにします。 ask:尋ねるメッセージボックスを表示し、既存のPDFファイルを上書きするかどうかを尋ねます。
画像の設定	tr2	入力 TreeNode	<unassigned>	エクスポートしたPDFファイルのプロパティを指定します。詳細は、説明セクションのダイアログ設定の詳細をご覧下さい。
印刷設定	tr3	入力 TreeNode	<unassigned>	エクスポートするPDFファイルの印刷設定を指定します。詳細は、説明セクションのダイアログ設定の詳細をご覧下さい。

説明

このXファンクションは、画像または埋込/リンクグラフを含むワークシートを複数ページのPDFファイルにエクスポートするのに使用されます。

Note:

レポートシートはPDFファイルにエクスポートできません。
ワークシートは大きすぎる場合、1つのPDFファイルの複数ページにエクスポートします。

ダイアログ設定の詳細

画像の設定 (tr2)

ツリーノード	ラベル	データ型	デフォルト	説明
PDF	PDFオプション	入力 TreeNode	<unassigned>	このツリーノードは、PDFファイルのエクスポート設定を指定するのに使われます。詳細は、下記のPDFオプションサブツリーの表をご覧下さい。
MultiPage	複数ページ	入力 TreeNode	<unassigned>	このツリーノードは、複数ページを含むPDFをエクスポートするときに、カバーページとページ番号を指定するのに使われます。詳細は、下記の複数ページサブツリーの表をご覧下さい。

PDFオプションサブツリー

ツリーノード	ラベル	データ型	デフォルト	説明
PDF	基本オブジェクト	入力 TreeNode	<unassigned>	PDFの基本オブジェクトを参照してください。
Compressiontree	データ圧縮	入力 TreeNode	<unassigned>	PDFの圧縮を参照してください。
Fonts	フォント	入力 TreeNode	<unassigned>	PDFのフォントを参照して下さい。

複数ページサブツリー

エクスポートしたPDFファイルにカバーページとページ番号を追加するかどうかを指定します。

ツリーノード	ラベル	データ型	デフォルト	説明
CoverPage	カバーページ	入力 TreeNode	<unassigned>	これはカバーページの右にあるチェックボックスにチェックを付けた場合のみ利用できます。エクスポートしたPDFファイルにカバーページを追加するかどうかを指定します。デフォルトで、カバーページはなしです。このブランチ内のツリーノードは、以下の通りです。(下記は、コロンの前のてきすとがツリーノード名で、コロンの後のテキストはツリーノードのラベルです。) Text:テキストこのテキストフィールドに入力するテキストがカバーページに表示されます。 Font:フォントこのブランチはカバーページテキストのフォントをセットするのに使います。 Name:名前テキストのフォント名を指定します。 Size:サイズテキストのフォントサイズを選択または入力します。デフォルトサイズは18です。 Bold:太字テキストを太字にするかどうかを指定します。このチェックボックスはデフォルトで、選択されています。 Italic:斜体テキストを斜体にするかどうかを指定します。このチェックボックスはデフォルトで、選択されています。 Underline:下線テキストに下線を追加するかどうかを指定します。このチェックボックスはデフォルトで、選択されています。
Pagination	ページ番号付け	入力 TreeNode	<unassigned>	ページ番号付けの右側にあるチェックボックスにチェックが付いているときのみ、開くことができます。エクスポートしたPDFファイルにページ番号を追加するかどうかを指定します。デフォルトで、ページ番号の追加は無しです。エクスポートするPDFがカバーページを含む場合、カバーページを最初のページと見なしますが、ページ番号はカバーページに表示しません。このブランチ内のツリーノードは、以下の通りです。(下記は、コロンの前のてきすとがツリーノード名で、コロンの後のテキストはツリーノードのラベルです。) FontP:フォントこのブランチはページ番号のフォントをセットするのに使います。 Name:名前ページ番号のフォント名を指定します。 Size:サイズページ番号のフォントサイズを選択または入力します。デフォルトサイズは18です。 Bold:太字ページ番号を太字にするかどうかを指定します。このチェックボックスはデフォルトで、選択されています。 Italic:斜体ページ番号を斜体にするかどうかを指定します。このチェックボックスはデフォルトで、選択されています。 Underline:下線ページ番号に下線を追加するかどうかを指定します。このチェックボックスはデフォルトで、選択されています。 Top:上エクスポートするPDFファイル内のページの上にページ番号を追加するかどうかを指定します。このチェックボックスはデフォルトで、選択されています。 Bottom:下エクスポートするPDFファイル内のページの下にページ番号を追加するかどうかを指定します。このチェックボックスはデフォルトで、選択されています。 HorizPos:水平位置ページ番号の水平位置を指定します。上および下の両方ともチェックが付いてない場合、PDFファイルにページ番号が無いので、ここで指定した水平位置は無効となります。以下のオプションがあります。 0:偶数ページを左、奇数ページを右ページ番号は、偶数ページに対して左に表示され、奇数ページに対して右に表示されます。 1:左すべてのページに対してページ番号は左に表示されます。 2:右すべてのページに対してページ番号は右に表示されます。 3:中央すべてのページに対してページ番号は中央に表示されます。これはデフォルトの選択です。

印刷設定 (tr3)

ツリーノード	ラベル	データ型	デフォルト	説明
UseOwn	ワークシート自身の設定を使う	入力 int	1	エクスポートするPDFファイルを印刷するのに、ワークシート自体の設定(水平グリッド、行ヘッダの設定など)を使うかどうかを指定します。選択されていない場合に、ワークシート印刷オプションブランチ内のオプションを指定することができます。
Check	ワークシート印刷オプション	入力 TreeNode	<unassigned>	これは、ワークシート自身の設定を使うがチェックされていないときのみ利用できます。このツリーノードは、いくつかのワークシート要素を印刷するかどうか指定するのに使うことができます。詳細は、下記のワークシート印刷オプションサブツリーの表をご覧下さい。
Margin	余白	入力 TreeNode	<unassigned>	これは、ワークシート自身の設定を使うがチェックされていないときのみ利用できます。このツリーノードは余白を指定するのに使うことができます。余白に対して、2つの単位、mmとインチを利用できます。詳細は、下記のワークシート印刷オプションサブツリーの表をご覧下さい。

ワークシート印刷オプションサブツリー

ツリーノード	ラベル	データ型	デフォルト	説明
Chk_Horz_Grids	水平グリッド	入力 int	0	PDFファイルに水平グリッドを出力するかどうかを指定します。
Chk_Vert_Grids	垂直グリッド	入力 int	0	PDFファイルに垂直グリッドを出力するかどうかを指定します。
Chk_Row_header	行ヘッダ	入力 int	0	PDFファイルに行ヘッダを出力するかどうかを指定します。
Chk_Col_header	列ヘッダ	入力 int	0	PDFファイルに列ヘッダを出力するかどうかを指定します。
Chk_Page_header	ページヘッダ	入力 int	0	PDFファイルにページヘッダを出力するかどうかを指定します。
Chk_Page_Footer	ページフッタ	入力 int	0	PDFファイルにページフッタを出力するかどうかを指定します。
Chk_BkColor	背景色	入力 int	1	PDFファイルに背景色を出力するかどうかを指定します。
Chk_Frame	枠	入力 int	1	PDFファイルに枠を出力するかどうかを指定します。
Chk_EmptyCols	空列	入力 int	0	PDFファイルに空白列を出力するかどうかを指定します。
Chk_EmptyRows	空行	入力 int	0	PDFファイルに空白行を出力するかどうかを指定します。

余白サブツリー

ツリーノード	ラベル	データ型	デフォルト	説明
Left	左	入力 Double	6.35	左余白を指定します。
Right	右	入力 Double	6.35	右余白を指定します。
Top	上	入力 Double	6.35	上余白を指定します。
Bottom	下	入力 Double	6.35	下余白を指定します。

サンプル

新しいプロジェクトを作成し、メインメニューからファイル：インポート：カンマ区切りファイル (CSV)... を選択して <Origin プログラムディレクトリ>\Samples\Import and Export\donations.csv をインポートします。
データがインポートされたワークシートをアクティブにし、ファイル：エクスポート：マルチページPDF形式で...を選び、expPDFwダイアログを開きます。
ダイアログで、ファイル名をdonationsにし、パスを C:\My PDF Filesにします。画像の設定ブランチにある複数ページブランチで、カバーページにあるチェックボックスを選択し、このブランチを広げます。テキストフィールドにDonations と入力し、フォントサイズを72に変更します。その他のオプションはデフォルト値のままにします。
OK ボタンをクリックします。すると、donations.pdf という名前のPDFがC:\My PDF Filesフォルダにエクスポートされます。