←
▼
▲
Sub Shell::RegDelete( Path as string )
レジストリの値かキーを削除します。
【引数】
path
レジストリのパス
返り値
値
Path の末尾が \ のときは、キーを削除します。
Path の末尾が \ ではないときは、値を削除します。
←
▼
▲
Option Explicit
Dim g_sh : Set g_sh = WScript.CreateObject( "WScript.Shell" )
Dim desktop_path : desktop_path = g_sh.SpecialFolders( "Desktop" )
Dim shcut : Set shcut = g_sh.CreateShortcut( desktop_path + "\file1.lnk" )
shcut.TargetPath = desktop_path + "\file1.txt"
shcut.Arguments = "1 2 3"
shcut.WorkingDirectory = desktop_path
shcut.Description = "This is test shortcut"
shcut.IconLocation = "foo.exe,1"
shcut.WindowStyle = 3
shcut.HotKey = "CTRL+ALT+SHIFT+X"
shcut.Save
上記のサンプルより細かい設定を追加したもの。
Function Shell::CreateShortcut( ShortcutPath as string ) as WshShortcut
ショートカットを新規に作成するか、既存のショートカットを開きます。
デスクトップに、file1.lnk という名前のショートカットができます。
Option Explicit
Dim g_sh : Set g_sh = WScript.CreateObject( "WScript.Shell" )
Dim desktop_path : desktop_path = g_sh.SpecialFolders( "Desktop" )
Dim shcut : Set shcut = g_sh.CreateShortcut( desktop_path + "\file1.lnk" )
shcut.TargetPath = desktop_path + "\file1.txt"
shcut.Save
desktop_path + "\file1.lnk"
desktop_path + "\file1.txt"
サンプル
サンプル
サンプル
既存のショートカットのリンク先を表示する。
Option Explicit
Dim g_sh : Set g_sh = WScript.CreateObject( "WScript.Shell" )
Dim shortcut :Set shortcut = g_sh.CreateShortcut( "Example.lnk" )
WScript.Echo shortcut.TargetPath
Example.lnk
関連
←
▼
▲
ショートカット ファイルを操作するオブジェクト。
.Arguments
実行するときの引数
.Description
.FullName
.Hotkey
.IconLocation
.TargetPath
.WindowStyle
.WorkingDirectory
リンク先のパス
実行するときのカレント フォルダー
説明文
アイコンのパス
実行するときのウィンドウの表示方法
ホット キー
ショートカット ファイルのパス
←
▼
▲
Function Shell::Popup( Text as string, SecondToWait as integer, Title as string, Type as integer )
as integer
メッセージボックスを表示します。
【引数】
Text
SecondToWait
表示する内容
自動的に閉じるまでの時間(秒)
Title
メッセージボックスのタイトルに表示する内容
押されたボタン、 自動的に閉じたとき = -1
返り値
メッセージボックスの種類
Type
との違いは、自動的に閉じるまでの時間が指定できることです。
カウントダウン表示はしません。
←
▼
▲
.StdIn
.StdOut
.StdErr
0=実行中(WshRunning)、1=終了(WshFinished)
.Terminate
Dim ex
Set ex = g_sh.Exec( "..." )
ex.StdIn.Write "Y"+vbCRLF
.StdIn の例
(下記)
参考
.ExitCode
.ProcessID
←
▼
▲
で実行したプログラムが実行中かどうか。 0=実行中、1=終了
Dim WshScriptExec::Status as integer
サンプル
text = ""
Do While ex.Status = 0 : WScript.Sleep 100 : text = text + ex.StdOut.ReadAll() : Loop
実行したプログラムの標準出力を取り出さないと、実行したプログラムが止まることがあります。
←
▼
▲
取得
.Length
.Count
.Item( symbol as string )
(Default Property)
.Remove( symbol as string )
環境変数の設定の一覧。 Array( "VAR1=A", ... )
symbol に指定した環境変数の参照
For Each line In g_sh.Environment
'// line sample is "VAR1=A"
Next
g_sh.Environment(0) は、"=::=::\" です。 無いこともあります。
g_sh.Environment(1) は、"=C:=(カレントディレクトリ)" です。
要素数
要素数
Dictionary 準拠メンバー
その他のメンバー
←
▼
▲
関連
←
▼
▲
MsgBox "〜しました。"
(p297)
vbOKOnly = 0, vbOKCancel = 1, vbYesNo = 4, vbYesNoCancel = 3
vbCritical = 16, vbQuestion = 32, vbExplamation = 48, vbInformation = 64
ボタンの構成
アイコン
vbDefaultButton1 = 0, vbDefaultButton2=256, vbDefaultButton3=512
デフォルト
vbOK = 1, vbCancel = 2, vbYes = 6, vbNo = 7
押されたボタン
If MsgBox( "〜します", vbOKCancel, "タイトル" ) = vbCancel Then _
WScript.Quit 1
(p264)
MsgBox "1" + Chr(13)+Chr(10) +"2"
複数行
MsgBox "〜しました。", vbOKOnly, "タイトル"
MsgBox は、CScript で実行しても、ウィンドウが表示されます。
WScript.Echo は、WScript ではウィンドウ表示、CScript では標準出力になります。
WScript.Echo "〜しました。"
〜しました。
または
(プロンプトへ)
vbSystemModal=4096
Shell::Popup
wscript.exe のとき
cscript.exe のとき
自動的に閉じるまでの時間を指定できる MsgBox です。
←
▼
▲
(p263)
s = InputBox( "入力してください", "タイトル", "デフォルト" )
キャンセルが押されたら、 s="" になります。
InputBox は、CScript で実行しても、ウィンドウが表示されます。
WScript.StdIn は、WScript ではエラーになります。CScript で実行してください。
Dim name
WScript.StdOut.Write "Enter your name: "
name = WScript.StdIn.ReadLine()
WScript.Echo "Hello, " & name & "!"
Enter your name: bob
Hello, bob , welcome!
WScript.StdIn
→ vbslib - input
サンプル (起動時に実行する内容の選択する)
Sub main()
Dim op
If ArgumentExist( "menu1" ) Then
op = 1
ElseIf ArgumentExist( "menu2" ) Then
op = 2
Else
op = InputBox( _
"1. menu1" +vbCRLF+_
"2. menu2",_
WScript.ScriptName )
If op = "" Then WScript.Quit 1
op = CInt( op )
End If
'// common functions
Select Case op
Case 1: '// each functions
Case 2: '// each functions
End Select
End Sub
←
▼
▲
参考
メモ帳を起動して、文字を入力するスクリプト
Set objShell = WScript.CreateObject("WScript.Shell")
objShell.Run "notepad.exe"
WScript.Sleep 500
objShell.SendKeys "hello"
→ キーボード
関連
スクリプトからカレントウィンドウにキーボード入力を送ることができます。
ただし、Sleep を使って、タイミングに気をつける必要があります。
Set sh = WScript.CreateObject("WScript.Shell")
sh.AppActivate( "net Explorer" ) '(*1)
WScript.Sleep 500
sh.SendKeys "%F"
(*1) タイトル(前方一致または後方一致の部分文字列)
IE をアクティブにして、[ファイル] メニュうーを選択するスクリプト
→ SendInput
←
▼
▲
Sub WshShell::SendKeys( keys as string )
キーボード操作をエミュレーションします。
【引数】
keys
アクティブウィンドウに送信するキーの内容
"+(EC)"
シフトキーを押しながら、E、C
"+EC"
シフトキーを押しながら、E、シフトキーを離して、C
"^C"
コントロールキーを押しながら C
"%FS"
Alt キーを押しながら F、離して S
"{ENTER}"
"{ESC}"
"{TAB}"
" " (空白文字)
keys に設定する値の例:
←
▼
▲
Dim g_sh : Set g_sh = WScript.CreateObject( "WScript.Shell" )
Dim player : Set player = CreateObject( "MediaPlayer.MediaPlayer" )
player.FileName = g_sh.ExpandEnvironmentStrings( "%windir%\Media\tada.wav" )
player.Play
While player.PlayState <> 0 : WScript.Sleep 300 : WEnd '// Wait for finish to play
→ システムの警告音 (SystemSound)
参考
→ 効果音や曲を鳴らす (SoundPlayer)
参考
Dim g_sh : Set g_sh = WScript.CreateObject( "WScript.Shell" )
SystemSound ".Default"
Sub SystemSound( Sound )
Dim player : Set player = CreateObject( "WMPlayer.OCX" )
player.Settings.Volume = 100
player.URL = g_sh.ExpandEnvironmentStrings( g_sh.RegRead( _
"HKEY_CURRENT_USER\AppEvents\Schemes\Apps\.Default\"+ Sound +"\.Current\" ) )
player.Controls.Play
While player.PlayState <> 1 '// Wait for finish to play
WScript.Sleep 300
If player.PlayState = 10 Then Err.Raise 1,, "This is not sound file."
WEnd
End Sub
Dim g_sh : Set g_sh = WScript.CreateObject( "WScript.Shell" )
Dim player : Set player = CreateObject( "WMPlayer.OCX" )
player.Settings.Volume = 100
player.URL = g_sh.ExpandEnvironmentStrings( "%windir%\Media\tada.wav" )
player.Controls.Play
While player.PlayState <> 1 '// Wait for finish to play
WScript.Sleep 300
If player.PlayState = 10 Then Err.Raise 1,, "This is not sound file."
WEnd
(参考) 下記は、Play でエラーになる場合があります。
メディアプレイヤー 7 以降が必要
メディアプレイヤーの ActiveX を使います。
←
▼
▲
If ... Then WScript.Quit 1 ' Error
WScript.Echo "Pass."
単純なテストスクリプトは、次のように記述し、標準出力を比較することで、
テストが正常かどうかを判定します。
関連
ただし、テスト項目が多くなってくると大変なので、vbslib にテストを自動化できる
ツールが用意されています。
←
▼
▲
関連
←
▼
▲
64ビットWindows には、32ビットWSH と 64ビットWSH の2種類が入っています。
64ビットWSH
64ビットWindows
32ビットWindows
32ビットWSH
%windir%\System32\cscript.exe
%windir%\SysWOW64\cscript.exe
%windir%\System32\cscript.exe
-
→ [x64] 64ビットWindows (WOW64)
参考
wscript.exe も同様です。 %windir% は通常 C:\Windows です。
←
▼
▲
Dim g_fs : Set g_fs = WScript.CreateObject( "Scripting.FileSystemObject" )
Dim path
If WScript.Arguments.Unnamed.Count <= 0 Then path = "" _
Else path = WScript.Arguments.Unnamed(0)
If path = "" Then WScript.Echo "変換するファイルをドラッグ&ドロップしてください。":WScript.Quit 1
cd g_fs.GetParentFolderName( WScript.ScriptFullName ) '// change from system32 folder
Dim out_path
out_path = g_fs.GetParentFolderName( path ) +"\"+ g_fs.GetBaseName( path ) +"_replaced.xml"
Dim r : Set r = g_fs.OpenTextFile( path )
Dim w : Set w = g_fs.CreateTextFile( out_path, False, True )
下記のスクリプトで、path にドロップしたファイルのフル・パスが入ります。
ドラッグ&ドロップすると、カレントフォルダが、C:\Windows\System32 になり危険なので、上記のように
ドロップしたファイルが入っているフォルダを、カレントフォルダにします。
←
▼
▲
CScript sample.vbs param0 param1 ...
コマンドプロンプトからスクリプトに対してパラメータを渡すことができます。
スクリプトファイルにドラッグ&ドロップしたら、ドロップしたファイルパスがパラメータになります。
WScript.Arguments.Named.Item("debug")
cscript script.vbs /debug:1
名前付き引数の値を参照する
名前付き引数の指定方法
該当する名前の引数がないときは、Empty を返します。
Item は、デフォルト・プロパティなので、省略できます。
パラメータを渡す
Set args = WScript.Arguments.Unnamed
If args.Count = 0 Then Err.Raise 1,,"ファイルをドロップしてください"
For i=0 To args.Count - 1
WScript.Echo args(i)
Next
Set args = WScript.Arguments
For i = 0 to args.Count - 1
WScript.Echo args(i)
Next
args( 0 ) が1つ目のパラメータです。
If WScript.Arguments.Count >= 1 Then
s = WScript.Arguments(0)
End If
cscript script.vbs /path:"C:\Folder X\"
"" で囲むと空白を含めることができます
cscript script.vbs /flag
Empty を返します。(/flag が無いときと変わりません)
下記の
For Each key in WScript.Arguments.Named
WScript.Echo "/" + key + ":" + WScript.Arguments.Named.Item(key)
Next
名前付き引数の名前と値を一覧します。
Unnamed( ) の中の数値が、パラメータの数以上のときは、
Err.Number = 9 のエラーになります。
args( 0 ) が1つ目のパラメータです。
Unnamed( ) の中の数値が、パラメータの数以上のときは、
Err.Number = 9 のエラーになります。
If WScript.Arguments.Named.Exists( "Config" ) Then
オプションが指定されたかどうかの判定:
パラメータが /flag:1 でも /flag でも True を返します
で判定できます。
vbslib の ArrayClass を用いれば、引数の指定をエミュレーションできます。
WScript.Arguments.Unnamed(0)
デフォルト値に対応したオプションの取得:
Dim x
config = "Default"
x = WScript.Arguments.Named( "Config" ) : If not IsEmpty( x ) Then config = x
/ から始まる Linux 形式のパスを、オプションではないパラメーターとするとき
を取得してください。
ユーザーは、/ から始まるオプションを、メイン・パラメータの後に指定してください。
If WScript.Arguments.Unnamed.Count >= 1 Then
input_path = WScript.Arguments.Unnamed(0)
Else
input_path = InputPath( "分割するファイル >", )
End If
\" \\\" \\\\\" \\"a > b" \\\\"c d"
\ \\\
\\\\\ \\a
b" \\\\"c
d
コマンドラインやバッチファイルに VBScript の引数を複数指定するときは、空白文字で区切ります。
・" " で囲むと空白文字を要素に含めることができます
・" " で囲んだ隣が空白文字でなければ、要素の続きになります
>
" 文字を、WScript.Argument に渡す
\'/Option\'
"/Option"
…
以下は、cmd.exe のコマンドラインと異なる、Shell::Run などに指定するコマンドラインについてです。
・" 文字を、WScript.Argument に渡すことはできません
・vbslib では、\' 文字を指定することで " 文字を渡すことができ、/ から始まる名前なし引数を
渡すことができjます(下記リンク先を参照)
・\, ^, >, < 文字はエスケープ文字や特殊な機能を持つ文字ではありません
参考
WSH では変換されない
vbslib のみ。
ただし、vbslib では、特殊な形式で渡されれば、
で取得
できます。