Clarion Community Help

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
| **Navigation:**  [[abc library reference.htm|ABC Library Reference]] > ViewManager > ViewManager Methods >====== GetFreeElementPosition (return free key element position) {{c6h0009.jpg|C6H0009.jpg}} ====== | [[getfreeelementname  return free key element name .htm|{{btn_prev_n.gif|Previous page}}]][[abc library reference.htm|{{btn_home_n.gif|Return to chapter overview}}]][[init  initialize the viewmanager object .htm|{{btn_next_n.gif|Next page}}]] |
|  ||

**GetFreeElementPosition, PROTECTED, VIRTUAL**

{{blk2blue.jpg|blk2blue.jpg}}

The **GetFreeElementPosition **method returns the position of the first sort field in the active sort order that is not limited to a single value by the applied range limit. For example, consider a VIEW sorted by Customer, Order, and Item, with the Customer field range limited to its current value. The free element is the Order field. But remove the range limit, and the free element is the Customer field.

The AddSortOrder method sets the key/sort order for the VIEW. The SetSort method sets the active sort order. The AddRange method adds range limits.

**Implementation:**

The BrowseClass.TakeKey method uses the GetFreeElementPosition method to reposition the VIEW based on the fixed key elements. The GetFreeElementName method uses the GetFreeElementPosition method to find the free element name.

**Return Data Type:     **BYTE

**Example:**

**BrowseClass.TakeKey PROCEDURE**

**!method code**

** IF SELF.Sort.Locator.TakeKey()**

**  Handled = 1**

**  SELF.Reset(SELF.GetFreeElementPosition())**

**  SELF.ResetQueue(Reset:Done)**

** ELSE**

**  SELF.ListControl{PROP:SelStart} = SELF.CurrentChoice**

** END**

**See Also:     **[[getfreeelementname  return free key element name .htm|GetFreeElementName]], [[takekey  process an alerted keystroke browseclass .htm|BrowseClass.TakeKey]]