4D Doc Center : OBJECT Get action

Home

4D v14.3

OBJECT Get action


OBJECT Get action ( {* ;} object ) -> Function result

Parameter	Type	Description
*	Operator	If specified, object is an object name (string) If omitted, object is a field or variable
object	Form object	Object name (if * is specified) or Field or variable (if * is omitted)
Function result	Text	Associated standard action

Description

The OBJECT Get action command returns the code of the standard action associated with the object(s) designated by the object and * parameters.

You can set a standard action for an object in the Design mode using the Property List (see Standard actions in the Design Reference manual), or using the OBJECT SET ACTION command.

The command returns a string containing the code for the standard action associated with the object. You can compare the value received with the constants of the "Text Values for Associated Standard Action" theme:

Constant	Type	Value
Object Accept action	String	2
Object Add subrecord action	String	14
Object Automatic splitter action	String	16
Object Cancel action	String	1
Object Clear action	String	21
Object Copy action	String	19
Object Cut action	String	18
Object Database Settings action	String	32
Object Delete record action	String	7
Object Delete subrecord action	String	13
Object Edit subrecord action	String	12
Object First page action	String	10
Object First record action	String	5
Object Goto page action	String	15
Object Last page action	String	11
Object Last record action	String	6
Object MSC action	String	36
Object Next page action	String	8
Object Next record action	String	3
Object No standard action	String	0
Object Open back URL action	String	37
Object Open next URL action	String	38
Object Paste action	String	20
Object Previous page action	String	9
Object Previous record action	String	4
Object Quit action	String	27
Object Redo action	String	31
Object Refresh current URL action	String	39
Object Return to Design mode action	String	35
Object Select all action	String	22
Object Show Clipboard action	String	23
Object Stop loading URL action	String	40
Object Test Application action	String	26
Object Undo action	String	17

Example

You want to associate the "Cancel" action with all the objects in the form that do not already have any associated action:

 ARRAY TEXT($arrObjects;0)

 

 FORM GET OBJECTS($arrObjects)

 For($i;1;Size of array($arrObjects))

    If(OBJECT Get action(*;$arrObjects{$i})=Object No standard action)

       OBJECT SET ACTION(*;$arrObjects{$i};Object Cancel action)

    End if

 End for