Compartilhar via

Criar um modo de exibição

  • Artigo

Este exemplo mostra como usar o método Add(String, OlViewType, OlViewSaveOption) da coleção Views para criar um modo de exibição para o objeto Folder.

Exemplo

Observação

O exemplo de código a seguir é um trecho da Programação de aplicativos do Microsoft Office Outlook 2007.

Você pode criar modos de exibição personalizáveis que permitem que você classifique, agrupe e exiba dados de todos os tipo diferentes no Painel de Exibição da janela do explorador do Outlook. Você também pode personalizar modos de exibição internos de modo programático. A tabela a seguir lista os objetos que representam os modos de exibição do Outlook.

Nome do Objeto

Descrição

BusinessCardView

Os dados são exibidos como uma série de imagens de cartões de visita eletrônicos.

CalendarView

Os dados são exibidos no formato de calendário.

CardView

Os dados são exibidos em uma série de cartões.

IconView

Os dados são exibidos como ícones da pasta Windows ou ícones do explorador.

TableView

Os dados são exibidos como uma tabela simples baseada em um campo.

TimelineView

Os dados são exibidos em uma linha do tempo linear personalizável.

Você pode acessar métodos e propriedades que são comuns para todos os modos de exibição usando o objetoView. Entretanto, para acessar certas propriedades que não são comuns para todos os modos de exibição, você deve converter o objeto View em um objeto View derivado ao qual pertence a propriedade que você quer acessar. Por exemplo, para acessar a propriedade HeadingsFont do objeto Cardview, converta o objeto View no objeto Cardview. Se você quiser determinar que tipo de modo de exibição é representado por um objeto View específico, use a propriedade ViewType.

Para criar um novo modo de exibição, use o método Add da coleção Views para um objeto Folder. Em seguida, defina a visibilidade do modo de exibição no momento da criação ou a qualquer momento depois que o modo de exibição for criado. Para definir a visibilidade do modo de exibição no momento da criação, especifique uma constante OIViewSaveOption no parâmetro SaveOption do método Add. Para definir a visibilidade a qualquer momento depois da criação do modo de exibição, especifique uma constante OlViewSaveOption para a propriedade SaveOption do objeto View.

A adição de um novo modo de exibição gera o evento ViewAdd evento da coleção Views. Após a criação do modo de exibição, personalize o modo de exibição programaticamente convertendo o objeto View em um dos objetos derivados e fazendo as alterações necessárias em seguida. Use o método Save do objeto derivado View, ou o objeto View para salvar quaisquer alterações no modo de exibição. Finalmente, use o método Apply do objeto derivado View ou o objeto View para aplicar o modo de exibição ao objeto Explorer atual. Isso gera o evento ViewSwitch do objeto Explorer.

O exemplo de código a seguir, CreateMeetingRequestsView, adiciona um novo modo de exibição chamado “Meeting Requests” à Caixa de Entrada do usuário gerando um objeto View para um objeto TableView. CreateMeetingRequestsView chama o método Add do objeto Views com o parâmetro Name definido para “Meeting Requests” e o parâmetro ViewType definido para olTableView. A propriedade Filter do objeto TableView é definida para uma cadeia de caracteres DAV Searching and Locating (DASL), que faz com que o modo de exibição exiba apenas quando houver itens que contêm “IPM.Schedule” na classe de mensagem do item. Então, o novo modo de exibição é salvo e aplicado.

Se usar o Visual Studio para testar este exemplo de código, adicione primeiro uma referência ao componente da biblioteca de objetos do Microsoft Outlook 15.0 e especifique a variável do Outlook quando importar o namespace Microsoft.Office.Interop.Outlook. A instruçãousing não deve ocorrer diretamente antes das funções no exemplo de código, mas deve ser adicionada antes da declaração de classe pública. The following line of code shows how to do the import and assignment in C#.

using Outlook = Microsoft.Office.Interop.Outlook;

private void CreateMeetingRequestsView()
{
    const string PR_MESSAGE_CLASS =
        "http://schemas.microsoft.com/mapi/proptag/0x001A001E";
    Outlook.Views views =
        Application.Session.GetDefaultFolder(
        Outlook.OlDefaultFolders.olFolderInbox).Views;
    Outlook.TableView tableView = (Outlook.TableView)
        views.Add("Meeting Requests",
        Outlook.OlViewType.olTableView,
        Outlook.OlViewSaveOption.olViewSaveOptionThisFolderEveryone);
    tableView.Filter = "\"" + PR_MESSAGE_CLASS + "\"" +
        " like 'IPM.Schedule%'";
    tableView.Save();
    tableView.Apply();
}

Confira também