Excel 変換

－セルの列幅と行高さのユーザによる調整機能－

プログラム外部からセルの列幅とセルの高さを調整するための機能です。　拡大縮小率を指定することで、1ページに含めるセルの範囲を調整することができます。

Excelファイルに保存されている「キーとなる情報」 と 「キーに対応する調整値」を指定することで、ユーザ側でファイルに応じた調整を行えます。複数の設定をパラメータセットとしてファイルに記述して読み込むこともできます。キーを無視して一括して調整することもできます。

キーとなる情報は、Excelファイルに保存されている「デフォルトフォント」と「プリンタ名」です。　「デフォルトフォント」とは、新規のExcelシートを作成した場合に、セルに設定されているフォントで、行列見出しやセルの列幅を計算する元にもなっているフォントのことです。「デフォルトフォント」は、フォント名とフォントサイズの組からなります。「デフォルトフォント」はExcelのワークブック(ファイル)に対して、一つ指定されます。「プリンタ名」とは、印刷に使用したプリンタ名で、ワークブック内の各シートごとに指定されています。

デフォルトフォントもプリンタ名も、それぞれExcelファイル内に保存されているものが対象となります。プリンタ名は保存されていない場合もあるので注意が必要です。保存されていない場合でも、確認のためにファイルをExcelで開き、印刷関連のメニューを開いたときにはプリンタ名は表示されますが、これはファイルに保存されているプリンタ名が表示されているわけではありません。現在システムに設定されているものが表示されている場合が多いので注意が必要です。

デフォルトフォントの違いによって、列幅などのサイズは変動します。　印刷先のプリンタを変更することで異なってしまうこともあったので、追加のキーとして採用していますが、それほど例は多くないので、プリンタ名を利用する場面は、それほど多くないと思われます。キーに対して縦横の拡大縮小割合を指定することで、ページに含まれるセルを調整します。　また、読込時にデフォルトフォントとプリンタ名を情報として戻す機能を用意しました。　エラーメッセージと同様の形式で情報が得られますので、キーを指定する場合にこれを参照してください。

以下のような記述を納めたファイルを用意して、プログラムに渡すことで、指定したキーを含むファイルを変換する時に、行の高さと列の幅を指定した調整値で調整できます。

<xls-rowcol-controls>
<xls-rowcol-control>
<xls-key>
<printer-name>プリンタ名</printer-name>
<font name="フォント名" size="フォントサイズ"/>
</xls-key>
<xls-key> ... </xls-key>
:
<xls-parameter row="行高調整値" col="列幅調整値"/>
</xls-rowcol-control>
</xls-rowcol-controls>

　DTDは以下

<!ELEMENT xls-rowcol-controls (xls-rowcol-control*)>

<!ELEMENT xls-rowcol-control (xls-key*,
xls-parameter? ) >

<!ELEMENT xls-key (printer-name?,
font? ) >

