GuiSetProperty: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
Line 16: Line 16:
If the function succeeds it returns ''true'', if it fails it returns ''false''.
If the function succeeds it returns ''true'', if it fails it returns ''false''.


==Example==
==Examples==
This example creates a button when the resource starts and defines a console command that toggles it between enabled (clickable) and disabled (not clickable).
This example creates a button when the resource starts and defines a console command that toggles it between enabled (clickable) and disabled (not clickable).
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
Line 34: Line 34:
end
end
addCommandHandler( "togglebtn", toogleButton )
addCommandHandler( "togglebtn", toogleButton )
</syntaxhighlight>
This example creates a button when the resource starts and defines its normal color to red and hover color to yellow.
<syntaxhighlight lang="lua">
function onStart()
  button = guiCreateButton (20, 200, 150, 30, "Test", false)
  guiSetProperty (button, "NormalTextColour", "FFFF0000") -- Color format: AARRGGBB
  guiSetProperty (button, "HoverTextColour", "FFFFFF00")
end
addEventHandler ("onClientResourceStart", getResourceRootElement(), onStart)
</syntaxhighlight>
</syntaxhighlight>


==See Also==
==See Also==
{{GUI functions}}
{{GUI functions}}

Revision as of 15:15, 19 May 2018

This function sets the value of a specific CEGUI property of a GUI element. For a list of properties and their meaning, see the CEGUI properties page.

Syntax

bool guiSetProperty ( element guiElement, string property, string value )

Required Arguments

  • guiElement: the GUI element you wish to get a property of.
  • property: the name of of property you want the value of.
  • value: the new value for the property.

Returns

If the function succeeds it returns true, if it fails it returns false.

Examples

This example creates a button when the resource starts and defines a console command that toggles it between enabled (clickable) and disabled (not clickable).


function onStart()
  button = guiCreateButton( 20, 200, 150, 30, "Test", false )
end
addEventHandler( "onClientResourceStart", getResourceRootElement(), onStart )

function toogleButton()
  local currentState = guiGetProperty( button, "Disabled" )
  if currentState == "False" then
    guiSetProperty( button, "Disabled", "True" )
  else
    guiSetProperty( button, "Disabled", "False" )
  end
end
addCommandHandler( "togglebtn", toogleButton )

This example creates a button when the resource starts and defines its normal color to red and hover color to yellow.

function onStart()
  button = guiCreateButton (20, 200, 150, 30, "Test", false)
  guiSetProperty (button, "NormalTextColour", "FFFF0000") -- Color format: AARRGGBB
  guiSetProperty (button, "HoverTextColour", "FFFFFF00")
end
addEventHandler ("onClientResourceStart", getResourceRootElement(), onStart)

See Also

General functions

Browsers

Buttons

Checkboxes

Comboboxes

Edit Boxes

Gridlists

Memos

Progressbars

Radio Buttons

Scrollbars

Scrollpanes

Static Images

Tab Panels

Tabs

Text Labels

Windows