The Application Object: 2.3 Advanced GenApplication Usage: The GenApplication's Moniker

MSG_GEN_APPLICATION_FIND_MONIKER, MSG_GEN_APPLICATION_SET_TASK_ENTRY_MONIKER

Every GenApplication object should be given a moniker; this moniker is displayed by the UI in its task list. (In OSF/Motif, the task list is manifested as the floating "Express" menu.) While you will set the moniker just like for any generic object, the GenApplication has two messages that can be used to get or set the moniker used in the task list.

MSG_GEN_APPLICATION_FIND_MONIKER

optr	MSG_GEN_APPLICATION_FIND_MONIKER(
        MemHandle		destBlock,
        word		searchFlags,
        DisplayType		displayType);

This message finds the specified moniker in the GenApplication's VisMonikerList and optionally copies it into a specified destination block.

Source: Infrequently used.

Destination: The GenApplication to get the moniker from.

Parameters: destBlock The handle of the destination block into which the chunk will be copied. For this to work, you must pass VMSF_COPY_CHUNK in searchFlags .

searchFlags: A record of VisMonikerSearchFlags indicating what type of moniker to find in the moniker list and what to do with it when it is found.
displayType: The display type of the moniker to search for.

Return: The optr of the GenApplication's VisMonikerList chunk.

Interception: Do not intercept.

MSG_GEN_APPLICATION_SET_TASK_ENTRY_MONIKER

void	MSG_GEN_APPLICATION_SET_TASK_ENTRY_MONIKER(
        optr	entryMoniker);

This message changes the moniker which is used in the GenField's task list. The task list menu will be updated if currently visible.

Source: Infrequently used.

Destination: The GenApplication to have its moniker changed.

Parameters: entryMoniker The optr of the chunk containing the moniker that will be set into the task list.

Return: Nothing.

Interception: Do not intercept.

GEOS SDK TechDocs |

2.2 Application Busy States | Next:

2.4 Measurement Type