Struct gtk4::ComboBoxText

source ·

pub struct ComboBoxText { /* private fields */ }

👎Deprecated: Since 4.10

Expand description

Use DropDown with a StringList instead A ComboBoxText is a simple variant of ComboBox for text-only use cases.

An example GtkComboBoxText

ComboBoxText hides the model-view complexity of ComboBox.

To create a ComboBoxText, use new() or with_entry().

You can add items to a ComboBoxText with append_text(), insert_text() or prepend_text() and remove options with remove().

If the ComboBoxText contains an entry (via the has-entry property), its contents can be retrieved using active_text().

You should not call ComboBoxExt::set_model() or attempt to pack more cells into this combo box via its CellLayout interface.

§GtkComboBoxText as GtkBuildable

The ComboBoxText implementation of the Buildable interface supports adding items directly using the <items> element and specifying <item> elements for each item. Each <item> element can specify the “id” corresponding to the appended text and also supports the regular translation attributes “translatable”, “context” and “comments”.

Here is a UI definition fragment specifying ComboBoxText items:

<object class="GtkComboBoxText">
  <items>
    <item translatable="yes" id="factory">Factory</item>
    <item translatable="yes" id="home">Home</item>
    <item translatable="yes" id="subway">Subway</item>
  </items>
</object>

§CSS nodes

combobox
╰── box.linked
    ├── entry.combo
    ├── button.combo
    ╰── window.popup

ComboBoxText has a single CSS node with name combobox. It adds the style class .combo to the main CSS nodes of its entry and button children, and the .linked class to the node of its internal box.

§Implements

ComboBoxExt, WidgetExt, [trait@glib::ObjectExt], AccessibleExt, BuildableExt, ConstraintTargetExt, CellEditableExt, CellLayoutExt, ComboBoxExtManual, WidgetExtManual, AccessibleExtManual, CellLayoutExtManual

Struct gtk4::ComboBoxTextCopy item path

§GtkComboBoxText as GtkBuildable

§CSS nodes

§Implements

Implementations§

impl ComboBoxText

pub fn new() -> ComboBoxText

§Deprecated since 4.10

§Returns

pub fn with_entry() -> ComboBoxText

§Deprecated since 4.10

§Returns

pub fn builder() -> ComboBoxTextBuilder

pub fn append(&self, id: Option<&str>, text: &str)

§Deprecated since 4.10

§id

§text

pub fn append_text(&self, text: &str)

§Deprecated since 4.10

§text

pub fn active_text(&self) -> Option<GString>

§Deprecated since 4.10

§Returns

pub fn insert(&self, position: i32, id: Option<&str>, text: &str)

§Deprecated since 4.10

§position

§id

§text

pub fn insert_text(&self, position: i32, text: &str)

§Deprecated since 4.10

§position

§text

pub fn prepend(&self, id: Option<&str>, text: &str)

§Deprecated since 4.10

§id

§text

pub fn prepend_text(&self, text: &str)

§Deprecated since 4.10

§text

pub fn remove(&self, position: i32)

§Deprecated since 4.10

§position

pub fn remove_all(&self)

§Deprecated since 4.10

Trait Implementations§

impl Clone for ComboBoxText

fn clone(&self) -> Self

fn clone_from(&mut self, source: &Self)

impl Debug for ComboBoxText

fn fmt(&self, f: &mut Formatter<'_>) -> Result

impl Default for ComboBoxText

fn default() -> Self

impl HasParamSpec for ComboBoxText

type ParamSpec = ParamSpecObject

type SetValue = ComboBoxText

type BuilderFn = fn(_: &str) -> ParamSpecObjectBuilder<'_, ComboBoxText>

fn param_spec_builder() -> Self::BuilderFn

impl Hash for ComboBoxText

fn hash<H>(&self, state: &mut H)where H: Hasher,

fn hash_slice<H>(data: &[Self], state: &mut H)where H: Hasher, Self: Sized,

impl Ord for ComboBoxText

fn cmp(&self, other: &Self) -> Ordering

fn max(self, other: Self) -> Selfwhere Self: Sized,

fn min(self, other: Self) -> Selfwhere Self: Sized,

fn clamp(self, min: Self, max: Self) -> Selfwhere Self: Sized + PartialOrd,

impl ParentClassIs for ComboBoxText

type Parent = ComboBox

impl<OT: ObjectType> PartialEq<OT> for ComboBoxText

fn eq(&self, other: &OT) -> bool

fn ne(&self, other: &Rhs) -> bool

impl<OT: ObjectType> PartialOrd<OT> for ComboBoxText

fn partial_cmp(&self, other: &OT) -> Option<Ordering>

fn lt(&self, other: &Rhs) -> bool

fn le(&self, other: &Rhs) -> bool

fn gt(&self, other: &Rhs) -> bool

fn ge(&self, other: &Rhs) -> bool

impl StaticType for ComboBoxText

fn static_type() -> Type

impl Eq for ComboBoxText

impl IsA<Accessible> for ComboBoxText

Struct gtk4::ComboBoxText

§`id`

§`text`

§`text`

§`position`

§`id`

§`text`

§`position`

§`text`

§`id`

§`text`

§`text`

§`position`

fn hash<H>(&self, state: &mut H)
where H: Hasher,

fn hash_slice<H>(data: &[Self], state: &mut H)
where H: Hasher, Self: Sized,

fn max(self, other: Self) -> Self
where Self: Sized,

fn min(self, other: Self) -> Self
where Self: Sized,

fn clamp(self, min: Self, max: Self) -> Self
where Self: Sized + PartialOrd,

impl<O> AccessibleExt for O
where O: IsA<Accessible>,

impl<O> AccessibleExtManual for O
where O: IsA<Accessible>,

impl<T> Any for T
where T: 'static + ?Sized,

impl<T> Borrow<T> for T
where T: ?Sized,

impl<T> BorrowMut<T> for T
where T: ?Sized,

impl<O> BuildableExt for O
where O: IsA<Buildable>,

impl<T> Cast for T
where T: ObjectType,

fn upcast<T>(self) -> T
where T: ObjectType, Self: IsA<T>,

fn upcast_ref<T>(&self) -> &T
where T: ObjectType, Self: IsA<T>,

fn downcast<T>(self) -> Result<T, Self>
where T: ObjectType, Self: MayDowncastTo<T>,

fn downcast_ref<T>(&self) -> Option<&T>
where T: ObjectType, Self: MayDowncastTo<T>,

fn dynamic_cast<T>(self) -> Result<T, Self>
where T: ObjectType,

fn dynamic_cast_ref<T>(&self) -> Option<&T>
where T: ObjectType,

unsafe fn unsafe_cast<T>(self) -> T
where T: ObjectType,

unsafe fn unsafe_cast_ref<T>(&self) -> &T
where T: ObjectType,

impl<O> CellEditableExt for O
where O: IsA<CellEditable>,

impl<O> CellLayoutExt for O
where O: IsA<CellLayout>,