ShowCursor: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
mNo edit summary
No edit summary
Line 1: Line 1:
__NOTOC__  
__NOTOC__
This function is used to show or hide a player's cursor.
{{Server client function}}
This function is used to show or hide a [[player]]'s cursor.


Note that, regardless of the cursor state you set using this function, the cursor will always be visible while the menu or chatbox are open.
Note that, regardless of the cursor state you set using this function, the cursor will always be visible while the menu or chatbox are open.
Line 19: Line 20:
This example shows the cursor for a player named "Dave", then outputs a message if it was shown successfully.
This example shows the cursor for a player named "Dave", then outputs a message if it was shown successfully.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
local thePlayer = getPlayerFromNick ( "Dave" ) -- get the player named Dave
local thePlayer = getPlayerFromNick ( "Dave" )             -- get the player named Dave
if thePlayer then -- if we got him
if thePlayer then                                           -- if we got him
  showCursor ( thePlayer, true ) -- make his cursor show
    showCursor ( thePlayer, true )                         -- make his cursor show
  if isCursorShowing ( thePlayer ) then -- did it show?
    if isCursorShowing ( thePlayer ) then                   -- did it show?
    outputChatBox ( "Cursor is now showing for Dave." ) -- print a message to the chat box
        outputChatBox ( "Cursor is now showing for Dave." ) -- print a message to the chat box
  end
    end
end
end
</syntaxhighlight>
</syntaxhighlight>

Revision as of 18:25, 15 August 2007

This function is used to show or hide a player's cursor.

Note that, regardless of the cursor state you set using this function, the cursor will always be visible while the menu or chatbox are open.

Syntax

bool showCursor ( player thePlayer, bool show )

Required Arguments

  • thePlayer: The player you want to show or hide the cursor of.
  • show: A boolean value determining whether to show (true) or hide (false) the cursor.

Returns

Returns true if the player's cursor was shown or hidden successfully, false otherwise.

Example

This example shows the cursor for a player named "Dave", then outputs a message if it was shown successfully.

local thePlayer = getPlayerFromNick ( "Dave" )              -- get the player named Dave
if thePlayer then                                           -- if we got him
    showCursor ( thePlayer, true )                          -- make his cursor show
    if isCursorShowing ( thePlayer ) then                   -- did it show?
        outputChatBox ( "Cursor is now showing for Dave." ) -- print a message to the chat box
    end
end

See Also