biz-Streamマニュアル XMLページレイアウトタグ リファレンス 第4章 イメージ 4.3 リンク付きイメージ<LinkImage>

4.3 リンク付きイメージ<LinkImage>


4.3.1機能説明

リンク先(URI)を付加したイメージの定義を行います。LinkImageタグのcontent(#PCDATA)には、使用するイメージファイル名を指定します。

4.3.2属性説明

属性名指定説明指定内容初期値
Name任意名前CDATA
Width任意イメージの幅CDATA実サイズ
Height任意イメージの高さCDATA実サイズ
X任意X座標CDATA0
Y任意Y座標CDATA0
Unit任意単位(Choice)mm / cm / in / px / ptmm
Format任意色空間(Choice)rgb / cmyk ※1cmyk
Uri必須リンク先(URI)
数値の場合、文書内のページへリンク
CDATA
Depth任意色階調(Choice)1 / 2 / 4 / 88
GrayScale任意グレースケール(Choice)true / false ※2false
Rate任意拡大縮小率CDATA※30
  • (注)初期値:出荷時のXMLデフォルト情報(default_values.properties)値を表します。ユーザにより値の変更が行われた場合は内容が異なります。
  • ※1Format属性値により、イメージ処理で使用されるパッケージ(AWT or ACI)が異なります。また、対応できるファイルタイプも異なります。詳細は「4.2 イメージ<image>」の対応表を参照してください。
  • ※2グレースケールをtrueにした場合に使用されるアルゴリズムはpdf.propertiesのgrayscale.algorithmの項目にてNTSC加重平均法またはRGB平均法を選択できます。
  • ※3Rate:サイズが明示的にレイアウト定義中に定義されている場合、Rateの指定値は無視され前者のサイズが使用されます。


4.3.3記述例

LinkImageサンプル1

LinkImageサンプル1(『<biz-Stream_home>/sample/xml/LinkImage/LinkImageSample1.xml』)

<?xml version="1.0" encoding="UTF-8"?>
<!-- XML file created by biz-Stream Designer -->
<!-- biz-Stream Copyright BrainSellers.com Corp. -->
<Layout Name="LinkImageSample1" Width="50" Height="50" X="10" Y="10" xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:bs="http://www.brainsellers.com/schema" xmlns:svg="http://www.brainsellers.com/schema" xmlns:form="http://www.brainsellers.com/schema" xmlns:pdf="http://www.brainsellers.com/schema" version="5.0.0">
    <!-- 外枠(青線) -->

    <Square Width="30" Height="30" LineColor="14,0,176" FillColor="204,204,204" LineStyle="Solid"/>

    <!-- イメージ -->

    <LinkImage Width="9.7" Height="8.527" X="10" Y="10" Format="cmyk" Uri="http://www.brainsellers.com">${base-dir}/sample/xml/LinkImage/sample1.jpg</LinkImage>
</Layout>

<LinkImage Width="9.7" Height="8.527" X="10" Y="10" Format="cmyk" Uri="http://www.brainsellers.com">${base-dir}/sample/xml/LinkImage/sample1.jpg</LinkImage>


生成されるPDF(『<biz-Stream_home>/sample/xml/LinkImage/LinkImageSample1.pdf』)



サンプル1

Uri属性でリンク先
(http://www.brainsellers.com)が指定されているため、PDF上からブラウザを起動し、リンク先を表示します。

biz-Streamでは、イメージの指定として次の要素が用意されています。

  • イメージ:       Imageタグ
  • リンク付きイメージ:  LinkImageタグ
  • 白黒2値イメージ:    MonochromeImageタグ
  • CCITTFaxイメージ:  CCITTFaxXImageタグ