FormModule

Package

Class

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

oracle.forms.jdapi
Class FormModule

java.lang.Object
  oracle.forms.jdapi.JdapiModule
      oracle.forms.jdapi.FormModule

All Implemented Interfaces:: JdapiObject

public class FormModule
extends JdapiModule
extends JdapiModule

Object to represent a Forms FormModule object. This is an encapsulation of the Forms C API d2ffmd.

In some cases, using methods on this class may result in a JdapiIllegalStateException being thrown. When this happens, you are using an object that refers to a Forms object that has been deleted - your reference is no longer valid. You can check if an instance of this class is valid by using the isValidFormsObject() method. If you code correctly, this should not happen. It will tend to happen if you keep references (for extended periods) to Forms objects rather than look them up dynamically. Of course you will only have this problem if you destroy Forms objects.

See Also:: BaseAPI

Field Summary
`protected java.lang.Object`	`m_clientInfo` Client info object held against this Forms object.
`protected long`	`m_pd2fob` This is the d2fob pointer in the C ifjapi60 for the object that is derived from this class.

Fields inherited from interface oracle.forms.jdapi.JdapiObject
`PROPERTY_DEFAULT_VALUE, PROPERTY_INHERITED_VALUE, PROPERTY_OVERRIDDEN_DEFAULT_VALUE, PROPERTY_OVERRIDDEN_INHERITED_VALUE, PROPERTY_STATE_UNKNOWN`

Constructor Summary
`protected`	`FormModule(long pd2ffmd)` Protected constructor, used internally to create FormModule objects.
	`FormModule(java.lang.String name)` Constructor used to create FormModule objects.

