Type: Boolean

Specifies if you have permission to write to the table using any of the following RecordRef functions:

• INSERT Function (RecordRef)

• DELETE Function (RecordRef)

• MODIFY Function (RecordRef)

• DELETEALL Function (RecordRef)

true if you can write to some or all of the table; otherwise, false.

This function can test for both full write permission and a partial write permission that has been granted with a security filter. A write permission consists of Insert, Delete, and Modify permissions.

This function uses the filter that is currently applied to the RecordRef to determine whether you have write permission. If no filter is applied, the function tests for full write permission. If a filter has been set, the function only tests for write permission within the range of the filter.

To determine whether the user has partial write permission, because a security filter has been applied, use the SETPERMISSIONFILTER Function (RecordRef) before testing the permission with the WRITEPERMISSION function (RecordRef).

If you do not have permission to write to a table and you attempt to write, a run-time error occurs. This function lets you find out in advance if you have write permission. When the permissions are checked, the combination of permissions in the license file and the user's permissions in the Permission table is considered.

This function works the same as the WRITEPERMISSION Function (Record).

Reference