AITransformAgainSuite Struct Reference
[API Suite List]

When Illustrator performs a transformation using a built-in tool or menu item, the user can repeat the action again easily by using the Transform Again command. More...

#include <AITransformAgain.h>

List of all members.

Public Attributes
AIAPI AIErr(*	SetTransformAgain )(SPPluginRef self)
	Registers for the kSelectorAITransformAgain selector.
AIAPI AIErr(*	GetTransformAgain )(SPPluginRef *plugin)
	Retrieves the plug-in that is currently registered to receive the next kSelectorAITransformAgain selector.

---

Detailed Description

When Illustrator performs a transformation using a built-in tool or menu item, the user can repeat the action again easily by using the Transform Again command.

This suite allows you to register your plug-in to receive the Transform Again command. If a tool does a rotation in three dimensions, for example, it could allow the user to repeat the transformation.

The Transform Again command does not allow a user interface; you must store any user parameters needed when your plug-in performs the initial transformation.

• Acquire this suite using SPBasicSuite::AcquireSuite() with the constants kAITransformAgainSuite and kAITransformAgainVersion.

---

Member Data Documentation

AIAPI AIErr(* AITransformAgainSuite::GetTransformAgain)(SPPluginRef *plugin)

Retrieves the plug-in that is currently registered to receive the next kSelectorAITransformAgain selector.

Parameters:

plugin

A buffer in which to return the plug-in reference, or NULL if the last transformation was performed by the application, rather than a plug-in.

AIAPI AIErr(* AITransformAgainSuite::SetTransformAgain)(SPPluginRef self)

Registers for the kSelectorAITransformAgain selector.

Call this after a transformation is performed, to allow the same transformation to be repeated if the user chooses the Transform Again menu item.

// add the transform again
sAgain->SetTransformAgain( message->d.self );

The plug-in receives the selector until the user does a different transformation. If more than one plug-in calls this function, the last one to make the call receives the selector.

In response to the kSelectorAITransformAgain selector, the plug-in should repeat the previous transformation. For example:

// transform again handler
static AIErr repeatTransform (AITransformAgainMessage *message) {
        AIErr error = kNoErr;

        error = acquireSuites(message->d.basic);
        if (error) goto error;
        changeSelection;
        sUndo->SetUndoText((char*)g->undoMove, (char*)g->redoMove);

error:
        error = releaseSuites(message->d.basic);
        return error;
}

Parameters:

self

This plug-in.

---

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

• AITransformAgain.h