API version 23

SmaPri.RegisterFormatメソッド変更履歴

iOSAndroidWindows

 

説明

SmaPriのフォーマットファイル(*.spfmtz)を登録します。

フォーマットファイルは、Webサーバー上、あるいは端末のストレージ上のファイルの場所をURLで指定するか、バイナリデータをBase64形式の文字列で指定します。

登録したフォーマットファイルは端末のストレージ上に保存され、次回のBiz/Browser起動時にもそのフォーマットファイルの情報を使用します。

 

formatにURLを指定した場合、フォーマットファイルが更新されているかどうかを比較し、更新されていなければダウンロードしません。

更新されているかどうかは、ファイルの最終更新日とファイルサイズのどちらかが異なっているかどうかで判断します。

URLがWebサーバー上のファイルを指している場合、ファイルの最終更新日として、HTTPのHEADメソッドで取得したレスポンスヘッダのLast-Modifiedの値を使用します。ファイルサイズにはContent-Lengthの値を使用します。

 

詳しい使用方法についてはこちらを参照してください。

 

Android版
Biz/Browser HT ver 1.2.6より、Android11以降の端末でアプリケーション専用ディレクトリ以外のディレクトリにあるファイルにアクセスする場合、OSに対してユーザー操作で許可をとる必要があります。
詳しくはAndroid11以降のファイルアクセスを参照してください。

 

呼出形式

sm.RegisterFormat(format);

 

戻り値

なし

 

引数

String format

フォーマットファイルのURL、もしくはフォーマットファイルのバイナリデータをBase64形式で表現した文字列

 

URLは絶対パスまたは相対パスで指定することが可能です。*1

 

例外

FUNC-4

引数の値が不正です

 

SMAPRI-5

フォーマットの登録に失敗しました。

 

SMAPRI-15

印刷中です。

 

使用例

SmaPri sm;
Button btnRegisterFormat {
 X = 10;
 Y = 40;
 Width = 50;
 Height = 20;
 Title = "Register format";
 Function OnTouch(e) {
  ^sm.RegisterFormat("http://192.168.1.15/format/sample.spfmtz");
 }
}

 

関連項目

PrintFormatメソッド

変更履歴
*1 相対パスによるURL指定はAPI version 31から可能になりました。

 



「オンラインマニュアル」一覧へ戻る
「Bizの宝箱」TOPへ戻る