Object PmfButton

Description:

This object represents one form item of the type: Button.

Properties and methods of this object:

Value	Text displayed inside the button
ValueHorzAlign	The way of horizontal text alignment

Properties and methods that are common to all objects of the PmfObject type:

AddEvent()	Registers a function into the specified event
BodyFont	Font of the Body area of the Pmf object
BodyHeightIni	Initial height of the Body area
BodyHeightMode	The way of changing the Body area height
BodyWidthIni	Initial width of the Body area
BodyWidthMode	The way of changing the Body area width
Enabled	Enable/disable editing of values
Form	Returns PmForm object
Id	Pmf object identifier
Parent	Returns reference to the parent Pmf object
PrivateData	Private value of the object
RemoveEvent()	Unregisters the function in the specified event
Title	Displayed name of the Pmf object
TitleFont	Font of the Title area of the Pmf object
TitlePos	Position of the Title area of the Pmf object
Type	Pmf object type
Visible	Visibility of the Pmf object

Events:

onAction	Is triggered when an important logical action happens over the object
onFocus	Is triggered if the Pmf object gets or loses focus

Note:

- The object can be created by method PmForm.CreateItem("button", ...).

- This object is functional also in Web panels.

If the oExtra.onChange entry is set when opening the window and if the user presses this button, then the user event is triggered with oSystem.ChangeType = "push" flag.

Example1:

Script creates one form item. It is presumed that the oForm object already exists.

JavaScriptSelect and copy to clipboard



var oBtn = oForm.CreateItem("button", "id_btn1");

oBtn.Value = "Button";


// The function is registered into the onAction event.

function onBtnAction(ev)

{

	if (ev.Action == "main")

	{

		Pm.Debug("PmfButton.onAction Main");

		// . . .

	}

}

oBtn.AddEvent("onAction", "Id_Btn1", onBtnAction);