Resource_GetDisplayName()

Examples


The Resource_GetDisplayName() function returns a string containing the display name of a specified resource in an application dictionary.

Syntax

Resource_GetDisplayName(product_ID, resource_type, resource_ID)

Parameters

product_ID – An integer specifying the product ID of the dictionary from which the resource display name is being retrieved.

resource_type – An integer specifying the type of resource to identify. Use one of the following constants:

[spacer]

Constant

Description

FORMTYPE

Indicates a form.

TABLETYPE

Indicates a table.

GROUPTYPE

Indicates a table group.

REPORTTYPE

Indicates a report.


resource_ID An integer specifying the resource ID of the resource.

Return value

A string containing the display name of the resource. If there is no main window for the form, the string “[No Display Name]” is returned.

Comments

If you implement activity tracking in your application, you can use this function in conjunction with the Security procedure to retrieve the display name of a selected resource. The Security procedure runs each time a form, report, or table is accessed. A dictionary ID, resource type and a resource ID for the resource being accessed are automatically passed as in parameters for the Security procedure. With this information, Resource_GetDisplayName() can ascertain the resource’s display name, then store the name in an activity table (see the following example).

The resource_type parameter automatically passed to the Security procedure will indicate a form, report or table group, but not an individual table. To track table access, be sure you use place each table into a table group.


Documentation Feedback