Multi Theft Auto: Wiki - User contributions [en]

LoadBrowserURL

2019-01-20T17:50:23Z

DieselTV:

__NOTOC__
{{Client function}}
{{New feature/item|3.0150|1.5||
This function loads the specified URL.
{{Note|You Must Use [[requestBrowserDomains]] to load the page on the specific browser. -- Made By: Mohamed Hussein}}

}}

==Syntax==
<syntaxhighlight lang="lua">bool loadBrowserURL ( browser webBrowser, string url [, string postData = "", bool urlEncoded = true ] )</syntaxhighlight>
{{OOP||[[Element/Browser|browser]]:loadURL|url|getBrowserURL}}

===Required arguments===
*'''webBrowser:''' The [[Element/Browser|browser]] element which will load the URL
*'''url:''' The url you want to load. It can either contain a remote website ("http://" prefix) or a website stored within a local resource ("http://mta/local/gui.html" for example, see [[Local_Scheme_Handler|Local Scheme Handler]] for details).
*'''postData:''' The post data passed to the website. Its content type can be any type (e.g. JSON) if urlEncoded is set to ''false''
*'''urlEncoded:''' If set to ''true'', it will be available f.e. in PHP's $_POST variable (the content type is: ''application/x-www-form-urlencoded'')

===Returns===
Returns ''true'' if the URL was successfully loaded.

==Example==
<syntaxhighlight lang="lua">
-- In order to render the browser on the full screen, we need to know the dimensions.
local screenWidth, screenHeight = guiGetScreenSize()

-- Let's create a new browser in local mode. We will not be able to load an external URL.
local webBrowser = createBrowser(screenWidth, screenHeight, false, false)

-- This is the function to render the browser.
function webBrowserRender()
-- Render the browser on the full size of the screen.
dxDrawImage(0, 0, screenWidth, screenHeight, webBrowser, 0, 0, 0, tocolor(255,255,255,255), true)
end

-- The event onClientBrowserCreated will be triggered, after the browser has been initialized.
-- After this event has been triggered, we will be able to load our URL and start drawing.
addEventHandler("onClientBrowserCreated", webBrowser,
function()
-- After the browser has been initialized, we can load our website.
loadBrowserURL(webBrowser, "https://www.youtube.com/")

-- Now we can start to render the browser.
addEventHandler("onClientRender", root, webBrowserRender)
end
)
</syntaxhighlight>

==See also==
{{CEF_functions}}

[[hu:loadBrowserURL]]

LoadBrowserURL

2019-01-20T17:49:57Z

DieselTV:

__NOTOC__
{{Client function}}
{{New feature/item|3.0150|1.5||
This function loads the specified URL.
{{Note|You Must Use [[requestBrowserDomains]] to load the page on the specific browser}}

}}

==Syntax==
<syntaxhighlight lang="lua">bool loadBrowserURL ( browser webBrowser, string url [, string postData = "", bool urlEncoded = true ] )</syntaxhighlight>
{{OOP||[[Element/Browser|browser]]:loadURL|url|getBrowserURL}}

===Required arguments===
*'''webBrowser:''' The [[Element/Browser|browser]] element which will load the URL
*'''url:''' The url you want to load. It can either contain a remote website ("http://" prefix) or a website stored within a local resource ("http://mta/local/gui.html" for example, see [[Local_Scheme_Handler|Local Scheme Handler]] for details).
*'''postData:''' The post data passed to the website. Its content type can be any type (e.g. JSON) if urlEncoded is set to ''false''
*'''urlEncoded:''' If set to ''true'', it will be available f.e. in PHP's $_POST variable (the content type is: ''application/x-www-form-urlencoded'')

===Returns===
Returns ''true'' if the URL was successfully loaded.

==Example==
<syntaxhighlight lang="lua">
-- In order to render the browser on the full screen, we need to know the dimensions.
local screenWidth, screenHeight = guiGetScreenSize()

-- Let's create a new browser in local mode. We will not be able to load an external URL.
local webBrowser = createBrowser(screenWidth, screenHeight, false, false)

