Struct fltk::browser::Browser

pub struct Browser { /* fields omitted */ }

Creates a normal browser. Example usage:

use fltk::*;
let mut b = browser::Browser::new(10, 10, 900 - 20, 300 - 20, "");
let widths = &[50, 50, 50, 70, 70, 40, 40, 70, 70, 50];
b.set_column_widths(widths);
b.set_column_char('\t');
b.add("USER\tPID\t%CPU\t%MEM\tVSZ\tRSS\tTTY\tSTAT\tSTART\tTIME\tCOMMAND");
b.add("root\t2888\t0.0\t0.0\t1352\t0\ttty3\tSW\tAug15\t0:00\t@b@f/sbin/mingetty tty3");
b.add("erco\t2889\t0.0\t13.0\t221352\t0\ttty3\tR\tAug15\t1:34\t@b@f/usr/local/bin/render a35 0004");
b.add("uucp\t2892\t0.0\t0.0\t1352\t0\tttyS0\tSW\tAug15\t0:00\t@b@f/sbin/agetty -h 19200 ttyS0 vt100");
b.add("root\t13115\t0.0\t0.0\t1352\t0\ttty2\tSW\tAug30\t0:00\t@b@f/sbin/mingetty tty2");
b.add(
    "root\t13464\t0.0\t0.0\t1352\t0\ttty1\tSW\tAug30\t0:00\t@b@f/sbin/mingetty tty1 --noclear",
);

Trait Implementations

impl BrowserExt for Browser

fn remove(&mut self, line: u32)

Removes the specified line Lines start at 1

fn add(&mut self, item: &str)

Adds an item

fn insert(&mut self, line: u32, item: &str)

Inserts an item at an index Lines start at 1

fn move_item(&mut self, to: u32, from: u32)

Moves an item Lines start at 1

fn swap(&mut self, a: u32, b: u32)

Swaps 2 items Lines start at 1

fn clear(&mut self)

Clears the browser widget

fn size(&self) -> u32

Returns the number of items

fn set_size(&mut self, w: i32, h: i32)

Set the number of items

fn select(&mut self, line: u32)

Select an item at the specified line Lines start at 1

fn selected(&self, line: u32) -> bool

Returns whether the item is selected Lines start at 1

fn text(&self, line: u32) -> Option<String>

Returns the text of the selected item Lines start at 1

fn set_text(&mut self, line: u32, txt: &str)

Sets the text of the selected item Lines start at 1

fn load<P: AsRef<Path>>(&mut self, path: P) -> Result<(), FltkError>

Load a file

fn text_size(&self) -> u32

Return the text size

fn set_text_size(&mut self, c: u32)

Sets the text size Lines start at 1

fn set_icon<Img: ImageExt>(&mut self, line: u32, image: Option<Img>)

Sets the icon for browser elements Lines start at 1

fn icon(&self, line: u32) -> Option<Box<dyn ImageExt>>

Returns the icon of a browser element Lines start at 1

fn remove_icon(&mut self, line: u32)

Removes the icon of a browser element Lines start at 1

fn top_line(&mut self, line: u32)

Scrolls the browser so the top item in the browser is showing the specified line Lines start at 1

fn bottom_line(&mut self, line: u32)

Scrolls the browser so the bottom item in the browser is showing the specified line Lines start at 1

fn middle_line(&mut self, line: u32)

Scrolls the browser so the middle item in the browser is showing the specified line Lines start at 1

fn format_char(&self) -> char

Gets the current format code prefix character, which by default is ‘@’ More info here

fn set_format_char(&mut self, c: char)

Sets the current format code prefix character to \p c. The default prefix is ’@ c should be ascii

fn column_char(&self) -> char

Gets the current column separator character. The default is ‘\t’

fn set_column_char(&mut self, c: char)

Sets the column separator to c. This will only have an effect if you also use set_column_widths() c should be ascii

fn column_widths(&self) -> Vec<i32>

Gets the current column width array

