VBA リファレンスに載っていない書き方

Question

前提・実現したいこと

VBAリファレンスに載っていない構文（書き方）は皆さんどこでお知りになるのでしょうか。
いま下記のソースコードに記載したコードを書いています。
もとはネットからの寄せ集めで、ひとつひとつどんな構造か調べながら微修正しているような形です。

たとえば、 この部分↓

Set mySubfolder = myInbox.Folders.Item("格納用")

成り立ちを確認しようと思ってネットを調べて、

FoldersコレクションやItemメソッドについてのこれらのページ
http://outlook-navi.com/vbs/vbs56.htm
http://outlook-navi.com/vbs/vbs64.htm
を読みます。一応なるほどそう書けばいいのか、と思います。

ではリファレンスではどう書いてあるのかとリファレンスを見ると
[Itemのリファレンス]
https://docs.microsoft.com/ja-jp/office/vba/api/outlook.items.item
⇒("ファイル名")にすればいいってなぜわかるの？と疑問に思う

[Foldersコレクションのリファレンス]
https://docs.microsoft.com/ja-jp/office/vba/language/reference/user-interface-help/folders-collection
⇒.Foldersという書き方はどこからきたの？と疑問に思う

いまいち解決しなくて、一応動くので、このままやり過ごしてしまうのですが。。。

リファレンスに構文として載っていないということは、オフィシャルな書き方ではないということなんでしょうか。
ベースの知識として”そう書くもの”と分かるべき部分なんでしょうか？
ご助言いただけたら幸いです。

該当のソースコード

Sub GetMail()

    Dim objOutlook As Outlook.Application
    Dim myNamespace As Outlook.Namespace
    Dim myInbox As Object
    Dim mySubfolder As Object
    Dim i As Integer
    
    Set objOutlook = New Outlook.Application
    Set myNamespace = objOutlook.GetNamespace("MAPI")
    Set myInbox = myNamespace.GetDefaultFolder(olFolderInbox)
    Set mySubfolder = myInbox.Folders.Item("格納用")
 
    For i = 1 To mySubfolder.Items.Count
        With ThisWorkbook.Worksheets("Sheet1")
            .Cells(i + 1, 1).Value = mySubfolder.Items(i).SentOn
            .Cells(i + 1, 2).Value = mySubfolder.Items(i).Subject
            .Cells(i + 1, 3).Value = mySubfolder.Items(i).Body
       End With
    Next i
        
End Sub

Comments

[m.ts10806]

コードやエラーはマークダウンのcode機能を利用してご提示ください。
https://teratail.com/questions/238564

あと、リンクは
[リンク文言](URL)
です。
https://teratail.com/help#about-markdown

[meg_]

・リンクは「リンクの挿入」で記入してください。
・コードは「コードの挿入」で記入してください。

[yukitaro223]

正しくない書き方で投稿してしまいすみません。マークダウン利用して編集しました。

Answer 1

⇒.Foldersという書き方はどこからきたの？と疑問に思う

これは見るところを間違っています。Folder#Foldersプロパティです（MSDN）。

Comments

[maisumakun]

今アクセスしているオブジェクトが、どんな「型」なのか考えてみましょう。VBAはあまりメチャクチャなことができない言語なので、それで追えるはずです。

[yukitaro223]

回答有難う御座います。すみません、”オブジェクト　型”という言葉だとあまりそれらしきものが検索ヒットしないのですが、別のキーワードいただけませんでしょうか。

[maisumakun]

> すみません、”オブジェクト　型”という言葉だとあまりそれらしきものが検索ヒットしないのですが

ネット上を検索するのではなく、ソースコードを見て考えるべきものです。

Answer 2

リファレンスはよくある使い方や、とりあえず動かせる、といったもので、それが全てではありません。

maisumakun さんのコメントのとおり、VBAで使用できるオブジェクトのほとんどはできることが決まっているため、そのオブジェクトがどのような型であるか？を特定できれば何ができるのかもおおよそわかります。

「できること」の調べ方

リファレンスを見ないとわからないこともありますが、VBAのエディタだけでもそれなりの内容は調べられます。

静的な定義の確認(「オブジェクトブラウザ」)

型がどんな機能(プロパティ・メソッドなど)を持っているのか？を定義したものとして「タイプライブラリ」というものがあります。

VBAのエディタでは、「ツール(T)>参照設定(R)…」から一覧の確認・追加ができ、「オブジェクトブラウザ」から内容を閲覧できます(よく使うタイプライブラリのほとんどはMicrosoft ~という名前です)。

「オブジェクトブラウザ」を見れば、どの型にどんな機能があるのか、といった定義を確認できます。

しかし、定義だけでは曖昧な部分があるため、そのような場合には、
VBAのエディタの機能である「ローカルウィンドウ」・「ウォッチウィンドウ」を使うと実際にどうなっているのかを確認できます。

動的な中身の確認(「ローカルウィンドウ」・「ウォッチウィンドウ」)

「ローカルウィンドウ」も「ウォッチウィンドウ」もVBAの実行中に何かしらの値を確認するためのものです。

確認する値の指定方法に違いがあり、「ローカルウィンドウ」はローカル変数を自動で表示し、「ウォッチウィンドウ」は自分で確認したいものの式を指定します。

個人的には、表示さえすれば自動で動作する「ローカルウィンドウ」の方が、使いやすいと思います。

これらを使うと、変数の値や、オブジェクトの実際の型やプロパティの確認、オブジェクトがコレクション(For Eachなどで列挙できるもの)かどうか、などが確認できます。

---

また、質問の一部にあるItemに関しては以下のような慣例があるため、「そういうもの」に近いです。

慣例

VBAで扱えるオブジェクトのうち、型の名前が~sと複数形のものはコレクション(For Eachなどで列挙できるもの)であり、
Countで要素数の取得、Itemに文字列(名前)か整数を渡すことでその要素の取得ができる(Itemは既定のメンバーで省略できることも多い)。

例

質問のソースコードでいうと以下の箇所が該当します。

• Folders.Item("格納用")(Outlook.Folders型のItemメソッドの呼び出し)
• Worksheets("Sheet1")(Excel.Sheets型のItemプロパティの呼び出し)
• Items(i)(Outlook.Items型のItemメソッドの呼び出し)

あくまで慣例ですので、当てはまらないものもあります。
例えばCells(i + 1, 1)は、Excel.Range型のItemプロパティの呼び出しとなっており、型名が複数形ではありません(MS Office系であれば~Rangeは単一または複数のオブジェクトを抽象化して示す型、という傾向はありますが)。