Category: Objects / Search
Since engine version: 1.0 OC
Search criterion: Finds all objects which have the layer set to the given value.
array Find_Layer(object layer);
- The layer that has to be set for objects to be found.
Starting from OC 7.0, all find and count functions in object context include an implicit Find_Layer(GetObjectLayer()). This search criterion can be used to override this setting and search for objects in an explicit layer instead. Using this criterion in a search function disables the implicit layer check.
If layer is nil, only objects without a specific layer are found. To find all objects regardless of layer, use Find_AnyLayer().
For additional information on the use of this function see FindObjects.