Method Summary
`void`	`changeOwner(JdapiObject newOwner)` Assigns a new owner to the referred object.
`protected void`	`clearObjectPointer()` Used internally to flag this object as an invalid object.
`JdapiObject`	`clone(JdapiObject parent, java.lang.String newName)` Creates a clone of the specified object, creating a new object with the given name and owner.
`FormModule`	`clone(java.lang.String newName)` Creates a copy of the object as a child of 'parent'.
`void`	`compile()` Compiles the module to the filesystem.
`JdapiObject`	`createSubclassedChild(JdapiObject childOwner, java.lang.String childName)` Subclass the referred object.
`boolean`	`equals(JdapiObject obj)` Compares two objects and determines if they are equal.
`static FormModule`	`find(java.lang.String name)` Find an instance of FormModule.
`JdapiIterator`	`getAlerts()` Accessor for child Alert objects (ALERT_PTID).
`JdapiIterator`	`getAttachedLibraries()` Accessor for child AttachedLibrary objects (ATTACHMENT_LIBRARY_PTID).
`JdapiIterator`	`getBlocks()` Accessor for child Block objects (BLOCK_PTID).
`boolean`	`getBooleanProperty(int propertyTypeId)` Retrieves a boolean property from the referred object.
`JdapiIterator`	`getCanvases()` Accessor for child Canvas objects (CANVAS_PTID).
`JdapiIterator`	`getChildObjectProperty(int propertyTypeId)` Retrieves child objects for a given property value.
`java.lang.String`	`getClassName()` Gets the class name of the object.
`java.lang.Object`	`getClientInfo()` Returns the client info object associated with this Object.
`java.lang.String`	`getComment()` Get text property Comment (COMMENT_PTID).
`java.lang.String`	`getConsoleWindow()` Get text property ConsoleWindow (CONSOLE_WINDOW_PTID).
`int`	`getCursorMode()` Get number property CursorMode (CURSOR_MODE_PTID).
`JdapiIterator`	`getEditors()` Accessor for child Editor objects (EDITOR_PTID).
`JdapiIterator`	`getEvents()` Accessor for child Event objects (EVENT_PTID).
`java.lang.String`	`getFirstNavigationBlockName()` Get text property FirstNavigationBlockName (FIRST_NAVIGATION_BLOCK_NAME_PTID).
`Block`	`getFirstNavigationBlockObject()` Get object property FirstNavigationBlockObject (FIRST_NAVIGATION_BLOCK_OBJECT_PTID).
`java.lang.String`	`getHelpBookTitle()` Get text property HelpBookTitle (HELP_BOOK_TITLE_PTID).
`java.lang.String`	`getHorizontalToolbarCanvas()` Get text property HorizontalToolbarCanvas (HORIZONTAL_TOOLBAR_CANVAS_PTID).
`java.lang.String`	`getInitializeMenu()` Get text property InitializeMenu (INITIALIZE_MENU_PTID).
`int`	`getIntegerProperty(int propertyTypeId)` Retrieves an integer property from the referred object.
`java.lang.String`	`getIntegerPropertyString(int propertyTypeId)` Gets a numeric (`long`) property value's text representation.
`int`	`getInteractionMode()` Get number property InteractionMode (INTERACTION_MODE_PTID).
`int`	`getIsolationMode()` Get number property IsolationMode (ISOLATION_MODE_PTID).
`JdapiMetaObject`	`getJdapiMetaObject()` Gets the metadata object for the specified object.
`int`	`getLanguageDirection()` Get number property LanguageDirection (LANGUAGE_DIRECTION_PTID).
`JdapiIterator`	`getLOVs()` Accessor for child LOV objects (LOV_PTID).
`int`	`getMaximumQueryTime()` Get number property MaximumQueryTime (MAXIMUM_QUERY_TIME_PTID).
`int`	`getMaximumRecordsFetched()` Get number property MaximumRecordsFetched (MAXIMUM_RECORDS_FETCHED_PTID).
`java.lang.String`	`getMenuModule()` Get text property MenuModule (MENU_MODULE_PTID).
`java.lang.String`	`getMenuRole()` Get text property MenuRole (MENU_ROLE_PTID).
`JdapiIterator`	`getMenus()` Accessor for child Menu objects (MENU_PTID).
`JdapiIterator`	`getMetaProperties()` Return an iterator over the meta properties in object referred.
`JdapiObject`	`getModule()` Get Module (MODULE_PTID) object property.
`JdapiIterator`	`getModuleParameters()` Accessor for child ModuleParameter objects (FORM_PARAMETER_PTID).
`int`	`getMouseNavigationLimit()` Get number property MouseNavigationLimit (MOUSE_NAVIGATION_LIMIT_PTID).
`java.lang.String`	`getName()` Get text property Name (NAME_PTID).
`int`	`getNewdeferReqEnf()` Get number property NewdeferReqEnf (NEWDEFER_REQ_ENF_PTID).
`JdapiIterator`	`getObjectGroups()` Accessor for child ObjectGroup objects (OBJECT_GROUP_PTID).
`protected long`	`getObjectPointer()` Gets the Forms API pointer for this object.
`JdapiObject`	`getObjectProperty(int propertyTypeId)` Retrieves a `JdapiObject` property from the referred object.
`protected long`	`getObjProp(int propertyTypeId)` Internal method used to get an object property value.
`JdapiIterator`	`getOwnedObjects()` Get the object instances owned by this particular object.
`JdapiObject`	`getOwner()` Get Owner (OWNER_PTID) object property.
`java.lang.String`	`getParentFilename()` Get text property ParentFilename (PARENT_FILENAME_PTID).
`java.lang.String`	`getParentFilepath()` Get text property ParentFilepath (PARENT_FILEPATH_PTID).
`java.lang.String`	`getParentModule()` Get text property ParentModule (PARENT_MODULE_PTID).
`int`	`getParentModuleType()` Get number property ParentModuleType (PARENT_MODULETYPE_PTID).
`java.lang.String`	`getParentName()` Get text property ParentName (PARENT_NAME_PTID).
`int`	`getParentType()` Get number property ParentType (PARENT_TYPE_PTID).
`Blob`	`getPersistentClientInfoBlob()` Returns the persistent client info Blob associated with this object.
`int`	`getPersistentClientInfoLength()` Get number property PersistentClientInfoLength (PERSISTENT_CLIENT_INFO_LENGTH_PTID).
`java.lang.Object`	`getPersistentClientInfoObject()` Returns the persistent client info Java object associated with this object.
`JdapiIterator`	`getProgramUnits()` Accessor for child ProgramUnit objects (PROGRAM_UNIT_PTID).
`JdapiIterator`	`getPropertyClasses()` Accessor for child PropertyClass objects (PROPERTY_CLASS_PTID).
`int`	`getPropertyState(int propertyTypeId)` Returns the current state of the specified property.
`java.lang.String`	`getPropertyValueName(int propertyTypeId, int val)` Gets the string representation of a given property's value.
`java.lang.String`	`getQualifiedName(boolean includeModule)` Gets a fully qualified name for the object in the format of: MODULE.OBJECT.CHILD.CHILD...
`JdapiIterator`	`getRecordGroups()` Accessor for child RecordGroup objects (RECORD_GROUP_PTID).
`java.lang.String`	`getRecordVisualAttributeGroupName()` Get text property RecordVisualAttributeGroupName (RECORD_VISUALATTRIBUTE_GROUP_NAME_PTID).
`VisualAttribute`	`getRecordVisualAttributeGroupObject()` Get object property RecordVisualAttributeGroupObject (RECORD_VISUALATTRIBUTE_GROUP_OBJECT_PTID).
`JdapiIterator`	`getReports()` Accessor for child Report objects (REPORT_PTID).
`int`	`getRuntimeComp()` Get number property RuntimeComp (RUNTIME_COMP_PTID).
`int`	`getStringIDProperty(int propertyTypeId)` Retrieves a special String ID (integer) property from the referred object.
`java.lang.String`	`getStringProperty(int propertyTypeId)` Retrieves a string property from the referred object.
`JdapiObject`	`getSubclassParent()` Get Source (SOURCE_PTID) object property, i.e.
`java.lang.String`	`getTitle()` Get text property Title (TITLE_PTID).
`TranslationTable`	`getTranslationTable()` Get a TranslationTable object representing the translations for this module.
`JdapiIterator`	`getTriggers()` Accessor for child Trigger objects (TRIGGER_PTID).
`int`	`getTypeId()` Gets the HtmlForms object type ID.
`int`	`getValidationUnit()` Get number property ValidationUnit (VALIDATION_UNIT_PTID).
`java.lang.String`	`getVerticalToolbarCanvas()` Get text property VerticalToolbarCanvas (VERTICAL_TOOLBAR_CANVAS_PTID).
`JdapiIterator`	`getVisualAttributes()` Accessor for child VisualAttribute objects (VISUAL_ATTRIBUTE_PTID).
`JdapiIterator`	`getWindows()` Accessor for child Window objects (WINDOW_PTID).
`boolean`	`hasDefaultedProperty(int propertyTypeId)` Checks if a property is set to it's default value.
`boolean`	`hasInheritedProperty(int propertyTypeId)` Checks if a property is inherited.
`boolean`	`hasOverriddenProperty(int propertyTypeId)` Determine whether the object referred has a property of the given type id with an overridden value.
`boolean`	`hasProperty(int propertyTypeId)` Checks if the object has a given property.
`void`	`inheritProperty(int propertyTypeId)` Resets a property to it's default value (confusing name eh?).
`boolean`	`isDirtyInfo()` Get boolean property DirtyInfo (DIRTY_INFO_PTID).
`boolean`	`isSavepointMode()` Get boolean property SavepointMode (SAVEPOINT_MODE_PTID).
`boolean`	`isSubclassed()` Checks if the object is subclassed from another object.
`boolean`	`isUse3dControls()` Get boolean property Use3dControls (USE_3D_CONTROLS_PTID).
`boolean`	`isValidFormsObject()` Determines whether this Java instance references a valid Forms object.
`void`	`move(JdapiObject next)` Reorders an object with respect to its siblings in the collection it belongs to.
`static FormModule`	`open(java.io.File file)` Loads a FormModule module from the filesystem or from the loaded modules list.
`static FormModule`	`open(java.io.File file, java.lang.String formsPath)` Loads a FormModule module from the filesystem or from the loaded modules list.
`static FormModule`	`open(java.lang.String fileName)` Loads a FormModule module from the filesystem or from the loaded modules list.
`static FormModule`	`open(java.lang.String fileName, java.lang.String formsPath)` Loads a FormModule module from the filesystem or from the loaded modules list.
`int`	`queryType()` Returns the FormAPI object type ID (x`_OTID` in `JdapiTypes`).
`void`	`reattach()` Reattaches subclassed object.
`void`	`save(java.lang.String fileName)` Saves the module to the filesystem.
`void`	`setBooleanProperty(int propertyTypeId, boolean propertyValue)` Sets the value of the specified boolean property belonging to the referred object.
`void`	`setClientInfo(java.lang.Object clientInfo)` Sets the client information.
`void`	`setComment(java.lang.String value)` Sets text property Comment (COMMENT_PTID).
`void`	`setConsoleWindow(java.lang.String value)` Sets text property ConsoleWindow (CONSOLE_WINDOW_PTID).
`void`	`setDirtyInfo(boolean value)` Sets boolean property DirtyInfo (DIRTY_INFO_PTID).
`void`	`setFirstNavigationBlockName(java.lang.String value)` Sets text property FirstNavigationBlockName (FIRST_NAVIGATION_BLOCK_NAME_PTID).
`void`	`setFirstNavigationBlockObject(Block value)` Set object property FirstNavigationBlockObject (FIRST_NAVIGATION_BLOCK_OBJECT_PTID).
`void`	`setHelpBookTitle(java.lang.String value)` Sets text property HelpBookTitle (HELP_BOOK_TITLE_PTID).
`void`	`setHorizontalToolbarCanvas(java.lang.String value)` Sets text property HorizontalToolbarCanvas (HORIZONTAL_TOOLBAR_CANVAS_PTID).
`void`	`setInitializeMenu(java.lang.String value)` Sets text property InitializeMenu (INITIALIZE_MENU_PTID).
`void`	`setIntegerProperty(int propertyTypeId, int propertyValue)` Sets the value of the specified object integer property.
`void`	`setInteractionMode(int value)` Sets number property InteractionMode (INTERACTION_MODE_PTID).
`void`	`setIsolationMode(int value)` Sets number property IsolationMode (ISOLATION_MODE_PTID).
`void`	`setLanguageDirection(int value)` Sets number property LanguageDirection (LANGUAGE_DIRECTION_PTID).
`void`	`setMaximumQueryTime(int value)` Sets number property MaximumQueryTime (MAXIMUM_QUERY_TIME_PTID).
`void`	`setMaximumRecordsFetched(int value)` Sets number property MaximumRecordsFetched (MAXIMUM_RECORDS_FETCHED_PTID).
`void`	`setMenuModule(java.lang.String value)` Sets text property MenuModule (MENU_MODULE_PTID).
`void`	`setMenuRole(java.lang.String value)` Sets text property MenuRole (MENU_ROLE_PTID).
`void`	`setMouseNavigationLimit(int value)` Sets number property MouseNavigationLimit (MOUSE_NAVIGATION_LIMIT_PTID).
`void`	`setName(java.lang.String value)` Sets text property Name (NAME_PTID).
`void`	`setNewdeferReqEnf(int value)` Sets number property NewdeferReqEnf (NEWDEFER_REQ_ENF_PTID).
`void`	`setObjectProperty(int propertyTypeId, JdapiObject propertyValue)` Sets the value of the specified object object property value.
`protected void`	`setObjProp(int propertyTypeId, long val)` Internal method used to set an object property.
`void`	`setParentFilename(java.lang.String value)` Sets text property ParentFilename (PARENT_FILENAME_PTID).
`void`	`setParentFilepath(java.lang.String value)` Sets text property ParentFilepath (PARENT_FILEPATH_PTID).
`void`	`setParentModule(java.lang.String value)` Sets text property ParentModule (PARENT_MODULE_PTID).
`void`	`setParentModuleType(int value)` Sets number property ParentModuleType (PARENT_MODULETYPE_PTID).
`void`	`setParentName(java.lang.String value)` Sets text property ParentName (PARENT_NAME_PTID).
`void`	`setParentType(int value)` Sets number property ParentType (PARENT_TYPE_PTID).
`void`	`setPersistentClientInfo(Blob val)` Sets persistent client info for this object.
`void`	`setPersistentClientInfo(java.io.Serializable obj)` Serializes any Java object which supports the Serializable interface to this object's Persistent Client Info.
`void`	`setPersistentClientInfoLength(int value)` Sets number property PersistentClientInfoLength (PERSISTENT_CLIENT_INFO_LENGTH_PTID).
`void`	`setRecordVisualAttributeGroupName(java.lang.String value)` Sets text property RecordVisualAttributeGroupName (RECORD_VISUALATTRIBUTE_GROUP_NAME_PTID).
`void`	`setRecordVisualAttributeGroupObject(VisualAttribute value)` Set object property RecordVisualAttributeGroupObject (RECORD_VISUALATTRIBUTE_GROUP_OBJECT_PTID).
`void`	`setRuntimeComp(int value)` Sets number property RuntimeComp (RUNTIME_COMP_PTID).
`void`	`setStringProperty(int propertyTypeId, java.lang.String propertyValue)` Sets the value of the specified string property for the object.
`void`	`setSubclassParent(JdapiObject parent)` Change the subclassing parent of the object referred.
`void`	`setTitle(java.lang.String value)` Sets text property Title (TITLE_PTID).
`void`	`setUse3dControls(boolean value)` Sets boolean property Use3dControls (USE_3D_CONTROLS_PTID).
`void`	`setValidationUnit(int value)` Sets number property ValidationUnit (VALIDATION_UNIT_PTID).
`void`	`setVerticalToolbarCanvas(java.lang.String value)` Sets text property VerticalToolbarCanvas (VERTICAL_TOOLBAR_CANVAS_PTID).
`java.lang.String`	`toString()` Converts and returns the object properties to string format.
`void`	`unsetSubclassParent()` Remove the subclassing parent of the object referred.
`void`	`wrapTranslatedText(Graphics pd2fgra, java.lang.String language)` #(4292441) Jdapi for wrapping of boilerplate text needed.

