Sintaxe
Parâmetros
surfaceIndex _In_Tipo: uint32_t Índice da superfície de toque. Deve ser menor que o valor retornado por IGameInputDevice::GetTouchSurfaceCount. contactArrayCount _In_
Tipo: uint32_t Número de elementos em contactArray. contactArray _Out_writes_to_opt_(contactArrayCount, return)
Tipo: GameInputTouchContact* Matriz que recebe os contatos na superfície de toque. Pode ser nula.
Valor retornado
Tipo: uint32_t Se contactArray for nulo, retorna o número de contatos na superfície de toque. Caso contrário, retorna o número de contatos gravados em contactArray, que é o menor valor entre o número de contatos e contactArrayCount. Retorna 0 se a leitura não contiver dados de toque ou se surfaceIndex não for um índice de superfície válido.Comentários
Cada elemento de contactArray descreve um contato na superfície, como um dedo. Os elementos de contactArray que não são gravados com um contato são definidos como zero. O membrocontactId de GameInputTouchContact permanece o mesmo enquanto o contato permanecer na superfície, portanto você pode usá-lo para acompanhar um contato entre leituras.
Para dimensionar contactArray, chame IGameInputReading::GetTouchContactCount ou use o membro maxContactCount de GameInputTouchSurfaceInfo para alocar uma matriz grande o suficiente para qualquer leitura. Para interpretar as coordenadas do contato, chame IGameInputDevice::GetTouchSurfaceInfo com o mesmo índice de superfície.
As leituras que contêm dados de toque incluem GameInputKindTouch em IGameInputReading::GetInputKind.
O suporte ao toque depende do dispositivo e da plataforma.
Requisitos
Cabeçalho: GameInput.h Biblioteca: gameinput.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX SeriesConfira também
Visão geral do GameInputIGameInputReading
IGameInputReading::GetTouchContactCount
IGameInputDevice::GetTouchSurfaceInfo
GameInputTouchContact
GameInputTouchSurfaceInfo