fn set_column_widths(&mut self, arr: &'static [i32])

Sets the current column width array

fn displayed(&self, line: u32) -> bool

Returns whether a certain line is displayed

fn make_visible(&mut self, line: u32)

Makes a specified line visible

fn position(&self) -> u32

Gets the vertical scroll position of the list as a pixel position

fn set_position(&mut self, pos: u32)

Sets the vertical scroll position of the list as a pixel position

fn hposition(&self) -> u32

Gets the horizontal scroll position of the list as a pixel position

fn set_hposition(&mut self, pos: u32)

Sets the horizontal scroll position of the list as a pixel position

fn has_scrollbar(&self) -> BrowserScrollbar

Returns the type of scrollbar associated with the browser

fn set_has_scrollbar(&mut self, mode: BrowserScrollbar)

Sets the type of scrollbar associated with the browser

fn scrollbar_size(&self) -> u32

Gets the scrollbar size

fn set_scrollbar_size(&mut self, new_size: u32)

Sets the scrollbar size

fn sort(&mut self)

Sorts the items of the browser

fn scrollbar(&self) -> Box<dyn ValuatorExt>

Returns the vertical scrollbar

fn hscrollbar(&self) -> Box<dyn ValuatorExt>

Returns the horizontal scrollbar

fn value(&self) -> u32

Returns the selected line, returns 0 if no line is selected

impl Clone for Browser

fn clone(&self) -> Browser

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Browser

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

Formats the value using the given formatter.

impl Default for Browser

fn default() -> Self

Returns the “default value” for a type.

impl Send for Browser

impl Sync for Browser

impl WidgetBase for Browser

fn new(x: i32, y: i32, width: i32, height: i32, title: &str) -> Browser

Creates a new widget, takes an x, y coordinates, as well as a width and height, plus a title

fn delete(wid: Self)

Deletes widgets and their children.

unsafe fn from_widget_ptr(ptr: *mut Fl_Widget) -> Self

transforms a widget pointer to a Widget, for internal use

unsafe fn from_widget<W: WidgetExt>(w: W) -> Self

Get a widget from base widget

fn handle<F: FnMut(Event) -> bool + 'static>(&mut self, cb: F)

Set a custom handler, where events are managed manually, akin to Fl_Widget::handle(int) Handled or ignored events shoult return true, unhandled events should return false

fn handle2<F: FnMut(&mut Self, Event) -> bool + 'static>(&mut self, cb: F)

Set a custom handler, where events are managed manually, akin to Fl_Widget::handle(int) Handled or ignored events shoult return true, unhandled events should return false takes the widget as a closure argument

fn draw<F: FnMut() + 'static>(&mut self, cb: F)

Set a custom draw method MacOS requires that WidgetBase::draw actually calls drawing functions

fn draw2<F: FnMut(&mut Self) + 'static>(&mut self, cb: F)

Set a custom draw method takes the widget as a closure argument MacOS requires that WidgetBase::draw actually calls drawing functions

unsafe fn draw_data(&mut self) -> Option<Box<dyn FnMut()>>

INTERNAL: Retrieve the draw data

unsafe fn handle_data(&mut self) -> Option<Box<dyn FnMut(Event) -> bool>>

INTERNAL: Retrieve the handle data

impl WidgetExt for Browser

fn set_pos(&mut self, x: i32, y: i32)

Set to position x, y

fn set_size(&mut self, width: i32, height: i32)

Set to dimensions width and height

fn set_label(&mut self, title: &str)

Sets the widget’s label labels support special symbols preceded by an @ sign and for the associated formatting.

fn redraw(&mut self)

Redraws a widget, necessary for resizing and changing positions

fn show(&mut self)

Shows the widget

fn hide(&mut self)

Hides the widget

fn x(&self) -> i32

Returns the x coordinate of the widget

fn y(&self) -> i32

Returns the y coordinate of the widget

fn width(&self) -> i32

Returns the width of the widget

fn height(&self) -> i32

Returns the height of the widget

fn label(&self) -> String

Returns the label of the widget

fn measure_label(&self) -> (i32, i32)

Measures the label’s width and height

unsafe fn as_widget_ptr(&self) -> *mut Fl_Widget

transforms a widget to a base Fl_Widget, for internal use

fn activate(&mut self)

Activates the widget

fn deactivate(&mut self)

Deactivates the widget

fn redraw_label(&mut self)

Redraws the label of the widget

fn resize(&mut self, x: i32, y: i32, width: i32, height: i32)

Resizes and/or moves the widget, takes x, y, width and height

fn tooltip(&self) -> Option<String>

Returns the tooltip text

fn set_tooltip(&mut self, txt: &str)

Sets the tooltip text

fn color(&self) -> Color

Returns the widget color

fn set_color(&mut self, color: Color)

Sets the widget’s color

fn label_color(&self) -> Color

Returns the widget label’s color

fn set_label_color(&mut self, color: Color)

Sets the widget label’s color

fn label_font(&self) -> Font

Returns the widget label’s font

fn set_label_font(&mut self, font: Font)

Sets the widget label’s font

fn label_size(&self) -> i32

Returns the widget label’s size

fn set_label_size(&mut self, sz: i32)

Sets the widget label’s size

fn label_type(&self) -> LabelType

Returns the widget label’s type

fn set_label_type(&mut self, typ: LabelType)

Sets the widget label’s type

fn frame(&self) -> FrameType

Returns the widget’s frame type

fn set_frame(&mut self, typ: FrameType)

Sets the widget’s frame type

fn changed(&self) -> bool

Returns whether the widget was changed

fn set_changed(&mut self)

Mark the widget as changed

fn clear_changed(&mut self)

Clears the changed status of the widget

fn align(&self) -> Align

Returns the alignment of the widget

fn set_align(&mut self, align: Align)

Sets the alignment of the widget

fn set_trigger(&mut self, trigger: CallbackTrigger)

Sets the default callback trigger for a widget

fn trigger(&self) -> CallbackTrigger

Return the callback trigger

fn parent(&self) -> Option<Box<dyn GroupExt>>

Returns the parent of the widget

fn selection_color(&mut self) -> Color

Gets the selection color of the widget

fn set_selection_color(&mut self, color: Color)

Sets the selection color of the widget

fn do_callback(&mut self)

Runs the already registered callback

fn window(&self) -> Option<Box<dyn WindowExt>>

Returns the direct window holding the widget

fn top_window(&self) -> Option<Box<dyn WindowExt>>

Returns the topmost window holding the widget

fn takes_events(&self) -> bool

Checks whether a widget is capable of taking events

unsafe fn user_data(&self) -> Option<Box<dyn FnMut()>>

INTERNAL: Retakes ownership of the user callback data

fn take_focus(&mut self) -> Result<(), FltkError>

Make the widget take focus

fn set_visible_focus(&mut self)

Set the widget to have visible focus

fn clear_visible_focus(&mut self)

Clear visible focus

fn visible_focus(&mut self, v: bool)

Set the visible focus using a flag

fn has_visible_focus(&mut self) -> bool

Return whether the widget has visible focus

fn was_deleted(&self) -> bool

Check if a widget was deleted

fn damage(&self) -> bool

Return whether the widget was damaged

fn set_damage(&mut self, flag: bool)

Signal the widget as damaged and it should be redrawn in the next event loop cycle

fn clear_damage(&mut self)

Clear the damaged flag

fn as_window(&self) -> Option<Box<dyn WindowExt>>

Return the widget as a window if it’s a window

fn as_group(&self) -> Option<Box<dyn GroupExt>>

Return the widget as a group widget if it’s a group widget

fn below_of<W: WidgetExt>(self, w: &W, padding: i32) -> Self

Positions the widget below w, the size of w should be known

fn above_of<W: WidgetExt>(self, w: &W, padding: i32) -> Self

Positions the widget above w, the size of w should be known

fn right_of<W: WidgetExt>(self, w: &W, padding: i32) -> Self

Positions the widget to the right of w, the size of w should be known

fn left_of<W: WidgetExt>(self, w: &W, padding: i32) -> Self

Positions the widget to the left of w, the size of w should be known

fn center_of<W: WidgetExt>(self, w: &W) -> Self

Positions the widget to the center of w, the size of w should be known

fn size_of<W: WidgetExt>(self, w: &W) -> Self

Takes the size of w, the size of w should be known

fn inside<W: WidgetExt>(&self, wid: &W) -> bool

Checks whether the self widget is inside another widget

fn with_pos(self, x: i32, y: i32) -> Self

Initialize to position x, y, (should only be called on initialization)

fn with_size(self, width: i32, height: i32) -> Self

Initialilze to dimensions width and height, (should only be called on initialization)

fn with_label(self, title: &str) -> Self

Initialize with label/title, (should only be called on initialization)

fn with_align(self, align: Align) -> Self

Sets the initial alignment of the widget, (should only be called on initialization)

fn get_type<T: WidgetType>(&self) -> T

Returns the widget type when applicable

fn set_type<T: WidgetType>(&mut self, typ: T)

Sets the widget type

fn set_image<I: ImageExt>(&mut self, image: Option<I>)

Sets the image of the widget

fn image(&self) -> Option<Box<dyn ImageExt>>

Gets the image associated with the widget

fn set_deimage<I: ImageExt>(&mut self, image: Option<I>)

Sets the image of the widget

fn deimage(&self) -> Option<Box<dyn ImageExt>>

Gets the image associated with the widget

fn set_callback<F: FnMut() + 'static>(&mut self, cb: F)

Sets the callback when the widget is triggered (clicks for example)

fn set_callback2<F: FnMut(&mut Self) + 'static>(&mut self, cb: F)

Sets the callback when the widget is triggered (clicks for example) takes the widget as a closure argument

fn emit<T: 'static + Clone + Send + Sync>(&mut self, sender: Sender<T>, msg: T)

Emits a message on callback using a sender

unsafe fn into_widget<W: WidgetBase>(&self) -> W where
    Self: Sized, 

Upcast a WidgetExt to a Widget

fn visible(&self) -> bool

Returns whether a widget is visible

fn visible_r(&self) -> bool

Returns whether a widget or any of its parents are visible (recursively)