GuiSetEnabled: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
(Sheva's code is shorter and should work)
 
(7 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Client function}}
{{Client function}}
__NOTOC__
__NOTOC__
This function enables/disables a DGS element. A disabled DGS element can't be used, gets a gray aspect and doesn't receive any events.
This function enables/disables a GUI element. A disabled GUI element can't be used, gets a gray aspect and doesn't receive any events.


==Syntax==
==Syntax==
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool dgsDxGUISetEnabled ( element dgsElement, bool enabled )
bool guiSetEnabled ( element guiElement, bool enabled )
</syntaxhighlight>
</syntaxhighlight>
{{OOP||[[GUI widgets|GuiElement]]:setEnabled|enabled|guiGetEnabled}}


===Required Arguments===
===Required Arguments===
*'''dgsElement:''' the DGS element you wish to enable or disable
*'''guiElement:''' the GUI element you wish to enable or disable
*'''enabled:''' the new state
*'''enabled:''' the new state


Line 17: Line 18:
==Example==
==Example==
<section name="Client" class="client" show="true">
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">function ChangeMyButtonEnabled ( )         
DGS = exports.dgs
    guiSetEnabled ( MyButton, not guiGetEnabled ( MyButton ) ) -- enable button if disabled. Disable if enabled
function ChangeMyButtonEnabled ( )         
        if ( DGS:dgsDxGUIGetEnabled ( MyButton ) == true ) then -- check if the element is enabled         
                DGS:dgsDxGUISetEnabled ( MyButton, false ) -- if it is, we disable it
        else             
                DGS:dgsDxGUISetEnabled ( MyButton, true ) -- if not, we make it enabled
        end
end
end
 
MyGuiWindow = guiCreateWindow(254,206,478,306,"Awesome Gui Window",false) -- Your gui window
MyGuiWindow = DGS:dgsDxCreateWindow(254,206,478,306,"Awesome dgs Window",false) -- Your dgs window
MyButton = guiCreateButton(0.477,0.8268,0.1946,0.0784,"Hello World!",true,MyGuiWindow) -- Creates a button in your gui window
MyButton = DGS:dgsDxCreateButton(0.477,0.8268,0.1946,0.0784,"Hello World!",true,MyGuiWindow) -- Creates a button in your dgs window</syntaxhighlight></section>
ChangeMyButtonEnabled ( ) -- Execute function </syntaxhighlight></section>


==See Also==
==See Also==
{{DGSFUNCTIONS}}
{{GUI functions}}
{{GUI_events}}

Latest revision as of 13:49, 14 May 2019

This function enables/disables a GUI element. A disabled GUI element can't be used, gets a gray aspect and doesn't receive any events.

Syntax

bool guiSetEnabled ( element guiElement, bool enabled )

OOP Syntax Help! I don't understand this!

Method: GuiElement:setEnabled(...)
Variable: .enabled
Counterpart: guiGetEnabled


Required Arguments

  • guiElement: the GUI element you wish to enable or disable
  • enabled: the new state

Returns

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

Example

Click to collapse [-]
Client
function ChangeMyButtonEnabled ( )        
    guiSetEnabled ( MyButton, not guiGetEnabled ( MyButton ) ) -- enable button if disabled. Disable if enabled
end
MyGuiWindow = guiCreateWindow(254,206,478,306,"Awesome Gui Window",false) -- Your gui window
MyButton = guiCreateButton(0.477,0.8268,0.1946,0.0784,"Hello World!",true,MyGuiWindow) -- Creates a button in your gui window
ChangeMyButtonEnabled ( ) -- Execute function

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

Input

GUI


Retrieved from "https://wiki.multitheftauto.com/wiki/GuiSetEnabled?oldid=62662"