Tag Attributes and Behaviour in ZML | ManageEngine AppCreator Help

<pc>

The <pc> tag defines a column within a panel row.

Parent tag : <pr>

Child tag : <pr>, <text>, <image>, <button>

Attributes

width The width attribute defines a width for the <pc>.

Possible Values

A numeric value in percentage.

Example

Syntax	<pr width='fill'> <pc width='50%' bgColor='#2A70E7'> <text type='Text' value='Zoho AppCreator'/> </pc> <pc width='50%' bgColor='#00D9B1'> <text type='Text' value='Zoho AppCreator'/> </pc> </pr>
Output

Syntax

</pc>

</pc>

</pr>

Output

Note:

width attribute is applicable to <pc> only when <pr width='fill'>

padding The padding attribute generates a specified amount of space between the all sides of the <pc> and it's child element.

Possible Values

A numeric value in pixels

Example

Syntax	<pr width='fill'> <pc width='100%' padding='20px'></pc> </pr>
Output

Syntax

</pr>

Output

Note:

padding attribute is optional.

paddingTop The paddingTop attribute generates a specified amount of space between the top side of the <pc> and it's child element.

Possible Values

A numeric value in pixels

Example

Syntax	<pr width='fill'> <pc width='100%' paddingTop='50px'></pc> </pr>
Output

Syntax

</pr>

Output

Note:

paddingTop attribute is optional

paddingRight The paddingRight attribute generates a specified amount of space between the right side of the <pc> and it's child element.

Possible Values

A numeric value in pixels

Example

Syntax	<pr width='fill'> <pc width='100%'> <pr> <pc> <text value='Zoho AppCreator'/></pc> <pc paddingRight='25px' bgColor='#00D9B1'> <text value='Zoho AppCreator'/></pc> </pr> </pc> </pr>

Syntax

<pr>

<pc>

</pr>

</pc>

</pr>

Note:

paddingRight attribute is optional

paddingBottom The paddingBottom attribute generates a specified amount of space between the bottom side of the <pc> and it's child element.

Possible Values

A numeric value in pixels

Example

Syntax	<pr width='fill'> <pc width='100%' paddingBottom='50px'></pc> </pr>
Output

Syntax

</pr>

Output

Note:

paddingBottom attribute is optional

paddingLeft The paddingLeft attribute generates a specified amount of space between the the left side of the <pc> and it's child element.

Possible Values

A numeric value in pixels

Example

Syntax	<pr width='fill'> <pc width='100%'> <pr> <pc> <text value='Zoho AppCreator'/></pc> <pc paddingLeft='25px' bgColor='#00D9B1'> <text value='Zoho AppCreator'/></pc> </pr> </pc> </pr>

Syntax

<pr>

<pc>

</pr>

</pc>

</pr>

Note:

paddingLeft attribute is optional

bgColor The bgColor attribute specifies a background color for the <pc> element.

Possible Values

A hexadecimal color value. Refer this link for hexadecimal color codes.

Default Value

#FFFFFF

Example

Syntax	<pc bgColor='#2A70E7'>
Output

hAlign The hAlign attribute specifies the horizontal positioning of the contents within the <pc>.

Possible Values

left
center
right

Default Value

center

Example

Syntax	<pc hAlign='left'> <text type='Text' value='Zoho AppCreator'/> </pc>

Syntax

</pc>

vAlign The vAlign attribute specifies the vertical positioning of the contents within the <pc>.

Possible Values

top
middle
bottom

Default Value

middle

Example

Syntax	<pc vAlign='top'> <text type='Text' value='Zoho AppCreator'/> </pc>

Syntax

</pc>

action The action attribute specifies the action to be triggerred on click of the <pc>.

Possible Values

Link
Form
Report
Page
Function

Example

action	Syntax
Link	<pc action='Link' url='A URL to be opened '></pc>*
Form	<pc action='Form' componentLinkName='linkname of the ManageEngine AppCreator form to be opened' appLinkName='linkname of the ManageEngine AppCreator application to which the form belongs' /></pc>*
Report	<pc action='Report' componentLinkName='linkname of the ManageEngine AppCreator report to be opened' appLinkName='linkname of the ManageEngine AppCreator application to which the report belongs' /></pc>*
Page	<pc action='Page' componentLinkName='linkname of the ManageEngine AppCreator page to be opened' appLinkName='linkname of the ManageEngine AppCreator application to which the page belongs' /></pc>*
Function	<pc action='Function' functionName='Name of the custom function to be triggered' /></pc>*

* Learn in detail about each of the action types in the following sections.

Note:

action attribute is optional.
The action attribute acts as a source attribute. i.e: One or more of the following attributes viz: url, componentLinkName, appLinkName, functionName, parameters, successMessage, target, popupWidth and popupHeight will be applicable only when an action is specified.

url The url attribute specifies the resource location to be opened on click of the <pc>.

Possible Values

A url pointing to another website
A url pointing to a component within your ManageEngine AppCreator Account

Example

<pc action='Link' url='https://www.zoho.com/creator/'>

Note:

url attribute is optional.
It is applicable only when <action='Link'>

componentLinkName The componentLinkName attribute specifies the link name of the ManageEngine AppCreator component to be opened on click of the <pc>.

Possible Values

Linkname of the ManageEngine AppCreator Application component to be opened. Refer to this page for the link names of all the components across all applications in your ManageEngine AppCreator Account.

Example

action	Syntax
Form	<pc action='Form' componentLinkName='User_Details'></pc>
Report	<pc action='Report' componentLinkName='User_Details_Report'></pc>
Page	<pc action='Page' componentLinkName='User_Dashboard'></pc>

