Dev:ActionMenu

ActionMenu is an extension that adds extra options to the menu that pops up when you select text or tap-and-hold an item (such as an image or a table cell).

Developers can integrate with it (by making a plugin) to add their own custom options to these menus.

Creating an Action Menu Plugin
Requirements:


 * Theos installed
 * ActionMenu.h
 * Some knowledge of Objective C or how DHowett would say: "LEARN OBJECTIVE-C FOR GODS' SAKES"

What is an Action Menu Plugin?


 * We basically implement a category of the UIResponder class which will be loaded by Action Menu
 * Action Menu also provides us with easy methods to register our new UIMenuController item

The Makefile

The resulting file is a dynamic library (.dylib) so we will create a Makefile for a Library.

We set the architecture to be armv7 and arm64 (64Bit). Then we include theos' common.mk file and after that we define the properties for our Library project.

AMExample.h

We will first create our Header File which will not have more than the category interface

AMExample.m

We are going to implement the methods and then our category in the .m implementation File.

First we simply include our Header File and write our @implementation section

Using the NSObject's +(void)load method which will be executed earlier than any other method we implement so we can use this to initialize and create our UIMenuController Item.

Now we have to implement the canPerformAction and performMyAction method. The canPerformAction checks for the length of the selected Text and checks wether it is 0 or higher. It can only perform (return TRUE) if the selected text is longer than 0 characters.

Now we have to implement the canPerformAction and performMyAction method to complete this Plugin:

And in our performMyAction method we simply show an UIAlertView.

To sum it up, +(void)load registers our Action Menu Item to be shown in the UIMenuController, - (BOOL)canPerformAction checks if there is any selected text and - (void)performMyAction will run our code when the Menu Item is selected.

This is everything you need to know for your first Action Menu Plugin. All you need to do is change the actions that take place in the performMyAction method and you can customize your Plugin.