Compartilhar via

IPimSrcContactSummaryCard::Display

  • Artigo

Windows Mobile SupportedWindows Embedded CE Not Supported

9/8/2008

The Exibição método permite que um provedor de fonte para over-ride na guia exibir resumo de contato usar como padrão e exibir um alternativo caixa diálogo guia resumo a ser usado quando um contato item é aberto a partir de contatos exibição de lista.

Observação

Para utilizar esse mecanismo, você deverá fornecer seu próprio implementação para Exibição, em uma nova classe que deriva de IPimSrcContactSummaryCard.

Syntax

HRESULT Display(
   HWND hwndParent,
   IItem * pitem
)

Parameters

  • hwndParent
    [no] Identificador (HWND) para o janela pai. Para informações sobre o HWND tipo, consulte GetParent.

Return Value

This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED GPSGetPosition, e E_FAIL, as well as o seguinte.

  • S_OK
    The method completed successfully.

Remarks

Fonte provedores e seus associado fazem do Source ID parte de um mecanismo que ofereça suporte por-provedor personalização da experiência do gerenciador de informações pessoais em dispositivos Windows Mobile powered.

Um provedor de origem é um personalizado função que personaliza experiência do usuário Gerenciador de informações pessoais. Normalmente, um provedor de fonte tem uma correspondente associar função que é responsável Sincronizando dados gerenciador de informações pessoais com o dispositivo Windows Mobile powered. Dados sincronizado com o dispositivo Windows Mobile powered por este associar função é marcada com uma marca de identificação de fonte (Source ID). Quando Outlook Mobile exibe um PIM item, ele verifica se o item tem um ID. de origem Se encontrar um, ele chama o provedor de fonte, que personaliza a interface usuário para o gerenciador de informações pessoais item.

Quando os usuários inserem novos contatos e compromissos, pode selecionar um provedor de fonte para associar com eles.

Um válido Source ID é um DWORD com somente conjunto 1 bit (isto é, há identificações de origem possíveis 32).

Embora sejam itens de contatos e compromissos, regardless of Source ID, sincronizado com Microsoft Exchange — as identificações de origem não são.

As identificações de origem não são com suporte para itens de tarefas.

Como contatos e compromissos podem ser associado com apenas uma Source Provider, sua implementação instalação Source Provider deve selecionar um Source ID that is exclusivo no domínio de todos os Source Providers instalado o dispositivo Windows Mobile powered (ele é considerado um erro para determinar as identificações de fonte prior to instalar). A implementação deve escolher um exclusivo Source ID por Iterando primeiro sobre o Source Providers instalado registrado na chave \HKLM\PIMSources\ e, em seguida, escolhendo o próximo disponível ID. de origem

O valor Source ID usar como padrão é zero (0). Itens de contato e compromisso com um valor Source ID do zero não são associado com um Source Provider e apenas use a interface usuário usar como padrão.

Sua implementação desinstalar Source Provider deve redefinir o campo Source ID de tudo associado itens de contatos e compromissos voltar para zero.

Exemplo de código

O seguinte exemplo de código demonstra como usar IPimSrcContactSummaryCard::Display. Este método é implementado como um interface COM, que é chamado quando você registrar um provedor origem e conjunto de contatos propriedade Source ID do item para coincidir com esse determinado Source Provider.

Observação

Para tornar o exemplo de código mais fácil para ler, verificação de segurança e manipulação de erro não estão incluídos.This code example should not be used in a release configuration unless it has been modified to include them.

STDMETHODIMP CTestProvider::Display(HWND hwndParent, IItem *pItem)
{
    HRESULT      hr               = E_FAIL;
    const WORD   cProps           = 2;
    const int    iBufLen          = 1024;
    CEPROPVAL  * rgVals           = NULL;
    ULONG        cbBuffer         = 0;

    HANDLE       hHeap            = GetProcessHeap();
    CEPROPID     rgPropID[cProps] = {PIMPR_OID, PIMPR_FIRSTNAME};

    TCHAR        tszBuffer[iBufLen];

    // Assume that pItem is a Contact item, and get its properties to display.
    hr = pItem->GetProps(rgPropID, CEDB_ALLOWREALLOC, cProps, &rgVals, &cbBuffer, hHeap);

    hr = StringCchPrintf(tszBuffer, iBufLen, _T("OID = 0x%x\n FirstName = %s\n"), rgVals[0].val.ulVal, rgVals[1].val.lpwstr);

    // Display a custom message box instead of the standard summary card.
    MessageBox(NULL, tszBuffer, _T("Custom Summary Tab"), MB_SETFOREGROUND | MB_OK);

    if(NULL != rgVals)
        HeapFree(hHeap, 0, rgVals);

    return hr;
}

Requirements

Header pimstore.h
Library Pimstore.lib
Windows Mobile Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later

See Also

Reference

IPimSrcContactSummaryCard
Customizing the PIM User Experience by Using Source Providers
Source Provider Customization Type Flags
Source Provider PIM Type Ownership Flags
PIMSRC_COLOR
IPimSrcContactListIcon::Paint
IPimSrcContactNew::Create
IItem::Display
IAppointment::Display

Other Resources

Register a Source Provider