Topics   All   Mac OS X (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server (Not)   Client   Old   Guides   Examples
New in version: 6.2   6.3   6.4   6.5   7.0   7.1   7.2   7.3   7.4   7.5    Statistic  

Events.Event.Refresh

Refreshes an event object to ensure it's still valid.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
Events 6.2 Yes No Yes, macOS only No No

MBS( "Events.Event.Refresh"; EKEvent )

Parameters

Parameter Description Example value
EKEvent The reference to the event. $event

Result

Returns 1, 0 or error.

Description

Refreshes an event object to ensure it's still valid.
When the database changes, your application is sent an notification note and the plugin may trigger the notification script. You should generally consider all event instances to be invalid as soon as you receive the notification. However, for events you truly care to keep around, you can call this method. It ensures the record is still valid by ensuring the event and start date are still valid. It also attempts to refresh all properties except those you might have modified. If this method returns 0, the record has been deleted or is otherwise invalid. You should not continue to use it. If it returns 1, all is still well, and the record is ready for continued use. You should only call this method on events that are more critical to keep around if possible, such as an event that is being actively edited, as this call is fairly heavyweight. Do not use it to refresh the entire selected range of events you might have had selected. It is mostly pointless anyway, as recurrence information may have changed.

See also


Events.Event.OccurrenceDate   -   Events.Event.SetAllDay

Feedback: Report problem or ask question.




Links
MBS Xojo PDF Plugins