home *** CD-ROM | disk | FTP | other *** search
/ DOS/V Power Report 1998 March / VPR9803A.ISO / OLS / Windows / WBAT137P / wbat137p.lzh / WINBATCH.TXT < prev    next >
Text File  |  1997-12-25  |  18KB  |  388 lines
  1.  
  2. WinBatchEh 1.37 (Batch File Enhancer for Windows) ドキュメント
  3.  
  4. ★ はじめに
  5.  
  6.       Windows でも DOS のバッチファイルの様に簡単にプログラミングが楽
  7.     しめれば、Windows 環境が便利になると思いませんか? そうあのバッチフ
  8.     ァイルの手軽さが Windows でそのまま実現できてしまうのです。
  9.       無論 DOS と同じバッチが走るだけではありません。IF や FOR 文は構
  10.     造化が可能で WHILE によるループも行なえますし、GOSUB によるサブル
  11.     ーチンの呼び出し、PRINTF による書式に従った出力も可能です。さらに
  12.     Windows らしいバッチを作成する場合にはメッセージボックスによる表示
  13.     や、ダイアログによるファイル名選択、ボタンメニューによる分岐など、
  14.     GUI を盛り込んだアプリケーション作成の為のコマンドが用意されていま
  15.     す。
  16.       WinBatchEh を使えば、ちょっとした Windows アプリが簡単に作成でき
  17.     ることが実感できるかと思います。
  18.  
  19.  
  20. ★ 配布ファイル・動作環境など
  21.  
  22.       アーカイブには以下のファイルが含まれます。ディレクトリが含まれま
  23.     すので解凍を行なうときはディレクトリ付きで復元(LHA であれば x コマ
  24.     ンド)してください。
  25.       以前のバージョンでは 16 ビット版と 32 ビット版を同梱していました
  26.     が、現在は分離しています。
  27.  
  28.       16ビット版(WBAT???N.LZH):
  29.     WINBATCH.EXE    - 16ビット版実行ファイル
  30.     WINBATCH.HLP    - 16ビット版オンラインヘルプ
  31.     WBDLL16.DLL    - 16ビット版用DLL
  32.  
  33.       32ビット版(WBAT???P.LZH):
  34.     WINBAT32.EXE    - 32ビット版実行ファイル
  35.     WINBAT32.HLP    - 32ビット版オンラインヘルプ
  36.     WINBAT32.CNT    - 32ビット版オンラインヘルプ用コンテンツファイル
  37.     WBDLL32.DLL    - 32ビット版用DLL
  38.  
  39.       16/32ビットの両方に含まれるファイル:
  40.     WINBATCH.TXT    - このドキュメント
  41.     WINBATRG.TXT    - レジストレーションについての説明
  42.     SAMPLE\        - サンプルバッチのディレクトリ
  43.     WINBATHS.TXT    - ヒストリー
  44.  
  45.       実行ファイル(*.EXE と *.DLL)、ヘルプファイル(16 ビット版では
  46.     *.HLP, 32 ビット版では *.HLP と *.CNT) は同じディレクトリに入れて
  47.     ください。
  48.  
  49.       16 ビットバージョンは、Windows 3.1 日本語版上の 386 エンハンスド
  50.     モードで動作します。Windows 3.0 や 286CPU 上では動作しません。
  51.  
  52.       32 ビットバージョンは Windows 95, Windows NT(Intel) の日本語版上
  53.     で動作します。Windows 3.1 の Win32s 配下では環境変数がすぐに不足し
  54.     たり、コマンドによっては動作しない事があります。Windows 3.1 では
  55.     16 ビットバージョンを使用してください。
  56.  
  57.       32 ビットバージョンのヘルプファイルは新しいバージョンの形式を使
  58.     用していますので、Windows NT 3.5 では読み込む事ができません。
  59.     Windows NT 3.51 以降の環境で使用するか、16 ビット版のヘルプファイ
  60.     ルを WINBAT32.HLP の名前で上書きしてください。
  61.  
  62.       WinBatchEh はシェアウェアです。機能制限等は一切ありませんが試用
  63.     期間の 2 週間を過ぎるとときどき登録に関する案内が行なわれるように
  64.     なります。詳しくは「オンラインヘルプ」または「WINBATRG.TXT」をご参
  65.     照ください。
  66.  
  67.       なお、WinBatchEh のドキュメントはすべてタブサイズが 8 であること
  68.     を想定して書かれています。
  69.  
  70.  
  71. ★ インストール方法
  72.  
  73.       WinBatchEh のための適当なディレクトリを作成し全部のファイルを同
  74.     じところに解凍を行なってください。なお、解凍時はディレクトリオプシ
  75.     ョンを有りにして解凍してください(DOS 版の LHA であれば "LHA x ファ
  76.     イル名" のようにしてください)。
  77.       WinBatchEh を快適に使うには、バッチファイルの拡張子の .BTW の関
  78.     連付けが 16 ビット環境では WINBATCH.EXE、32 ビット環境では
  79.     WINBAT32.EXE になるように設定してください。PATH は必ずしも設定する
  80.     必要はありませんが、実行ファイルをフルパスではなくファイル名のみを
  81.     入力して WinBatchEh を起動するような場合には設定してください。
  82.       なお WINBATCH.EXE、または WINBAT32.EXE を起動して SAMPLE のディ
  83.     レクトリの 00SETUP.BTW を実行すれば、サンプルバッチなどがプルグラ
  84.     ムマネージャまたはスタートメニューに登録され、関連付けも自動的に行
  85.     なわれます。
  86.  
  87.       なお、サンプルバッチはコメントを記入するのに "REM" ではなく
  88.     ":/" の記述を使用しています。始めて見た方は異様な感じを受けるかも
  89.     知れませんが、DOS のバッチでも "REM" より ":/" を使用した方が、速
  90.     く処理が進み、リダイレクト文字なども記入できる事から、わたしは好ん
  91.     で使用していますので、お許しを(^_^;)。
  92.  
  93.  
  94. ★ アンインストール方法
  95.  
  96.       WinBatchEh を削除するには解凍したディレクトリ内のファイルをすべ
  97.     て削除してください。また、関連付けを行なった場合は、その設定も消去
  98.     してください。
  99.  
  100.  
  101. ★ 起動方法
  102.  
  103.   ○ バッチファイルのオープン
  104.  
  105.       WINBATCH.EXE または WINBAT32.EXE をパラメーターなしで起動すると
  106.     バッチ内容表示ウィンドウが現れます。「ファイル」メニューの「オープ
  107.     ン」でバッチファイルをオープンしてください。ファイルマネージャなど
  108.     からドロップしても OK です。
  109.       オープン後は「スタート」でバッチがスタートします。「スタート」を
  110.     行なうと項目が「ストップ」に変わりますので、動作中のバッチを止めた
  111.     い場合は「ストップ」を押してください。ちなみにこのスイッチは左上の
  112.     システムメニュー内にもありますのでアイコン状態でも使用できます。
  113.  
  114.       バッチファイルの拡張子は別に何でも構いませんが、BTW(BaTch file
  115.     for Win)や、普通に BAT などが無難ではないかと思います。オープンメ
  116.     ニューで最初にでてくるのもこの 2 つの拡張子のファイルです。
  117.  
  118.   ○ エディターの設定と起動
  119.  
  120.       バッチファイルの変更は WinBatchEh では行なえませんので変更を行な
  121.     う場合は「ファイル」メニューのエディター起動または SHIFT+[Enter]
  122.     でエディターを起動させて変更してください。
  123.  
  124.       エディタ名は初期値は NOTEPAD.EXE になっていますので、変更する場
  125.     合は「ファイル」の [設定] メニュー を選択してください。エディタで
  126.     ファイルを更新した場合のバッチファイルの自動再読み込みの有無などの
  127.     設定もこのメニュー内で行ないます。
  128.  
  129.   ○ バッチファイルを実行した後
  130.  
  131.       バッチを実行中はバッチ実行ウィンドウ(DOS の画面みたいなもので
  132.     す)が現れます。普通のバッチを動かした場合はここにメッセージなどが
  133.     表示される事になります。このバッチ実行ウィンドウが邪魔な場合は
  134.     "EXECWND OFF" で、表示が行なわれなくなります。
  135.       また、バッチ内容表示ウィンドウは現在実行中のバッチの行にあわせて
  136.     スクロールが行なわれ、どの行が実行されているか確認を行なうことがで
  137.     きます。このウィンドウも邪魔な場合は "BATWND OFF" でアイコン状態に
  138.     なります。
  139.  
  140.   ○ WINBATCH.EXE/WINBAT32.EXE からバッチを直接起動
  141.  
  142.       WINBATCH.EXE/WINBAT32.EXE をプログラムマネージャなどに登録し、さ
  143.     らにパラメータとしてバッチファイル名を指定すれば、そのバッチファイ
  144.     ルの実行がすぐに始まり、バッチファイルが終われば、WinBatchEh も終
  145.     了します。
  146.       「オープン」メニューからバッチを読み込んで「スタート」した場合は
  147.     バッチ終了時にメッセージが表示されキー入力待ちとなりますが、パラメ
  148.     ーターを付けてバッチを直接実行した場合、このメッセージも出なくなり
  149.     ます。
  150.  
  151.  
  152. ★ WinBatchEhで使えるコマンド一覧
  153.  
  154.       それぞれのコマンドの詳しい説明についてはオンラインヘルプをご参照
  155.     ください。
  156.  
  157. ○ 基本コマンド
  158.  
  159. @            ECHO ON の状態でもコマンド行の表示を行ないません。
  160. %数値, %環境変数%, %%    パラメーターの指定や環境変数の内容を参照します。
  161. REM [文字列]        その行をコメント行にします。
  162. ECHO 文字列, ON/OFF    文字列出力、実行中の行のエコーの有無を指定します。
  163. PAUSE [コメント文字列]    メッセージを表示し、何かキーが押されるまで待ちます。
  164. SET 変数名=文字列    環境変数への代入/削除を行ないます。
  165. IF(バッチコマンド互換)    条件の判定を行なって続く文を実行します。
  166. GOTO LABEL        LABELの行にジャンプします。
  167. FOR(バッチコマンド互換)    繰り返し実行を行ないます。
  168. SHIFT            バッチのパラメーターを左にシフトします。
  169. EXIT            バッチファイルから抜けます。
  170. 実行ファイル名        ファイルを実行します。
  171. CALL バッチファイル名    バッチファイルを呼び出します。
  172. BTWPATH パス名        バッチファイルを検索するサーチパスの設定を行ないます。
  173.  
  174. ○ COMMAND.COM内部コマンド
  175.  
  176. CLS            バッチ実行ウィンドウの内容を消去します。
  177. DIR            ディレクトリの内容を表示します。
  178. A: などドライブ名のみ    カレントドライブを変更します。
  179. CHDIR (または CD)    カレントディレクトリの変更または表示を行ないます。
  180. MKDIR (または MD)    ディレクトリの作成を行ないます。
  181. RMDIR (または RD)    ディレクトリの削除を行ないます。
  182. COPY            ファイルのコピーを行ないます。
  183. REN (または RENAME)    ファイル名の変更を行ないます。
  184. DEL (または ERASE)    ファイルの削除を行ないます。
  185. TYPE            テキストファイルの内容表示を行ないます。
  186. リダイレクト出力    表示する代わりにファイルに出力を行ないます。
  187.  
  188. ○ 拡張コマンド
  189.  
  190. GETVERSION        WinBatchEhやWindowsのバージョンを取得します。
  191. INLINECOMMENT        インラインコメント文字列の設定を行ないます。
  192. $(環境変数), $(英字)    特殊な文字を含んだ環境変数などを参照します。
  193. BATCHWND (BATWND)    バッチ内容表示ウィンドウの表示の制御を行ないます。
  194. EXECUTEWND (EXECWND)    バッチ実行ウィンドウの表示の制御を行ないます。
  195. ERRORLEVEL の参照・設定    ERRORLEVELを文字列として参照、また設定ができます。
  196. GOSUB LABEL ～ RETURN    サブルーチンを呼び出します。
  197. 構造化 IF ～ ENDIF    構造化の行なえるIFです。
  198. WHILE ～ ENDWHILE    条件の判定を行なって、繰り返し実行を行ないます。
  199. 構造化 FOR ～ ENDFOR    構造化の行なえるFORです。
  200. EXEC 実行ファイル名    実行ファイルを状態を指定して起動します。
  201. START 実行ファイル名    実行ファイルを状態を指定してマルチに起動します。
  202. MORE            テキストファイルの表示をページ制御ありで行ないます。
  203. GETKEYSTATE        指定のキーが押されているかどうかを調べます。
  204. CHOICE            選択肢の中のキーが入力されるのを待ちます。
  205. LET            環境変数に計算結果を代入します。
  206. PRINTF            書式に従って表示を行ないます。
  207. SPRINTF            書式に従って環境変数に代入を行ないます。
  208. GETCURRENT        カレントドライブ名やディレクトリ名を取得します。
  209. GETCLOCK        現在の日付や時間を取得します。
  210. SETCLOCK        日付と時間を設定します。
  211. STRTOKFILE        与えられた文字列からファイル名などを抜き出します。
  212. FILELINE        ファイルの行数を返します。
  213. LINPUTFILE        指定のファイルの特定の行を抜き出します。
  214. TIMESTAMP        ファイルのタイムスタンプの比較、取得/設定を行ないます。
  215. FILESIZE        ファイルのサイズの比較、取得を行ないます。
  216. FILEATTRIB        ファイルのアトリビュート(属性)を取得/設定します。
  217. FILECOMP        2つのファイルの内容を比較します。
  218. FILECRC            ファイルのCRC値の比較、取得を行ないます。
  219. CDD            ドライブとディレクトリを移動します。
  220. PUSHD/POPD        ドライブとディレクトリを移動/復帰します。
  221. WHICH            実行ファイルの存在を確認します。
  222. TEMPFILENAME        一時ファイル名を取得します。
  223. SLEEPTIME        指定した間、バッチの動作を止めます。
  224. ON ...            メニューなどを選んだ場合に特別な処理を行ないます。
  225. STR ...            文字列操作を行ないます。
  226. DRV ...            ドライブ情報の取得を行ないます。
  227. FINDWND ...        ウィンドウの検索を行ないます。
  228. FINDCHILDWND ...    子ウィンドウ(コントロール)の検索を行ないます。
  229.  
  230. ○ Windows用必殺コマンド
  231.  
  232. GETCURSORPOS        マウスカーソルの現在位置を取得します。
  233. SETCURSORPOS        マウスカーソルの位置を設定します。
  234. MOUSEEVENT        マウスボタンを押す動作を行ないます。
  235. CLIPCURSOR        マウスカーソルの移動可能な範囲を設定します。
  236. GETFOCUS        現在フォーカスが設定されたウィンドウを取得します。
  237. SETFOCUS        指定のウィンドウにフォーカスを設定します。
  238. SHOWWINDOW        指定のウィンドウの状態を設定/取得します。
  239. GETWINDOWRECT        指定のウィンドウの位置及びサイズを取得します。
  240. SETWINDOWRECT        指定のウィンドウの位置及びサイズを設定します。
  241. SETWINDOWPOS        指定のウィンドウの配列順序、位置、サイズを設定します。
  242. MESSAGEBOX (MSGBOX)    メッセージボックスの表示を行ないます。
  243. MESSAGEBEEP (MSGBEEP)    サウンドを再生します。
  244. NONSTOPMESSAGE (NONSTOPMSG)    バッチの処理を続けたままメッセージ表示します。
  245. DISPLAYTXT        テキストファイル(TXT)を表示後、応答を待ちます。
  246. DISPLAYBMP        ビットマップファイル(BMP)の表示を行ないます。
  247. SNDPLAYSOUND        WAVファイルまたはWIN.INIのentryのサウンドを再生します。
  248. INPUTSTRING        文字列入力を行ないます。
  249. SELECTSTRING        リストボックスから文字列の選択を行ないます。
  250. CHOICEBUTTON        ボタンの中から選択をして選んだボタンの値を返します。
  251. GETOPENFILENAME        ファイル名の選択(または入力)を行ないます。
  252. DROPFILEWAIT        ファイルがドロップされるのを待ちます。
  253. CHOOSECOLOR        色の選択を行なって環境変数に代入します。
  254. EXITWINDOWS        Windowsを終了します。
  255. RESTARTWINDOWS        Windowsを再起動します。
  256. REBOOTSYSTEM        Windowsを終了しシステム(マシン)を再起動します。
  257. EXITWINDOWSEXEC        Windowsを一旦終了し、DOSの実行ファイルを実行します。
  258. SUSPENDSYSTEM        コンピュータをサスペンドモードにします。
  259. GETINISTRING        INIファイルの文字列を取得します。
  260. WRITEINISTRING (SETINISTRING)    INIファイルに文字列を設定します。
  261. GETREGSTRING        レジストリデータを取得します。
  262. SETREGSTRING        レジストリデータを設定します。
  263. SYSTEMPARAMETERSINFO (SYSPARAMINFO)    システムパラメータの取得、設定。
  264. GETCLIPBOARD        クリップボードから文字列を受け取ります。
  265. SETCLIPBOARD        クリップボードに文字列を設定(送出)します。
  266. POSTMESSAGE        アプリケーションにメッセージを送ってすぐに戻ります。
  267. SENDMESSAGE        アプリケーションにメッセージを送って応答を待ちます。
  268. SENDMENUKEY        アプリケーションのメニューを選択します。
  269. SENDKEY            キーコードを直接送ります。
  270. SENDSTR            文字列を送ります。
  271. DDEEXECUTE        DDEサーバーにコマンドを実行させます。
  272.  
  273.  
  274. ★ WinBatchEh仕様上の注意
  275.  
  276.   ☆扱えるバッチファイル
  277.  
  278.       扱えるバッチファイルは、ファイルの大きさは関係ありませんが、最大
  279.     8192 行です。また、1 行の最大文字数は 512 文字です。
  280.  
  281.   ☆扱えるファイル名
  282.  
  283.       16 ビットバージョンでは長いファイル名はサポートしていませんが、
  284.     32 ビットバージョンでは長いファイル名も扱えます(空白を含むファイル
  285.     名も " " で囲う事により指定できます)。
  286.  
  287.   ☆環境変数の領域
  288.  
  289.       環境変数の領域は 16 ビットバージョンでは自前の領域を用意し、容量
  290.     的には約 64KB 程度使用できます。32 ビットバージョンではシステムで
  291.     用意された領域を使用し、容量的には約 16KB 程度は使用できるかと思い
  292.     ます。
  293.       また、1 つの環境変数の長さは変数名と文字列を合わせて 500 文字程
  294.     度まで使用できます。
  295.       16 ビットバージョンでは子プロセスとして起動した実行ファイルへの
  296.     環境変数の受け渡しは行なわれません(WinBatchEh を起動したときの環境
  297.     変数が渡されます)。32 ビットバージョンでは現在実行中のバッチの環境
  298.     変数の内容が引き継がれます。
  299.  
  300.   ☆バッチ上で起動する実行ファイルについて
  301.  
  302.       DOS 用のソフトについては実行できるものとできないものがありま
  303.     す。(実行できなくても終了を待つ場合がありますので、その場合「スト
  304.     ップ」で終わらせてください)。
  305.       また、Windows 用ソフトでも、一度しか起動しないアプリケーションを
  306.     すでに起動している状態で、さらに EXEC や実行ファイルのみで起動させ
  307.     ると、バッチに戻ってこないことやすぐにバッチに戻ってくる場合があり
  308.     ます。
  309.       実行ファイル名にパス名を含めない場合はカレント, WINDOWS, Windows
  310.     の SYSTEM, WinBatchEh 起動時に設定されていた環境変数 PATH のディレ
  311.     クトリ(16 ビットバージョンでは WinBatchEh 内で設定した PATH は参照
  312.     しません)を検索に行きます。
  313.       実行ファイル名にバッチファイルを与えると、WinBatchEh が現在処理
  314.     しているバッチを終了して、そのバッチファイルに制御を移します。なお、
  315.     CALL 文を使用すれば、元のバッチに戻ってきます。
  316.       EXEC や実行ファイルのみでプログラムを起動している間は、ハードウ
  317.     ェアによっては、省電力モードに移行するパワーマネージメント機能など
  318.     が使用できない場合があります。
  319.  
  320.   ☆パラメーター・環境変数の引継
  321.  
  322.       WinBatchEh を終了せずに続けて同じバッチの「スタート」を行なうと、
  323.     環境変数の設定が前の状態のままとなります。また SHIFT コマンドを使
  324.     用した場合も移動した結果がそのまま継続されます。
  325.  
  326.       WinBatchEh から他のバッチを「オープン」メニューでオープンした場
  327.     合及びバッチ内でバッチを起動した場合、環境変数の設定は以前の実行結
  328.     果のままになっています。
  329.       また、バッチへのパラメーターは、「ファイル」メニューの「オープン」
  330.     を行なった場合、及びエディターなどを起動してバッチの再読み込みを行
  331.     なった場合、%0 以外はすべて消去されます(%0 にはバッチ名が入ってい
  332.     ます)。
  333.       バッチ内でバッチを起動した場合及び CALL で呼び出した場合はそのバ
  334.     ッチへのパラメーターが設定されます。なお、CALL の場合は元のバッチ
  335.     に戻ったときに以前のパラメーターに戻ります。
  336.  
  337.   ☆文字列・定義文字列・数値・環境変数の指定について
  338.  
  339.       コマンドによっては文字列をパラメータに必要とするものがありますが、
  340.     通常は ["](ダブルクォーテーション)で囲いますが、文字列内で ["] を
  341.     使用したい場合は、['](シングルクォーテーション)で囲うこともできま
  342.     す。
  343.  
  344.       数値の指定と定義文字列の両方が書かれているものについては、できる
  345.     だけ定義文字列の方を使用してください。数値は今後のバージョンで変更
  346.     が行なわれる可能性があります。
  347.  
  348.       数値や定義文字列を '+' や '-' で計算を行なうときは、間にスペース
  349.     などを入れないでください。
  350.  
  351.       数値の指定では先頭を '0x' で始めると 16 進数の指定、それ以外の場
  352.     合は 10 進数の指定となります。
  353.  
  354.       また数値指定で 1 文字のキャラクターを指定することもできます。キ
  355.     ャラクターを指定する場合はシングルクォーテーション ['] で文字を囲
  356.     ってください(例: 'A')。
  357.  
  358.       環境変数の指定の部分で "=" のみを指定するとバッチ実行ウィンドウ
  359.     に出力することができます。これを利用して SPRINTF などの引数に、コ
  360.     マンドの実行出力を代入することが可能になります。
  361.  
  362.   ☆その他16ビットと32ビットバージョンの違い
  363.  
  364.       Windows の GUI 自身の違いにより、16 ビットと 32 ビットバージョン
  365.     で、表示される内容(表現)に違いが起きる場合があります。
  366.  
  367.       ツールバーは 32 ビットバージョンでのみサポートしています (ツール
  368.     バーは Windows95 または Windows NT 3.51 以降で動作しているときのみ
  369.     表示されます)。
  370.  
  371.  
  372. ★ 終わりに
  373.  
  374.       もし、お気付きの点や要望等がありましたら下記までご連絡願います。
  375.     もちろん、NIFTY SERVE の会議室(FGALTS MES 15, FEXT MES 3)に書き込
  376.     んで頂いても結構です。
  377.       ご質問などを頂く場合は機種と OS、それに WinBatchEh のバージョン
  378.     を明記して頂けますと助かります。
  379.       バグの対処などは可能な限り行ないますが、本ソフトウェアを使用した
  380.     為に生じたいかなる結果についても、作者は責務を負わないこととします。
  381.     とは言え、バグ報告や要望はじゃんじゃん受け付けますので(実現に致る
  382.     かどうかは定かではありませんが^^;)、お気軽にご連絡を頂ければと思い
  383.     ます。
  384.  
  385.     清水 洋平(Paci)    NIFTY SERVE   SDI00618
  386.                Internet-Mail SDI00618@niftyserve.or.jp
  387.                http://www.vector.co.jp/authors/VA000007/
  388.