Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

The Displaymethod displays the PIM item's Summarycard.

Syntax

HRESULT Display(
  HWND 
hwndParent
);

Parameters

hwndParent

[in] Handle to the parent window.

Return Value

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

You can call IItem::Displayon 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::Displayis equivalent to IAppointment::Display, IContact::Display, and ITask::Display.

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

If hWndis NULL, then IItem::Displayuses the window handle passed into IPOutlookApp::Logoninstead.

Code Example

The following code example demonstrates how to use IItem::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.
Copy Code
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;
}

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

IItem

Other Resources