zng_wgt_input/cmd.rs
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 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153
//! Common commands.
//!
use zng_ext_clipboard::{COPY_CMD, CUT_CMD, PASTE_CMD};
use zng_wgt::{prelude::*, ICONS};
command! {
/// Represents the **new** action.
///
/// The command parameter can identify the new item type, otherwise the default (or single) type
/// must be used.
pub static NEW_CMD = {
l10n!: true,
name: "New",
shortcut: [shortcut!(CTRL+'N'), shortcut!(New)],
};
/// Represents the **open** action.
///
/// The command parameter can be an item path to open (like a `PathBuf`), otherwise the
/// command implementer must identify the item, either by context or by prompting the user.
pub static OPEN_CMD = {
l10n!: true,
name: "Open…",
shortcut: [shortcut!(CTRL+'O'), shortcut!(Open)],
icon: wgt_fn!(|_| ICONS.get("file-open")),
};
/// Represents the **save** action.
///
/// Usually this saves to the already defined item path (open or previous save path),
/// otherwise the user is prompted like [`SAVE_AS_CMD`].
pub static SAVE_CMD = {
l10n!: true,
name: "Save",
shortcut: [shortcut!(CTRL+'S'), shortcut!(Save)],
icon: wgt_fn!(|_| ICONS.get("save")),
};
/// Represents the **save-as** action.
///
/// Usually this prompts the user for a save path, even if a previous path is already known.
pub static SAVE_AS_CMD = {
l10n!: true,
name: "Save As…",
shortcut: [shortcut!(CTRL|SHIFT+'S')],
};
/// Represents the **context menu open** action.
pub static CONTEXT_MENU_CMD = {
shortcut: [shortcut!(SHIFT+F10), shortcut!(ContextMenu)],
icon: wgt_fn!(|_| ICONS.get(["context-menu", "menu-open"])),
};
/// Represents the **open settings** action.
///
/// Settings is an editor for a selection of app configs.
///
/// # Parameter
///
/// The parameter can be a `Txt` that can match a `ConfigKey` or config metadata
/// such as the display name or description.
pub static SETTINGS_CMD = {
l10n!: true,
name: "Settings",
shortcut: [shortcut!(CTRL+',')],
icon: wgt_fn!(|_| ICONS.get("settings")),
};
}
command_property! {
/// On new command.
///
/// Receives [`NEW_CMD`] command events scoped on the widget. The command parameter can be
/// the new item type identifier.
pub fn new {
cmd: NEW_CMD.scoped(WIDGET.id()),
}
/// On open command.
///
/// Receives [`OPEN_CMD`] command events scoped on the widget. The command parameter can be
/// a path to open, otherwise the path must be derived from context or the user prompted.
///
/// You can use [`WINDOWS.native_file_dialog`] to prompt the user for a file or folder path.
///
/// [`WINDOWS.native_file_dialog`]: zng_ext_window::WINDOWS::native_file_dialog
pub fn open {
cmd: OPEN_CMD.scoped(WIDGET.id()),
}
/// On save command.
///
/// Receives [`SAVE_CMD`] command events scoped on the widget. Usually saves to the last
/// open or save path, otherwise prompt the user like [`on_save_as`].
///
/// You can use [`WINDOWS.native_file_dialog`] to prompt the user for a file or folder path.
///
/// [`WINDOWS.native_file_dialog`]: zng_ext_window::WINDOWS::native_file_dialog
/// [`on_save_as`]: fn@on_save_as
pub fn save {
cmd: SAVE_CMD.scoped(WIDGET.id()),
}
/// On save-as command.
///
/// Receives [`SAVE_AS_CMD`] command events scoped on the widget. Usually prompts the user for
/// a new save path.
///
/// You can use [`WINDOWS.native_file_dialog`] to prompt the user for a file or folder path.
///
/// [`WINDOWS.native_file_dialog`]: zng_ext_window::WINDOWS::native_file_dialog
pub fn save_as {
cmd: SAVE_AS_CMD.scoped(WIDGET.id()),
}
/// On cut command.
///
/// Receives [`CUT_CMD`] command events scoped on the widget. You can use the `CLIPBOARD` service
/// to send data to the clipboard.
///
/// [`CUT_CMD`]: zng_ext_clipboard::CUT_CMD
pub fn cut {
cmd: CUT_CMD.scoped(WIDGET.id()),
}
/// On copy command.
///
/// Receives [`COPY_CMD`] command events scoped on the widget. You can use the `CLIPBOARD` service
/// to send data to the clipboard.
///
/// [`COPY_CMD`]: zng_ext_clipboard::COPY_CMD
pub fn copy {
cmd: COPY_CMD.scoped(WIDGET.id()),
}
/// On paste command.
///
/// Receives [`PASTE_CMD`] command events scoped on the widget. You can use the `CLIPBOARD` service
/// to receive data from the clipboard.
///
/// [`PASTE_CMD`]: zng_ext_clipboard::PASTE_CMD
pub fn paste {
cmd: PASTE_CMD.scoped(WIDGET.id()),
}
/// On settings command.
///
/// Receives [`SETTINGS_CMD`] command events scoped on the widget.
pub fn settings {
cmd: SETTINGS_CMD.scoped(WIDGET.id()),
}
}