Note:

componentLinkName attribute is optional.
It is applicable only when <action='Form'/'Report'/'Page'>

appLinkName The appLinkName attribute specifies the name of the ManageEngine AppCreator application to which the associated component belongs.

Possible Values

Linkname of the ManageEngine AppCreator Application to be opened. Refer to this page for the link names of all the applications in your ManageEngine AppCreator Account.

Example

action	Syntax
Form	<pc action='Form' componentLinkName='User_Details' appLinkName='Resource_management'></pc>
Report	<pc action='Report' componentLinkName='User_Details_Report' appLinkName='Resource_management'></pc>
Page	<pc action='Page' componentLinkName='User_Dashboard' appLinkName='Resource_management'></pc>

Note:

appLinkName attribute is optional. You do not need to specify appLinkName if the component you are associating to the action, belongs to the same application you are currently in.
It is applicable only when <action='Form'/'Report'/'Page'/'Function'>

functionName The functionName attribute specifies the name of the custom function to be triggered on click of the <pc>.

Possible Values

A custom function defined in any of your ManageEngine AppCreator Applications. To get the list of custom functions in your application: Go to Settings -> Extensions -> Custom Functions

Example

<pc action='Function' functionName='send_email'/>

Note:

The functionName can belong to a default namespace or a custom namespace.
If the function belongs to a custom namespace : <functionName='namespace_name.function_name'>
functionName attribute is optional.
It is applicable only when <action='Function'> and a function name must be specified.

parameters The parameters attribute specifies query parameter to be associated to an action on click of the <pc>.

Possible Values

When <action='Form' / 'Report' / 'Page'>, parameters refers to the query string that will be appended to the corresponding component's permalink.
When <action='Function'>, parameters refers to an argument of the selected custom function.

Example

action	Syntax
Form	<pc action='Form' componentLinkName='User_Details' appLinkName='Resource_management' parameters='App_name=${name}'></pc> OR <pc action='Form' componentLinkName='User_Details' appLinkName='Resource_management' parameters='App_name=Zoho Creator'></pc>
Report	<pc action='Report' componentLinkName='User_Details' appLinkName='Resource_management' parameters='App_name=${name}' ></pc> or <button text='button label' action='Form' componentLinkName='User_Details' appLinkName='Resource_management' parameters='User_Name='Rob'></pc>
Page	<pc action='Page' componentLinkName='linkname of the ManageEngine AppCreator page to be opened' appLinkName='linkname of the ManageEngine AppCreator application to which the page belongs' parameters='App_name=${name}'></pc>*

action

Syntax

Form

Report

Page

<pc action='Page' componentLinkName='linkname of the ManageEngine AppCreator page to be opened' appLinkName='linkname of the ManageEngine AppCreator application to which the page belongs' parameters='App_name=${name}'></pc>*

Note:

parameter attribute is optional.
It is applicable only when <action='Form'/'Report'/'Page'/'Function'>
parameters can either be a static value like: Name='Rob' or a page parameter.
Page parameter must be specified as : App_name=${name}, where name is the page parameter.

successMessage The successMessage attribute specifies the message to be displayed on successful execution of the associated function.

Possible Values

A string

Example

<pc action='Function' functionName='send_email' successMessage='Sent Successfully!'></pc>

Note:

successMessage attribute is optional.
It is applicable only when <action='Function'>

target The target attribute specifies the location where the linked action will open on click of the <pc>.

Possible Values

new-window
same-window
popup

Default Value

new-window

Note:

It is applicable only when <action='Link'/'Form'/'Report'/'Page'>

popupWidth The popupWidth attribute specifies a width for the pop-up window where the link will be opened.

Possible Values

A numeric value in percentage or pixels

popupWidth The popupWidth attribute specifies a width for the pop-up window where the link will be opened.

Possible Values

A numeric value in percentage or pixels

bgtype The bgtype attribute specifies the background image of the <pc>.

Possible Values

gallery

Note:

bgtype attribute is optional.

bgImagePosition The bgImagePosition attribute specifies the position of the background image in the <pc>.

Possible Values

fill
fit
tile

Default Value

fill

Note:

It is applicable only when bgtype attribute is set for the <pc>.

bgImageRepeat The bgImageRepeat attribute specifies if the <pc> is being repeated.

Possible Values

repeat
repeat-x
repeat-y
no-repeat

Default Value

repeat

Note:

It is applicable only when bgtype attribute is set for the <pc> and bgImagePosition='tile'

bgHorizontalAlign The bgHorizontalAlign attribute specifies the horizontal alignment of the background image in the <pc>.

Possible Values

left
center
right

Default Value

left

Note:

It is applicable only when bgtype attribute is set for the <pc> and bgImagePosition is 'fill' or 'fit'

bgVerticalAlign The bgVerticalAlign attribute specifies the vertical alignment of the background image in the <pc>.

Possible Values

top
center
bottom

Default Value

Note:

It is applicable only when bgtype attribute is set for the <pc> and bgImagePosition is 'fill' or 'fit'

bgImage The bgImage attribute specifies which image from the library of your account is set as the <pc> tag's background.

Possible Values

Filename of an image from the image library of your account

Note:

It is applicable only when bgtype attribute is set for the <pc>.

overlayColor The overlayColor attribute specifies the color which is to be laid over the <pc>.

Possible Values

A hexadecimal color value

Default Value

#0000007f

Still can't find what you're looking for?

Write to us: appcreator-support@manageengine.com