<!ELEMENT printer-name (#PCDATA) >

<!ELEMENT font EMPTY >
<!ATTLIST font name CDATA #IMPLIED
size CDATA #IMPLIED >

<!ELEMENT xls-parameter EMPTY >
<!ATTLIST xls-parameter row CDATA #IMPLIED
col CDATA #IMPLIED >

パラメータの概要

• xls-rowcol-control：調整値の１セット。ファイル内に複数記述可。記述順に検証されます。
• xls-key：ファイル内に記述されている対象の要素(レコード)を決定するためのキーを指定します。
  • xls-rowcol-control内に複数記述可。記述順に検証されます。
  • ファイル内に記述されている対象の要素(レコード)と比較して合致すれば調整値を採用します。
• printer-name：プリンタ名（ワイルドカード指定可能）。ファイル内のプリンタ情報にあるプリンタ名と比較されます。
  • 例： "EPSON LP-S310" (機種名を含めた記述)、"EPSON *" (EPSONのプリンタ全般)
• font：フォント情報。ファイル内のデフォルトフォント情報と比較されます。
  • name：フォント名（ワイルドカード指定可能）。デフォルトフォントの名前と比較されます。
    　　　　　例： "IPA*" (IPAで始まるフォント)、"ＭＳ　Ｐゴシック"
  • size：フォントサイズ(',' による列挙、'-' による範囲指定が可能)。デフォルトフォントのサイズ(ポイント単位)と比較されます。
    　　　　　例：8 (8pt)、10-15 (10ptから15ptまで)、8,10 (8ptと10pt)、-10 (10pt以下)、20- (20pt以上)、8, 14- (8ptと14pt以上)
• xls-parameter：調整値セット。xls-rowcol-control内に一つだけ記述します。
  • row：行高調整値：%指定で拡大縮小率を指定します(90%)
  • col：列幅調整値：%指定で拡大縮小率を指定します(120%)

詳細と注意事項

• 一つの xls-rowcol-control に xls-key は複数指定可能で、一つでも合致すれば採用されます。
• xls-rowcol-control は先頭から順次検索、合致するセットを見つけた段階で検索終了します。
  • 見つからなかった場合(xls-row-controlが無かった場合も含む)は、ユーザによる調整を行わずに処理を行います。
  • xlsinfoviewオプションを指定していた場合は、合致するセットがないとしてメッセージを表示します。
• xls-key で指定が省略されているキーは検索時に条件が合致しているとみなされます。
  • キーをひとつも指定していない場合、そのキーはすべてのファイルに対して条件が満たされたことになり、続くパラメータの指定が有効となります。そのようなキーを最初に記述すると、それより後の指定を検討することはなくなりますので、注意してください。
• xls-parameter で指定が省略されている項目は100%が指定されたものとします。
  • 項目をひとつも指定していない場合、パラメータ値は省略時の値(100%)が指定されたことになるのでユーザの調整は行われないことになります。
  • row, colの最小・最大値：50%-150%
  • 指定は"90%"と単位を指定し、82.5%などの小数点も指定可能、2桁までとします。
• font で、指定がない項目は条件が合致したものとします。
  • 両方の指定がない場合、すべてのフォントと合致することになります
  • フォント名最大長　：Officeの仕様に準じます。31文字まで。
  • サイズの最小・最大値：Officeの仕様に準じます。1-409。

記述の一例

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE xls-rowcol-controls SYSTEM "xls-rowcol-controls.dtd">
<xls-rowcol-controls>
<xls-rowcol-control>
<xls-key> <font size="10"/> </xls-key>
<xls-key> <font size="8-9" name="MS Gothic"/> </xls-key>
<xls-parameter col="95%" row="82.5%"/>
</xls-rowcol-control>
<xls-rowcol-control>
<xls-parameter col="90%"/>
</xls-rowcol-control>
</xls-rowcol-controls>

－セルの用紙設定機能－

プログラム外部から用紙を設定する機能です。用紙サイズや印刷の向きなどを指定することで、ファイルの設定とは異なる設定で出力できます。

Excelファイルに用紙設定が保存されていない時のデフォルト値を指定することと、Excelファイルに保存されている用紙設定を無視して指定した値を使用することができます。

指定できるパラメータは、用紙、用紙方向、上下左右マージン、拡大縮小率です。

値は、以下の優先順位で最初に見つかったものを採用します。指定はパラメータごとに独立しています。

優先順位：ユーザ指定値(xlsPaper)＞ファイルに保存された指定値＞ユーザ指定デフォルト値(xlsPaperDefault)＞プログラム内蔵デフォルト値

パラメータは、文字列で指定します。文字列はカンマ区切りで、各要素を指定します。要素ごとに付随する値が必要なものはコロン区切りで並べます。

パラメータは、先頭から順次解釈されます。重複する要素の指定がある場合は、最後に指定されたものが有効となります。

パラメータの概要

• 用紙サイズ：用紙サイズを指定します。
  • A3, A4, A5, B3, B4, B5, Letter, Legal, custom:SIZEWIDTH:SIZEHEIGHT が指定できます。
  • customは、縦横のサイズ(SIZEWIDTH,SAIZEHEIGHT)を任意に指定するものです。
  • 単位は数字に続けてmmかinchを付加します。単位を省略した場合はmmと解釈します。必ず縦横共に指定する必要があり、不足した場合はエラーとなります。
  • デフォルトは A4 です。
• 用紙方向：用紙の向きを指定します。
  • 横 または 縦を landscape,portrait で指定します。
  • graph:,sheet:を前置することで、グラフシートとワークシートを別々に指定することができます。
  • graph:,sheet:が付加されていない場合は、両方のシートに対して指定が有効になります。
  • デフォルトは、ワークシートは縦、グラフシートは横です。
  • 用紙サイズとしてcustomが指定されている場合、この指定は有効になりません。
• 拡大縮小：拡大縮小率を指定します。
  • %指定 または 縦横のページ数を指定します。
  • %指定は、数値に続けて%を付加します。　例：100%, 50%, 200%
  • 縦横のページ数指定の場合、指定したページ数に納まるように全体を拡大縮小します。
  • ページ数指定は、page:HORIZONTAL:VERTICALで指定します。横方向と縦方向のページ数を指定します。片方を0に指定した場合、0でない側を基準に拡大縮小値が決定されます。
  • デフォルトは、100% です。
• 余白(マージン)：用紙の上下左右の余白を指定します。
  • marginは、左上右下の余白サイズ(MARGINLEFT,MARGINTOP,MARGINRIGHT,MARGINBOTTOM)を任意に指定します。
  • 単位は数字に続けてmmかinchを付加します。単位を省略した場合はmmと解釈します。必ず四つの数字を全て指定する必要があります。不足した場合エラーとなります。
  • デフォルトは、margin:20mm:25mm:20mm:25mm です。

記述の一例

-xlspaper A4,graph:landscape,100%

用紙サイズはA4、グラフシートは横書き、拡大縮小100%で出力する。マージンはファイルに指定されたものを使用する。

-xlspaperdefault custom:1000mm:1200mm,page:2:1,margin:10mm:10mm:15mm:15mm

用紙サイズは横1000mm、縦1200mm、マージンは左と上が10mm、右と下が15mm、横2ページ縦1ページに納まるように拡大縮小する。
デフォルト値の指定なので、xlspaperオプションが同時に使用されていたり、ファイルに指定が保存されている場合は採用されない。