ArcadeStick.GetButtonLocation Method

Retrieves the best-fit physical location of the button at the specified index.

Syntax

public:
void GetButtonLocation(
         unsigned char buttonIndex,
         out unsigned char row,
         out unsigned char column,
         out DeviceFace face
)  

Parameters

buttonIndex
Type: unsigned char 

  Zero-based index of the button to get the best-fit physical location for.

row
Type: unsigned char 

  Returns the row on which the button at the specified index is physically located.

column
Type: unsigned char 

  Returns the column on which the button at the specified index is physically located.

face
Type: DeviceFace 

Returns a DeviceFace value that indicates the face of the arcade stick device on which the button at the specified index is physically located.

Remarks

The row and column parameters return zero-based indexes for the row and column of a button on a particular device face. Although buttons might not be aligned precisely, these indexes indicate the best-fit match for the location within a perfect grid. The following figure displays the row and column indexes for the buttons on the pictured 8-button arcade stick device.

Figure 1.  Best-fit row and column indexes of physical buttons on an arcade stick device

Requirements

Namespace: Microsoft.Xbox.Input

Metadata: microsoft.xbox.input.arcadestick.winmd

See also

Reference

ArcadeStick Class

ArcadeStick Members

Microsoft.Xbox.Input Namespace