SetQuickAccessToolbarStatusPath

Description

Sets the file path of the QuickAccessToolbar item status (QatItems.qat).

Applies to

Application object

Syntax

applicationname.SetQuickAccessToolbarStatusPath (string path)

Argument

Description

applicationname

The name of the application object for which you want to set the file path of the QuickAccessToolbar item status.

path

A string that specifies the path to the QuickAccessToolbar status. It should be a valid path.


Usage

This method must be called before the MDI\MDIHelp window (which has DisplayMenuAsRibbonBar enabled) is opened.

It is recommended that the method is called in the Application Open event.

If no file path is set, no QatItems.qat file will be created (which means, the customization of QuickAccessToolbar will not be saved).

Return Value

Integer

Returns 1 if succeeds and -1 if an error occurs.

Examples

This example shows how to get a path from an INI file and set it as the file path for QatItems.qat.

String  ls_qatpath
ls_qatpath = ProfileString(gs_inifile, "QuickAccessBar", "path", "")
IF NOT isnull(ls_qatpath) AND ls_qatpath <>"" THEN 
            this.setquickaccesstoolbarstatuspath(ls_qatpath)       
            gs_QuickAccessToolbarStatusPath = ls_qatpath
End If

This is an example of the INI file:

[QuickAccessBar]
path=C:\Users\appeon\Desktop\Test

See also

GetQuickAccessToolbarStatusPath