Methods inherited from class oracle.forms.jdapi.JdapiModule
`destroy, getAbsolutePath, getModulesProductVersion, openModule, openModule, openModule, openModule, setAbsolutePath`

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

Field Detail

m_pd2fob

protected transient long m_pd2fob

This is the d2fob pointer in the C ifjapi60 for the object that is derived from this class.

m_clientInfo

protected transient java.lang.Object m_clientInfo

Client info object held against this Forms object.

Constructor Detail

FormModule

public FormModule(java.lang.String name)

Constructor used to create FormModule objects.

Parameters:: name - Name of the new object

FormModule

protected FormModule(long pd2ffmd)

Protected constructor, used internally to create FormModule objects. This doesn't actually create a new FormModule, it just creates a Java instance for an already existing Forms object.

Do NOT use this constructor, even within the Jdapi package. If you have a pointer and need to instantiate it's Java representation, get the object via the context cache, e.g.

 myBaseObject = Jdapi.getObject(myPointer);

Parameters:: pd2ffmd - C pointer to Forms object

Method Detail

getTypeId

public int getTypeId()

Gets the HtmlForms object type ID.

Specified by:: getTypeId in interface JdapiObject

Returns:: X_OTID ID for this object type
See Also:: queryType

open

public static FormModule open(java.lang.String fileName)

Loads a FormModule module from the filesystem or from the loaded modules list.

A runtime exception is thrown if a module the file has subclassed from cannot be found on the Forms path. This behaviour can be suppressed with the Jdapi.setFailSubclassLoad() method.

Parameters:: fileName - File name of FormModule to load
Returns:: FormModule object

open

public static FormModule open(java.io.File file)

Loads a FormModule module from the filesystem or from the loaded modules list.

A runtime exception is thrown if a module the file has subclassed from cannot be found on the Forms path. This behaviour can be suppressed with the Jdapi.setFailSubclassLoad() method.

Parameters:: file - File representing FormModule to load
Returns:: FormModule object

open

public static FormModule open(java.lang.String fileName,
                              java.lang.String formsPath)

Loads a FormModule module from the filesystem or from the loaded modules list.

A runtime exception is thrown if a module the file has subclassed from cannot be found on the Forms path. This behaviour can be suppressed with the Jdapi.setFailSubclassLoad() method.

Parameters:: fileName - Filename of FormModule to load; formsPath - Path to use to look for modules that have been subclassed from. 'null' means use the default FORMS70_PATH.
Returns:: FormModule object

open

public static FormModule open(java.io.File file,
                              java.lang.String formsPath)

Loads a FormModule module from the filesystem or from the loaded modules list.

A runtime exception is thrown if a module the file has subclassed from cannot be found on the Forms path. This behaviour can be suppressed with the Jdapi.setFailSubclassLoad() method.

Parameters:: file - File representing FormModule to load; formsPath - Path to use to look for modules that have been subclassed from. 'null' means use the default FORMS70_PATH.
Returns:: FormModule object

save

public void save(java.lang.String fileName)

Saves the module to the filesystem.

Specified by:: save in class JdapiModule

Parameters:: fileName - Filename to save as

compile

public void compile()

Compiles the module to the filesystem.

Specified by:: compile in class JdapiModule

clone

public FormModule clone(java.lang.String newName)

Creates a copy of the object as a child of 'parent'.

Parameters:: newName - Name of object that's being created
Returns:: Replicant object

