Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

IParseDisplayName interface

Parses a displayable name string to convert it into a moniker for custom moniker implementations.

Display name parsing is necessary when the end user inputs a string to identify a component, as in the following situations:

  • A compound document application that supports linked components typically supports the Edit:Links... dialog box. Through this dialog box, the end user can enter a display name to specify a new link source for a specified linked component. The compound document needs to have this input string converted into a moniker.
  • A script language such as the macro language of a spreadsheet can allow textual references to a component. The language's interpreter needs to have such a reference converted into a moniker in order to execute the macro.

This interface is not supported for use across machine boundaries.

When to implement

Compound document applications that support links to embedded components or to pseudo-objects within their documents must provide an implementation of the IOleItemContainer interface, which is derived indirectly from IParseDisplayName. In effect, such a compound document is providing a namespace for identifying its internal components; and its IOleItemContainer implementation (which includes the IParseDisplayName implementation) is the interface through which another application can access this namespace. Alternatively, the compound document application can implement IParseDisplayName as part of its class object, which is accessible through the CoGetClassObject function.

When to use

If you are implementing your own moniker class, you might need to use this interface from your implementation of IMoniker::ParseDisplayName. If you call the MkParseDisplayName or MkParseDisplayNameEx function, you are indirectly using IParseDisplayName. These two functions call IParseDisplayName to parse display names for objects that provide custom moniker implementations.

Members

The IParseDisplayName interface inherits from the IUnknown interface. IParseDisplayName also has these types of members:

Methods

The IParseDisplayName interface has these methods.

MethodDescription
ParseDisplayName

Parses the specified display name and creates a corresponding moniker.

 

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

OleIdl.h

IDL

OleIdl.idl

IID

IID_IParseDisplayName is defined as 0000011a-0000-0000-C000-000000000046

See also

IMoniker::ParseDisplayName
IOleItemContainer
MkParseDisplayName
MkParseDisplayNameEx

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.