What is a cheek press event?

Question

In the Android docs for a PopupWindow, the method setIgnoreCheekPress() is mentioned. It says that this method "Sets the flag on popup to ignore cheek press event; by default this flag is set to false which means the pop wont ignore cheek press dispatch events."

Quite simply, what is a cheek press dispatch event?

Answer 1

It's the event dispatched when your cheek presses against the phone.

Events have a size, the size is compared against a threshold to determine if it's a "cheek", e.g., if the size is bigger than some "it's a finger" threshold. This allows phones to not react when someone has the phone up to their face and their cheek is pressing on the screen.

---

Clarification from comment. The phone does not know you've specifically pressed with your cheek. It assumes you're not rubbing up on it with other large (compared to a finger) body parts. Ew.

Answer 2

Detects when you put your face to the phone, for example to turn off the screen during a phone call.