Xbasic

OBJECT_OPERATION Function

Syntax

C object_operation(C object_type ,C object_name [,C new_name [,C action [,C target_dict ]]])

Arguments

object_typeCharacter

The class of operation to act upon. The options are:

  • "append"
  • "bitmap"
  • "browse"
  • "copy"
  • "export"
  • "form"
  • "import"
  • "join"
  • "label"
  • "letter"
  • "mark"
  • "menu"
  • "post"
  • "query"
  • "report"
  • "summarize"
  • "toolbar"
  • "update"
  • "xtab"
  • "script"
  • "function"
object_nameCharacter

The name of the saved operation to process.

new_nameCharacter

Default = "". The name to use when using an Action that requires a second name.

actionCharacter

Default = "rename". Action to perform. The options are:

"rename"

Renames the object

"delete"

Delete the object

"clone"

Make a copy of the object in the same dictionary under a new name

"move"

Copy the object to a different dictionary and delete from current

"copyto"

Copy the object to a different dictionary

"export"

Copy the object to a different dictionary - it dictionary does not exists, create it.

target_dictCharacter

Default = "". The target dictionary.

Returns

ResultCharacter

Returns a blank string.

Description

Renames an object in the control panel.

Discussion

Performs different types of processes against saved operations. The OBJECT_OPERATION() function supports a large number of processes against saved operation. Not all combinations are supported. Displays a message box if an error occurs.

Example

Here is how you would delete an export operation called exportOperationName.

object_operation("export","exportOperationName","","delete")

See Also