MAPIFolder.SetCustomIcon(StdPicture) Método

Definição

Namespace:

Microsoft.Office.Interop.Outlook

Assembly:

Microsoft.Office.Interop.Outlook.dll

Define um ícone personalizado especificado pela Picture pasta.

public:
 void SetCustomIcon(stdole::StdPicture ^ Picture);

public void SetCustomIcon (stdole.StdPicture Picture);

Public Sub SetCustomIcon (Picture As StdPicture)

Parâmetros

Picture

StdPicture

Especifica o ícone personalizado para a pasta.

Comentários

O StdPicture objeto especificado por Picture deve ter sua propriedade Type igual a PICTYPE_ICON ou PICTYPE_BITMAP. O recurso de ícone ou bitmap pode ter um tamanho máximo de 32 x 32. Os ícones são 16 x 16 ou 24 x 24 também são suportados e Microsoft Outlook pode dimensionar um ícone de 16 x 16 se o Outlook estiver sendo executado no modo de alta pontos por polegada (DPI). Ícones de outros tamanhos causam SetCustomIcon retornar um erro.

Você pode definir um ícone personalizado para uma pasta de pesquisa e para todas as pastas que não representam um padrão ou uma pasta especial. Se você tentar definir um ícone personalizado para uma pasta que pertence a um dos seguintes grupos de pastas, SetCustomIcon retornará um erro:

Você só pode chamar GetCustomIcon de código que é executado em processo como o Outlook. Um objeto StdPicture não pode ser enfileirado nos limites do processo. Se você tentar chamar GetCustomIcon do código de fora do processo, ocorre uma exceção. Para obter mais informações, consulte Um servidor de automação não pode passar um ponteiro para a implementação IPictureDisp do objeto de imagem entre os limites do processo

O ícone personalizado de pasta fornecido por este método não persiste além da sessão do Outlook em execução. Portanto, os suplementos devem definir o ícone personalizado de pasta sempre que o Outlook for inicializado.

O ícone personalizado de pasta não aparece em outros clientes do Exchange, como o Outlook Web Access, nem no Outlook em execução em um dispositivo Windows Mobile.