Condividi tramite


Pulsanti, utilizzo a livello di report (touchpad-buttons-report-level-usages)

In questo argomento vengono illustrati gli utilizzi a livello di report per i pulsanti, all'interno del contesto della raccolta Touchpad di precisione di Windows.

Ecco una tabella che mostra tutti gli utilizzi obbligatori che devono essere presenti in tutti i report di input touchpad precisione windows. La tabella include gli utilizzi per i pulsanti 1, 2 e 3.

Membro Descrizione Pagina ID Obbligatorio/Facoltativo
ID report ID report touchpad di precisione di Windows. 0x0d 0x05 Obbligatorio
Tempo di analisi Tempo di analisi relativo. 0x0d 0x56 Facoltativo
Conteggio contatti Numero totale di contatti da segnalare in un determinato report. 0x0d 0x54 Obbligatorio
Pulsante 1 Indica lo stato pulsante per il pulsante touchpad integrato con il digitalizzatore. 0x09 0x01 Facoltativo
Pulsante 2 Indica lo stato del pulsante per il pulsante esterno per il clic primario (predefinito a sinistra). 0x09 0x02 Facoltativo
Pulsante 3 Indica lo stato del pulsante per il pulsante esterno per il clic secondario (impostazione predefinita a destra). 0x09 0x03 Facoltativo

Nelle sezioni seguenti vengono fornite informazioni sull'utilizzo di Pulsanti. Per informazioni sugli altri membri , ad esempio ID report, vedere Raccolta touchpad precisione Windows.

Pulsante 1

L'opzione Pulsante 1 specifica lo stato su/giù del pulsante Touchpad precisione Windows sotto il digitalizzatore. Indipendentemente dall'implementazione del tipo di pulsante (pressione o meccanica), quando un pulsante ha ricevuto la quantità richiesta di forza di attivazione, il relativo stato inferiore deve essere segnalato impostando il bit del pulsante. Quando la forza di attivazione applicata al pulsante scende al di sotto della soglia richiesta, lo stato "su" deve essere segnalato cancellando il bit del pulsante.

diagram showing a contact placed on a windows precision touchpad, with sufficient force to invoke a button-down. the contact's down force is later reduced enough to invoke a button-up, while the contact is still on the digitizer surface.

Con riferimento all'esempio descritto nel diagramma precedente, si supponga che un contatto venga posizionato su un Touchpad di precisione di Windows con una forza di attivazione sufficiente per richiamare un pulsante verso il basso. Successivamente, la forza di attivazione viene ridotta in modo da richiamare un pulsante su mentre il contatto rimane sulla superficie per un po 'di tempo aggiuntivo. Verrà segnalato come descritto nella tabella seguente.

Report 1 2 3 4 5 6 7 8 9 10 11
Conteggio contatti 1 1 1 1 1 1 1 1 1 1 1
Pulsante 1 1 1 1 1 0 NR NR NR NR NR
Contatto 2: opzione suggerimento 1 1 1 1 1 1 1 1 1 1 0
Contatto 2: X, Y X₁, Y₁ X scalabilità, Y* X₃, Y₃ X₄, Y₄ X₅, Y₅ X₆, Y₆ X₇, Y₇ X₈, Y₈ X₉, Y₉ X₁₀, Y₁₀ X₁₀, Y₁₀

diagram showing a non-capacitive contact that is placed on a windows precision touchpad with sufficient activation force to invoke a button down. the activation force is later reduced, such that it invokes a button up.

Con riferimento all'esempio descritto nel diagramma precedente, si supponga che un contatto non capacitivo venga posizionato su un touchpad di Precisione Windows con una forza di attivazione sufficiente per richiamare un pulsante verso il basso. Successivamente, la forza di attivazione viene ridotta in modo che richiami un pulsante su. Verrà segnalato come descritto nella tabella seguente.

Report 1 2 3 4 5 6
Conteggio contatti 0 0 0 0 0 0
Pulsante 1 1 1 1 1 0

Pulsanti 2 e 3 (discreti clic sinistro e destro)

