Struct winsafe::gui::ComboBox

pub struct ComboBox(_);

Available on crate feature gui only.

Native combo box control.

Implementations

impl ComboBox

pub fn new(parent: &impl GuiParent, opts: ComboBoxOpts) -> Self

Instantiates a new ComboBox object, to be created on the parent window with HWND::CreateWindowEx.

Panics

Panics if the parent window was already created – that is, you cannot dynamically create a ComboBox in an event closure.

Examples

use winsafe::prelude::*;
use winsafe::{gui, POINT};

let wnd: gui::WindowMain; // initialized somewhere

let cmb = gui::ComboBox::new(
    &wnd,
    gui::ComboBoxOpts {
        position: (10, 10),
        width: 140,
        items: vec![
            "Avocado".to_owned(),
            "Banana".to_owned(),
            "Grape".to_owned(),
            "Orange".to_owned(),
        ],
        selected_item: Some(0),
        ..Default::default()
    },
);

pub fn new_dlg( parent: &impl GuiParent, ctrl_id: u16, resize_behavior: (Horz, Vert) ) -> Self

Instantiates a new ComboBox object, to be loaded from a dialog resource with HWND::GetDlgItem.

Panics

Panics if the parent dialog was already created – that is, you cannot dynamically create a ComboBox in an event closure.

pub const fn items(&self) -> ComboBoxItems<'_>

Item methods.

Trait Implementations

impl Clone for ComboBox

fn clone(&self) -> ComboBox

Returns a copy of the value.

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

Performs copy-assignment from source.

impl GuiChild for ComboBox

fn ctrl_id(&self) -> u16

Returns the control ID, which is defined at control creation.

impl GuiChildFocus for ComboBox

fn focus(&self)

In a raw, ordinary window, simply calls HWND:SetFocus.

impl GuiNativeControl for ComboBox

fn on_subclass(&self) -> &WindowEvents

Exposes the subclass events. If at least one event exists, the control will be subclassed.

impl GuiNativeControlEvents<ComboBoxEvents> for ComboBox

fn on(&self) -> &ComboBoxEvents

Exposes the specific control events.

impl GuiWindow for ComboBox

fn hwnd(&self) -> &HWND

Returns the underlying handle for this control.

fn as_any(&self) -> &dyn Any

Converts a reference to the Any trait. This is useful when storing a collection of polymorphic controls, because Any allows downcasting.

impl GuiWindowText for ComboBox

fn set_text(&self, text: &str)

Sets the text by calling HWND::SetWindowText.

fn text(&self) -> String

Retrieves the text by calling HWND::GetWindowText.

impl Send for ComboBox