find

public static FormModule find(java.lang.String name)

Find an instance of FormModule.

Parameters:: name - Name of object you wish to find
Returns:: Object instance you are looking for, or null if none was found

getTranslationTable

public TranslationTable getTranslationTable()

Get a TranslationTable object representing the translations for this module.

Returns:: TranslationTable

wrapTranslatedText

public void wrapTranslatedText(Graphics pd2fgra,
                               java.lang.String language)

#(4292441) Jdapi for wrapping of boilerplate text needed. Wraps the boilerplate text label. This API must be by FormModule independent of Jdapi started in translation mode or not. pd2fgra Graphics object containing the text to be wrapped. language Oracle-defined name of the language.

getComment

public java.lang.String getComment()

Get text property Comment (COMMENT_PTID).

Returns:: Value of property

setComment

public void setComment(java.lang.String value)

Sets text property Comment (COMMENT_PTID).

Parameters:: value - Value to set property to

getConsoleWindow

public java.lang.String getConsoleWindow()

Get text property ConsoleWindow (CONSOLE_WINDOW_PTID).

Returns:: Value of property

setConsoleWindow

public void setConsoleWindow(java.lang.String value)

Sets text property ConsoleWindow (CONSOLE_WINDOW_PTID).

Parameters:: value - Value to set property to

getFirstNavigationBlockName

public java.lang.String getFirstNavigationBlockName()

Get text property FirstNavigationBlockName (FIRST_NAVIGATION_BLOCK_NAME_PTID).

Returns:: Value of property

setFirstNavigationBlockName

public void setFirstNavigationBlockName(java.lang.String value)

Sets text property FirstNavigationBlockName (FIRST_NAVIGATION_BLOCK_NAME_PTID).

Parameters:: value - Value to set property to

getHelpBookTitle

public java.lang.String getHelpBookTitle()

Get text property HelpBookTitle (HELP_BOOK_TITLE_PTID).

Returns:: Value of property

setHelpBookTitle

public void setHelpBookTitle(java.lang.String value)

Sets text property HelpBookTitle (HELP_BOOK_TITLE_PTID).

Parameters:: value - Value to set property to

getHorizontalToolbarCanvas

public java.lang.String getHorizontalToolbarCanvas()

Get text property HorizontalToolbarCanvas (HORIZONTAL_TOOLBAR_CANVAS_PTID).

Returns:: Value of property

setHorizontalToolbarCanvas

public void setHorizontalToolbarCanvas(java.lang.String value)

Sets text property HorizontalToolbarCanvas (HORIZONTAL_TOOLBAR_CANVAS_PTID).

Parameters:: value - Value to set property to

getInitializeMenu

public java.lang.String getInitializeMenu()

Get text property InitializeMenu (INITIALIZE_MENU_PTID).

Returns:: Value of property

setInitializeMenu

public void setInitializeMenu(java.lang.String value)

Sets text property InitializeMenu (INITIALIZE_MENU_PTID).

Parameters:: value - Value to set property to

getMenuModule

public java.lang.String getMenuModule()

Get text property MenuModule (MENU_MODULE_PTID).

Returns:: Value of property

setMenuModule

public void setMenuModule(java.lang.String value)

Sets text property MenuModule (MENU_MODULE_PTID).

Parameters:: value - Value to set property to

getMenuRole

public java.lang.String getMenuRole()

Get text property MenuRole (MENU_ROLE_PTID).

Returns:: Value of property

setMenuRole

public void setMenuRole(java.lang.String value)

Sets text property MenuRole (MENU_ROLE_PTID).

Parameters:: value - Value to set property to

getName

public java.lang.String getName()

Get text property Name (NAME_PTID).

Specified by:: getName in interface JdapiObject

Returns:: Value of property

setName

public void setName(java.lang.String value)

Sets text property Name (NAME_PTID).

Parameters:: value - Value to set property to

getParentFilename

public java.lang.String getParentFilename()

Get text property ParentFilename (PARENT_FILENAME_PTID).

Returns:: Value of property

setParentFilename

public void setParentFilename(java.lang.String value)

Sets text property ParentFilename (PARENT_FILENAME_PTID).

Parameters:: value - Value to set property to

getParentFilepath

public java.lang.String getParentFilepath()

Get text property ParentFilepath (PARENT_FILEPATH_PTID).

Returns:: Value of property

setParentFilepath

public void setParentFilepath(java.lang.String value)

Sets text property ParentFilepath (PARENT_FILEPATH_PTID).

Parameters:: value - Value to set property to

getParentModule

public java.lang.String getParentModule()

Get text property ParentModule (PARENT_MODULE_PTID).

Returns:: Value of property

setParentModule

public void setParentModule(java.lang.String value)

Sets text property ParentModule (PARENT_MODULE_PTID).

Parameters:: value - Value to set property to

getParentName

public java.lang.String getParentName()

Get text property ParentName (PARENT_NAME_PTID).

Returns:: Value of property

setParentName

public void setParentName(java.lang.String value)

Sets text property ParentName (PARENT_NAME_PTID).

Parameters:: value - Value to set property to

getRecordVisualAttributeGroupName

public java.lang.String getRecordVisualAttributeGroupName()

Get text property RecordVisualAttributeGroupName (RECORD_VISUALATTRIBUTE_GROUP_NAME_PTID).

Returns:: Value of property

setRecordVisualAttributeGroupName

public void setRecordVisualAttributeGroupName(java.lang.String value)

Sets text property RecordVisualAttributeGroupName (RECORD_VISUALATTRIBUTE_GROUP_NAME_PTID).

Parameters:: value - Value to set property to

getTitle

public java.lang.String getTitle()

Get text property Title (TITLE_PTID).

Returns:: Value of property

setTitle

public void setTitle(java.lang.String value)

Sets text property Title (TITLE_PTID).

Parameters:: value - Value to set property to

getVerticalToolbarCanvas

public java.lang.String getVerticalToolbarCanvas()

Get text property VerticalToolbarCanvas (VERTICAL_TOOLBAR_CANVAS_PTID).

Returns:: Value of property

setVerticalToolbarCanvas

public void setVerticalToolbarCanvas(java.lang.String value)

Sets text property VerticalToolbarCanvas (VERTICAL_TOOLBAR_CANVAS_PTID).

Parameters:: value - Value to set property to

getCursorMode

public int getCursorMode()

Get number property CursorMode (CURSOR_MODE_PTID).

Returns:: Value of property

getInteractionMode

public int getInteractionMode()

Get number property InteractionMode (INTERACTION_MODE_PTID).

Returns:: Value of property

setInteractionMode

public void setInteractionMode(int value)

Sets number property InteractionMode (INTERACTION_MODE_PTID).

Parameters:: value - Value to set property to

getIsolationMode

public int getIsolationMode()

Get number property IsolationMode (ISOLATION_MODE_PTID).

Returns:: Value of property

setIsolationMode

public void setIsolationMode(int value)

Sets number property IsolationMode (ISOLATION_MODE_PTID).

Parameters:: value - Value to set property to

getLanguageDirection

public int getLanguageDirection()

Get number property LanguageDirection (LANGUAGE_DIRECTION_PTID).

Returns:: Value of property