-- This is the function to render the browser.
function webBrowserRender()
-- Render the browser on the full size of the screen.
dxDrawImage(0, 0, screenWidth, screenHeight, webBrowser, 0, 0, 0, tocolor(255,255,255,255), true)
end

-- The event onClientBrowserCreated will be triggered, after the browser has been initialized.
-- After this event has been triggered, we will be able to load our URL and start drawing.
addEventHandler("onClientBrowserCreated", webBrowser,
function()
-- After the browser has been initialized, we can load our website.
loadBrowserURL(webBrowser, "https://www.youtube.com/")

-- Now we can start to render the browser.
addEventHandler("onClientRender", root, webBrowserRender)
end
)
</syntaxhighlight>

==See also==
{{CEF_functions}}

[[hu:loadBrowserURL]]

RequestBrowserDomains

2019-01-20T17:48:42Z

DieselTV:

__NOTOC__
{{Client function}}
{{New feature/item|3.0150|1.5||
This function opens a request window in order to accept the requested remote URLs.
{{Note|Using [[loadBrowserURL]] without using requestBrowserDomains so the links may not work. -- made by Mohamed Hussein}}
}}

==Syntax==
<syntaxhighlight lang="lua">bool requestBrowserDomains ( table pages [, bool parseAsURL = false, function callback ] )</syntaxhighlight>
{{OOP||[[Element/Browser|Browser]].requestDomains}}

===Required Arguments===
*'''pages:''' A table containing all domains

===Optional Arguments===
*'''parseAsURL:''' ''true'' if the passed addresses should be converted from URLs, ''false'' otherwise.
*'''callback:''' A callback function that is called as soon as the result is available
Syntax:
<syntaxhighlight lang="lua">function(bool wasAccapted, table new_domains)</syntaxhighlight>

===Returns===
Returns '''true''', if the string was successfully read, '''false''' otherwise.

==Example==
<syntaxhighlight lang="lua">requestBrowserDomains({ "mtasa.com" }) -- request browser domain
showCursor(true) -- show cursor
addEventHandler("onClientBrowserWhitelistChange", root,
function(newDomains)
if newDomains[1] == "mtasa.com" then
local browser = createBrowser(1280, 720, false, false) -- create browser
loadBrowserURL(browser, "http://mtasa.com/") -- load browser url
end
end
)
</syntaxhighlight>

==See also==
{{CEF_functions}}

[[hu:requestBrowserDomains]]

RequestBrowserDomains

2019-01-20T17:48:00Z

DieselTV:

__NOTOC__
{{Client function}}
{{New feature/item|3.0150|1.5||
This function opens a request window in order to accept the requested remote URLs.
{{Note|Using [[loadBrowserURL]] without using requestBrowserDomains so the links may not work.}}
}}

==Syntax==
<syntaxhighlight lang="lua">bool requestBrowserDomains ( table pages [, bool parseAsURL = false, function callback ] )</syntaxhighlight>
{{OOP||[[Element/Browser|Browser]].requestDomains}}

===Required Arguments===
*'''pages:''' A table containing all domains

===Optional Arguments===
*'''parseAsURL:''' ''true'' if the passed addresses should be converted from URLs, ''false'' otherwise.
*'''callback:''' A callback function that is called as soon as the result is available
Syntax:
<syntaxhighlight lang="lua">function(bool wasAccapted, table new_domains)</syntaxhighlight>

===Returns===
Returns '''true''', if the string was successfully read, '''false''' otherwise.

==Example==
<syntaxhighlight lang="lua">requestBrowserDomains({ "mtasa.com" }) -- request browser domain
showCursor(true) -- show cursor
addEventHandler("onClientBrowserWhitelistChange", root,
function(newDomains)
if newDomains[1] == "mtasa.com" then
local browser = createBrowser(1280, 720, false, false) -- create browser
loadBrowserURL(browser, "http://mtasa.com/") -- load browser url
end
end
)
</syntaxhighlight>

==See also==
{{CEF_functions}}

[[hu:requestBrowserDomains]]