ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

New WINDEV Mobile 2024 feature!
Help / WLanguage / WLanguage functions / Mobile specific functions / 
  • Properties specific to QuickAction variables
  • Functions that use QuickAction variables
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
The QuickAction type allows you to define all the advanced characteristics of a quick action of an app on Android (app shortcut) or iOS (Quick Action). A quick action is defined, among other things, by an identifier, a label and an action.
You can define and change the characteristics of this action using different WLanguage properties.
Remark: For more details on the declaration of this type of variable and the use of WLanguage properties, see Declaring a variable.
Example
// Creates a new quick action for the application
action is QuickAction
action.Identifier = "ACTION_ID__SEND_MESSAGE"
action.Caption = "New message"
action.Procedure = ProcSendMessage
QuickActionAdd(action)
Properties

Properties specific to QuickAction variables

The following properties can be used to handle QuickAction variables:
Property nameType usedEffect
IconDesired typePath to the icon associated with the action. This property can correspond to:
  • the image path as a string,
  • a variable of type Image,
  • a variable of type URI.
This property is optional. If this property is not specified, the application icon will be used.
CaptionCharacter stringShort description of the action to be performed.
This property must be specified.
IdentifierCharacter stringIdentifier of the action to be executed.
This property must be specified.
LongCaptionCharacter string
Android Detailed description of the action.
This description will be displayed instead of the short caption if there is enough space.
Maximum recommended length: 25 characters.
NoteCharacter stringStores additional data associated with the action.
OrderIntegerPositive integer value used to set the position of the action in the context menu of the application. The lower the value, the higher the action will rank.
ProcedureProcedureName of the global WLanguage procedure called when the user taps the icon associated with the action.
This procedure has the following format:
PROCEDURE <Procedure name>(<action>)
where <action> is a QuickAction variable corresponding to the action selected by the user. Remark: in this case, the Icon property of the QuickAction variable will not be specified.
If this property is set to an empty string, the application will be launched as a standard application.
If the application is not already running when the action is triggered, it will be launched automatically, the application initialization WLanguage events will be run, and then the procedure will be executed. If no window is open once the procedure is executed, the first window of the application will be automatically opened.
If the application is already running, it will move to the foreground and the procedure will be executed.
It is not recommended to call Info, Error, or similar functions in this procedure.
SubCaptionCharacter string
iPhone/iPad Subtitle of the quick action.
Remarks

Functions that use QuickAction variables

The following functions are used to handle QuickAction variables:
New in version 2024
QuickActionAdd
Adds a new quick action to the application.
New in version 2024
QuickActionPin
Generates a request to pin a quick action.
New in version 2024
QuickActionRemove
Removes a quick action defined for the application.
Minimum version required
  • Version 2024
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 01/17/2024

Send a report | Local help