setLanguageDirection

public void setLanguageDirection(int value)

Sets number property LanguageDirection (LANGUAGE_DIRECTION_PTID).

Parameters:: value - Value to set property to

getMaximumQueryTime

public int getMaximumQueryTime()

Get number property MaximumQueryTime (MAXIMUM_QUERY_TIME_PTID).

Returns:: Value of property

setMaximumQueryTime

public void setMaximumQueryTime(int value)

Sets number property MaximumQueryTime (MAXIMUM_QUERY_TIME_PTID).

Parameters:: value - Value to set property to

getMaximumRecordsFetched

public int getMaximumRecordsFetched()

Get number property MaximumRecordsFetched (MAXIMUM_RECORDS_FETCHED_PTID).

Returns:: Value of property

setMaximumRecordsFetched

public void setMaximumRecordsFetched(int value)

Sets number property MaximumRecordsFetched (MAXIMUM_RECORDS_FETCHED_PTID).

Parameters:: value - Value to set property to

getMouseNavigationLimit

public int getMouseNavigationLimit()

Get number property MouseNavigationLimit (MOUSE_NAVIGATION_LIMIT_PTID).

Returns:: Value of property

setMouseNavigationLimit

public void setMouseNavigationLimit(int value)

Sets number property MouseNavigationLimit (MOUSE_NAVIGATION_LIMIT_PTID).

Parameters:: value - Value to set property to

getNewdeferReqEnf

public int getNewdeferReqEnf()

Get number property NewdeferReqEnf (NEWDEFER_REQ_ENF_PTID).

Returns:: Value of property

setNewdeferReqEnf

public void setNewdeferReqEnf(int value)

Sets number property NewdeferReqEnf (NEWDEFER_REQ_ENF_PTID).

Parameters:: value - Value to set property to

getParentModuleType

public int getParentModuleType()

Get number property ParentModuleType (PARENT_MODULETYPE_PTID).

Returns:: Value of property

setParentModuleType

public void setParentModuleType(int value)

Sets number property ParentModuleType (PARENT_MODULETYPE_PTID).

Parameters:: value - Value to set property to

getParentType

public int getParentType()

Get number property ParentType (PARENT_TYPE_PTID).

Returns:: Value of property

setParentType

public void setParentType(int value)

Sets number property ParentType (PARENT_TYPE_PTID).

Parameters:: value - Value to set property to

getPersistentClientInfoLength

public int getPersistentClientInfoLength()

Get number property PersistentClientInfoLength (PERSISTENT_CLIENT_INFO_LENGTH_PTID).

Returns:: Value of property

setPersistentClientInfoLength

public void setPersistentClientInfoLength(int value)

Sets number property PersistentClientInfoLength (PERSISTENT_CLIENT_INFO_LENGTH_PTID).

Parameters:: value - Value to set property to

getRuntimeComp

public int getRuntimeComp()

Get number property RuntimeComp (RUNTIME_COMP_PTID).

Returns:: Value of property

setRuntimeComp

public void setRuntimeComp(int value)

Sets number property RuntimeComp (RUNTIME_COMP_PTID).

Parameters:: value - Value to set property to

getValidationUnit

public int getValidationUnit()

Get number property ValidationUnit (VALIDATION_UNIT_PTID).

Returns:: Value of property

setValidationUnit

public void setValidationUnit(int value)

Sets number property ValidationUnit (VALIDATION_UNIT_PTID).

Parameters:: value - Value to set property to

isDirtyInfo

public boolean isDirtyInfo()

Get boolean property DirtyInfo (DIRTY_INFO_PTID).

Returns:: Value of property

setDirtyInfo

public void setDirtyInfo(boolean value)

Sets boolean property DirtyInfo (DIRTY_INFO_PTID).

Parameters:: value - Value to set property to

isSavepointMode

public boolean isSavepointMode()

Get boolean property SavepointMode (SAVEPOINT_MODE_PTID).

Returns:: Value of property

isUse3dControls

public boolean isUse3dControls()

Get boolean property Use3dControls (USE_3D_CONTROLS_PTID).

Returns:: Value of property

setUse3dControls

public void setUse3dControls(boolean value)

Sets boolean property Use3dControls (USE_3D_CONTROLS_PTID).

Parameters:: value - Value to set property to

getAlerts

public JdapiIterator getAlerts()

Accessor for child Alert objects (ALERT_PTID). Gets list of child objects as an iterator (which implements Enumeration for simple traversal).

Returns:: Iterator of Alert objects

getAttachedLibraries

public JdapiIterator getAttachedLibraries()

Accessor for child AttachedLibrary objects (ATTACHMENT_LIBRARY_PTID). Gets list of child objects as an iterator (which implements Enumeration for simple traversal).

Returns:: Iterator of AttachedLibrary objects

getBlocks

public JdapiIterator getBlocks()

Accessor for child Block objects (BLOCK_PTID). Gets list of child objects as an iterator (which implements Enumeration for simple traversal).

Returns:: Iterator of Block objects

getCanvases

public JdapiIterator getCanvases()

Accessor for child Canvas objects (CANVAS_PTID). Gets list of child objects as an iterator (which implements Enumeration for simple traversal).

Returns:: Iterator of Canvas objects

getEditors

public JdapiIterator getEditors()

Accessor for child Editor objects (EDITOR_PTID). Gets list of child objects as an iterator (which implements Enumeration for simple traversal).

Returns:: Iterator of Editor objects

getEvents

public JdapiIterator getEvents()

Accessor for child Event objects (EVENT_PTID). Gets list of child objects as an iterator (which implements Enumeration for simple traversal).

Returns:: Iterator of Event objects

getModuleParameters

public JdapiIterator getModuleParameters()

Accessor for child ModuleParameter objects (FORM_PARAMETER_PTID). Gets list of child objects as an iterator (which implements Enumeration for simple traversal).

Returns:: Iterator of ModuleParameter objects

getFirstNavigationBlockObject

public Block getFirstNavigationBlockObject()

Get object property FirstNavigationBlockObject (FIRST_NAVIGATION_BLOCK_OBJECT_PTID).

Returns:: Value of property (null if none)

setFirstNavigationBlockObject

public void setFirstNavigationBlockObject(Block value)

Set object property FirstNavigationBlockObject (FIRST_NAVIGATION_BLOCK_OBJECT_PTID).

Parameters:: value - Block object to set property to

getLOVs

public JdapiIterator getLOVs()

Accessor for child LOV objects (LOV_PTID). Gets list of child objects as an iterator (which implements Enumeration for simple traversal).

Returns:: Iterator of LOV objects

getMenus

public JdapiIterator getMenus()

Accessor for child Menu objects (MENU_PTID). Gets list of child objects as an iterator (which implements Enumeration for simple traversal).

Returns:: Iterator of Menu objects

getObjectGroups

public JdapiIterator getObjectGroups()

Accessor for child ObjectGroup objects (OBJECT_GROUP_PTID). Gets list of child objects as an iterator (which implements Enumeration for simple traversal).

Returns:: Iterator of ObjectGroup objects

getProgramUnits

public JdapiIterator getProgramUnits()

Accessor for child ProgramUnit objects (PROGRAM_UNIT_PTID). Gets list of child objects as an iterator (which implements Enumeration for simple traversal).

