MKI_NOTIFY_ITEM_EDIT_CONTENT (Plug-In Notification Command) New in Version 2022.0

The plug-in shall display a dialog to edit the specific collection or pinboard item's content.

Note: Start by reading all current data from the item using standard profile reading commands. If successful, display the dialog for editing. If the user chooses "OK", clear the data by means of MKI_ProfileWriteClear and then use standard profile writing commands to write the edited data. Neither call MKI_CollectionReadClose nor MKI_CollectionWriteClose to close the item, the serving application will close it automatically once control is returned.

Parameters

Ext

Unused, will usually be nullptr.

Data

Address of a MKI_ITEM_HEADER structure. The members OwnerID and Type identify the item type. The specific item is already both open for reading (as if opened by MKI_CollectionReadItemOpen) AND writing (as if opened by MKI_CollectionWriteItemOpen), so you can use standard profile reading and writing commands. All header members must remain unchanged!

Return Value

MKI_NOTIFY_RESULT_DONE

The item type identified by OwnerID and Type is known, the user changed something.

MKI_NOTIFY_RESULT_IGNORE

The item type identified by OwnerID and Type is known, but the user did not change anything.

MKI_NOTIFY_RESULT_UNKNOWN

The item type identified by OwnerID and Type is not known or task not supported, ask the other plug-ins.