qtrs 0.4.0

qtrs - A type-safe, builder-pattern-driven Qt6 GUI library for Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78

//! Static convenience functions for input dialogs.
//!
//! Wraps static methods on
//! [`QInputDialog`](https://doc.qt.io/qt-6/qinputdialog.html).
//!
//! # Note
//!
//! These are pure static functions — there is no struct or builder pattern.

use cxx::let_cxx_string;

use crate::ffi;
use crate::widget::AsWidget;

/// Show a modal dialog asking the user to enter a string.
///
/// Returns the entered text, or an empty string if the user cancelled.
pub fn get_text(parent: Option<&dyn AsWidget>, title: &str, label: &str, default_text: &str) -> String {
    let parent_ptr = parent.map(|p| p.widget_ptr()).unwrap_or(std::ptr::null_mut());
    let_cxx_string!(c_title = title);
    let_cxx_string!(c_label = label);
    let_cxx_string!(c_default = default_text);
    unsafe { ffi::QInputDialog_getText(parent_ptr, &c_title, &c_label, &c_default) }
}

/// Show a modal dialog asking the user to enter an integer.
///
/// Returns `0` if the user cancelled.
pub fn get_int(
    parent: Option<&dyn AsWidget>,
    title: &str,
    label: &str,
    value: i32,
    min: i32,
    max: i32,
    step: i32,
) -> i32 {
    let parent_ptr = parent.map(|p| p.widget_ptr()).unwrap_or(std::ptr::null_mut());
    let_cxx_string!(c_title = title);
    let_cxx_string!(c_label = label);
    unsafe { ffi::QInputDialog_getInt(parent_ptr, &c_title, &c_label, value, min, max, step) }
}

/// Show a modal dialog asking the user to enter a floating-point number.
///
/// Returns `0.0` if the user cancelled.
pub fn get_double(
    parent: Option<&dyn AsWidget>,
    title: &str,
    label: &str,
    value: f64,
    min: f64,
    max: f64,
    decimals: i32,
) -> f64 {
    let parent_ptr = parent.map(|p| p.widget_ptr()).unwrap_or(std::ptr::null_mut());
    let_cxx_string!(c_title = title);
    let_cxx_string!(c_label = label);
    unsafe { ffi::QInputDialog_getDouble(parent_ptr, &c_title, &c_label, value, min, max, decimals) }
}

/// Show a modal dialog asking the user to pick an item from a list.
///
/// Returns the selected item text, or an empty string if the user cancelled.
pub fn get_item(
    parent: Option<&dyn AsWidget>,
    title: &str,
    label: &str,
    items: &[&str],
    current: i32,
    editable: bool,
) -> String {
    let parent_ptr = parent.map(|p| p.widget_ptr()).unwrap_or(std::ptr::null_mut());
    let_cxx_string!(c_title = title);
    let_cxx_string!(c_label = label);
    let items_vec: Vec<String> = items.iter().map(|s| s.to_string()).collect();
    unsafe { ffi::QInputDialog_getItem(parent_ptr, &c_title, &c_label, items_vec, current, editable) }
}