Returns:: Iterator of ProgramUnit objects

getPropertyClasses

public JdapiIterator getPropertyClasses()

Accessor for child PropertyClass objects (PROPERTY_CLASS_PTID). Gets list of child objects as an iterator (which implements Enumeration for simple traversal).

Returns:: Iterator of PropertyClass objects

getRecordGroups

public JdapiIterator getRecordGroups()

Accessor for child RecordGroup objects (RECORD_GROUP_PTID). Gets list of child objects as an iterator (which implements Enumeration for simple traversal).

Returns:: Iterator of RecordGroup objects

getRecordVisualAttributeGroupObject

public VisualAttribute getRecordVisualAttributeGroupObject()

Get object property RecordVisualAttributeGroupObject (RECORD_VISUALATTRIBUTE_GROUP_OBJECT_PTID).

Returns:: Value of property (null if none)

setRecordVisualAttributeGroupObject

public void setRecordVisualAttributeGroupObject(VisualAttribute value)

Set object property RecordVisualAttributeGroupObject (RECORD_VISUALATTRIBUTE_GROUP_OBJECT_PTID).

Parameters:: value - VisualAttribute object to set property to

getReports

public JdapiIterator getReports()

Accessor for child Report objects (REPORT_PTID). Gets list of child objects as an iterator (which implements Enumeration for simple traversal).

Returns:: Iterator of Report objects

getTriggers

public JdapiIterator getTriggers()

Accessor for child Trigger objects (TRIGGER_PTID). Gets list of child objects as an iterator (which implements Enumeration for simple traversal).

Returns:: Iterator of Trigger objects

getVisualAttributes

public JdapiIterator getVisualAttributes()

Accessor for child VisualAttribute objects (VISUAL_ATTRIBUTE_PTID). Gets list of child objects as an iterator (which implements Enumeration for simple traversal).

Returns:: Iterator of VisualAttribute objects

getWindows

public JdapiIterator getWindows()

Accessor for child Window objects (WINDOW_PTID). Gets list of child objects as an iterator (which implements Enumeration for simple traversal).

Returns:: Iterator of Window objects

getObjectPointer

protected long getObjectPointer()

Gets the Forms API pointer for this object.

Returns:: C pointer to the Forms object

queryType

public int queryType()

Returns the FormAPI object type ID (x_OTID in JdapiTypes). This should always be the same value as returned for getTypeId. The difference between the two methods is that queryType calls down to the API itself; this ensures that the correct type is returned. Because this method calls down to the API, you might find it a little faster to use getTypeID instead.

Specified by:: queryType in interface JdapiObject

Returns:: x_OTID an object type ID as defined in JdapiTypes.

setClientInfo

public void setClientInfo(java.lang.Object clientInfo)

Sets the client information. Since the clientInfo is a java.lang.Object, the client information can be anything you want to associate with the referred object. For example, you can create your own class, then pass it to this method. The referred object will retain a reference to the clientInfo.

This client info object is not persistent and will be lost when the session ends.

Specified by:: setClientInfo in interface JdapiObject

Parameters:: clientInfo - client info to be associated with the object.

getClientInfo

public java.lang.Object getClientInfo()

Returns the client info object associated with this Object. The type ID of the object returned is dependant on the type ID of the object that was set using setClientObject.

Specified by:: getClientInfo in interface JdapiObject

Returns:: the client info object associated with this object.

getPersistentClientInfoBlob

public Blob getPersistentClientInfoBlob()

Returns the persistent client info Blob associated with this object.

Specified by:: getPersistentClientInfoBlob in interface JdapiObject

Returns:: Blob containing client info.

getPersistentClientInfoObject

public java.lang.Object getPersistentClientInfoObject()

Returns the persistent client info Java object associated with this object.

Specified by:: getPersistentClientInfoObject in interface JdapiObject

Returns:: java.lang.Object serialized into the Forms object.

setPersistentClientInfo

public void setPersistentClientInfo(Blob val)

Sets persistent client info for this object.

Like the non-persistent client info methods, the client info can be any information that you want to save with the form. Unlike the non-persistent client info methods, the persistent info is saved as part of the form and will not be lost when the session is ended.

Specified by:: setPersistentClientInfo in interface JdapiObject

Parameters:: val - a Blob object containing client info.

setPersistentClientInfo

public void setPersistentClientInfo(java.io.Serializable obj)

Serializes any Java object which supports the Serializable interface to this object's Persistent Client Info.

Specified by:: setPersistentClientInfo in interface JdapiObject

Parameters:: obj - any Serializable object containing client info.

equals

public boolean equals(JdapiObject obj)

Compares two objects and determines if they are equal.

Specified by:: equals in interface JdapiObject

Parameters:: obj - object to be compared.
Returns:: true if the two objects are equal; returns false if they are not equal.

clone

public JdapiObject clone(JdapiObject parent,
                         java.lang.String newName)

Creates a clone of the specified object, creating a new object with the given name and owner. For example, given a Block in Form A, you can clone it into Form B by passing Form B in the parent parameter, and specifying a new name for the block in the newName parameter.

The new object is the same as the original object in that it has the same property values. However, subclassing information is discarded, and the inherited property values "flattened" into local values in the new object.

It is your reponsibility to pass in an appropriate parent object. If you do not do this, you will probably get a JdapiException runtime exception. If possible, use the type safe clone method that is provided on each Forms object class.

Specified by:: clone in interface JdapiObject

Parameters:: parent - owner of the new object.; newName - name of the new object.
Returns:: the clone of the object.

changeOwner

public void changeOwner(JdapiObject newOwner)

Assigns a new owner to the referred object. This method will cause any previous owner to relinquish its ownership of the referred object.

Set newOwner to null if you want the object to have no owner.

The only restriction on this method is that the new owner must be in the same module as the referred object. If you attempt to assign a new owner that is in a different module, then a JdapiException will be thrown.

Note: If you want to assign the object to a new owner in a different module, then you will have to clone or subclass the object.

Specified by:: changeOwner in interface JdapiObject

Parameters:: newOwner - the new owner of referred object; specify null if you want the object to have no owner.
Throws:: JdapiException - if newOwner is in a different module.

toString

public java.lang.String toString()

Converts and returns the object properties to string format. This is useful for debugging purposes. The string is in the format: NAME(CLASSNAME, pointer: D2FOB*, context D2FCTX*)

Specified by:: toString in interface JdapiObject
Overrides:: toString in class java.lang.Object

Returns:: String representation of the object

clearObjectPointer

protected void clearObjectPointer()

Used internally to flag this object as an invalid object.

isValidFormsObject

public boolean isValidFormsObject()

Description copied from interface: JdapiObject

Determines whether this Java instance references a valid Forms object.

For example, assume that you have a reference to a block. If you call destroy() on its owning module, then the module and all of its blocks should be deleted from memory. The reference that you have no longer refers to a valid Forms object. A call to isValidFormsObject() on the block should return false.

Specified by:: isValidFormsObject in interface JdapiObject

Returns:: true if the instance references a valid forms object; false otherwise.

move

public void move(JdapiObject next)

