mirror of
https://github.com/FliegendeWurst/cursive.git
synced 2024-11-23 17:35:00 +00:00
Update Cursive::find_id doc comment
Mention SelectView and the need to get the type right.
This commit is contained in:
parent
48d0aea92e
commit
44ddfc7abf
@ -470,6 +470,28 @@ impl Cursive {
|
|||||||
/// view.set_content("bar");
|
/// view.set_content("bar");
|
||||||
/// ```
|
/// ```
|
||||||
///
|
///
|
||||||
|
/// Note that you must specify the exact type for the view you're after; for example, using the
|
||||||
|
/// wrong item type in a `SelectView` will not find anything:
|
||||||
|
///
|
||||||
|
/// ```rust
|
||||||
|
/// # use cursive::Cursive;
|
||||||
|
/// # use cursive::views::{SelectView};
|
||||||
|
/// # let mut siv = Cursive::dummy();
|
||||||
|
/// use cursive::traits::Identifiable;
|
||||||
|
///
|
||||||
|
/// let select = SelectView::new().item("zero", 0u32).item("one", 1u32);
|
||||||
|
/// siv.add_layer(select.with_id("select"));
|
||||||
|
///
|
||||||
|
/// // Specifying a wrong type will not return anything.
|
||||||
|
/// assert!(siv.find_id::<SelectView<String>>("select").is_none());
|
||||||
|
///
|
||||||
|
/// // Omitting the type will use the default type, in this case `String`.
|
||||||
|
/// assert!(siv.find_id::<SelectView>("select").is_none());
|
||||||
|
///
|
||||||
|
/// // But with the correct type, it works fine.
|
||||||
|
/// assert!(siv.find_id::<SelectView<u32>>("select").is_some());
|
||||||
|
/// ```
|
||||||
|
///
|
||||||
/// [`IdView`]: views/struct.IdView.html
|
/// [`IdView`]: views/struct.IdView.html
|
||||||
/// [`ViewRef`]: views/type.ViewRef.html
|
/// [`ViewRef`]: views/type.ViewRef.html
|
||||||
pub fn find_id<V>(&mut self, id: &str) -> Option<views::ViewRef<V>>
|
pub fn find_id<V>(&mut self, id: &str) -> Option<views::ViewRef<V>>
|
||||||
|
Loading…
Reference in New Issue
Block a user