Export (0) Print
Expand All

GamePad.GetState Method (PlayerIndex, GamePadDeadZone)

Gets the current state of a game pad controller, using a specified dead zone on analog stick positions.

Namespace: Microsoft.Xna.Framework.Input
Assembly: Microsoft.Xna.Framework (in microsoft.xna.framework.dll)

public static GamePadState GetState (
         PlayerIndex playerIndex,
         GamePadDeadZone deadZoneMode
)

Parameters

playerIndex
Player index for the controller you want to query.
deadZoneMode
Enumerated value that specifies what dead zone type to use.

Return Value

The current state of the controller.

Exception typeCondition
InvalidOperationExceptionAn unknown error has occurred. Verify that the correct playerIndex is being requested.

Bb197229.bp(en-US,XNAGameStudio.30).gifBest Practice
  • On the first menu presented by the game, consider asking the player to sign in by pressing A or Start. This enables the game to detect the correct controller in use for each player in the game.

  • When processing player input, you can examine SignedInGamer.GameDefaults to determine a player's preferences for how the Xbox 360 controller is used to send input to the game.

When you call GetState, check the returned structure's IsConnected property value. If the controller has been disconnected, this value will be false. When a controller is disconnected, values for its state will not be valid. Also, the controller will not receive any new vibration settings.

The deadZoneMode parameter specifies the type of dead-zone processing to apply to the analog sticks on the controller. By applying a dead zone, controller inputs will report values near the center and edges of their ranges more accurately. If you wish to do your own dead-zone processing, use GamePadDeadZone.None.

On Zune, the default is "no dead zone." Dead zones are not necessary on Zune. You can specify a dead zone if you want, but you need to remember this setting will reduce the available input in a simple device.

Xbox 360, Windows XP SP2, Windows Vista, Zune

Community Additions

ADD
Show:
© 2014 Microsoft