Reorders an object with respect to its siblings in the collection it belongs to. This is similar to using drag and drop in Form Builder to move a block in a list. This method represents a way to do the same thing programmatically. For example, if you want a block appear immediately before Block5 in a list, you pass the object representing Block5 as the nextObject argument.

Pass null to this method to move the object to the end of the list. If the specified object and the next_object do not share the same owner, or do not have the same type, the method throws an exception.

You cannot use this method to move objects between parents. For example, it cannot be used to move an Item from one Block to another. If you want to move an object from one parent to another you will have to do something like:

   // e.g. to move 'itmA' to be positioned before 'itmB' in block
   // 'blkB' (when 'itmA' is in another block)

   // copy itmA into a new parent (blkB) using same name
   Item newItmA = itmA.clone(blkB, itmA.getName());
   newItmA.move(itmB);   // move new item relative to itmB
   itmA.destroy();       // delete original object
   itmA = newItmA;

Specified by:: move in interface JdapiObject

Parameters:: next - the object next to which the specified object is to be moved.
Throws:: JdapiException - if you attempt to move an object next to an object that does not share the same owner or is not of the samme type.

getBooleanProperty

public boolean getBooleanProperty(int propertyTypeId)

Retrieves a boolean property from the referred object.

Specified by:: getBooleanProperty in interface JdapiObject

Parameters:: propertyTypeId - property type ID for which a boolean value is returned.
Returns:: the boolean property value.

getStringProperty

public java.lang.String getStringProperty(int propertyTypeId)

Retrieves a string property from the referred object.

Specified by:: getStringProperty in interface JdapiObject

Parameters:: propertyTypeId - property type ID for which a string value is returned.
Returns:: the string property value.

getIntegerProperty

public int getIntegerProperty(int propertyTypeId)

Retrieves an integer property from the referred object. For example:

   ...
    if(propClass.hasProperty(propNumber) && propClass.allowGet(propNumber))
    {
      int propValue = propClass.getIntegerProperty(propNum);
    } 
    ...

Specified by:: getIntegerProperty in interface JdapiObject

Parameters:: propertyTypeId - property type ID for which an integer value is returned.
Returns:: the integer property value.

getStringIDProperty

public int getStringIDProperty(int propertyTypeId)

Retrieves a special String ID (integer) property from the referred object.

This method is intended for use with the TranslationTable object only. For a given property ID it retrieves the integer that indexes the string property in the table for the current language.

Specified by:: getStringIDProperty in interface JdapiObject

Parameters:: propertyTypeId - property type ID for which a String ID value is returned.
Returns:: the integer String ID property value.

getPropertyValueName

public java.lang.String getPropertyValueName(int propertyTypeId,
                                             int val)

Description copied from interface: JdapiObject

Gets the string representation of a given property's value.

Specified by:: getPropertyValueName in interface JdapiObject

Parameters:: propertyTypeId - Property number; val - Value of property
Returns:: String representation

getIntegerPropertyString

public java.lang.String getIntegerPropertyString(int propertyTypeId)

Description copied from interface: JdapiObject

Gets a numeric (long) property value's text representation.

Specified by:: getIntegerPropertyString in interface JdapiObject

Parameters:: propertyTypeId - Number identifying the property
Returns:: Property's text representation

getObjProp

protected long getObjProp(int propertyTypeId)

Internal method used to get an object property value. This only really gets the C pointer to the Forms object. You must then use the ContextCache to lookup/instantiate the Java representation of the object.

Parameters:: propertyTypeId - Number identifying the property
Returns:: Property's value
See Also:: ContextCache, getObjectProperty(int)

getObjectProperty

public JdapiObject getObjectProperty(int propertyTypeId)

Description copied from interface: JdapiObject

Retrieves a JdapiObject property from the referred object. For example, if you pass the integer propertyTypeId for an Item in a Block to this method, it returns the Item.

Specified by:: getObjectProperty in interface JdapiObject

Parameters:: propertyTypeId - property type ID for which a JdapiObject value is returned.
Returns:: the JdapiObject property value.

getChildObjectProperty

public JdapiIterator getChildObjectProperty(int propertyTypeId)

Description copied from interface: JdapiObject

Retrieves child objects for a given property value. Implicit in this method is the idea of an ownership relationship between objects. Items are clearly owned by a Block. If you delete the Block, then its Items are deleted. On the other hand, Items can appear on a Canvas. If you delete the Canvas, however, the Items are not deleted. Thus, the method returns an iterator over Items if it is passed a Block. In contrast, if it is passed a Canvas, it should not return an iterator over Items.

For example:

      ...
      // get the actual values for the current child object type, 
      // for example, get the Items on a Block 
      iter = jo.getChildObjectProperty(prop.getPropertyId());  
      ...

Note, it should be (slightly) faster to call the specific method on the object, for example getBlocks() on the FormModule, as it involves fewer API calls. However, getChildObjectProperty should be sufficient if you only have a propertyTypeId available.

This method also differs from the direct accessors in that null is returned if there are no objects, not an empty iterator.

Specified by:: getChildObjectProperty in interface JdapiObject

Parameters:: propertyTypeId - number identifying the child object property.
Returns:: Iterator for child objects, can return null if there are no child objects.

setBooleanProperty

public void setBooleanProperty(int propertyTypeId,
                               boolean propertyValue)

Description copied from interface: JdapiObject

Sets the value of the specified boolean property belonging to the referred object.

Specified by:: setBooleanProperty in interface JdapiObject

Parameters:: propertyTypeId - property type ID of the property for which you want to set the boolean value.; propertyValue - the boolean value for the property.

setStringProperty

public void setStringProperty(int propertyTypeId,
                              java.lang.String propertyValue)

Description copied from interface: JdapiObject

Sets the value of the specified string property for the object.

Specified by:: setStringProperty in interface JdapiObject

Parameters:: propertyTypeId - property type ID of the property for which you want to set the string value.; propertyValue - the string value for the property.

setIntegerProperty

public void setIntegerProperty(int propertyTypeId,
                               int propertyValue)

Sets the value of the specified object integer property.

Specified by:: setIntegerProperty in interface JdapiObject

Parameters:: propertyTypeId - property type id for which we set the integer value.; propertyValue - the integer property value in property.

setObjProp

protected void setObjProp(int propertyTypeId,
                          long val)

Internal method used to set an object property. This sets the object property by the C pointer to the object you want to set.

Parameters:: propertyTypeId - Number identifying the property; val - Value to set the property to
See Also:: setObjectProperty(int, oracle.forms.jdapi.JdapiObject)

setObjectProperty

public void setObjectProperty(int propertyTypeId,
                              JdapiObject propertyValue)

Sets the value of the specified object object property value.

Specified by:: setObjectProperty in interface JdapiObject

Parameters:: propertyTypeId - property type id for which we set the object property value.; propertyValue - the object property value in property.

hasProperty

public boolean hasProperty(int propertyTypeId)

Checks if the object has a given property.

Specified by:: hasProperty in interface JdapiObject

Parameters:: propertyTypeId - Number identifying the property
Returns:: 'true' if the object has that property, 'false' otherwise

inheritProperty

public void inheritProperty(int propertyTypeId)

