Filter でフィルター処理されたアイテムを含む Table オブジェクトを取得します。
構文
expression.
GetTable( _Filter_ , _TableContents_ )
式 'Folder' オブジェクトを表す変数。
パラメーター
| 名前 | 必須 / オプション | データ型 | 説明 |
|---|---|---|---|
| Filter | 省略可能 | String | 親 フォルダー内のアイテムの条件を指定する、Microsoft Jet または DAV 検索と検索 (DASL) 構文のフィルター。 |
| TableContents | 省略可能 | OlTableContents | GetTable が返すフォルダー内のアイテムの種類を指定します。 既定では olUserItems です。 |
戻り値
親オブジェクト Folder 内で Filter の基準を満たすアイテムが含まれている Table オブジェクト。 TableContents を既定値の olUserItems で使用した場合、隠されていないフィルター処理されたアイテムのみが Table オブジェクトに含まれて返されます。
注釈
Filter が空白文字列の場合、または Filter パラメーターが省略された場合、GetTable はフォルダー内のすべてのアイテムを表す行を含む Table を返します。 Filter が空白文字列の場合、または Filter パラメーターが省略され、TableContents が olHiddenItems の場合、GetTable は、フォルダー内のすべての非表示アイテムを表す行を含む Table を返します。
フィルタの詳細については、「 アイテムのフィルタリング 」および 「名前空間によるプロパティの参照」を参照してください。
GetTable は、親 フォルダー のフォルダーの種類に設定する既定の列を持つ テーブル を返します。 既定の列セットを変更するには、 Columns コレクションのオブジェクトの 追加 、 削除 、または RemoveAll メソッドを使用します。 TableContents が olHiddenItems の場合、親フォルダーが連絡先フォルダーなどであっても、既定の列セットは常にメール フォルダーの既定の列セットになります。 既定の列セットの詳細については、「Table オブジェクトに表示される既定のプロパティ」を参照してください。
Folder オブジェクトに基づくテーブルに後続のフィルターを適用するには、Table.Restrict を使用します。
例
マッチング を使用して、受信トレイ内のアイテムの LastModificationTime に基づいて Table オブジェクトを取得する方法を次のコード例に示します。 列挙し、これらのアイテムの既定のプロパティのいくつかの値を表示します。
Sub DemoTable()
'Declarations
Dim Filter As String
Dim oRow As Outlook.Row
Dim oTable As Outlook.Table
Dim oFolder As Outlook.Folder
'Get a Folder object for the Inbox
Set oFolder = Application.Session.GetDefaultFolder(olFolderInbox)
'Define Filter to obtain items last modified after May 1, 2005
Filter = "[LastModificationTime] > '5/1/2005'"
'Restrict with Filter
Set oTable = oFolder.GetTable(Filter)
'Enumerate the table using test for EndOfTable
Do Until (oTable.EndOfTable)
Set oRow = oTable.GetNextRow()
Debug.Print (oRow("Subject"))
Debug.Print (oRow("LastModificationTime"))
Loop
End Sub
関連項目
サポートとフィードバック
Office VBA またはこの説明書に関するご質問やフィードバックがありますか? サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。