migrations/winit
1
0
Fork 0
mirror of https://github.com/rust-windowing/winit.git synced 2026-06-26 14:49:07 -04:00
Code Issues Packages Projects Releases Wiki Activity

Document potential user expectation of ctrl+left click behavior on macOS. (#4518)

Browse Source
This commit is contained in:
RandomScientist
2026-03-16 19:39:12 -07:00
committed by GitHub
parent 7a11ff8766
commit 6f3d763650
1 changed files with 13 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

13
winit-core/src/event.rs
View File

@@ -516,6 +516,19 @@ impl From<PointerSource> for PointerKind {
/// system. /// system.
#[derive(Clone, Debug, PartialEq)] #[derive(Clone, Debug, PartialEq)]
pub enum ButtonSource { pub enum ButtonSource {
/// ## Platform-specific
///
/// ### macOS
///
/// Users may expect holding [<kbd>CTRL</kbd>](ModifiersState::CONTROL) while
/// clicking [`MouseButton::Left`] to result in a "secondary" click, but the way these
/// clicks behave natively is slightly different from how a physical secondary
/// button press would, depending on the content under the cursor when clicked. If
/// applications want this behavior they should implement it themselves by interpreting
/// [`Left`](MouseButton::Left) clicks as secondary when
/// [<kbd>CTRL</kbd>](ModifiersState::CONTROL) is held and their internal logic deems it
/// appropriate for the content under the pointer.
/// See also https://github.com/rust-windowing/winit/issues/4469.
Mouse(MouseButton), Mouse(MouseButton),
/// See [`PointerSource::Touch`] for more details. /// See [`PointerSource::Touch`] for more details.
/// ///