Enum gtk4::InputPurpose
source · #[non_exhaustive]
pub enum InputPurpose {
FreeForm,
Alpha,
Digits,
Number,
Phone,
Url,
Email,
Name,
Password,
Pin,
Terminal,
}
Expand description
Describes primary purpose of the input widget.
This information is useful for on-screen keyboards and similar input methods to decide which keys should be presented to the user.
Note that the purpose is not meant to impose a totally strict rule about allowed characters, and does not replace input validation. It is fine for an on-screen keyboard to let the user override the character set restriction that is expressed by the purpose. The application is expected to validate the entry contents, even if it specified a purpose.
The difference between Digits
and
Number
is that the former accepts only digits
while the latter also some punctuation (like commas or points, plus,
minus) and “e” or “E” as in 3.14E+000.
This enumeration may be extended in the future; input methods should interpret unknown values as “free form”.
Variants (Non-exhaustive)§
This enum is marked as non-exhaustive
FreeForm
Allow any character
Alpha
Allow only alphabetic characters
Digits
Allow only digits
Number
Edited field expects numbers
Phone
Edited field expects phone number
Url
Edited field expects URL
Edited field expects email address
Name
Edited field expects the name of a person
Password
Like FreeForm
, but characters are hidden
Pin
Like Digits
, but characters are hidden
Terminal
Allow any character, in addition to control codes
Trait Implementations§
source§impl Clone for InputPurpose
impl Clone for InputPurpose
source§fn clone(&self) -> InputPurpose
fn clone(&self) -> InputPurpose
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moresource§impl Debug for InputPurpose
impl Debug for InputPurpose
source§impl Display for InputPurpose
impl Display for InputPurpose
source§impl From<InputPurpose> for Value
impl From<InputPurpose> for Value
source§fn from(v: InputPurpose) -> Self
fn from(v: InputPurpose) -> Self
source§impl<'a> FromValue<'a> for InputPurpose
impl<'a> FromValue<'a> for InputPurpose
§type Checker = GenericValueTypeChecker<InputPurpose>
type Checker = GenericValueTypeChecker<InputPurpose>
source§unsafe fn from_value(value: &'a Value) -> Self
unsafe fn from_value(value: &'a Value) -> Self
Value
. Read moresource§impl HasParamSpec for InputPurpose
impl HasParamSpec for InputPurpose
type ParamSpec = ParamSpecEnum
§type SetValue = InputPurpose
type SetValue = InputPurpose
type BuilderFn = fn(_: &str, _: InputPurpose) -> ParamSpecEnumBuilder<'_, InputPurpose>
fn param_spec_builder() -> Self::BuilderFn
source§impl Hash for InputPurpose
impl Hash for InputPurpose
source§impl Ord for InputPurpose
impl Ord for InputPurpose
source§fn cmp(&self, other: &InputPurpose) -> Ordering
fn cmp(&self, other: &InputPurpose) -> Ordering
1.21.0 · source§fn max(self, other: Self) -> Selfwhere
Self: Sized,
fn max(self, other: Self) -> Selfwhere Self: Sized,
source§impl PartialEq<InputPurpose> for InputPurpose
impl PartialEq<InputPurpose> for InputPurpose
source§fn eq(&self, other: &InputPurpose) -> bool
fn eq(&self, other: &InputPurpose) -> bool
self
and other
values to be equal, and is used
by ==
.source§impl PartialOrd<InputPurpose> for InputPurpose
impl PartialOrd<InputPurpose> for InputPurpose
source§fn partial_cmp(&self, other: &InputPurpose) -> Option<Ordering>
fn partial_cmp(&self, other: &InputPurpose) -> Option<Ordering>
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl StaticType for InputPurpose
impl StaticType for InputPurpose
source§fn static_type() -> Type
fn static_type() -> Type
Self
.source§impl ToValue for InputPurpose
impl ToValue for InputPurpose
source§impl ValueType for InputPurpose
impl ValueType for InputPurpose
§type Type = InputPurpose
type Type = InputPurpose
Type
from. Read moreimpl Copy for InputPurpose
impl Eq for InputPurpose
impl StructuralEq for InputPurpose
impl StructuralPartialEq for InputPurpose
Auto Trait Implementations§
impl RefUnwindSafe for InputPurpose
impl Send for InputPurpose
impl Sync for InputPurpose
impl Unpin for InputPurpose
impl UnwindSafe for InputPurpose
Blanket Implementations§
source§impl<T> IntoClosureReturnValue for Twhere
T: Into<Value>,
impl<T> IntoClosureReturnValue for Twhere T: Into<Value>,
fn into_closure_return_value(self) -> Option<Value>
source§impl<T> PropertyGet for Twhere
T: HasParamSpec,
impl<T> PropertyGet for Twhere T: HasParamSpec,
source§impl<T> StaticTypeExt for Twhere
T: StaticType,
impl<T> StaticTypeExt for Twhere T: StaticType,
source§fn ensure_type()
fn ensure_type()
source§impl<T> ToSendValue for Twhere
T: Send + ToValue + ?Sized,
impl<T> ToSendValue for Twhere T: Send + ToValue + ?Sized,
source§fn to_send_value(&self) -> SendValue
fn to_send_value(&self) -> SendValue
SendValue
clone of self
.