「自動クイックヒント」を使いこなそう（その１） - Excelマクロ・VBA

エクセルマクロ・VBAでプログラムを書いているとき、引数の順番とか、引数のデータ型に迷ったり、名前付き引数の名前を正しく書けなかったり、といったトラブルはありませんか？
例えば、こんな感じ。

• Left関数の第一引数って、文字列だったっけ？数値だったっけ？
• Sortメソッドで並べ替えするとき、第一条件って、「KeyA」って書くんだっけ？「OrderA」って書くんだっけ？

今日は、そんな問題を回避するための、分かれば便利なテクニックをご紹介します。
まずは、これからご紹介するテクニックを利用可能な状態になっているかどうか、設定の確認から。

開発環境（Visual Basic Editor 略称VBE）のメニューバーで、[ツール] → [オプション]を選択します。

「編集」タブに、「自動クイックヒント」というボタンがあります。 チェックが入っていることを確認します。
（デフォルトの設定のままなら、入っているはずです）

では、Left関数でも書いてみますか。
サブプロシージャを、ひとつ作ります。
以下まで、書いてください。

Sub hoge()  
      Dim s As String s = left  
End Sub  

そうして、leftのあと、カッコ「 ( 」を書きます。
そうすると、以下のように、メッセージがでてきます。
小さくて黄色いヤツ。

Left(String, Length As Long)とのこと。
これ、どういうことかというと...ざっくり言うと、

• Left関数の第一引数は、String、つまり、「文字列」だよ
• Left関数の第二引数は、Length As Long、つまり、「長さ」だよ。この引数で渡すデータは、「Long型」、つまり、「整数として解釈し得る値だよ」
• そして、今、Left関数の第一引数を入力中だよ

という意味です。
赤字になっているのが、今扱っている引数に関する部分。
ふんふん、なるほど。

てことで、ひきつづき、以下まで書いてみる。

Left("あらのよろし",  

すると、今度は、表記がこうなりました。

Left(String, Length As Long)となっている。これは、

• Left関数の第一引数は、String、つまり、「文字列」だよ
• Left関数の第二引数は、Length As Long、つまり、「長さ」だよ。この引数で渡すデータは、「Long型」、つまり、「整数として解釈し得る値だよ」
• そして、今、Left関数の第二引数を入力中だよ

ということです。
こんな感じに、関数を書くとき、その引数を教えてくれるんですね。
便利です ヾ(´ー｀)ﾉ

Left関数について、Microsoftの公式サイトで調べてみました。

Left 関数

文字列の左から数えて指定した数の文字を含むバリアント型 (内部処理形式 String の Variant) を返します。

構文：Left(string, length)

Left 関数の構文には、次の名前付き引数があります。

赤太字（＋斜体）の部分と表が、この関数の引数について解説している部分。
やはり、渡す引数は「String, Length」ですね。
Lengthについては、よく読んでみると、「Long型として解釈し得る値を指定しろ」という趣旨のことが書いてあります。
Sort等の「メソッド」でも、同様です。
参考までに、下記にSortメソッドのヘルプも貼りつけておきます。 ヾ(´ー｀)ﾉ

Range.Sort メソッド

名前空間: Microsoft.Office.Interop.Excel
アセンブリ: Microsoft.Office.Interop.Excel.dll

指定した範囲にセルが 1 つだけ含まれている場合は、ピボットテーブル レポート、範囲、またはアクティブな領域を並べ替えます。

なお、「自動クイックヒント」という機能は、自作の関数についても同様に機能します。
なので、普段から、自作の関数を作るときも、引数のネーミングには気をつけましょう。
極端な例ですが、上記の自作関数であれば、引数の名前も、「s, i1, i2」とかよりも、以下のようにしたほうが数段勝ります。

引数には、可読性の高い名前を！
自作関数を作るとき、引数の名前からはどの引数にどういう値を入れるべきか分かるようにしておかないと、その関数を呼び出すマクロを書くとき、いちいちその関数を書いたところまで見にいって確認しなくてはなりません。
今回紹介したサンプルでは近くにあるから迷いませんが、これが、その自作関数が別プロシージャにあったり、同一モジュール内でも、遠くにあったりすると、いちいち確認するのがかなり面倒になります (´・ω・｀)

あと、この「自動クイックヒント」という機能。
人によっては、「自動パラメータヒント」と呼ぶ人もあります。

ということで、エクセル仕事をたくさん抱えているあなた。
お申し込みは、こちら↓です。
ベタな初心者の方は、VBA基礎編 でお待ちしております。