SAVE-LAYOUT Action

This document covers the following topics:


Description

Saves the specified dialog's current control bar layout for the current user. The control bars include the newer tool-bar and status bar controls, but not the traditional tool bar and status bar available in earlier Natural versions. The layout includes the bar type (dockable or fixed), location, position, and the bar's visible and enabled state.

The information is currently stored in the registry under:

 
\\HKEY_CURRENT_USER\Software\Software AG\Natural Applications\<profile name>\<section name>

where <profile name> and <section name> are described in the table below. However, the base location (or whether the information is stored in the registry at all) may change for future Natural versions.

Parameters

Name/Data Type Explanation
HANDLE OF GUI Input

Handle of the dialog for which the control bar layout is to be saved.

Profile name

(A253)

Input (optional parameter)

The name of the profile to which the information is to be saved. If this parameter is not specified, the name of the library containing the dialog is used.

Section name

(A253)

Input (optional parameter)

The name of the profile section to which the information is to be saved. If this parameter is not specified, the name of the dialog is used.

Example:

PROCESS GUI ACTION SAVE-LAYOUT WITH #DLG$WINDOW 
GIVING #RESPONSE