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
/* * 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. */ /// 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) => { let stream = $other_component.stream().clone(); $widget.$event(move |$($args),*| { stream.emit($msg); }); }; // Connect to a GTK+ widget event. ($relm:expr, $widget:expr, $event:ident($($args:pat),*), $msg:expr) => {{ let stream = $relm.stream().clone(); $widget.$event(move |$($args),*| { stream.emit($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),*) $msg:expr) => {{ let stream = $relm.stream().clone(); $widget.$event(move |$($args),*| { let (msg, return_value) = $msg; let msg: Option<_> = msg.into(); if let Some(msg) = msg { stream.emit(msg); } return_value }); }}; // Connect to a message reception. // TODO: create another macro rule accepting multiple patterns. ($src_component:ident @ $message:pat, $dst_component:ident, $msg:expr) => { let stream = $dst_component.stream().clone(); $src_component.stream().observe(move |msg| { #[allow(unreachable_patterns)] match msg { $message => { stream.emit($msg); }, _ => (), } }); }; }