AddTask

Return to Introduction  Previous page  Next page

Adds a task to a header. The task will be visible on the next redraw.

 

 

Prototypes:

AddTask(STRING Title, LONG ActionFeq, BYTE MimicButton, STRING IconName, BYTE DontMimicIcon),LONG,PROC

AddTask(LONG HeaderID, STRING Title, LONG ActionFeq, <BYTE MimicButton>, <STRING IconName>, <BYTE DontMimicIcon>),LONG,PROC

 

Arguments:

HeaderID

A previously obtained ID for parent header the task should be added to. If you ommit this value (i.e. use the first prototype) the task will be added to the last added header.

Title

This is the screentext for this task

ActionFeq

The FEQ (Field Equate Label) for the control that should receive an EVENT:Accepted, when this task is clicked. Set this to zero if you don't want the task to activate a control.

MimicButton

Optional. If a button was specifed as the ActionFeq, you could set MimicButton to True. The task will then be hidden whenever the button is disabled. When the button is enabled, the task will be visible to the user. (Defaults to false)

IconName

Optional. The name of the icon that should be shown to the left of the task. If ommited, no icon is shown. NOTE: The icon MUST be linked into your application.  Also note that the icon name should NOT be prefixed with a tilde (~) even if it is linked in!

DontMimicIcon

Optional, If set to True and MimicButton is specified, the icon set in the template settings will be used instead of the icon of the mimiced button.

 

Return value:

This function returns a LONG, representing an ID for this task. The ID is only uniqe within its header. Tasks in different headers could have the same ID.

 

See also:

AddHeader, DeleteHeader, DeleteTask

 

Example:

OutlookBar5.AddTask('Introduction', ?Button1{PROP:Feq}, False, 'user.ico')

 

 

 



Direct link to this page on our website: http://www.icetips.com/manuals/outlookbar/addtask.htm