mlreportgen.dom.Watermark クラス
名前空間: mlreportgen.dom
PDF レポート セクション内のページへの透かしの追加
説明
PDF レポート セクションに追加できる透かしオブジェクトを作成します。透かしとは、ページの背景に表示するイメージのことで、ドラフト
や秘密情報
などの言葉が使われます。これは、適用された各ページのテキストの背後に表示されます。次のファイル タイプのいずれかを使用できます。
.emf
.gif
.jpg
.pdf
.png
.svg
.tiff
mlreportgen.dom.Watermark
クラスは handle
クラスです。
作成
説明
は、指定されたイメージに基づいて wm
= Watermark(image)Watermark
オブジェクトを作成し、Watermark
オブジェクトを返します。
入力引数
透かしとして使用するイメージ。イメージ パス名として指定します。次のファイル タイプのいずれかを使用します。
.emf
.gif
.jpg
.pdf
.png
.svg
.tiff
プロパティ
イメージ ファイルのパス。文字ベクトルまたは string スカラーとして指定します。
属性:
GetAccess | public |
SetAccess | private |
NonCopyable | true |
Transient | true |
データ型: char
| string
透かしの高さ。数値とそれに続く測定単位の略語を含む文字ベクトルまたは string スカラーとして指定します。たとえば、"10px"
は 10 ピクセルを指定します。有効な略語を以下に示します。
"px"
— ピクセル"cm"
— センチメートル"in"
— インチ"mm"
— ミリメートル"pc"
— パイカ"pt"
— ポイント
あるいは、Watermark.Style
プロパティを使用して高さを指定できます。以下に例を示します。
Watermark.Style = {Height("4in")};
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
データ型: char
| string
透かしの幅。数値とそれに続く測定単位の略語を含む文字ベクトルまたは string スカラーとして指定します。たとえば、"10px"
は 10 ピクセルを指定します。有効な略語を以下に示します。
"px"
— ピクセル"cm"
— センチメートル"in"
— インチ"mm"
— ミリメートル"pc"
— パイカ"pt"
— ポイント
あるいは、Watermark.Style
プロパティを使用して幅を指定できます。以下に例を示します。
Watermark.Style = {Width("4in")};
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
データ型: char
| string
このドキュメント要素オブジェクトの書式指定。DOM 書式オブジェクトの配列として指定します。このプロパティで指定された書式は、この要素の StyleName
プロパティで指定された対応する書式をオーバーライドします。このドキュメント要素オブジェクトに適用されない書式は無視されます。
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
ドキュメント要素のカスタム属性。mlreportgen.dom.CustomAttribute
オブジェクトの配列として指定します。カスタム属性は、このオブジェクトが追加されるドキュメント要素の出力形式でサポートされていなければなりません。
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
タグ。文字ベクトルまたは string スカラーとして指定します。DOM API は、このオブジェクトを作成するときに、セッション固有タグを生成します。生成されるタグの形式は CLASS:ID
という形式です。ここで、CLASS
はオブジェクト クラスです。ID
はオブジェクトの Id
プロパティの値です。この値を使用すると、ドキュメントの生成中に問題が発生した箇所を容易に特定できるようになります。
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
データ型: char
| string
オブジェクト識別子。文字ベクトルまたは string スカラーとして指定します。DOM API は、ドキュメント要素オブジェクトの作成時にセッション固有識別子を生成します。
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
データ型: char
| string
例
この例では、透かしをプログラムで作成し、それを現在のレイアウトに適用する方法を示します。透かしをプログラムで作成すると、イメージ ファイルを保存してその場所を追跡する必要がないため、ファイル管理が簡素化されます。
MATLAB® コマンドを使用して、イメージ ファイルをプログラムで作成します。SVG
イメージ ファイルを使用すると、イメージをスケーリングしても解像度が維持されます。イメージをファイルに書き込んだら、Figure を削除できます。
wmname = 'wm'; wmtype = 'svg'; wmfilename = [wmname '.' wmtype]; subplot('Position',[0, 0, 1, 1]); axis('off'); text(0.25, 0.25,'Draft', ... 'Rotation', 45, ... 'Color', [0.85, 0.85, 0.85], ... 'FontSize',72); print(wmfilename, ['-d' wmtype]); delete(gcf);
透かしオブジェクト wm
を作成し、現在のページ レイアウトに適用します。レポートを生成したら、変数 wmfilename
で指定されたイメージ ファイルを削除できます。
import mlreportgen.dom.*; d = Document('myreport','pdf'); open(d); wm = Watermark(wmfilename); wm.Width = '12in'; wm.Height = []; d.CurrentPageLayout.Watermark = wm; append(d,'Hello'); append(d, PageBreak); append(d,'World'); close(d); rptview(d.OutputPath); delete(wmfilename);
バージョン履歴
R2016b で導入MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Web サイトの選択
Web サイトを選択すると、翻訳されたコンテンツにアクセスし、地域のイベントやサービスを確認できます。現在の位置情報に基づき、次のサイトの選択を推奨します:
また、以下のリストから Web サイトを選択することもできます。
最適なサイトパフォーマンスの取得方法
中国のサイト (中国語または英語) を選択することで、最適なサイトパフォーマンスが得られます。その他の国の MathWorks のサイトは、お客様の地域からのアクセスが最適化されていません。
南北アメリカ
- América Latina (Español)
- Canada (English)
- United States (English)
ヨーロッパ
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)