HcmObjectCreateDescRec

Used by CHcmPlugInContentHandler::Create.

struct HcmObjectCreateDescRec
{
	HcmObjectTypeEnum  m_KindOfObject;
	HcmPmUniqueRec  m_PageMakerRec;
	HcmDisplayNameRec  m_DisplayRec;
	HcmPointToRec  m_PointToRec;
	HcmItemPrivateStoreRec  m_PrivateStore;
}; // HcmObjectCreateDescRec
typedef struct HcmObjectCreateDescRec HcmObjectCreateDescRec;

The HcmObjectCreateDescRec members.

HcmObjectTypeEnum  m_KindOfObject;

The type of hyper content object being created (Anchor, hyperlink, or storage.)

HcmPmUniqueRec  m_PageMakerRec;

Identifies the page item or text tag that the hyper content object is associated with.

HcmDisplayNameRec  m_DisplayRec;

Gives the text that describes the hyper content (currently, this is only used for the Hyperlinks palette.)

HcmPointToRec  m_PointToRec;

The anchor that the hyperlink points to. (Only valid if the hyper content that is being created is a hyperlink.)

HcmItemPrivateStoreRec  m_PrivateStore;

The information to store. This is only valid for hyper content objects that are defined as storage objects.

HcmPmUniqueRec

Identifies an object or text token.

struct HcmPmUniqueRec
    {
		UINT32  m_SegmentType;
		UINT32  m_OuterRid;
		UINT32  m_InnerRid;
    }; // HcmPmUniqueRec

HcmPmUniqueRec members

UINT32  m_SegmentType;

For any object on a page, this value is set to the object type (see PGetObjectIDList.)
When adding hypercontent to text, this value is set to 33.

UINT32  m_OuterRid;

The object ID for the object to which the hypercontent will be associated. The object can be any native or imported object, including a text block. You cannot attach hypercontent to a story, but you can attach hypercontent to a text block, or the text within the story. When attaching hypercontent to the text within the story, the text must be selected, and the value of m_OuterRid must be set to INVAL_RID.

UINT32  m_InnerRid;

Always set to INVAL_RID.

Values

For an insertion point (a single point within the text, at the location of the cursor), or selection of text, use the following values.

m_SegmentType = 33;
m_OuterRid = INVAL_RID;
m_InnerRid = INVAL_RID;

For any other object (with the object selected):

m_SegmentType = objectType; // type of object
m_OuterRid = theObjectID;
m_InnterRid = INVAL_RID;

In the example above, the values for "objectType" and "theObjectID" can be queried from the PageMaker Application through either the queries, or the CIObjectAccess interface.


Comments or suggestions? Contact Adobe Developer Support
Copyright © 1997 - 2001 Adobe Systems Incorporated. All rights reserved.
Legal notices and trademark attributions