🅾 App Page ​
App Page object represents an App Page in the application.
App Page Object Methods ​
🅼 appPage.<itemId> ​
Description: Provides convenient direct access to all items on the page, including those inside Sections and Tab Folders.
Example:
appPage.F_NextButton.setVisible(false);
🅼 appPage.addClasses(classes) ​
Parameters: classes
- A single class name, multiple class names separated by spaces, or an Array of class names.
Description: Adds a list of custom class names to the page for dynamic CSS styling. If any of the given class names are invalid CSS class names, then no classes are added, and false
is returned.
Example:
appPage.addClasses("emphasized error");
🅼 appPage.connectEvent(eventName, callbackFunction) ​
Parameters:
eventName
- The name of the event to connect.callbackFunction
- The function to execute when the event occurs.
Description: Connects a function to an event on the page. Useful for hooking behavior into the page dynamically. Returns a handle object that represents the connection, which can be used for disconnection.
Example:
var eventHdl = appPage.connectEvent("<some event>", function (pSuccess, pErrorObj) {
if (pSuccess) {
//do something when service is done
}
appPage.disconnectEvent(eventHndl);
});
🅼 appPage.disconnectEvent(eventHandle) ​
Parameters: eventHandle
- The event handle object returned by a previous appPage.connectEvent
call.
Description: Disconnects the event handler specified by the passed-in event handle. This is useful to avoid duplicate event handlers being connected.
Example:
var eventHdl = appPage.connectEvent("<some event>", function (pSuccess, pErrorObj) {
if (pSuccess) {
//do something when service is done
}
appPage.disconnectEvent(eventHndl);
});
🅼 appPage.getChildren() ​
Description: Returns a list object that provides access to all direct children items of this page. Items within a Section on the page are not included in the list, but the Section itself is. The list object includes getLength()
and get(index)
functions for accessing the objects within the list.
Example:
var list = appPage.getChildren();
for (var i = 0; i < list.getLength(); i++) {
if (list.get(i).getType() === 'button') {
list.get(i).setVisible(false);
}
}
🅼 appPage.getClasses() ​
Description: Returns an array of custom class names currently applied to the page.
🅼 appPage.getId() ​
Description: Returns the unique ID, within the application, of this page, such as "P_App_Page1".
🅼 appPage.getServiceConfigurationIds() ​
Parameters: None.
Description: Returns an array of all the IDs for services that are mapped in this app page. This function is useful for enumerating all services associated with a page, which can then be used to interact with or manipulate those services programmatically.
Example:
var serviceConfigs = appPage.getServiceConfigurationIds();
🅼 appPage.getServiceConfiguration(serviceId) ​
Parameters:
serviceId
: The ID of the service configuration to retrieve.
Description: Retrieves the service object for a particular service ID. This function allows for direct interaction with a specific service, such as executing the service, by providing its unique identifier.
Example:
var service = appPage.getServiceConfiguration('SC_ServiceConfig');
service.callService();
🅼 appPage.getType() ​
Description: Returns a string identifying the object type, which is "page" for page objects.
🅼 appPage.removeClasses(classes) ​
Description: Removes a list of custom class names from the page. The classes
parameter can be a single class name, multiple class names separated by spaces, or an array of class names.
Example:
page.removeClasses("emphasized");
Object available in the App Page event context ​
Here's your text reformatted into the desired structure:
🅾 Application object (GUI type) ​
- Variable:
app
- Description: Contains functions for accessing global general information.
- Example:
app.isSingleFormView();
🅾 App Page object (GUI type) ​
- Variable:
appPage
- Description: For accessing the items on the page.
- Example:
appPage.getChildren();
App Page Events ​
Based on your request, here's how your text would look formatted in the desired output style:
🅴 onShow ​
Event Name: onShow
Description: Called after the app page is shown.
🅴 onHide ​
Event Name: onHide
Description: Called after the app page is hidden.