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
/* * Copyright (c) 2017 Boucher, Antoni <bouanto@zoho.com> * * Permission is hereby granted, free of charge, to any person obtaining a copy of * this software and associated documentation files (the "Software"), to deal in * the Software without restriction, including without limitation the rights to * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of * the Software, and to permit persons to whom the Software is furnished to do so, * subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all * copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ /// Connect events to sending a message. /// /// Rule #1: /// Send `$msg` to `$other_component` when the GTK+ `$event` is emitted on `$widget`. /// /// Rule #2: /// Optionally send `$msg.0` when the GTK+ `$event` is emitted on `$widget`. /// Return `$msg.1` in the GTK+ callback. /// This variant gives more control to the caller since it expects a `$msg` returning `(Option<MSG>, /// ReturnValue)` where the `ReturnValue` is the value to return in the GTK+ callback. /// Option<MSG> can be None if no message needs to be emitted. /// /// Rule #3: /// Send `$msg` when the GTK+ `$event` is emitted on `$widget`. /// /// Rule #4: /// Send `$msg` to `$widget` when the `$message` is received on `$stream`. #[macro_export] macro_rules! connect { // Connect to a GTK+ widget event, sending a message to another widget. ($widget:expr, $event:ident($($args:pat),*), $other_component:expr, $msg:expr) => { connect_stream!($widget, $event($($args),*), $other_component.stream(), $msg); }; // Connect to a GTK+ widget event. // This variant gives more control to the caller since it expects a `$msg` returning (Option<MSG>, // ReturnValue) where the ReturnValue is the value to return in the GTK+ callback. // Option<MSG> can be None if no message needs to be emitted. ($relm:expr, $widget:expr, $event:ident($($args:pat),*), return $msg:expr) => {{ connect_stream!(return $relm.stream(), $widget, $event($($args),*), $msg); }}; // Connect to a GTK+ widget event. ($relm:expr, $widget:expr, $event:ident($($args:pat),*), $msg:expr) => {{ let stream = $relm.stream().clone(); let _ = $widget.$event(move |$($args),*| { let msg: Option<_> = $crate::IntoOption::into_option($msg); if let Some(msg) = msg { stream.emit(msg); } }); }}; // Connect to a message reception. // TODO: create another macro rule accepting multiple patterns. ($src_component:ident @ $message:pat, $dst_component:expr, $msg:expr) => { let stream = $src_component.stream().clone(); connect_stream!(stream@$message, $dst_component.stream(), $msg); }; } /// Connect events to sending a message. /// Similar to `connect!` but wants a stream instead of a component. /// /// Rule #1: /// Send `$msg` to `$other_stream` when the GTK+ `$event` is emitted on `$widget`. /// /// Rule #2: /// Send `$msg` to `$widget` when the `$message` is received on `$stream`. #[macro_export] macro_rules! connect_stream { // Connect to a GTK+ widget event. // This variant gives more control to the caller since it expects a `$msg` returning (Option<MSG>, // ReturnValue) where the ReturnValue is the value to return in the GTK+ callback. // Option<MSG> can be None if no message needs to be emitted. (return $stream:expr, $widget:expr, $event:ident($($args:pat),*), $msg:expr) => {{ let stream = $stream.clone(); let _ = $widget.$event(move |$($args),*| { let (msg, return_value) = $crate::IntoPair::into_pair($msg); let msg: Option<_> = $crate::IntoOption::into_option(msg); if let Some(msg) = msg { stream.emit(msg); } return_value }); }}; // Connect to a GTK+ widget event, sending a message to another widget. ($widget:expr, $event:ident($($args:pat),*), $other_stream:expr, $msg:expr) => { let stream = $other_stream.clone(); let _ = $widget.$event(move |$($args),*| { let msg: Option<_> = $crate::IntoOption::into_option($msg); if let Some(msg) = msg { stream.emit(msg); } }); }; // Connect to a message reception. // TODO: create another macro rule accepting multiple patterns. ($src_stream:ident @ $message:pat, $dst_stream:expr, $msg:expr) => { let stream = $dst_stream.clone(); $src_stream.observe(move |msg| { #[allow(unreachable_patterns)] match msg { &$message => { let msg: Option<_> = $crate::IntoOption::into_option($msg); if let Some(msg) = msg { stream.emit(msg); } }, _ => (), } }); }; }