Resets a property to it's default value (confusing name eh?). What it's really doing is setting the property to it's base classes value - i.e. whatever it's subclassed from. If the object is not subclassed from anything, then this is the default value.

Specified by:: inheritProperty in interface JdapiObject

Parameters:: propertyTypeId - Number that identified the property

hasInheritedProperty

public boolean hasInheritedProperty(int propertyTypeId)

Checks if a property is inherited.

Specified by:: hasInheritedProperty in interface JdapiObject

Parameters:: propertyTypeId - Number that identified the property
Returns:: 'true' if property is inherited

hasOverriddenProperty

public boolean hasOverriddenProperty(int propertyTypeId)

Determine whether the object referred has a property of the given type id with an overridden value.

Specified by:: hasOverriddenProperty in interface JdapiObject

Parameters:: propertyTypeId - The type id of the property to be queried.
Returns:: TRUE if the object's property has overridden value, else FALSE.

hasDefaultedProperty

public boolean hasDefaultedProperty(int propertyTypeId)

Checks if a property is set to it's default value.

Specified by:: hasDefaultedProperty in interface JdapiObject

Parameters:: propertyTypeId - Number that identified the property
Returns:: 'true' if the property is set to the default value

getPropertyState

public int getPropertyState(int propertyTypeId)

Returns the current state of the specified property.

A property can be in one of the 5 states:
PROPERTY_STATE_UNKNOWN = 0;
PROPERTY_DEFAULT_VALUE = 1;
PROPERTY_OVERRIDDEN_DEFAULT_VALUE = 2;
PROPERTY_INHERITED_VALUE = 3;
PROPERTY_OVERRIDDEN_INHERITED_VALUE = 3;

Specified by:: getPropertyState in interface JdapiObject

Parameters:: propertyTypeId - The type id of the property.
Returns:: integer 0 through 3 representing one of the states.

isSubclassed

public boolean isSubclassed()

Checks if the object is subclassed from another object.

Specified by:: isSubclassed in interface JdapiObject

Returns:: 'true' if the object is subclassed, 'false' otherwise

getSubclassParent

public JdapiObject getSubclassParent()

Get Source (SOURCE_PTID) object property, i.e. the object this object subclassed from. This is also implemented on derived classed with this property as getSource().

Specified by:: getSubclassParent in interface JdapiObject

Returns:: Value of property downcast to a BaseFormsObject (null if none of object does not have this property)

setSubclassParent

public void setSubclassParent(JdapiObject parent)

Change the subclassing parent of the object referred.

The metadata associated with each object describes the types of objects that can become its subclassing parent. If the subclassing metadata associated with the refrred object doesn't indicate the objects of the given parent's type are allowed, then this method will throw an exception.

Specified by:: setSubclassParent in interface JdapiObject

Parameters:: parent - The parent object. If this is null, the child the referred object will become an orphan. This is the way to unset the subclassing parent of an object.

unsetSubclassParent

public void unsetSubclassParent()

Remove the subclassing parent of the object referred.

The subclassing will be removed completely if it existed and the object will now contain the default values.

createSubclassedChild

public JdapiObject createSubclassedChild(JdapiObject childOwner,
                                         java.lang.String childName)

Subclass the referred object. The child will be owned by the referred object specified.

Specified by:: createSubclassedChild in interface JdapiObject

Parameters:: childOwner - The object that will own the newly created subclassed child object.; childName - The name to be given to the newly created child.
Returns:: the subclassed object.

reattach

public void reattach()

Reattaches subclassed object. You must call this method if you manipulate any of the following properties of a Forms object: PAR_MODULE_PTID, PAR_NAM_PTID, PAR_SL1OBJ_NAM_PTID, PAR_MODTYP_PTID, PAR_TYP_PTID, PARSL1OBJ_TYP_PTID This is only if you are manipulating these low level subclassing properties.

Specified by:: reattach in interface JdapiObject

getModule

public JdapiObject getModule()

Get Module (MODULE_PTID) object property.

Specified by:: getModule in interface JdapiObject

Returns:: Value of property downcast to a JdapiObject (null if none)

getOwner

public JdapiObject getOwner()

Get Owner (OWNER_PTID) object property.

Specified by:: getOwner in interface JdapiObject

Returns:: Value of property downcast to a JdapiObject (null if none)

getOwnedObjects

public JdapiIterator getOwnedObjects()

Get the object instances owned by this particular object.

Specified by:: getOwnedObjects in interface JdapiObject

Returns:: Iterator of JdapiObjects

getClassName

public java.lang.String getClassName()

Gets the class name of the object. This is useful if you want to refer to the name of the Forms object in some output but don't want the Java package details.

Specified by:: getClassName in interface JdapiObject

Returns:: Name of "class" of Forms object

getQualifiedName

public java.lang.String getQualifiedName(boolean includeModule)

Gets a fully qualified name for the object in the format of: MODULE.OBJECT.CHILD.CHILD... i.e. '.' separates the objects names from the current object back upto the module.

Specified by:: getQualifiedName in interface JdapiObject

Parameters:: includeModule - Include the module name

getJdapiMetaObject

public JdapiMetaObject getJdapiMetaObject()

Gets the metadata object for the specified object.

Specified by:: getJdapiMetaObject in interface JdapiObject

Returns:: the metadata object for the specified object.

getMetaProperties

public JdapiIterator getMetaProperties()

Return an iterator over the meta properties in object referred.

The various property type ids and the object-property mapping are defined by the specific implementation in the respective Constants file.

Specified by:: getMetaProperties in interface JdapiObject

Returns:: an enumeration of the specified object meta properties.

Package

Class

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

oracle.forms.jdapi Class FormModule

m_pd2fob

m_clientInfo

FormModule

FormModule

getTypeId

open

open

open

open

save

compile

clone

find

getTranslationTable

wrapTranslatedText

getComment

setComment

getConsoleWindow

setConsoleWindow

getFirstNavigationBlockName

setFirstNavigationBlockName

getHelpBookTitle

setHelpBookTitle

getHorizontalToolbarCanvas

setHorizontalToolbarCanvas

getInitializeMenu

setInitializeMenu

getMenuModule

setMenuModule

getMenuRole

setMenuRole

getName

setName

getParentFilename

setParentFilename

getParentFilepath

setParentFilepath

getParentModule

setParentModule

getParentName

setParentName

getRecordVisualAttributeGroupName

setRecordVisualAttributeGroupName

getTitle

setTitle

getVerticalToolbarCanvas

setVerticalToolbarCanvas

getCursorMode

getInteractionMode

setInteractionMode

getIsolationMode

setIsolationMode

getLanguageDirection

setLanguageDirection

getMaximumQueryTime

setMaximumQueryTime

getMaximumRecordsFetched

setMaximumRecordsFetched

getMouseNavigationLimit

setMouseNavigationLimit

getNewdeferReqEnf

setNewdeferReqEnf

getParentModuleType

setParentModuleType

getParentType

setParentType

getPersistentClientInfoLength

setPersistentClientInfoLength

getRuntimeComp

setRuntimeComp

getValidationUnit

setValidationUnit

isDirtyInfo

setDirtyInfo

isSavepointMode

isUse3dControls

setUse3dControls

getAlerts

getAttachedLibraries

oracle.forms.jdapi
Class FormModule