Application:get: Difference between revisions

From GiderosMobile
No edit summary
No edit summary
 
(6 intermediate revisions by the same user not shown)
Line 37: Line 37:
|openFileDialog||X||X||X||||X||||||||
|openFileDialog||X||X||X||||X||||||||
|-
|-
|pathfileexists||?||X||||||||||||X||
|pathfileexists||X||X||||||||||||X||
|-
|-
|saveFileDialog||X||X||X||||X||||||||
|saveFileDialog||X||X||X||||X||||||||
Line 113: Line 113:
-- get the user download folder path
-- get the user download folder path
print(application:get("directory", "download")) -- prints c:/Users/xxx/Downloads
print(application:get("directory", "download")) -- prints c:/Users/xxx/Downloads
-- save a RenderTarget
local sep = "\\" -- for Win32
if Qt then sep = "/" end -- for Qt
rt:save(application:get("directory", "pictures")..sep.."myimage.png")
</syntaxhighlight>
</syntaxhighlight>


Line 118: Line 123:
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
local path = application:get("openDirectoryDialog", "Title", "c:/tmp/") -- "title", "path"
local path = application:get("openDirectoryDialog", "Title", "c:/tmp/") -- "title", "path"
local path = application:get("openDirectoryDialog", "Title", "c:\\tmp\\") -- "title", "path" win32
local path = application:get("openDirectoryDialog", "Title", "c:\\tmp\\") -- "title", "path" Win32
print(path) -- on cancel, returns nil for win32 and "" for other systems
print(path) -- on cancel, returns nil for Win32 and "" for other systems
</syntaxhighlight>
</syntaxhighlight>


Line 125: Line 130:
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
local path = application:get("openFileDialog", "My Title", "c:\\", "Images (*.png *.jp*g);; 3D (*.obj *.fbx)")
local path = application:get("openFileDialog", "My Title", "c:\\", "Images (*.png *.jp*g);; 3D (*.obj *.fbx)")
print(path) -- on cancel, returns nil for win32 and "" for other systems
print(path) -- on cancel, returns nil for Win32 and "" for other systems


