pub struct KeyModifiers { /* private fields */ }
Expand description
Represents key modifiers (shift, control, alt, etc.).
Note: SUPER
, HYPER
, and META
can only be read if
KeyboardEnhancementFlags::DISAMBIGUATE_ESCAPE_CODES
has been enabled with
PushKeyboardEnhancementFlags
.
Implementations§
Source§impl KeyModifiers
impl KeyModifiers
pub const SHIFT: KeyModifiers
pub const CONTROL: KeyModifiers
pub const ALT: KeyModifiers
pub const SUPER: KeyModifiers
pub const HYPER: KeyModifiers
pub const META: KeyModifiers
pub const NONE: KeyModifiers
Sourcepub const fn empty() -> KeyModifiers
pub const fn empty() -> KeyModifiers
Returns an empty set of flags.
Sourcepub const fn all() -> KeyModifiers
pub const fn all() -> KeyModifiers
Returns the set containing all flags.
Sourcepub const fn from_bits(bits: u8) -> Option<KeyModifiers>
pub const fn from_bits(bits: u8) -> Option<KeyModifiers>
Convert from underlying bit representation, unless that representation contains bits that do not correspond to a flag.
Sourcepub const fn from_bits_truncate(bits: u8) -> KeyModifiers
pub const fn from_bits_truncate(bits: u8) -> KeyModifiers
Convert from underlying bit representation, dropping any bits that do not correspond to flags.
Sourcepub const unsafe fn from_bits_unchecked(bits: u8) -> KeyModifiers
pub const unsafe fn from_bits_unchecked(bits: u8) -> KeyModifiers
Convert from underlying bit representation, preserving all bits (even those not corresponding to a defined flag).
§Safety
The caller of the bitflags!
macro can chose to allow or
disallow extra bits for their bitflags type.
The caller of from_bits_unchecked()
has to ensure that
all bits correspond to a defined flag or that extra bits
are valid for this bitflags type.
Sourcepub const fn intersects(&self, other: KeyModifiers) -> bool
pub const fn intersects(&self, other: KeyModifiers) -> bool
Returns true
if there are flags common to both self
and other
.
Sourcepub const fn contains(&self, other: KeyModifiers) -> bool
pub const fn contains(&self, other: KeyModifiers) -> bool
Returns true
if all of the flags in other
are contained within self
.
Sourcepub fn insert(&mut self, other: KeyModifiers)
pub fn insert(&mut self, other: KeyModifiers)
Inserts the specified flags in-place.
Sourcepub fn remove(&mut self, other: KeyModifiers)
pub fn remove(&mut self, other: KeyModifiers)
Removes the specified flags in-place.
Sourcepub fn toggle(&mut self, other: KeyModifiers)
pub fn toggle(&mut self, other: KeyModifiers)
Toggles the specified flags in-place.
Sourcepub fn set(&mut self, other: KeyModifiers, value: bool)
pub fn set(&mut self, other: KeyModifiers, value: bool)
Inserts or removes the specified flags depending on the passed value.
Sourcepub const fn intersection(self, other: KeyModifiers) -> KeyModifiers
pub const fn intersection(self, other: KeyModifiers) -> KeyModifiers
Returns the intersection between the flags in self
and
other
.
Specifically, the returned set contains only the flags which are
present in both self
and other
.
This is equivalent to using the &
operator (e.g.
ops::BitAnd
), as in flags & other
.
Sourcepub const fn union(self, other: KeyModifiers) -> KeyModifiers
pub const fn union(self, other: KeyModifiers) -> KeyModifiers
Returns the union of between the flags in self
and other
.
Specifically, the returned set contains all flags which are
present in either self
or other
, including any which are
present in both (see Self::symmetric_difference
if that
is undesirable).
This is equivalent to using the |
operator (e.g.
ops::BitOr
), as in flags | other
.
Sourcepub const fn difference(self, other: KeyModifiers) -> KeyModifiers
pub const fn difference(self, other: KeyModifiers) -> KeyModifiers
Returns the difference between the flags in self
and other
.
Specifically, the returned set contains all flags present in
self
, except for the ones present in other
.
It is also conceptually equivalent to the “bit-clear” operation:
flags & !other
(and this syntax is also supported).
This is equivalent to using the -
operator (e.g.
ops::Sub
), as in flags - other
.
Sourcepub const fn symmetric_difference(self, other: KeyModifiers) -> KeyModifiers
pub const fn symmetric_difference(self, other: KeyModifiers) -> KeyModifiers
Returns the symmetric difference between the flags
in self
and other
.
Specifically, the returned set contains the flags present which
are present in self
or other
, but that are not present in
both. Equivalently, it contains the flags present in exactly
one of the sets self
and other
.
This is equivalent to using the ^
operator (e.g.
ops::BitXor
), as in flags ^ other
.
Sourcepub const fn complement(self) -> KeyModifiers
pub const fn complement(self) -> KeyModifiers
Returns the complement of this set of flags.
Specifically, the returned set contains all the flags which are
not set in self
, but which are allowed for this type.
Alternatively, it can be thought of as the set difference
between Self::all()
and self
(e.g. Self::all() - self
)
This is equivalent to using the !
operator (e.g.
ops::Not
), as in !flags
.
Trait Implementations§
Source§impl Binary for KeyModifiers
impl Binary for KeyModifiers
Source§impl BitAnd for KeyModifiers
impl BitAnd for KeyModifiers
Source§fn bitand(self, other: KeyModifiers) -> KeyModifiers
fn bitand(self, other: KeyModifiers) -> KeyModifiers
Returns the intersection between the two sets of flags.
Source§type Output = KeyModifiers
type Output = KeyModifiers
&
operator.Source§impl BitAndAssign for KeyModifiers
impl BitAndAssign for KeyModifiers
Source§fn bitand_assign(&mut self, other: KeyModifiers)
fn bitand_assign(&mut self, other: KeyModifiers)
Disables all flags disabled in the set.
Source§impl BitOr for KeyModifiers
impl BitOr for KeyModifiers
Source§fn bitor(self, other: KeyModifiers) -> KeyModifiers
fn bitor(self, other: KeyModifiers) -> KeyModifiers
Returns the union of the two sets of flags.
Source§type Output = KeyModifiers
type Output = KeyModifiers
|
operator.Source§impl BitOrAssign for KeyModifiers
impl BitOrAssign for KeyModifiers
Source§fn bitor_assign(&mut self, other: KeyModifiers)
fn bitor_assign(&mut self, other: KeyModifiers)
Adds the set of flags.
Source§impl BitXor for KeyModifiers
impl BitXor for KeyModifiers
Source§fn bitxor(self, other: KeyModifiers) -> KeyModifiers
fn bitxor(self, other: KeyModifiers) -> KeyModifiers
Returns the left flags, but with all the right flags toggled.
Source§type Output = KeyModifiers
type Output = KeyModifiers
^
operator.Source§impl BitXorAssign for KeyModifiers
impl BitXorAssign for KeyModifiers
Source§fn bitxor_assign(&mut self, other: KeyModifiers)
fn bitxor_assign(&mut self, other: KeyModifiers)
Toggles the set of flags.
Source§impl Clone for KeyModifiers
impl Clone for KeyModifiers
Source§fn clone(&self) -> KeyModifiers
fn clone(&self) -> KeyModifiers
1.0.0 · Source§const fn clone_from(&mut self, source: &Self)
const fn clone_from(&mut self, source: &Self)
source
. Read moreSource§impl Debug for KeyModifiers
impl Debug for KeyModifiers
Source§impl Extend<KeyModifiers> for KeyModifiers
impl Extend<KeyModifiers> for KeyModifiers
Source§fn extend<T>(&mut self, iterator: T)where
T: IntoIterator<Item = KeyModifiers>,
fn extend<T>(&mut self, iterator: T)where
T: IntoIterator<Item = KeyModifiers>,
Source§fn extend_one(&mut self, item: A)
fn extend_one(&mut self, item: A)
extend_one
)Source§fn extend_reserve(&mut self, additional: usize)
fn extend_reserve(&mut self, additional: usize)
extend_one
)Source§impl FromIterator<KeyModifiers> for KeyModifiers
impl FromIterator<KeyModifiers> for KeyModifiers
Source§fn from_iter<T>(iterator: T) -> KeyModifierswhere
T: IntoIterator<Item = KeyModifiers>,
fn from_iter<T>(iterator: T) -> KeyModifierswhere
T: IntoIterator<Item = KeyModifiers>,
Source§impl Hash for KeyModifiers
impl Hash for KeyModifiers
Source§impl LowerHex for KeyModifiers
impl LowerHex for KeyModifiers
Source§impl Not for KeyModifiers
impl Not for KeyModifiers
Source§fn not(self) -> KeyModifiers
fn not(self) -> KeyModifiers
Returns the complement of this set of flags.
Source§type Output = KeyModifiers
type Output = KeyModifiers
!
operator.Source§impl Octal for KeyModifiers
impl Octal for KeyModifiers
Source§impl Ord for KeyModifiers
impl Ord for KeyModifiers
Source§fn cmp(&self, other: &KeyModifiers) -> Ordering
fn cmp(&self, other: &KeyModifiers) -> Ordering
1.21.0 · Source§fn max(self, other: Self) -> Selfwhere
Self: Sized,
fn max(self, other: Self) -> Selfwhere
Self: Sized,
Source§impl PartialEq for KeyModifiers
impl PartialEq for KeyModifiers
Source§impl PartialOrd for KeyModifiers
impl PartialOrd for KeyModifiers
Source§impl Sub for KeyModifiers
impl Sub for KeyModifiers
Source§fn sub(self, other: KeyModifiers) -> KeyModifiers
fn sub(self, other: KeyModifiers) -> KeyModifiers
Returns the set difference of the two sets of flags.
Source§type Output = KeyModifiers
type Output = KeyModifiers
-
operator.Source§impl SubAssign for KeyModifiers
impl SubAssign for KeyModifiers
Source§fn sub_assign(&mut self, other: KeyModifiers)
fn sub_assign(&mut self, other: KeyModifiers)
Disables all flags enabled in the set.