findDrawings

From RPTools Wiki
Revision as of 23:59, 9 February 2023 by Conversion script (talk | contribs) (Conversion script moved page FindDrawings to findDrawings: Converting page titles to lowercase)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

findDrawings() Function

 Note: This function can only be used in a Trusted Macro

• Introduced in version 1.5.0
Returns the id or ids of any drawing on the specified map that matches the name parameter.

Usage

findDrawings(mapRef, name)
findDrawings(mapRef, name, delim)

Parameters

  • mapRef - The Name or ID of the map.
  • name - A string containing name of the searched for drawings. Pass "*" to get all drawings. Drawings can be named via the Draw Explorer interface or using setDrawingName().
  • delim - Optional separator. If not specified, the default value "," is used. If "json" is specified, a JSON array is returned instead of a String List.

Example

[h:id=findDrawings("Grasslands", "block")]
[h:setFillColor("Grasslands", id,"#000000")]
[h:refreshDrawing("Grasslands", id)]

See Also

setFillColor() refreshDrawing() setDrawingName()

Version Changes

  • 1.10.0 - Added wildcard option for drawing name.
Retrieved from "https://wiki.rptools.info/index.php?title=findDrawings&oldid=34930"