Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Aplica-se a: Outlook 2013 | Outlook 2016
Uma folha de propriedades é uma caixa de diálogo para exibir as propriedades de um objeto. As propriedades podem ser somente leitura, permitindo que o usuário apenas as visualize ou leia/escreva, permitindo que o usuário faça alterações. Uma folha de propriedades contém uma ou mais janelas filho sobrepostas chamadas páginas. Cada página contém janelas de controle para definir um grupo de propriedades relacionadas. Os usuários navegam de página em página selecionando uma guia que traz a página correspondente para o primeiro plano da folha de propriedades.
Os provedores de serviços devem implementar uma folha de propriedades que exibe um conjunto mínimo de propriedades relacionadas à configuração no serviço de mensagem. Se você permitir que essas propriedades do serviço de mensagem sejam alteradas, poderá permitir que usuários de aplicativos cliente, como o Painel de Controle, façam as alterações ou implementem as alterações programaticamente. Implementar planilhas de propriedades para exibir e editar outros tipos de propriedades é opcional.
Normalmente, você precisará exibir uma folha de propriedades nas seguintes situações:
Quando um cliente chama o método IMAPIStatus::SettingsDialog do objeto status.
Quando MAPI chama o método de logon do objeto provedor.
Quando MAPI chama a função de ponto de entrada para o serviço de mensagens do provedor.
Os provedores de transporte também implementam planilhas de propriedades para exibir propriedades relacionadas às opções de mensagem e os provedores de catálogo de endereços implementam planilhas de propriedades para exibir e editar informações detalhadas sobre usuários de mensagens e listas de distribuição, critérios avançados de pesquisa e modelos para inserir novos usuários.
Você pode usar uma das três técnicas a seguir para criar uma folha de propriedades:
Manualmente, como faria com qualquer caixa de diálogo.
Usando o controle comum da folha de propriedades fornecido no SDK do Windows.
Usando uma tabela de exibição MAPI.
Os provedores devem escolher a última opção (criar uma folha de propriedades usando uma tabela de exibição). Essa é a opção mais simples porque elimina a necessidade de trabalhar com a interface do usuário do Windows.
Para implementar uma folha de propriedades criada a partir de uma tabela de exibição para suas propriedades do serviço de mensagem, use o seguinte procedimento:
Chame IMAPISupport::OpenProfileSection para abrir uma seção no perfil atual. Passe seu MAPIUID ou NULL para abrir a seção de perfil do provedor.
Chame CreateIProp para criar um objeto de dados de propriedade.
Chame o método IMAPIProp::CopyTo da seção de perfil para copiar todas as propriedades da seção para o objeto de dados de propriedade.
Crie uma tabela de exibição criando uma ou mais estruturas DTPAGE que descrevem os controles a serem exibidos na folha de propriedades e chamando a função BuildDisplayTable ou implementando código personalizado.
Chame IMAPISupport::D oConfigPropsheet para exibir uma folha de propriedades que tenha as propriedades copiadas. Passe um ponteiro para o objeto de dados de propriedade como o parâmetro lpConfigData e um ponteiro para a tabela de exibição como o parâmetro lpDisplayTable . Se você quiser substituir o modo de acesso padrão para essa folha de propriedades, não defina o sinalizador de DT_EDITABLE para cada controle na tabela de exibição que representa uma propriedade somente leitura.
Quando todas as alterações forem feitas na folha de propriedades, chame o método IMAPIProp::CopyTo do objeto de propriedade para copiar as propriedades alteradas de volta para a seção de perfil.
Para obter uma visão geral das tabelas de exibição, consulte Tabelas de Exibição.
Para obter informações detalhadas sobre tabelas de exibição, consulte Implementação da Tabela de Exibição.
Para obter informações sobre como implementar um controle, consulte Implementação de Objeto de Controle.
Para recuperar o índice de um controle que um usuário seleciona em uma caixa de lista de tabelas de exibição, aguarde até que o usuário clique em OK ou Aplicar. Neste ponto, o identificador de entrada do item selecionado é gravado de volta na interface IMAPIProp : IUnknown como o valor da propriedade especificada pelo membro ulPRSetProperty na estrutura DTBLLBX .
Se você precisar ser capaz de adicionar ou remover itens da sua caixa de listagem, o uso de uma tabela de exibição e o método IMAPISupport::D oConfigPropsheet não funcionará. Em vez disso, considere implementar uma folha de propriedades com a API da folha de propriedades Win32 contida no arquivo comdlg32.dll.