Il dispositivo Touchpad precisione Windows supporterà in modo nativo gli utilizzi per i pulsanti (clic con il pulsante destro del mouse e il clic con il pulsante destro del mouse) integrati con il digitalizzatore, ma i pulsanti aggiuntivi devono essere gestiti da un driver di terze parti.

E se un dispositivo supporta solo pulsanti esterni, deve comunque usare il pulsante 2 e il pulsante 3 per fare riferimento ai pulsanti esterni.

Se sono presenti più pulsanti per l'uso con il touchpad, i pulsanti aggiuntivi devono essere dichiarati nel descrittore. I pulsanti esterni vengono segnalati a livello di pacchetto simile ai pulsanti del digitalizzatore, ma non esistono requisiti per coordinare i pulsanti esterni con lo stato del contatto.

Modalità di creazione di report pacchetti

Modalità parallela

In modalità parallela, i dispositivi segnalano tutte le informazioni di contatto in un singolo pacchetto. Ogni contatto fisico è rappresentato da una raccolta logica incorporata nella raccolta di primo livello. Questa raccolta logica contiene tutti gli utilizzi supportati dal dispositivo per ogni contatto. Quando si usa la modalità Parallel, ognuna delle raccolte logiche deve essere identica. Poiché il dispositivo segnala in genere un numero inferiore di contatti al massimo, il numero di contatti segnalati in un pacchetto parallelo deve essere comunicato tramite l'utilizzo del conteggio contatti.

Si consideri, ad esempio, un dispositivo che supporta tre contatti. Se l'utente ha solo due dita sul digitalizzatore, il pacchetto parallelo avrà solo due dati di contatto validi in un report in grado di trasportare dati per tre contatti. In questo caso, il conteggio contatti deve essere impostato su 2, in modo che l'applicazione client conosca che eventuali informazioni su più di due contatti non siano valide.

Uno svantaggio della segnalazione di più contatti in un report è che lo spazio viene sprecato per ogni report ogni volta che sono presenti meno contatti rispetto al numero massimo di contatti possibili. I dispositivi possono usare la modalità ibrida per ridurre questa inefficienza.

Modalità ibrida

In modalità ibrida, il numero di contatti che è possibile segnalare in un report è inferiore al numero massimo di contatti supportati dal dispositivo. Ad esempio, un dispositivo che supporta un massimo di 4 contatti fisici simultanei può configurare la raccolta di primo livello per recapitare un massimo di 2 contatti in un unico report. Se sono presenti 4 punti di contatto, il dispositivo può suddividerli in 2 report seriali che recapitano 2 contatti ciascuno.

Quando un dispositivo recapita i dati in questo modo, il valore di utilizzo conteggio contatti nel primo report deve riflettere il numero totale di contatti recapitati nei report ibridi. Gli altri report seriali devono avere un numero di contatti pari a zero (0).

Modalità di creazione report ibrida con un solo dito

Il primo report di input per un determinato frame indica il numero totale di contatti da segnalare tramite l'utilizzo del conteggio dei contatti. Tutti i report di input successivi per lo stesso frame devono avere un valore pari a zero (0) per l'utilizzo del conteggio dei contatti, per indicare che fanno parte del frame segnalato in precedenza. Il tempo di analisi per tutti i report di un determinato frame deve essere identico.

Ecco una tabella che mostra la sequenza di report per 2 contatti (in modalità Single Finger Hybrid Reporting).

Report 1 2 3 4 5 6
Conteggio contatti 2 0 2 0 2 0
ID contatto 1 2 1 2 1 2
Contatto 1: X, Y X₁, Y₁ NR X scalabilità, Y* NR X₃, Y₃ NR
Contatto 1: opzione suggerimento 1 NR 1 NR 1 NR
Contatto 2: X, Y NR X₁, Y₁ NR X scalabilità, Y* NR X₃, Y₃
Contatto 2: opzione suggerimento NR 1 NR 1 NR 1
Tempo di analisi T₁ T₁ T* T* T₃ T₃

I dispositivi Windows Precision Touchpad connessi a USB e I²C possono fornire report di input in modalità di creazione di report ibridi con un solo dito o in modalità di creazione di report ibridi a due dita.

Raccolta touchpad precisione Windows