-
はじめに
-
JPedalを実行する
-
JPedalの使い方
-
機能
-
JPedal Viewer
- JPedalのBase ViewerでPDFを見る
- カスタマイズ可能なビューアでのPDFファイルを表示する
- JavaのコードからPDF Viewerの機能にアクセス
- Java PDF Viewerでユーザーインターフェイスをカスタマイズ
- ビューアにオブジェクトを描画
- JavaアプリケーションにPDFビューアを追加する方法
- ビューアの機能をカスタマイズする
- JPedalインスペクタでPDFファイルの内容を検査
- PDFビューアの通知ポップアップを独自のものに置き換える
- JPedal のアクセシビリティオプション
- Java PDF Viewerを使ってポートフォリオファイルを表示
- Java PDF Viewerでテキストを選択
- JPedal ViewerはJavaFXで使用できますか?
- JPedal ViewerはSWTで使用できますか?
- JPedal ビューアでダークモードを設定する
- 線の太さを非表示にする
- すべての記事を表示 ( 1 ) 記事を折り畳む
-
テキスト関連
-
画像への変換
-
画像の抽出
-
PDF画像変換のWebサービスAPI
-
フォームについて
-
PDFの注釈(アノテーション)
-
PDFの操作
-
印刷について
-
メタデータ
-
フォントについて
-
JPedalをクラウド上で実行する
-
アップデート情報
JavaのコードからPDF Viewerの機能にアクセス
PDF Viewerコンポーネントを統合した後、独自のJavaコードからその機能にアクセスしたいと思うかもしれません。このセクションでは、その方法を説明します。
PDF Viewerには、Viewerの機能にアクセスしたり、Viewerから情報を取得したりするための2つのメソッドがあります。
ビューアからの情報の取得
現在のページ/表示に関する情報を取得するには、以下のメソッドを使用します。
Object Viewer.getViewerValue(ViewerValues) – このメソッドを表示します。 ViewerValues を入力として、以下の値を返すことができます。
- ViewerValues.CURRENTPAGE – 現在のページの整数値を返します。
- ViewerValues.PAGECOUNT – 合計ページ数を整数で返します。
- ViewerValues.PDFNAME – PDF ファイル名を表す文字列を返します。
- ViewerValues.SCALE – スケール倍率を Float で表します (1 を 100% とします)。
- ViewerValues.ROTATION – 表示上の現在のページの位置を整数で返します。
- ViewerValues.PAGELAYOUT – 下記の値を用いてページレイアウトを表す整数を返します。
- Display.SINGLE_PAGE = 1
- Display.CONTINUOUS = 2
- Display.CONTINUOUS_FACING = 3
- Display.FACING = 4
- Display.PAGEFLOW = 5
- Display.PORTFOLIO_DETAIL = 6
- Display.PORTFOLIO_TILE = 7
ビューア機能へのアクセス
ビューア機能は以下の方法で実行できます。
Object Viewer.executeCommand(ViewerCommands command, Object… args) – このメソッドを表示.
このメソッドは、実行する機能を指定するためにViewerCommandsのenumを使用し、特定のメソッドが完全なカスタマイズのためにそれを必要とする場合、Object…は入力引数を指定します。
返される Object は、指定されたコマンドから返される可能性のあるものすべてを返します。特に記述がない限り、この値はNULLになります。これは、PDFの読み込みや印刷などに独自のポップアップウィンドウを使用したい場合に便利です。
ファイルを開く/閉じる
ViewerCommands.OPENFILE
指定したPDFを開くか、PDFを選択するダイアログを開きます。
入力値
このメソッドの各呼び出しは、以下のいずれかのタイプの値を受け取ることができます。
- PDFの絶対ファイル名を表す文字列。
- PDFのFileオブジェクト。
- PDFファイルの内容を含むInputStream。
- PDFの内容を含むbyte[]とPDFファイル名を示すString。
- 入力がない場合、代わりにPDFを選択するダイアログを開きます。
出力値 None
ViewerCommands.OPENURL
指定されたURLからPDFを開くか、URLを入力するダイアログを開きます。
入力値
このメソッドの各呼び出しは、以下のいずれかのタイプの値を受け取ることができます。
- PDFを指すURLを表す文字列。
- 入力しない場合は、代わりにURLを入力するダイアログを開きます。
出力値 None
ViewerCommands.PREVIOUSDOCUMENT
最後に開いたドキュメントを開きます。このコマンドは、[ファイル] メニューの [最近開いたファイル] リストから実行できます。
入力値 None
出力値 None
ViewerCommands.NEXTDOCUMENT
次に開くドキュメントを開きます。これは、ViewerCommands.PREVIOUSDOCUMENTの後に使用すると、前に表示した文書に戻ることができます。
入力値 None
出力値 None
ViewerCommands.EXIT
ビューアを閉じます。Viewer には Viewer.exitOnClose フラグがあります。これがtrueの場合、ViewerはSystem.exit(1)を呼び出し、JVMをシャットダウンします。
入力値 None
出力値 None
ページ・ナビゲーション
ViewerCommands.FORWARDPAGE
指定されたページ数だけ先に進みます。
入力値 このメソッドの各呼び出しは、以下のいずれかのタイプの値を受け取ることができます。
- ページ数を指定する文字列。
- 次のページに移動する場合は None (現在のページを 1 ページ増やす)。
出力値 None
ViewerCommands.FFORWARDPAGE
10ページ進む
入力値 None
出力値 None
ViewerCommands.BACKPAGE
指定されたページ数だけ前に戻ります。
入力値 このメソッドの各呼び出しは、以下のいずれかのタイプの値を受け取ることができます。
- 前に移動するページ数を指定する文字列 (現在のページを指定されたページ数だけ戻ります)。
- 次のページに移動する場合は None (現在のページを 1 ページ戻ります)。
出力値 None
ViewerCommands.FBACKPAGE
10ページ戻ります。
入力値 None
出力値 None
ViewerCommands.FIRSTPAGE
ドキュメントの先頭のページに移動します。
入力値 None
出力値 None
ViewerCommands.LASTPAGE
ドキュメントの最終ページに移動します。
入力値 None
出力値 None
ViewerCommands.GOTO
ドキュメントの指定されたページに移動します。
入力値 移動するページの番号を表す文字列。
出力値 None
ViewerCommands.BOOKMARK
PDF内の指定されたしおり(ブックマーク)へ移動します
入力値 PDF内のしおりの名前を表す文字列。
出力値 None
ViewerCommands.SCROLL
ページの指定された部分を移動して表示します。ページの拡大縮小や回転には影響しません。
入力値 このコマンドは2つの入力を必要とします。
- スクロール先のページの領域を表す矩形オブジェクト。
- スクロール先の領域を含むページを指定する整数。
出力値 None
ディスプレイ・コントロール
ViewerCommands.ROTATION
ページの回転量を設定します。
入力値 “0”、”90″、”180″、”270 “のいずれかの値。
出力値 None
ViewerCommands.ROTATELEFT
ページを現在とは反時計回りに90度回転させます。
入力値 None
出力値 None
ViewerCommands.ROTATERIGHT
ページを現在から時計回りに90度回転させます。
入力値 None
出力値 None
ViewerCommands.SCALING
ページの倍率を指定された値に設定します。
入力値 パーセントで指定された倍率の文字列値(パーセンテージなし)。
例:”200 “で200%の倍率。
出力値 None
ViewerCommands.ZOOMIN
ページの倍率を、スケーリングのコンボボックスで次に大きい値まで上げます。
入力値 None
出力値 None
ViewerCommands.ZOOMOUT
ページの倍率を、スケーリングのコンボボックスで次に小さい値まで下げます。
入力値 None
出力値 None
ViewerCommands.SINGLE
表示モードをシングルページモードに設定します。このモードでは、ビューアに一度に1ページを表示します。
入力値 None
出力値 None
ViewerCommands.CONTINUOUS
表示モードを連続 ページモードに設定します。このモードでは、すべてのページを連続したページの列として表示し、必要に応じて読み込んでレンダリングします。
入力値 None
出力値 None
ViewerCommands.CONTINUOUS_FACING
表示モードを見開きページモードに設定します。このモードでは、すべてのページが2ページの連続した列として表示され、必要に応じて読み込まれ、レンダリングされます。奇数ページが右側、偶数ページが左側に表示されます。
入力値 None
出力値 None
ViewerCommands.FACING
表示モードをFacing Pageモードに設定します。このモードでは2ページが一列に表示され、必要に応じて読み込まれ、レンダリングされます。奇数ページが右側、偶数ページが左側に表示されます。ページが2つしかない場合は、奇数ページを左にして横に並べて表示します。
入力値 None
出力値 None
ViewerCommands.PAGEFLOW
表示モードをPageflowページモードに設定します。このモードでは、ビューの中央に単一のページを表示し、他のページはすべてY軸に沿って回転します。この表示モードを機能させるにはJavaFXが必要です。
入力値 None
出力値 None
ViewerCommands.PORTFOLIO_DETAIL
ポートフォリオ内の各項目の詳細表を表示する表示モードを詳細モードに設定します。この機能はポートフォリオPDFが開いているときのみ機能します。
入力値 None
出力値 None
ViewerCommands.PORTFOLIO_TILES
ポートフォリオ内の各項目について一連のタイルを表示するタイルモードに表示モードを設定します。この機能はポートフォリオPDFが開いているときのみ機能します。
入力値 None
出力値 None
ViewerCommands.FULLSCREEN
ビューアをフルスクリーンモードで表示するかどうかを設定します。
オンにすると、奇数ページが右側に表示され、オフにすると左側に表示されます。
入力値 None
出力値 None
ViewerCommands.OPENINSYSTEMDEFAULT
現在のファイル ( または指定されたファイル ) を現在のシステムのデフォルトのアプリケーションで開きます。
入力値 このメソッドの各呼び出しは、以下のいずれかのタイプの値を受け取ることができます。
- PDFの絶対ファイル名を表す文字列。
- ビューアで現在開いているファイルを開きます。
出力値 None
ページのレンダリング設定
ViewerCommands.SEPARATECOVER
フェイシングモードと連続フェイシングモードで使用する、最初のページを単独で表示するかどうかを切り替える表紙オプション。
入力値 None
出力値 None
ViewerCommands.SETENHANCEFRACTIONALLINES
描線幅が 1 未満でレンダリングされる線を、代わりに描線幅 1 でレンダリングするかどうかを設定します。
これにより、線が小さくなりすぎて見えなくなるのを防ぐことができます。
入力値 このオプションをオン (true) またはオフ (false) にする論理値。
出力値 None
ViewerCommands.SETHIDELINEWEIGHTS
ストロークされた図形が中身の幅を無視し、代わりにすべての図形を 1 のストロークでレンダリングするかどうかを設定します。
入力値 このオプションをオン (true) またはオフ (false) にする論理値。
出力値 None
ViewerCommands.SETHIGHLIGHTFORMFIELDS
編集可能なフォームフィールドをページ上で見つけやすくするためにハイライトするかどうかを設定します。
入力値 このオプションをオン (true) またはオフ (false) にする論理値。
出力値 None
インタラクティブ機能
ViewerCommands.SAVE
フォームの内容を変更したPDFを保存します。ファイルを保存する場所を指定するダイアログが開きます。
入力値 None
出力値 None
ViewerCommands.PRINT
ダイアログを開いて印刷オプションを指定し、ファイルを印刷します。
入力値 None
出力値 None
ViewerCommands.MOUSEMODE
テキスト選択 ( マウスでテキストを選択 ) とパンモード ( マウスでページビューを移動 ) の 2 つのマウスモードを切り替えます。現在のモードがテキスト選択の場合、この機能はパンモードに変更します。現在のモードがパンモードの場合、この機能はテキスト選択に変更します。
入力値 None
出力値 None
ViewerCommands.PANMODE
現在のマウスモードを、ページの表示領域を変更するためにマウスをドラッグできるパンモードに設定します。
入力値 None
出力値 None
ViewerCommands.TEXTSELECT
現在のマウスモードを「テキスト選択」に設定すると、テキストの上をクリック&ドラッグして選択できるようになります。
入力値 None
出力値 None
ViewerCommands.SELECTALL
テキスト選択機能を使用すると、現在のページ上のすべてのテキストが強調表示されます。
入力値 None
出力値 None
ViewerCommands.DESELECTALL
現在のページ上のすべてのハイライトされたテキストは、ハイライトと選択範囲が解除されます。
入力値 None
出力値 None
ViewerCommands.FIND
ページ上の特定の文字列を検索できます。検索が完了すると、最初に見つかった結果がハイライト表示されます。
入力値 このコマンドは4つの入力値を受け付けます。
- 検索する用語を表す文字列値。
- 複数のオプションを組み合わせるために bitwise OR を使用する SearchType 値を表す整数。
- 文字列をスペース区切りの複数の検索語として扱うかどうかを制御するブール値 (true の場合)。
- 現在のページだけを検索するか (true の場合)、 ドキュメント全体を検索するかを指定するブール値。
出力値 None
ViewerCommands.PREVIOUSRESULT
現在強調表示されている結果を解除し、強調表示されている前の結果に表示を変更します。
入力値 None
出力値 整数が返され、3つの値のいずれかが指定されます。
- (Commands.FIRST_DOCUMENT_SEARCH_RESULT_NOW_SHOWN == 1) このアクションが検索から最初の検索結果に達したときに返されます
- (Commands.SEARCH_RETURNED_TO_START == 2) このアクションが検索から最初の検索結果にループバックするときに返されます。
- (Commands.SEARCH_NOT_FOUND == 3) このドキュメントに検索結果がない場合に返されます。
ViewerCommands.NEXTRESULT
現在強調表示されている結果を解除し、強調表示されている次の結果に表示を変更します。
入力値 None
出力値 整数が返され、3つの値のいずれかが指定されます。
- (Commands.FIRST_DOCUMENT_SEARCH_RESULT_NOW_SHOWN == 1) このアクションが検索から最初の検索結果に達したときに返されます。
- (Commands.SEARCH_RETURNED_TO_START == 2) このアクションが検索から最初の検索結果にループバックするときに返されます。
- (Commands.SEARCH_NOT_FOUND == 3) このドキュメントに検索結果がない場合に返されます。
ViewerCommands.UPDATEGUILAYOUT
ビューアを開いて表示している間、ビューア内の GUI 要素の可視性を変更できます。
入力値 このコマンドは2つの入力値を受け付けます。要素名の文字列。要素の新しい可視性を示すブール値(可視の場合はtrue、不可視の場合はfalse)。
出力値 None
ViewerCommands.VISITWEBSITE
システムデフォルトの Web ブラウザを開き、IDRSolutions のホームページを表示します。
入力値 None
出力値 None
ViewerCommands.HIGHLIGHT
強調表示するテキストの範囲を指定します。
入力値 このコマンドは3つの入力値を受け付けます。
- ページ上の領域を定義する4つの値の整数配列を含むInteger[][]。
- ハイライトを適用するページ。
- 領域をテキスト選択として扱うか (false)、正確なハイライト領域として扱うか (true) を指定するブール値。
出力値 None
ViewerCommands.ABOUT
JPedalのバージョン、JpedalとJavaのバージョンを表示し、JPedalウェブページへのリンクを提供します。
入力値 None
出力値 None
ViewerCommands.BITMAP
ダイアログを開いて、すべてのページを個別の画像としてさまざまな形式で抽出できます。
入力値 None
出力値 None
ViewerCommands.IMAGES
PDFページからすべての画像コンテンツを抽出するためのダイアログを開きます。
入力値 None
出力値 None
ViewerCommands.TEXT
PDFページからすべてのテキストコンテンツを抽出するためのダイアログを開きます。
入力値 None
出力値 None
ViewerCommands.DOCINFO
ページサイズやクロップ値、フォント、フォームなど、現在のPDFに関するさまざまな情報を表示するダイアログを開きます。
入力値 None
出力値 None
ViewerCommands.TIP
ビューアを使用するためのランダムなヒントを表示するダイアログを開きます。これは、プロパティファイルのキー「displaytipsonstartup」をtrueに設定することで、この機能を使わずに起動時に行うことができます。
入力値 None
出力値 None
ViewerCommands.PREFERENCES
現在のプロパティファイルから読み込まれたビューアプロパティを表示するダイアログを開き、ユーザーがこれらの値を変更し、変更を保存できるようにします。
入力値 None
出力値 None
ViewerCommands.EXTRACTTEXT
ダイアログを開いて、現在強調表示されているテキストのテキスト抽出プレビューとオプションを表示します。
入力値 None
出力値 None
ViewerCommands.EXTRACTIMAGE
現在強調表示されているイメージコンテンツをページ上に保存するためのダイアログを開きます(このコンテンツは、テキスト選択モードでイメージをクリックすると強調表示されます)。
入力値 None
出力値 None
ViewerCommands.SNAPSHOT
一度トリガーされると、ユーザーはページ上の領域を選択することができます。その後、ダイアログが開き、ユーザーはキャンセル、選択した領域を画像として保存、または領域を画像としてシステムクリップボードにコピーすることができます。
入力値 None
出力値 None
カスタマイズ
ViewerCommands.SETDISPLAYBACKGROUND
PDFページの後ろに表示する色を設定します。
入力値 色の値を表す整数。これは Color.getRGB() を使用して作成します。
出力値 None
ViewerCommands.SETPAGECOLOR
PDFページの背景色を設定します。
入力値 色の値を表す整数。これは Color.getRGB() を使用して作成します。
出力値 None
ViewerCommands.SETTEXTCOLOR
PDFページのテキストの色を設定します。
入力値 色の値を表す整数。これは Color.getRGB() を使用して作成します。
出力値 None
ViewerCommands.CHANGELINEART
図形もテキストと同様に色を変更するかどうかを指定します。
入力値 図形の色をテキスト色に合わせて変更するかどうかを指定するブール値。
出力値 None
ViewerCommands.SETREPLACEMENTCOLORTHRESHOLD
テキストの色を置換するしきい値(0-255)を設定します。例えば、テキストに5つの色が指定されている場合、それらの色のRGB数値がしきい値よりも小さい数値の場合に置き換えられます。以下のRGB値の場合に「REPLACEMENTCOLORTHRESHOLD=20」とすると、1から3のテキスト色がViewerCommands.SETTEXTCOLORで設定された色に置き換わります。
- 5, 5, 5
- 0, 0, 0
- 10, 20, 10
- 100, 100, 100
- 255, 0, 0
入力値 どのテキストの色が置き換えられるかを決定するために使われる整数値。
出力値 None
ViewerCommands.SETUNDRAWNPAGECOLOR
コンテンツが描画される前に表示されるPDFページの色を設定します。
入力値 色の値を表す整数。これは Color.getRGB() を使用して作成します。
出力値 None
ViewerCommands.AUTOSCROLL
テキスト選択中にビューアがページをスクロールするかどうかを設定します。デフォルトではこのオプションはtrueですが、プロパティファイルで変更することができます。
入力値 None
出力値 None
ViewerCommands.HIDEVERSIONNUMBER
デフォルトのJFrameタイトルバーからJPedalのバージョン番号を削除できるようにしました。
入力値 None
出力値 None
ViewerCommands.SHOWVERSIONNUMBER
デフォルトのJFrameタイトルバーにJPedalのバージョン番号を表示できるようにしました。
入力値 None
出力値 None(