IItem::Display

Article
08/28/2006

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

Syntax

HRESULT Display(
  HWND hwndParent
);

Parameters

hwndParent
[in] Handle to the parent window.

Return Values

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.

Remarks

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

You can call IItem::Display on unsaved as well as saved PIM items.

Code Example

The following code example demonstrates how to use Display.

Note 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;

    // You should set the hWnd to the window you want to summary card to be parented to.
    // If hWnd = NULL, then it uses the hwnd passed into IPOutlookApp::Logon.
    // The summary card displayed depends on the item type.
    hr = pItem->Display(hWnd);

    // This statement is reached after the summary card is dismissed.
    return hr;

}

Requirements

Pocket PC: Windows Mobile Version 5.0 and later
Smartphone: Windows Mobile Version 5.0 and later
OS Versions: Windows CE 5.01 and later
Header: pimstore.h
Library: pimstore.lib