appcui 0.4.8

A feature-rich and cross-platform TUI/CUI framework for Rust, enabling modern terminal-based applications on Windows, Linux, and macOS. Includes built-in UI components like buttons, menus, list views, tree views, checkboxes, and more. Perfect for building fast and interactive CLI tools and text-based interfaces.
Documentation
use std::marker::PhantomData;

use super::events::EventData;
use super::EnumSelector;
use super::Flags;
use crate::prelude::*;
use crate::ui::components::{ComboBoxComponent, ComboBoxComponentDataProvider};

struct DataProvider<T>
where
    T: EnumSelector + Copy + Eq + 'static,
{
    _phanton: PhantomData<T>,
}
impl<T> ComboBoxComponentDataProvider for DataProvider<T>
where
    T: EnumSelector + Copy + Eq + 'static,
{
    fn count(&self) -> u32 {
        T::COUNT
    }

    fn name(&self, index: u32) -> Option<&str> {
        T::from_index(index).map(|p| p.name())
    }

    fn description(&self, index: u32) -> Option<&str> {
        T::from_index(index).map(|p| p.description())
    }

    fn symbol(&self, _index: u32) -> Option<&str> {
        None    
    }
}

#[CustomControl(overwrite=OnPaint+OnDefaultAction+OnKeyPressed+OnMouseEvent+OnExpand, internal=true)]
pub struct Selector<T>
where
    T: EnumSelector + Copy + Eq + 'static,
{
    component: ComboBoxComponent<DataProvider<T>>,
    flags: Flags,
}
impl<T> Selector<T>
where
    T: EnumSelector + Copy + Eq + 'static,
{
    /// Creates a new Selector control with the specified value, layout and flags.
    /// The flags can be a combination of the following values:
    /// * `Flags::AllowNoneVariant` - if set, the selector will allow the value `None` to be selected 
    /// 
    /// This is a genric control over the type T, which must implement the `EnumSelector` trait. You can do this by manually implement the trait for your enum or by using the `EnumSelector` derive macro.
    /// 
    /// # Example
    /// ```rust, no_run
    /// use appcui::prelude::*;
    /// 
    /// #[derive(EnumSelector, Eq, PartialEq, Copy, Clone)]
    /// enum Shape {
    ///     #[VariantInfo(name = "Square", description = "a red square")]
    ///     Square,
    /// 
    ///     #[VariantInfo(name = "Rectangle", description = "a green rectangle")]
    ///     Rectangle,
    /// }
    /// 
    /// let mut selector: Selector<Shape> = Selector::new(
    ///                                 Some(Shape::Square),
    ///                                 layout!("x:1,y:1,w:20,h:1"),
    ///                                 selector::Flags::AllowNoneVariant);
    /// ```
    pub fn new(value: Option<T>, layout: Layout, flags: Flags) -> Self {
        let mut obj = Self {
            base: ControlBase::with_status_flags(layout, StatusFlags::Visible | StatusFlags::Enabled | StatusFlags::AcceptInput),
            component: ComboBoxComponent::new(flags.contains(Flags::AllowNoneVariant), false, T::COUNT, 0),
            flags,
        };
        if let Some(val) = value {
            for i in 0..T::COUNT {
                if T::from_index(i) == Some(val) {
                    obj.component.current_index = i;
                    break;
                }
            }
        } else {
            // value is None
            if !obj.flags.contains(Flags::AllowNoneVariant) {
                panic!(
                    "You can not instantiate a selector with `None` value without setting the flags `AllowNoneVariant`. Have you forgot to do this ?"
                );
            }
            obj.component.current_index = T::COUNT;
        }
        if T::COUNT == 0 {
            panic!("You should have at least one variant in the enum associated with the seclector control !");
        }
        obj.component.set_none_string("None");
        obj.set_size_bounds(7, 1, u16::MAX, 1);
        obj
    }
    #[inline(always)]
    pub fn value(&self) -> T {
        EnumSelector::from_index(self.component.current_index).unwrap()
    }
    #[inline(always)]
    pub fn try_value(&self) -> Option<T> {
        EnumSelector::from_index(self.component.current_index)
    }
    pub fn set_value(&mut self, value: T) {
        let count = T::COUNT;
        for i in 0..count {
            if T::from_index(i) == Some(value) {
                self.component.update_current_index(i);
                break;
            }
        }
    }
    pub fn clear_value(&mut self) {
        if !self.flags.contains(Flags::AllowNoneVariant) {
            panic!("You can not clear the value of a selector unless flag `AllowNoneVariant` was set. Have you forgot to do this ?");
        }
        self.component.update_current_index(T::COUNT);
    }
    fn emit_on_selection_changed_event(&mut self) {
        self.raise_event(ControlEvent {
            emitter: self.handle,
            receiver: self.event_processor,
            data: ControlEventData::Selector(EventData {
                type_id: std::any::TypeId::of::<T>(),
            }),
        });
    }
}
impl<T> OnPaint for Selector<T>
where
    T: EnumSelector + Copy + Eq,
{
    fn on_paint(&self, surface: &mut Surface, theme: &Theme) {
        let data: DataProvider<T> = DataProvider { _phanton: PhantomData };
        self.component.on_paint(&self.base, &data, surface, theme);
    }
}
impl<T> OnExpand for Selector<T>
where
    T: EnumSelector + Copy + Eq,
{
    fn on_expand(&mut self, direction: ExpandedDirection) {
        self.component.on_expand(&mut self.base, direction);
    }
    fn on_pack(&mut self) {
        self.component.on_pack();
    }
}
impl<T> OnDefaultAction for Selector<T>
where
    T: EnumSelector + Copy + Eq,
{
    fn on_default_action(&mut self) {
        self.component.on_default_action(&mut self.base);
    }
}
impl<T> OnKeyPressed for Selector<T>
where
    T: EnumSelector + Copy + Eq,
{
    fn on_key_pressed(&mut self, key: Key, character: char) -> EventProcessStatus {
        let data: DataProvider<T> = DataProvider { _phanton: PhantomData };
        let orig_index = self.component.current_index;
        let result = self.component.on_key_pressed(&mut self.base, &data, key, character);
        if orig_index != self.component.current_index {
            self.emit_on_selection_changed_event();
        }
        result
    }
}
impl<T> OnMouseEvent for Selector<T>
where
    T: EnumSelector + Copy + Eq,
{
    fn on_mouse_event(&mut self, event: &MouseEvent) -> EventProcessStatus {
        let data: DataProvider<T> = DataProvider { _phanton: PhantomData };
        let orig_index = self.component.current_index;
        let result = self.component.on_mouse_event(&mut self.base, &data, event);
        if orig_index != self.component.current_index {
            self.emit_on_selection_changed_event();
        }
        result
    }
}