SetControlState

Sets a state of a specified player's control, as if they pressed or released it.

Syntax

Click to collapse [-]

Server

bool setControlState ( player thePlayer, string control, bool state ) 

Click to collapse [-]

Client

bool setControlState ( string control, bool state ) 

Required Arguments

• thePlayer: The player you wish to set the control state of.
• control: The control that you want to set the state of. See control names for a list of possible controls.
• state: A boolean value representing whether or not the key will be set to pressed or not.

Returns

Returns 'true' if the control state was successfully set, 'false' otherwise.

Click to expand [+]

Server

Example

This example will disable the use of the accelerate, brake/reverse and handbrake keys, then force the accelerate on for any player who enters a vehicle.

function onPlayerEnterVehicle ( theVehicle, seat, jacked )
  toggleControl ( source, "accelerate", false ) -- disable the accelerate key
  toggleControl ( source, "brake_reverse", false ) -- disable the brake_reverse key
  toggleControl ( source, "handbrake", false ) -- disable the handbrake key
  setControlState ( source, "accelerate", true ) -- force the accelerate key on
end
addEventHandler ( "onPlayerEnterVehicle", getRootElement(), onPlayerEnterVehicle )

Click to expand [+]

Client

Example

This example will disable the use of the accelerate, brake/reverse and handbrake keys, then force the accelerate on for any player who enters a vehicle.

function onClientPlayerEnterVehicle ( theVehicle, seat, jacked )
  toggleControl ( getLocalPlayer(), "accelerate", false ) -- disable the accelerate key
  toggleControl ( getLocalPlayer(), "brake_reverse", false ) -- disable the brake_reverse key
  toggleControl ( getLocalPlayer(), "handbrake", false ) -- disable the handbrake key
  setControlState ( getLocalPlayer(), "accelerate", true ) -- force the accelerate key on
end
addEventHandler ( "onClientPlayerVehicleEnter", getRootElement(), onClientPlayerEnterVehicle )

See Also

• addCommandHandler
• bindKey
• executeCommandHandler
• getCommandHandlers
• getFunctionsBoundToKey
• getKeyBoundToFunction
• isControlEnabled
• removeCommandHandler
• toggleAllControls
• toggleControl
• unbindKey