IsVehicleLocked: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
(5 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Server client function}}
__NOTOC__
__NOTOC__
This will tell you if a vehicle is locked.
This will tell you if a vehicle is locked.
Line 4: Line 5:
==Syntax==
==Syntax==
<syntaxhighlight lang="lua">bool isVehicleLocked ( vehicle theVehicle )</syntaxhighlight>
<syntaxhighlight lang="lua">bool isVehicleLocked ( vehicle theVehicle )</syntaxhighlight>
{{OOP||[[vehicle]]:isLocked|locked|setVehicleLocked}}


===Required Arguments===
===Required Arguments===
*'''theVehicle''': The [[vehicle]] that you need to obtain the locked status of.
*'''theVehicle:''' The [[vehicle]] that you want to obtain the locked status of.


===Returns===
===Returns===
Line 12: Line 15:


==Example==
==Example==
This example creates a vehicle then displays if it is locked or not in the chatbox (vehicles are created unlocked).
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">newcar = createVehicle ( 520, 1024, 1024, 1024 )
This example allows a player to lock his vehicle when he is inside it.
if isVehicleLocked ( newcar )
<syntaxhighlight lang="lua">
  outputChatBox ( "Vehicle is locked." )
function lockcar ( thePlayer )
else
    playervehicle = getPlayerOccupiedVehicle ( thePlayer )   -- define 'playervehicle' as the vehicle the player is in
  outputChatBox ( "Vehicle is unlocked." )
    if ( playervehicle ) then                                -- if a player is in a vehicle
end</syntaxhighlight>
        if isVehicleLocked ( playervehicle ) then            -- and if the vehicle is already locked
            setVehicleLocked ( playervehicle, false )       -- unlock it
        else                                                 -- otherwise (if it isn't locked)
            setVehicleLocked ( playervehicle, true )        -- lock it
        end
    end
end
 
function bindLockOnSpawn ( theSpawnpoint )                    -- when a player spawns
    bindKey ( source, "l", "down", "Lock car", lockcar )     -- bind the 'l' key to the 'lockcar' function
end
addEventHandler ( "onPlayerSpawn", getRootElement(), bindLockOnSpawn )    -- add an event handler for onPlayerSpawn
</syntaxhighlight>
</section>


==See Also==
==See Also==
{{Vehicle functions}}
{{Vehicle functions}}

Revision as of 22:53, 11 August 2017

This will tell you if a vehicle is locked.

Syntax

bool isVehicleLocked ( vehicle theVehicle )


OOP Syntax Help! I don't understand this!

Method: vehicle:isLocked(...)
Variable: .locked
Counterpart: setVehicleLocked


Required Arguments

  • theVehicle: The vehicle that you want to obtain the locked status of.

Returns

Returns true if the vehicle specified is locked, false if is unlocked or the vehicle specified is invalid.

Example

Click to collapse [-]
Server

This example allows a player to lock his vehicle when he is inside it.

function lockcar ( thePlayer )
    playervehicle = getPlayerOccupiedVehicle ( thePlayer )   -- define 'playervehicle' as the vehicle the player is in
    if ( playervehicle ) then                                -- if a player is in a vehicle
        if isVehicleLocked ( playervehicle ) then            -- and if the vehicle is already locked
            setVehicleLocked ( playervehicle, false )        -- unlock it
        else                                                 -- otherwise (if it isn't locked) 
            setVehicleLocked ( playervehicle, true )         -- lock it
        end
    end
end

function bindLockOnSpawn ( theSpawnpoint )                     -- when a player spawns
    bindKey ( source, "l", "down", "Lock car", lockcar )     -- bind the 'l' key to the 'lockcar' function
end
addEventHandler ( "onPlayerSpawn", getRootElement(), bindLockOnSpawn )     -- add an event handler for onPlayerSpawn

See Also