IItem::Display

Windows Mobile 6.5
4/8/2010

The Display method displays the PIM item's Summary card.


HRESULT Display(
  HWND hwndParent
);

hwndParent

[in] Handle to the parent window.

This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following.

S_OK

The method completed successfully.

You can call IItem::Display on unsaved as well as saved PIM items. All saved PIM items and unsaved Contact items display in their associated Summary Cards, while unsaved Appointment and Task items display in their associated Edit Cards.

IItem::Display is equivalent to IAppointment::Display, IContact::Display, and ITask::Display.

Set hWnd to the handle of the window that you want the summary card "parented" to.

If hWnd is NULL, then IItem::Display uses the window handle passed into IPOutlookApp::Logon instead.

The following code example demonstrates how to use IItem::Display.

Bb446023.note(en-us,MSDN.10).gifNote:
To make the following code example easier to read, security checking and error handling are not included. This code example should not be used in a release configuration unless it has been modified to include them.
HRESULT DisplayExample(IItem *pItem)
{
    HRESULT hr   = E_FAIL;
    HWND    hWnd = NULL;

    hr = pItem->Display(hWnd);

    // This statement is reached after the summary card is dismissed.

    return hr;
}

Headerpimstore.h
LibraryPimstore.lib
Windows MobilePocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later

Reference

IItem

Other Resources


Community Additions

Show: