This section describes the functions of the Oracle Forms Open API Object (generic object).
d2fobfo_FindObj( d2fctx *pd2fctx, d2fob *owner, text *name, d2fotyp objtyp, d2fob **ppd2fob );
This function returns the specified object. You specify a pointer to the context in pd2fctx, a pointer to the object’s parent in parent, a pointer to a text string for the name of the specified object in name, the object type in objtyp, and a handle for the function to return the object in ppd2fob.
For example, if you want to find a particular trigger object under a block, you need to pass in the block as the parent, the name of the specific trigger object, and D2FFO_TRIGGER (the object type).
d2fobmv_Move( d2fctx *pd2fctx, d2fob *pd2fob, d2fob *pd2fob_nxt );
This function moves the specified object around the list of objects. You specify a pointer to the context in pd2fctx, a pointer to the object in pd2fob, and the object that should directly follow this object (once moved) in pd2fob_nxt.
Note that if you want to place the specified object at the top of the list, pass the first object in pd2fob_nxt; if you want to place the object at the end of the list, set pd2fob_nxt to NULL.
d2fobgb_GetBoolProp( d2fctx *pd2fctx, d2fob *pd2fob, ub2 pnum, boolean *pprp );
This function retrieves a property of type boolean for the specified object (generic object). You specify a pointer to the context in pd2fctx, the object in pd2fob, the property number in pnum, and a pointer to pprp, to store the boolean value.
This function returns D2FS_SUCCESS if it stores the value of the boolean property in pprp.
d2fobgn_GetNumProp( d2fctx *pd2fctx, d2fob *pd2fob, ub2 pnum, number *pprp );
This function retrieves a property of type number (an actual scalar constant) for the specified object. You specify a pointer to the context in pd2fctx, the object in pd2fob, the property number in pnum, and a pointer to pprp, to store the numeric value.
This function returns D2FS_SUCCESS if it stores the value of the number property in pprp.
d2fobgt_GetTextProp( d2fctx *pd2fctx, d2fob *pd2fob, ub2 pnum, text **pprp );
This function retrieves a property of type text for the specified object. You specify a pointer to the context in pd2fctx, the object in pd2fob, the property number in pnum, and a handle to an array of characters in pprp for the function to store the text property value.
This function returns D2FS_SUCCESS if it fills the supplied array with a copy of the text property value for the specified object in pprp.
Note that the client is responsible for freeing the text returned by this function.
d2fobgo_GetObjectProp( d2fctx *pd2fctx, d2fob *pd2fob, ub2 pnum, dvoid **pprp );
This function retrieves a property of type object of the specified object. You specify a pointer to the context in pd2fctx, the object in pd2fob, a property number in pnum, and a handle to pprp, for the function to store the object property value.
This function returns D2FS_SUCCESS if it stores a handle to the desired object property in pprp.
d2fobgp_GetBlobProp( d2fctx *pd2fctx, d2fob *pd2fob, ub2 pnum, dvoid **pprp );
This function retrieves the value from the client-specified handle. You specify a pointer to the context in pd2fctx, a pointer to the specified object in pd2fob, a property number in pnum, and a handle to pprp, for the function to provide access to the client-specified value.
This function returns D2FS_SUCCESS if it stores a handle to the desired client-specified property in pprp.
d2fobsb_SetBoolProp( d2fctx *pd2fctx, d2fob *pd2fob, ub2 pnum, boolean prp );
This function sets the value of the specified object boolean property. You specify a pointer to the context in pd2fctx, the object in pd2fob, the property number in pnum, and the boolean value in prp.
This function returns D2FS_SUCCESS if it sets the boolean property with the value you specify in prp.
d2fobsn_SetNumProp( d2fctx *pd2fctx, d2fob *pd2fob, ub2 pnum, number prp );
This function sets the value of the specified object number property. You specify a pointer to the context in pd2fctx, the object in pd2fob, the property number in pnum, and the number value in prp.
This function returns D2FS_SUCCESS if it sets the number property with the value you specify in prp.
d2fobst_SetTextProp( d2fctx *pd2fctx, d2fob *pd2fob, ub2 pnum, text *prp );
This function sets the value of the specified object text property. You specify a pointer to the context in pd2fctx, the object in pd2fob, the property number in pnum, and a handle to the text value in prp.
This function returns D2FS_SUCCESS if it sets the specified text property with the value stored in prp.
d2fobso_SetObjectProp( d2fctx *pd2fctx, d2fob *pd2fob, ub2 pnum, dvoid *prp );
This function sets the object of the specified object property. You specify a pointer to the context in pd2fctx, the object in pd2fob, a property number in pnum, and a handle to the object property in prp.
This function returns D2FS_SUCCESS if it sets the specified object property with the value stored in prp.
d2fobsp_SetBlobProp( d2fctx *pd2fctx, d2fob *pd2fob, ub2 pnum, dvoid *prp );
This function sets the client-specified handle. You specify a pointer to the context in pd2fctx, a pointer to the specified object in pd2fob, a property number in pnum, and a pointer to the client-specified value in prp.
This function returns D2FS_SUCCESS if it sets the client-specified handle with the value stored in prp.
d2fobhp_HasProp( d2fctx *pd2fctx, d2fob *pd2fob, ub2 pnum );
This function queries the specified object for the specified property. You specify a pointer to the context in pd2fctx, the object in pd2fob, and a property number in pnum.
If the function succeeds, it returns D2FS_YES or D2FS_NO, depending on whether the object has the specified property; otherwise, the function can return a number of possible return values, depending on the circumstances. For a complete list of the valid Open Forms API return values, refer to the "About Open API function return codes" section.
d2fobip_InheritProp( d2fctx *pd2fctx, d2fob *pd2fob, ub2 pnum );
This function enables the specified object to inherit the specified property. You specify a pointer to the context in pd2fctx, a pointer to the object in pd2fob, and the property number in pnum.
If the function succeeds, it returns D2FS_YES or D2FS_NO, depending on whether the object has been modified to inherit the specified property; otherwise, the function can return a number of possible return values, depending on the specific circumstances. For a complete list of the valid Open Forms API return values, refer to the "About Open API function return codes" section.
d2fobii_IspropInherited( d2fctx *pd2fctx, d2fob *pd2fob, ub2 pnum );
This function verifies that the specified object’s property is inherited, as is, from its parent object. You specify a pointer to the context in pd2fctx, a pointer to the object in pd2fob, and the property number in pnum.
If the function succeeds, it returns D2FS_YES or D2FS_NO, depending on whether the property is inherited from the specified object’s parent; otherwise, the function can return a number of possible return values, depending on the specific circumstances. For a complete list of the valid Open Forms API return values, refer to the "About Open API function return codes" section.
d2fobsc_SubClass( d2fctx *pd2fctx, d2fob *pd2fob, d2fob *parent, boolean keep_path);
This function returns D2FS_SUCCESS if the specified object (pd2fob) becomes a subclass of the specified parent (parent). You specify a pointer to the context in pd2fctx, a pointer to the object in pd2fob, a pointer to the parent object in parent, and a boolean flag to save the path to the parent object in keep_path.
Note that the Forms API uses the boolean keep_path argument to save the actual path information. It is recommended that you do not set keep_path to TRUE since this information may be lost if you move to another machine. If keep_path is set to TRUE, the Forms API saves the actual path in the .fmb file. Therefore, the next time the form is loaded, depending on how the environment variable Forms 4.5 or 5.0 path is defined, the Forms API searches for the parent form in one of the specified directories defined by the environment variable.
d2fobis_IsSubclassed ( d2fctx *pd2fctx, d2fob *pd2fob );
This function verifies that the specified object is a subclass of another object. You specify a pointer to the context in pd2fctx and a pointer to the specified object in pd2fob.
If the function succeeds, it returns D2FS_YES or D2FS_NO, depending on whether the specified object is a subclass of another object; otherwise, the function can return a number of possible return values, depending on the specific circumstances. For a complete list of the valid Open Forms API return values, refer to the "About Open API function return codes" section.
d2fobqt_QueryType( d2fctx *pd2fctx, d2fob *pd2fob, d2fotyp *objtyp );
This function returns D2FS_SUCCESS if the specified object type exists and stores the object in pd2fob. You specify a pointer to the context in pd2fctx, a pointer for the returned object (pd2fob), and a pointer for the specified object type (objtyp).
This function is particularly useful if you have a traversal function that traverses all of your objects in a Form. By using this function, you are able to gain access to all of the actual objects in your form.
Creating modules using the Open API
Modifying modules using the Open API
Object (generic object) macros