Added native.setProperty("mouseCursor", cursorName) Api

[DanS2D]

This Api allows the Solar developer to change the current operating system mouse cursor within their program on Desktop (Mac/Windows) to the cursor style of their choosing.

Shared cursors
The following cursors are available on both platforms:

• "crosshair",
• "pointingHand",
• "beam",
• "notAllowed",
• "resizeLeftRight",
• "resizeUpDown",
• "arrow"

Windows Cursors
The following cursors are available on Windows only:

• "appStarting",
• "resizeAll",
• "resizeNorthEastSouthWest",
• "resizeNorthWestSouthEast",
• "upArrow",
• "hourglass"

Mac Cursors
The following cursors are available on MacOS only:

• "closedHand",
• "openHand",
• "resizeRight",
• "resizeLeft",
• "resizeUp",
• "resizeDown",
• "disappearingItem",
• "beamHorizontal",
• "dragLink",
• "dragCopy",
• "contextMenu"

Documentation

I will be submitting a pull request with an updated native.setProperty() Api doc once this pull request has been approved, incase there are any changes to cursor names etc.

Test code:

local currentCursor = 0
local cursors = {
	"crosshair",
	"pointingHand",
	"beam",
	"notAllowed",
	"resizeLeftRight",
	"resizeUpDown",
	"arrow"
}
local windowsCursors = {
	"appStarting",
	"resizeAll",
	"resizeNorthEastSouthWest",
	"resizeNorthWestSouthEast",
	"upArrow",
	"hourglass"
}
local macCursors = {
	"closedHand", 
	"openHand",
	"resizeRight", 
	"resizeLeft",
	"resizeUp", 
	"resizeDown",
	"disappearingItem", 
	"beamHorizontal", 
	"dragLink", 
	"dragCopy", 
	"contextMenu",
}
local isWindows = system.getInfo("platform") == "win32"

if (isWindows) then
	for i = #windowsCursors, 1, -1 do
		table.insert(cursors, 1, windowsCursors[i])
	end
else
	for i = #macCursors, 1, -1 do
		table.insert(cursors, 1, macCursors[i])
	end
end

local cursorText =
	display.newText(
	{
		text = "",
		fontSize = 24
	}
)
cursorText.x = display.contentCenterX
cursorText.y = display.contentCenterY

local function changeCursor(event)
	currentCursor = currentCursor + 1

	if (currentCursor > #cursors) then
		timer.cancel(event.source)
		return
	end

	cursorText.text = cursors[currentCursor]
	native.setProperty("mouseCursor", cursors[currentCursor])
end

timer.performWithDelay(800, changeCursor, 0)

[CLAassistant]

All committers have signed the CLA.