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
//! Clipboard service, commands and other types.
//!
//! This module provides the [`CLIPBOARD`] service and clipboard related commands and command handlers.
//! The service does not implement the commands, widgets implement the commands and optionally use the service.
//!
//! Note that the [`CLIPBOARD`] service uses the view-process the interact with the system clipboard, so it will only
//! work if a headed app or headless app with renderer is running.
//!
//! # Text
//!
//! The example below uses the service to copy text to the clipboard:
//!
//! ```
//! use zng::prelude::*;
//!
//! # fn example() {
//! let txt = var(Txt::from(""));
//! let copied = var(false);
//! # let _ =
//! Container! {
//! child = TextInput!(txt.clone());
//! child_spacing = 5;
//! child_end = Button! {
//! child = Text!(copied.map(|&c| if !c { "Copy" } else { "Copied!" }.into()));
//! on_click = async_hn!(txt, copied, |_| {
//! if zng::clipboard::CLIPBOARD.set_text(txt.get()).wait_rsp().await.is_ok() {
//! copied.set(true);
//! }
//! });
//! };
//! }
//! # ; }
//! ```
//!
//! The `TextInput` widget also implements the clipboard commands, the example below requests clipboard paste to the
//! text input, that widget uses the clipboard service to get the text.
//!
//! ```
//! use zng::prelude::*;
//!
//! # fn example() {
//! # let _ =
//! Container! {
//! child = TextInput! {
//! id = "input-1";
//! txt = var(Txt::from(""));
//! };
//! child_spacing = 4;
//! child_end = Button!(zng::clipboard::PASTE_CMD.scoped(WidgetId::named("input-1")));
//! }
//! # ; }
//! ```
//!
//! # File List
//!
//! The example below modifies the paste button to paste file paths, the paths can be used to read or move
//! the each file, in the example they are converted to a text list.
//!
//! ```
//! use zng::prelude::*;
//!
//! # fn example() {
//! # let txt = var(Txt::from(""));
//! # let _ =
//! Button! {
//! child = Text!("Paste");
//! on_click = hn!(|_| {
//! if let Ok(Some(f)) = zng::clipboard::CLIPBOARD.paths() {
//! txt.modify(move |txt| {
//! let txt = txt.to_mut();
//! txt.clear();
//! for f in f {
//! use std::fmt::Write as _;
//! let _ = writeln!(txt, "{}", f.display());
//! }
//! });
//! }
//! });
//! }
//! # ; }
//! ```
//!
//! # Image
//!
//! The example below pastes an image from the clipboard. The example also demonstrates how to separate the
//! paste button from the paste action, the button only needs to know that the window handles the paste command,
//! the window implements the paste by setting an image variable.
//!
//! ```
//! use zng::clipboard;
//! use zng::prelude::*;
//!
//! # fn demo(img_source: Var<zng::image::ImageSource>) { let _ =
//! Window! {
//! child_top = Button!(clipboard::PASTE_CMD.scoped(WINDOW.id()));
//! child = Image!(img_source.clone());
//! clipboard::on_paste = hn!(|_| {
//! if let Ok(Some(img)) = clipboard::CLIPBOARD.image() {
//! img_source.set(img);
//! }
//! });
//! }
//! # ;}
//! ```
//!
//! # Full API
//!
//! See [`zng_ext_clipboard`] for the full clipboard API.
pub use ;
pub use ;