SetBrowserRenderingPaused: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
m (Link to the Romanian translation of this page added.)
(Added warning about flaky browser behaviour on PC with low ram, when using setBrowserRenderingPaused)
Line 4: Line 4:
This function sets the rendering state of a browser.
This function sets the rendering state of a browser.
}}
}}
{{MessageBox|bordercolorhex=FFB2B2|bgcolorhex=FFE5E5|image=File:Dialog-warning.png|title=Warning:|message=May cause issues with browser rendering on PC with low Ram [https://github.com/multitheftauto/mtasa-blue/issues/1567 #1567]. It's might be better to completely release browser, instead of pausing it, when its not needed.}}


==Syntax==
==Syntax==

Revision as of 20:45, 19 October 2020

This function sets the rendering state of a browser.

Dialog-warning.png Warning: May cause issues with browser rendering on PC with low Ram #1567. It's might be better to completely release browser, instead of pausing it, when its not needed.

Syntax

bool setBrowserRenderingPaused ( browser webBrowser, bool paused )

OOP Syntax Help! I don't understand this!

Note: As of MTA: SA 1.6 the counterpart is not implemented yet.
Method: browser:setRenderingPaused(...)
Variable: .renderingPaused
Counterpart: isBrowserRenderingPaused


Required Arguments

  • webBrowser: The browser
  • paused: true to pause rendering, false to continue

Returns

Returns true if the state was successfully changed

Example

--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 remote mode.
local window = guiCreateWindow(0, 0, screenWidth, screenHeight, "Webbrowser", false)
local browser = guiCreateBrowser(0, 0, 800, 600, false, false, false, window)
 
-- 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
local theBrowser = guiGetBrowser(browser) -- Get the browser element from gui-browser
addEventHandler("onClientBrowserCreated", theBrowser, 
	function()
		-- After the browser has been initialized, we can load www.youtube.com
		loadBrowserURL(source, "http://www.youtube.com")
	end
)


addCommandHandler ("pause", -- Add command named 'pause'
  function (player, command, value)
    if (value) then -- checking for a value
      setBrowserRenderingPaused (theBrowser, value) 
    else -- if there is no value
      outputChatBox ("You must enter a value.", player)
    end
  end
)

See also

Retrieved from "https://wiki.multitheftauto.com/wiki/SetBrowserRenderingPaused?oldid=67566"