Struct iced_audio::native::xy_pad::XYPad

pub struct XYPad<'a, Message, Renderer: Renderer, ID> where
    ID: Debug + Copy + Clone,  { /* fields omitted */ }

A 2D XY pad GUI widget that controls two Param parameters at once. One in the x coordinate and one in the y coordinate.

an XYPad will try to fill the space of its container while keeping a square aspect ratio.

Implementations

impl<'a, Message, Renderer: Renderer, ID> XYPad<'a, Message, Renderer, ID> where
    ID: Debug + Copy + Clone, 

pub fn new<F>(
    state: &'a mut State,
    param_x: &impl Param<ID = ID>,
    param_y: &impl Param<ID = ID>,
    on_change: F
) -> Self where
    F: 'static + Fn((ID, Normal)) -> Message, 

Creates a new XYPad.

It expects:

• the local State of the XYPad
• a Param with the current and default values for the x coordinate
• a Param with the current and default values for the y coordinate
• a function that will be called when the XYPad is dragged. It receives the parameter's ID and the new Normal of the XYPad. ID is a user supplied type. It can be an enum, u32, i32, String, etc. Each parameter must have a unique ID value!

pub fn size(self, size: Length) -> Self

Sets the size of the XYPad.

pub fn style(self, style: impl Into<Renderer::Style>) -> Self

Sets the style of the XYPad.

pub fn modifier_keys(self, modifier_keys: ModifiersState) -> Self

Sets the modifier keys of the XYPad.

The default modifier key is Ctrl.

pub fn modifier_scalar(self, scalar: f32) -> Self

Sets the scalar to use when the user drags the slider while holding down the modifier key.

For example, a scalar of 0.5 will cause the slider to move half a pixel for every pixel the mouse moves.

The default scalar is 0.02, and the default modifier key is Ctrl.

Trait Implementations

impl<'a, Message, Renderer, ID> From<XYPad<'a, Message, Renderer, ID>> for Element<'a, Message, Renderer> where
    Renderer: 'a + Renderer,
    Message: 'a,
    ID: 'a + Debug + Copy + Clone, 

fn from(
    xy_pad: XYPad<'a, Message, Renderer, ID>
) -> Element<'a, Message, Renderer>

Performs the conversion.

impl<'a, Message, Renderer, ID> Widget<Message, Renderer> for XYPad<'a, Message, Renderer, ID> where
    Renderer: Renderer,
    ID: Debug + Copy + Clone, 

fn width(&self) -> Length

Returns the width of the [Widget].

fn height(&self) -> Length

Returns the height of the [Widget].

fn layout(&self, _renderer: &Renderer, limits: &Limits) -> Node

Returns the [Node] of the [Widget].

fn on_event(
    &mut self,
    event: Event,
    layout: Layout,
    cursor_position: Point,
    messages: &mut Vec<Message>,
    _renderer: &Renderer,
    _clipboard: Option<&dyn Clipboard>
)

Processes a runtime [Event].

fn draw(
    &self,
    renderer: &mut Renderer,
    _defaults: &Renderer::Defaults,
    layout: Layout,
    cursor_position: Point
) -> Renderer::Output

Draws the [Widget] using the associated Renderer.

fn hash_layout(&self, state: &mut Hasher)

Computes the layout hash of the [Widget].