AILegacyTextConversionSuite Struct Reference
[API Suite List]

This suite provides functions to convert legacy text objects (from earlier versions of Illustrator) to native text objects. More...

#include <AILegacyTextConversion.h>

List of all members.

Public Attributes
AIAPI AIErr(*	ConvertToNative )(AIArtHandle art, ai::int16 paintOrder, AIArtHandle prep, AIArtHandle *ret)
	Converts a legacy text object to native Illustrator text art objects.
AIAPI AIErr(*	ConvertAllToNative )(AIBoolean *foundAnyLegacy)
	Traverses the artwork tree of the current document and converts every art object of type kLegacyTextArt to an object of type kTextFrameArt.
AIAPI AIErr(*	IsACopy )(AIArtHandle LegacyArt, AIBoolean *aCopy)
	Reports whether a legacy art object is a copy--that is, the result of executing the "Copy text object" command, which converts to native art, and retains the legacy art behind it, with 40% transparency.

---

Detailed Description

This suite provides functions to convert legacy text objects (from earlier versions of Illustrator) to native text objects.

• Acquire this suite using SPBasicSuite::AcquireSuite() with the constants kAILegacyTextConversionSuite and kAILegacyTextConversionVersion.

---

Member Data Documentation

AIAPI AIErr(* AILegacyTextConversionSuite::ConvertAllToNative)(AIBoolean *foundAnyLegacy)

Traverses the artwork tree of the current document and converts every art object of type kLegacyTextArt to an object of type kTextFrameArt.

Parameters:

foundAnyLegacy

[out] A buffer in which to return true if any legacy text objects were found the document. May be NULL.

AIAPI AIErr(* AILegacyTextConversionSuite::ConvertToNative)(AIArtHandle art, ai::int16 paintOrder, AIArtHandle prep, AIArtHandle *ret)

Converts a legacy text object to native Illustrator text art objects.

Parameters:

	art	The legacy text object. This function does not dispose of the object.
	paintOrder	The position for the new artwork in the paint order, relative to the prep object. See AITypes::AIPaintOrder.
	prep	The prepositional art object.
	ret	[out] A buffer in which to return a group art object containing art objects of type kTextFrameArt.

AIAPI AIErr(* AILegacyTextConversionSuite::IsACopy)(AIArtHandle LegacyArt, AIBoolean *aCopy)

Reports whether a legacy art object is a copy--that is, the result of executing the "Copy text object" command, which converts to native art, and retains the legacy art behind it, with 40% transparency.

Parameters:

	LegacyArt	The legacy art object.
	aCopy	[out] A buffer in which to return true if the art is a copy.

---

The documentation for this struct was generated from the following file:

• AILegacyTextConversion.h