M-Files UI Extensibility Framework
OnRenameObjectFile Event
M-Files UI Extensibility Framework > Events > OnRenameObjectFile Event
Triggered when a object file is renamed. This event occurs before the request is passed for M-Files Server.

objVer : IObjVer [ in ]

Identifies the target object version.


fileVer : IFileVer [ in ]

Identifies the file to rename.


newName : ITypedValue [ in, out ]

The new file name (file title), or null if the name (title) is not changed.

newExtension : ITypedValue [ in, out ]

The new file extension, or null if the extension is not changed.

Return Type

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


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:

objectVersion : IObjectVersion [ in ]

The object version updated in the operation.

objectFile : IObjectFile [ in ]

The updated object file.

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.


False to prevent the operation.


Prevents the operation.

Supported in M-Files 9.0.3372.6 and newer.
See Also