-- file dialogs on win32 should use a delay Timer.delayedCall or Core.asyncCall
-- file dialogs on Win32 should use a delay Timer.delayedCall or Core.asyncCall
self.tiled_ui.btnBrowse:addEventListener("clicked", function()
self.tiled_ui.btnBrowse:addEventListener("clicked", function()
Core.asyncCall(self.browse, self)
Core.asyncCall(self.browse, self)
Line 138: Line 143:
local path = application:get("saveFileDialog", "Title", "c:/tmp/", "Text (*.txt);; Image (*.jpg)") -- "title", "path", "extensions"
local path = application:get("saveFileDialog", "Title", "c:/tmp/", "Text (*.txt);; Image (*.jpg)") -- "title", "path", "extensions"
-- and we save some data to it
-- and we save some data to it
if path ~= "" then -- on cancel, returns nil for win32 and "" for other systems
if path ~= "" then -- on cancel, returns nil for Win32 and "" for other systems
local srcf = io.open("mytext.txt", "rb")
local srcf = io.open("mytext.txt", "rb")
local dstf = io.open(path, "wb")
local dstf = io.open(path, "wb")
Line 154: Line 159:
'''Path File Exists'''
'''Path File Exists'''
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
-- Path File Exists for Windows 64
-- Path File Exists for Windows Qt
-- tests folder path (nil=doesn't exist, 1=exists)
-- tests folder path (nil=doesn't exist, 1=exists)
if application:get("pathfileexists", application:get("directory", "pictures").."/Folder01") == nil then
if application:get("pathfileexists", application:get("directory", "pictures").."/Folder01") == nil then
application:set("mkDir", application:get("directory", "pictures"), "Folder01")
-- application:set("mkDir", application:get("directory", "pictures"), "Folder01") -- mkDir doesn't work for win Qt :-(
application:set("mkDir", application:get("directory", "pictures").."/Folder01", "subfolder01")
application:set("mkDir", application:get("directory", "pictures").."/Folder01", "subfolder02")
end
end


-- Path File Exists for win32
-- Path File Exists for Win32
-- tests folder path (nil=doesn't exist, 1=exists)
-- tests folder path (nil=doesn't exist, 1=exists)
if application:get("pathfileexists", application:get("directory", "pictures").."\\Folder01") == nil then
if application:get("pathfileexists", application:get("directory", "pictures").."\\Folder01") == nil then
Line 168: Line 171:
application:set("mkDir", application:get("directory", "pictures").."\\Folder01")
application:set("mkDir", application:get("directory", "pictures").."\\Folder01")
end
end
</syntaxhighlight>
'''Bonus'''
<syntaxhighlight lang="lua">
-- to open a directory
os.execute("start "..application:get("directory", "pictures"))
-- to open a sub directory
local sep = "\\" -- for Win32
--local sep = "/" -- for Qt
os.execute("start "..application:get("directory", "pictures")..sep.."myfolder")
</syntaxhighlight>
</syntaxhighlight>


{{Application}}
{{Application}}

Latest revision as of 08:35, 27 September 2026

Available since: Gideros 2015.7
Class: Application

Description

Returns the state of the desktop setting provided as string parameter.

varies = application:get(setting)

Parameters

setting (string) the name of the desktop setting

Return values

Returns (varies) the value(s) of the setting

Compatibility table

QT Win32 UWP Android Apple MacOS Apple iOS Apple tvOS Linux HTML
batteryLevel X X
clipboard X X X
commandLine X X X
currentUrl X
cursorPosition X X X
directory X X X
documentDirectory X X X
openDirectoryDialog X X X X
openFileDialog X X X X
pathfileexists X X X
saveFileDialog X X X X
screenSize X X X X X
temporaryDirectory X X X
windowPosition X X X
windowSize X X X
windowTitle X X X

Examples

Prints a list of all available settings

print(application:get("help"))
--[[
	Accepted value for Desktop's application:get()
	- [x,y] windowPosition
	- [w,h] windowSize
	- [w,h] screenSize
	- [x,y] cursorPosition
	- [text] clipboard
	- [text] windowTitle
	- [path] directory(where//help)
	- [path] openDirectoryDialog(title|path//help)
	- [path] openFileDialog(title|path|extensions//help)
	- [path] saveFileDialog(title|path|extensions//help)
	- [path] documentDirectory
	- [path] temporaryDirectory
	0
]]
print("\n")

print(application:get("directory", "help"))
--[[
	Accepted value for directory :
	- executable
	- document
	- desktop
	- temporary
	- data
	- music
	- movies
	- pictures
	- cache
	- download
	- home
	0
]]

Retrieves the whole command line

-- myapp.exe -param1 -param2
application:get("commandLine")

Various examples

print(application:get("windowTitle"))
print(application:get("documentDirectory"))
print(application:get("temporaryDirectory"))

-- get screen size
screenwidth, screenheight = application:get("screenSize") -- the actual user screen size!
myappleft, myapptop, myappright, myappbot = application:getLogicalBounds()
myappwidth, myappheight = myappright - myappleft, myappbot - myapptop
application:set("windowPosition", (screenwidth - myappwidth)/2, (screenheight - myappheight)/2) -- center the app
application:set("windowTitle", "MY TITLE")

-- get the user download folder path
print(application:get("directory", "download")) -- prints c:/Users/xxx/Downloads

-- save a RenderTarget
local sep = "\\" -- for Win32
if Qt then sep = "/" end -- for Qt
rt:save(application:get("directory", "pictures")..sep.."myimage.png")

File dialog open directory

local path = application:get("openDirectoryDialog", "Title", "c:/tmp/") -- "title", "path"
local path = application:get("openDirectoryDialog", "Title", "c:\\tmp\\") -- "title", "path" Win32
print(path) -- on cancel, returns nil for Win32 and "" for other systems

File dialog open file

local path = application:get("openFileDialog", "My Title", "c:\\", "Images (*.png *.jp*g);; 3D (*.obj *.fbx)")
print(path) -- on cancel, returns nil for Win32 and "" for other systems

-- file dialogs on Win32 should use a delay Timer.delayedCall or Core.asyncCall
self.tiled_ui.btnBrowse:addEventListener("clicked", function()
	Core.asyncCall(self.browse, self)
end)

File dialog save file

-- first we choose the destination
local path = application:get("saveFileDialog", "Title", "c:/tmp/", "Text (*.txt);; Image (*.jpg)") -- "title", "path", "extensions"
-- and we save some data to it
if path ~= "" then -- on cancel, returns nil for Win32 and "" for other systems
	local srcf = io.open("mytext.txt", "rb")
	local dstf = io.open(path, "wb")
	local size = 2^13 -- good buffer size (8K)
	while true do
		local block = srcf:read(size)
		if not block then break end
		dstf:write(block)
	end
	srcf:close()
	dstf:close()
end

Path File Exists

-- Path File Exists for Windows Qt
-- tests folder path (nil=doesn't exist, 1=exists)
if application:get("pathfileexists", application:get("directory", "pictures").."/Folder01") == nil then
--	application:set("mkDir", application:get("directory", "pictures"), "Folder01") -- mkDir doesn't work for win Qt :-(
end

-- Path File Exists for Win32
-- tests folder path (nil=doesn't exist, 1=exists)
if application:get("pathfileexists", application:get("directory", "pictures").."\\Folder01") == nil then
	-- create it
	application:set("mkDir", application:get("directory", "pictures").."\\Folder01")
end

Bonus

-- to open a directory
os.execute("start "..application:get("directory", "pictures"))
-- to open a sub directory
local sep = "\\" -- for Win32
--local sep = "/" -- for Qt
os.execute("start "..application:get("directory", "pictures")..sep.."myfolder")