Programming Guide

Event Handling

• Handle mouse events that occur within and on the borders of an embedded frame as needed. Use these events to initiate a drag of the embedded frame, to select the embedded frame, or to activate your own part.

• If you want to receive events sent to an embedded frame that its part chooses not to handle, set the doesPropagateEvents flag of the frame when you create it.

• Use mouse-down events in resize handles of selected embedded frames to initiate resize operations.

• Enable and respond to these items in the Edit menu:

  • Undo, Redo: include embedded frames in the actions that you save and restore. Handle any necessary reading and writing as described under data transfer.

  • Cut, Copy, Paste, Paste as: include embedded frames in the data you manipulate. Handle as described under data transfer (below).

  • Selection properties: Display a selected embedded frame's Part Properties notebook.

  • Open selection: Open selected embedded parts into a window.

  • Show selection as: Set view type of selected embedded frames.

Depending on your part's content model and features, you may want to add support for these capabilities:

• If you support resizing of embedded frames, use mouse events in resize handles of selected embedded frames to initiate resize operations.