GuiSetEnabled: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
(Undo revision 51816 by Thisdp (talk))
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>


===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 17:
==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
         if ( guiGetEnabled ( MyButton ) == true ) then -- check if the element is enabled           
function ChangeMyButtonEnabled ( )         
                 guiSetEnabled ( MyButton, false ) -- if it is, we disable it
         if ( DGS:dgsDxGUIGetEnabled ( MyButton ) == true ) then -- check if the element is enabled           
                 DGS:dgsDxGUISetEnabled ( MyButton, false ) -- if it is, we disable it
         else               
         else               
                 DGS:dgsDxGUISetEnabled ( MyButton, true ) -- if not, we make it enabled
                 guiSetEnabled ( MyButton, true ) -- if not, we make it enabled
         end
         end
end
end


MyGuiWindow = DGS:dgsDxCreateWindow(254,206,478,306,"Awesome dgs Window",false) -- Your dgs window
MyGuiWindow = guiCreateWindow(254,206,478,306,"Awesome Gui Window",false) -- 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>
MyButton = guiCreateButton(0.477,0.8268,0.1946,0.0784,"Hello World!",true,MyGuiWindow) -- Creates a button in your gui window</syntaxhighlight></section>


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

Revision as of 03:12, 9 August 2017

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 )

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 ( )        
        if ( guiGetEnabled ( MyButton ) == true ) then -- check if the element is enabled           
                guiSetEnabled ( MyButton, false ) -- if it is, we disable it
        else              
                guiSetEnabled ( MyButton, true ) -- if not, we make it enabled
        end
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

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