MKI_NOTIFY_EDIT_TEXT_SINGLE (Plug-In Notification Command) Changed in Version 2020.2

The plug-in shall display a dialog that allows text editing for one single text within an extended object.

If the extended object contains multiple texts, the plug-in can use the identification point to determine which of those texts to present for editing. Use MKI_InputGetLastPoint to retrieve the identification point entered by the user.

If the extended object contains only one text, you don't need to consider the identification point and can handle this the same way as MKI_NOTIFY_EDIT_TEXT_MULTI.

Parameters

Ext

Address of the object for which a text editing dialog shall be displayed by the plug-in.

Data

Address of a HWND element which contains the window handle of the window to be used as parent for the plug-in's dialog.

Return Value

MKI_NOTIFY_RESULT_COPY

Ext is known, the contained text was edited by the user.

MKI_NOTIFY_RESULT_IGNORE

Ext is known, the contained text was displayed to the user, but no changed were made, or this type of extended object does not include texts.

MKI_NOTIFY_RESULT_UNKNOWN

Ext is not known or task not supported, ask the other plug-ins.

Note: Since text editing may cause the extended object to change in size, the plug-in must always create a new extended object based on the previous object, but containing the new text. This new object must be created using MKI_ExtOpen and commands such as MKI_ExtAddPoint and MKI_ExtAddDataBlock. Once MKI_NOTIFY_RESULT_COPY was returned, the application will automatically execute code similar to MKI_ExtFastInsert, replacing the object Ext with the newly created extended object. The plug-in must neither call MKI_ExtAddEnd, MKI_ExtInsert, MKI_ExtClose nor MKI_ExtFastInsert itself while creating the new extended object!
The formerly supported MKI_NOTIFY_RESULT_DONE is no valid return value here, it will result in an error!