M-Files UI Extensibility Framework
OnSetPropertiesOfObjectVersions Event
M-Files UI Extensibility Framework > Events > OnSetPropertiesOfObjectVersions Event
Description
Triggered when a property change of one or more object versions is requested. This event occurs before the request is passed for M-Files Server.
https://developer.m-files.com/APIs/COM-API/Reference/
Parameters

setPropertiesParamsOfMultipleObjects : ISetPropertiesParamsOfMultipleObjects [ in, out ]

Specifies the target object versions and the changes in properties. Note: the callee must not change the target object versions.

singlePropertyUpdate : Boolean [ in ]

If true, a single property value update is requested. A single value must be specified in PropertyValuesToSet collections. The callee must not specify different change set.

singlePropertyRemove : Boolean [ in ]

If true, a single property value remove is requested. A single value must be specified in PropertyValuesToRemove collections. The callee must not specify different change set.

Return Type

The return type can be one of the types as follows:

Object

Callback object to be activated after the operation. Callback methods:

OnSuccess Method [ optional ]

Called when the operation is successfully performed. The call receives parameters as follows:

objectVersions : IObjectVersions [ in ]

The updated object versions created in the operation.

OnError Method [ optional ]

Called when the operation failed. The call receives parameters as follows:

errorCode : Long [ in ]

The error code (HRESULT).

errorMessage : String [ in ]

The error message.

errorStack : String [ in ]

The call stack that identifies the error source in the program code.

Finally Method [ optional ]

Called after the operation was performed regardless of the operation success or failure.

Boolean

False to prevent the operation.

Null

Prevents the operation.

Remarks

The OnSetPropertiesOfObjectVersion Event is triggered for each individual object, too.

Supported in M-Files 9.0.3372.6 and newer.

See Also