Objeto Row (Outlook)
Representa uma linha de dados do objeto Table.
Uma tabela é composta de linhas e colunas. Ela representa um rowset dinâmico somente leitura de dados em um objeto Folder ou Search. Você pode considerar cada linha de uma tabela como um item na pasta e cada coluna como uma propriedade do item. Por padrão, a tabela contém apenas um subconjunto das propriedades de itens na pasta. Isso faz com que a tabela um rowset leve de na memória que ofereça suporte a enumeração rápida e filtragem de itens na pasta.
Se o objeto Table for obtido de Folder.GetTable, você poderá ampliar a especificação do filtro (em Table.Restrict) para obter um conjunto de linhas mais restrito no objeto Table.
Use os métodos Table: FindRow, FindNextRow, GetNextRow e MoveToStart para obter uma linha específica em uma Tabela.
Use GetValues para obter uma matriz de valores que correspondem aos valores da coluna dessa linha da tabela.
Use as funções do auxiliar Row.BinaryToString, Row.LocalTimeToUTC e Row.UTCToLocalTime para facilitar a conversão de tipo de valores de coluna em uma linha específica. Para obter mais informações sobre representação de valor de propriedade em um objeto Table, consulte Fatores que afetam a representação de valor da propriedade nas classes Table e View.
Embora as adições e exclusões da pasta base serão refletidas pelas linhas na tabela, a tabela não suporta todos os eventos para adicionar, alterar e remoção de linhas. Se precisar de um objeto gravável da linha da tabela, obter o ID de entrada dessa linha do padrão EntryID coluna da tabela e use o método GetItemFromID do objeto NameSpace para obter um item completo, como MailItem ou ContactItem, que suporta operações de leitura / gravação. Para obter mais informações sobre colunas padrão em um Table, consulte Propriedades padrão exibidas em um objeto Table.
O exemplo de código a seguir ilustra como obter um objeto Table com base no LastModificationTime dos itens na caixa de entrada. Ele também mostra como personalizar as colunas na tabela e como enumerar e imprimir os valores das propriedades correspondentes desses itens.
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)
'Remove all columns in the default column set
oTable.Columns.RemoveAll
'Specify desired properties
With oTable.Columns
.Add ("Subject")
.Add ("LastModificationTime")
'PR_ATTR_HIDDEN referenced by the MAPI proptag namespace
.Add ("http://schemas.microsoft.com/mapi/proptag/0x10F4000B")
End With
'Enumerate the table using test for EndOfTable
Do Until (oTable.EndOfTable)
Set oRow = oTable.GetNextRow()
Debug.Print (oRow("Subject"))
Debug.Print (oRow("LastModificationTime"))
Debug.Print (oRow("http://schemas.microsoft.com/mapi/proptag/0x10F4000B"))
Loop
End Sub
Referência de modelo de objeto do Outlook
Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.