IMAPIFormMgr::SelectForm
Aplica-se a: Outlook 2013 | Outlook 2016
Apresenta uma caixa de diálogo que permite que o usuário selecione um formulário e retorna um objeto de informações de formulário que descreve esse formulário.
HRESULT SelectForm(
ULONG_PTR ulUIParam,
ULONG ulFlags,
LPCSTR pszTitle,
LPMAPIFOLDER pfld,
LPMAPIFORMINFO FAR * ppfrminfoReturned
);
Parâmetros
ulUIParam
[in] Um identificador para a janela pai da caixa de diálogo exibida.
ulFlags
[in] Um bitmask de sinalizadores que controla o tipo de cadeias de caracteres passadas. O seguinte sinalizador pode ser definido:
MAPI_UNICODE
As cadeias de caracteres passadas estão no formato Unicode. Se o sinalizador MAPI_UNICODE não estiver definido, as cadeias de caracteres estarão no formato ANSI.
Psztitle
[in] Um ponteiro para uma cadeia de caracteres que contém o legenda da caixa de diálogo. Se o parâmetro pszTitle for NULL, o provedor de biblioteca de formulários fornecerá um legenda padrão.
pfld
[in] Um ponteiro para a pasta da qual selecionar o formulário. Se o parâmetro pfld for NULL, o formulário poderá ser selecionado no contêiner de formulário local, pessoal ou de organização.
ppfrminfoReturned
[out] Um ponteiro para um ponteiro para o objeto de informações de formulário retornado.
Valor de retorno
S_OK
A chamada foi bem-sucedida e retornou o valor ou valores esperados.
MAPI_E_BAD_CHARWIDTH
O sinalizador MAPI_UNICODE foi definido e a implementação não dá suporte ao Unicode ou MAPI_UNICODE não foi definido e a implementação dá suporte apenas ao Unicode.
MAPI_E_USER_CANCEL
O usuário cancelou a operação, normalmente clicando no botão Cancelar na caixa de diálogo.
Comentários
Os visualizadores de formulário chamam o método IMAPIFormMgr::SelectForm para primeiro apresentar uma caixa de diálogo que permite que o usuário selecione um formulário e, em seguida, recupere um objeto de informações de formulário que descreve o formulário selecionado. A caixa de diálogo restringe o usuário a selecionar um único formulário.
Notas para chamadores
A caixa de diálogo SelectForm exibe apenas formulários que não estão ocultos (ou seja, formulários que têm suas propriedades ocultas desmarcadas). Se um visualizador de formulários passar o sinalizador MAPI_UNICODE no parâmetro ulFlags , todas as cadeias de caracteres serão Unicode. Os provedores de biblioteca de formulários que não dão suporte a cadeias de caracteres Unicode devem retornar MAPI_E_BAD_CHARWIDTH se MAPI_UNICODE for aprovada.
Referência do MFCMAPI
Para ver códigos de exemplo do MFCMAPI, confira a tabela a seguir.
| Arquivo | Função | Comentário |
|---|---|---|
| FolderDlg.cpp |
CFolderDlg::OnSelectForm |
O MFCMAPI usa o método IMAPIFormMgr::SelectForm para selecionar um formulário e enviar informações sobre o formulário para um ou mais logs. |