This article is about the mark() function of the Rows object.
Rows.mark()
1.Checks if the first record in the Rows object is marked or not.
2.Changes the mark value of one or more records.
Returns the mark value of the first row object in the Rows object if checking (no. 1). Returns the ‘this’ object if marking (no. 2).
Syntax
rows.mark( value )
- Omit value if you want to check if the first record in the Rows object is marked or not (Example 1).
- Specify value if you want to change the mark value of one or more records (Example 2).
If specified, value is either a boolean or the string ‘toggle’ and has the following data type and meaning:
Value | Data type | Meaning |
---|---|---|
true | boolean | Marks all records in scope |
false | boolean | Unmarks all records in scope |
toggle | string | Toggles the mark value of all records in scope |
Example 1
This example assigns the mark value (true or false) of the current record to the mark variable:
var mark = $.udb('EMP').rows('current').mark();
Example 2
These examples change the mark value of one or more records:
$.udb('EMP').rows().mark(true); // Mark all queried records
$.udb('EMP').rows(5).mark(false); // Unmark the 6th record