Fujitsu F-TRAN+ operating Manual
操作説明書／プログラム応用編
第１版
は じ め に
Ｆ＊ＴＲＡＮ＋ Ｖ６．０をお買い上げいただき、ありがとうございます。
Ｆ＊ＴＲＡＮ＋（エフトラン・プラス）は、汎用機／オフコン／ＵＮＩＸなどのホストのファ
イル転送データと、パソコンの標準であるＷｉｎｄｏｗｓファイルとのデータ交換をする汎用性
の高いファイル変換ユーティリティです。Ｗｉｎｄｏｗｓファイル間のデータ変換もできます。
発売以来１０年、多くのユーザにささえられている、実績あるソフトウェアです。
Ｆ＊ＴＲＡＮ＋ Ｖ６．０には、動作するＯＳ別に２種類の製品があります。
■ Ｆ＊ＴＲＡＮ＋ Ｖ６．０ Ｓｅｒｖｅｒ
Ｓｅｒｖｅｒ系、およびＤｅｓｋｔｏｐ系ＯＳで動作
■ Ｆ＊ＴＲＡＮ＋ Ｖ６．０ Ｄｅｓｋｔｏｐ
Ｄｅｓｋｔｏｐ系ＯＳで動作
Ｆ＊ＴＲＡＮ＋ Ｖ６．０では、Ｗｉｎｄｏｗｓ７上での動作をサポートしています。
Ｆ＊ＴＲＡＮ＋のマニュアルには、導入編、解説編、コマンド編、マルチレコード編、プログ
ラム応用編（本書）があります。
２０１０年４月
株式会社 富士通ビー･エス･シー
ii
Copyright 1997-2010 株式会社 富士通ビー･エス･シー
目 次
第１章 ＯＬＥオートメーション
１.１ ＯＬＥオートメーションとは？…………………………………………………………２
第２章 インターフェース
２.１ インターフェース…………………………………………………………………………４
■インターフェース ……………………………………………………………………４
■全体の流れの参考図 …………………………………………………………………５
■ＩＦｔＣｍｄのメソッド ……………………………………………………………６
■ＩＦｔＳｉｎｋのメソッド（コールバック） …………………………………１０
■ＩＦｔＱｕｉｔのメソッド ………………………………………………………１３
■メッセージボックス、ダイアログボックスの種類 ……………………………１４
■メッセージボックス、ダイアログボックスのボタンタイプ …………………１４
■メッセージボックス、ダイアログボックスの戻り値 …………………………１４
２.２ リターンコード…………………………………………………………………………１５
第３章 オートメーションサンプル
３.１ Ｖｉｓｕａｌ Ｃ＋＋のサンプル……………………………………………………１８
３.２ Ｖｉｓｕａｌ Ｂａｓｉｃのサンプル………………………………………………２１
iii
本書で用いる表記法
●本文と画面のパラメータ類の表記法
｛Ａ｜Ｂ｜Ｃ｝ Ａ、Ｂ、またはＣのうち、どれか１つを選択します。
省略はできません。
Ａ
Ｂ 同上。
Ｃ
（Ａ／Ｂ／Ｃ） 同上。
［Ａ］ Ａは省略できます。
［Ａ／Ｂ／Ｃ］ Ａ、Ｂ、またはＣのうち、どれか１つを選択します。
省略が可能で、その場合、下線を引いたＢを選択した
ものとみなします。
Ａ
Ｂ 同上。
Ｃ
（Ａ／［Ｂ］／Ｃ） 同上。ただし、［ ］でくくったＢを選択したものと
みなします。
Ｘ ・・・ Ｘ類を Ａ Ｂ Ｃ のように列挙します。
ｎ、ｎｎ、＜ｎ＞ １０進数を指定します。
（＜＞は表記上の記号で、入力はしません）
ｘｘＨ １６進でｘｘです。Ｈを省くこともあります。
↓ 改行を意味します。リターンキーのシンボルです。
ａ
下線部を入力します。
ａｂｃ↓ 下線部を入力し、リターンキーを押します。
ＣＴＲＬ＋Ａ コントロール（ＣＴＲＬ）キーを押しながら、Ａキー
を押します。コントロールＡと読みます。
＾Ａ 同上。
ｄ： ドライブＡ：やＣ：など、任意のドライブ指定を表し
ます。
◆注意 ---- 実画面と少し差異がある
本書に示す画面と実際の画面には、若干の差異がある場合があります。あらかじめ、ご了承く
ださい。
iv
第１章 ＯＬＥオートメーション
第１章
ＯＬＥオートメーション
1
第１章 ＯＬＥオートメーション
１．１ ＯＬＥオートメーションとは？
Ｆ＊ＴＲＡＮ＋ Ｖ３．０より、ＯＬＥオートメーションのインターフェースが提供されてい
ます。このインターフェースをアプリケーションから利用することで、Ｆ＊ＴＲＡＮ＋をユーザ
アプリケーションの「部品」として使用することができ、Ｆ＊ＴＲＡＮ＋の処理を細かにコント
ロールすることができます。
●ＯＬＥオートメーションを使わないＦ＊ＴＲＡＮ＋の利用（従来の方法）
Visual Basic、 起動
C/C++ などの Ｆ＊ＴＲＡＮ＋
アプリケーション リターン (FP.EXE)
Ｆ＊ＴＲＡＮ＋を外部プログラムとして起動し、プロセス終了後のリータン（正常、エラーの
どちらか）を取得する。細かいコントロールはできない。非同期の動作となる。
●ＯＬＥオートメーションを使ったＦ＊ＴＲＡＮ＋の利用
Visual Basic、 コール
C/C++ などの Ｆ＊ＴＲＡＮ＋
アプリケーション コールバック V3.0 以降(FP.EXE)
Ｆ＊ＴＲＡＮ＋の処理を自関数としてコールし、メッセージやダイアログのコールバックを受
け取ることもできる。詳細なエラーコードの判定ができ、Ｆ＊ＴＲＡＮ＋をアプリケーションの
一部として使用することができる。同期した動作となる。
2
第２章 インターフェース
第２章
インターフェース
3
第２章 インターフェース
２．１ インターフェース
Ｆ＊ＴＲＡＮ＋のＯＬＥオートメーションのインターフェースは、つぎのとおりです。
■インターフェース
●IFtCmd クライアントとのインタフェース
メソッド
Command コマンドラインを実行し、終了後に復帰する。
GetLastFtErrorCode F*TRAN+ のリターンコードを獲得する。
GetLastWinError Win32 エラーまたは OLE エラーの最終値を獲得する。
GetLastMessage 実行ウインドウに出力された最終エラーメッセージを獲得する。
SetOwnerWindow オーナーウインドウを設定する。
MessageBoxValue OnMessageBox の戻り値を設定する。
OnMessageBox の中で使用する。
DialogBoxValue OnDialogBox の戻り値を設定する。
OnDialogBox の中で使用する。
SelectWFile ファイル選択ウインドウから選択したファイルを通知する。
SetCurrentDirectory カレントディレクトリを設定する。
GetCurrentDirectory カレントディレクトリを取得する。
GetInstallDirectory F*TRAN+ のインストールディレクトリを取得する。
●IFtSink コールバックのインタフェース
メソッド
OnStart コマンド開始のタイミングで呼ばれる。
OnEnd コマンド終了のタイミングで呼ばれる。
OnProgress 処理中の％進行表示のために呼ばれる。
OnMessageBox メッセージボックス表示の直前に呼ばれる。
MessageBoxValue で戻り値が設定されると、
F*TRAN+ のメッセージボックスは表示されない。
OnEndMessageBox メッセージボックス終了直後に呼び出される。
OnDialogBox ダイアログボックス表示の直前に呼ばれる。
DialogBoxValue で戻り値が設定されると、
F*TRAN+ のダイアログボックスは表示されない。
OnEndDialogBox ダイアログボックス終了直後に呼び出される。
●IFtQuit 中止を指示するインタフェース
メソッド
Quit 実行中のコマンドの中止を指示する。非同期。
4
第２章 インターフェース
■全体の流れの参考図
●IFtCmd::Command（Ｆ＊ＴＲＡＮ＋のコマンドをコール）
●IFtSink（Ｆ＊ＴＲＡＮ＋からのコールバック）
OnStart
OnProgress
OnMessageBox
OnEndMessageBox
OnDialogBox
OnEndDialogBox
OnEnd
●IFtQuit::Quit（コマンド処理の中止）
リターン（コマンド処理の終了）
5
Loading...