> For the complete documentation index, see [llms.txt](https://docs.flatredball.com/flatredball/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flatredball.com/flatredball/api/flatredball/gui/cursor/setcontrollinggamepad.md).
# SetControllingGamepad
### Introduction
The FlatRedBall Cursor object uses mouse or touch screen input by default. This default behavior can be changed with the SetControllingGamepad method, which switches a Cursor to be used by an Xbox360GamePad instance. When using an Xbox360GamePad for cursor control, the following input is applied:
* Cursor position is controlled by the left analog stick and d-pad. Position is kept inside of the screen automatically.
* The primary action (usually left mouse button) is controlled by the A button
* The secondary action (usually the right mouse button) is controlled by the X button
* Scrolling is controlled by the right analog stick’s Y (vertical) position
When using an Xbox360GamePad, the native (Windows) cursor will not move in response to gamepad controls, so a visual representation must be manually added.
### Code Example - Using an Xbox360GamePad to Control the Cursor
The following code assumes a Circle has been added to the current Screen:
```
void CustomInitialize()
{
var cursor = GuiManager.Cursor;
cursor.SetControllingGamepad(InputManager.Xbox360GamePads.First(item => item.IsConnected));
}
void CustomActivity(bool firstTimeCalled)
{
var worldPosition = GuiManager.Cursor.WorldPosition.ToVector3();
FlatRedBall.Debugging.Debugger.Write(worldPosition);
CircleInstance.Position = worldPosition;
}
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.flatredball.com/flatredball/api/flatredball/gui/cursor/setcontrollinggamepad.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
