Struct pinentry::MessageDialog

pub struct MessageDialog<'a> { /* fields omitted */ }

A dialog for showing a message to the user.

Implementations

impl<'a> MessageDialog<'a>

pub fn with_default_binary() -> Option<Self>

Creates a new MessageDialog using the binary named pinentry.

Returns None if pinentry cannot be found in PATH.

pub fn with_binary<T: AsRef<OsStr>>(binary_name: T) -> Option<Self>

Creates a new MessageDialog using the given path to, or name of, a pinentry binary.

Returns None if:

• A path was provided that does not exist.
• A binary name was provided that cannot be found in PATH.
• The binary is found but is not executable.

pub fn with_title(&mut self, title: &'a str) -> &mut Self

Sets the window title.

When using this feature you should take care that the window is still identifiable as the pinentry.

pub fn with_ok(&mut self, ok: &'a str) -> &mut Self

Sets the text for the button signalling confirmation (the "OK" button).

You should use an underscore in the text only if you know that a modern version of pinentry is used. Modern versions underline the next character after the underscore and use the first such underlined character as a keyboard accelerator. Use a double underscore to escape an underscore.

pub fn with_timeout(&mut self, timeout: u16) -> &mut Self

Sets the timeout (in seconds) before returning an error.

pub fn show_message(&self, message: &str) -> Result<()>

Shows a message.