A Dialog is an interactive set of windows allowing the user to perform some task. More...
Functions | |
static bool | dlg_alias (struct Buffer *buf, struct AliasMenuData *mdata) |
Display a menu of Aliases -. | |
static bool | dlg_query (struct Buffer *buf, struct AliasMenuData *mdata) |
Get the user to enter an Address Query -. | |
void | dlg_attachment (struct ConfigSubset *sub, struct MailboxView *mv, struct Email *e, FILE *fp, bool attach_msg) |
Show the attachments in a Menu -. | |
void | dlg_autocrypt (void) |
Display the Autocrypt account Menu -. | |
void | dlg_browser (struct Buffer *file, SelectFileFlags flags, struct Mailbox *m, char ***files, int *numfiles) |
Let the user select a file -. | |
int | dlg_compose (struct Email *e, struct Buffer *fcc, uint8_t flags, struct ConfigSubset *sub) |
Allow the user to edit the message envelope -. | |
int | dlg_certificate (const char *title, struct CertArray *carr, bool allow_always, bool allow_skip) |
Ask the user to validate the certificate -. | |
void | dlg_history (char *buf, size_t buflen, char **matches, int match_count) |
Select an item from a history list -. | |
struct Mailbox * | dlg_index (struct MuttWindow *dlg, struct Mailbox *m_init) |
Display a list of emails -. | |
struct CryptKeyInfo * | dlg_gpgme (struct CryptKeyInfo *keys, struct Address *p, const char *s, unsigned int app, bool *forced_valid) |
Get the user to select a key -. | |
struct PgpKeyInfo * | dlg_pgp (struct PgpKeyInfo *keys, struct Address *p, const char *s) |
Let the user select a key to use -. | |
struct SmimeKey * | dlg_smime (struct SmimeKey *keys, const char *query) |
Get the user to select a key -. | |
int | dlg_pager (struct PagerView *pview) |
Display an email, attachment, or help, in a window -. | |
bool | dlg_pattern (char *buf, size_t buflen) |
Show menu to select a Pattern -. | |
struct Email * | dlg_postponed (struct Mailbox *m) |
Create a Menu to select a postponed message -. | |
A Dialog is an interactive set of windows allowing the user to perform some task.
The All Dialogs window is a container window and not visible. All active dialogs will be children of this window, though only one will be active at a time.
Name | Type | Constructor |
---|---|---|
All Dialogs | WT_ALL_DIALOGS | alldialogs_new() |
Parent
Children
The All Dialogs window has many possible children, e.g.
The All Dialogs window has no data.
Once constructed, it is controlled by the following events:
Event Type | Handler |
---|---|
NT_WINDOW | alldialogs_window_observer() |
The All Dialogs window does not implement MuttWindow::recalc() or MuttWindow::repaint().
|
static |
Display a menu of Aliases -.
true | Selection was made |
The Alias Dialog is an Address Book. The user can select addresses to add to an Email.
Definition at line 371 of file dlg_alias.c.
|
static |
Get the user to enter an Address Query -.
true | Selection was made |
The Select Query Dialog is an Address Book. It is dynamically created from an external source using $query_command.
The user can select addresses to add to an Email.
Definition at line 421 of file dlg_query.c.
void dlg_attachment | ( | struct ConfigSubset * | sub, |
struct MailboxView * | mv, | ||
struct Email * | e, | ||
FILE * | fp, | ||
bool | attach_msg | ||
) |
Show the attachments in a Menu -.
sub | Config Subset |
mv | Mailbox view |
e | |
fp | File with the content of the email, or NULL |
attach_msg | Are we in "attach message" mode? |
The Select Attachment dialog shows an Email's attachments. They can be viewed using the Pager or Mailcap programs. They can also be saved, printed, deleted, etc.
Definition at line 539 of file dlg_attach.c.
void dlg_autocrypt | ( | void | ) |
Display the Autocrypt account Menu -.
The Autocrypt Dialog lets the user select an Autocrypt Account to use.
Definition at line 328 of file dlg_autocrypt.c.
void dlg_browser | ( | struct Buffer * | file, |
SelectFileFlags | flags, | ||
struct Mailbox * | m, | ||
char *** | files, | ||
int * | numfiles | ||
) |
Let the user select a file -.
[in] | file | Buffer for the result |
[in] | flags | Flags, see SelectFileFlags |
[in] | m | Mailbox |
[out] | files | Array of selected files |
[out] | numfiles | Number of selected files |
The Select File Dialog is a file browser. It allows the user to select a file or directory to use.
Definition at line 1295 of file dlg_browser.c.
int dlg_compose | ( | struct Email * | e, |
struct Buffer * | fcc, | ||
uint8_t | flags, | ||
struct ConfigSubset * | sub | ||
) |
Allow the user to edit the message envelope -.
e | Email to fill |
fcc | Buffer to save FCC |
flags | Flags, e.g. MUTT_COMPOSE_NOFREEHEADER |
sub | ConfigSubset |
1 | Message should be postponed |
0 | Normal exit |
-1 | Abort message |
The Compose Dialog allows the user to edit the email envelope before sending.
Definition at line 305 of file dlg_compose.c.
int dlg_certificate | ( | const char * | title, |
struct CertArray * | carr, | ||
bool | allow_always, | ||
bool | allow_skip | ||
) |
Ask the user to validate the certificate -.
title | Menu title |
carr | Certificate text to display |
allow_always | If true, allow the user to always accept the certificate |
allow_skip | If true, allow the user to skip the verification |
1 | Reject certificate (or menu aborted) |
2 | Accept certificate once |
3 | Accept certificate always/skip (see notes) |
4 | Accept certificate skip |
The Verify Certificate Dialog shows a list of signatures for a domain certificate. They can choose whether to accept or reject it.
The possible retvals will depend on the parameters. The options are given in the order: Reject, Once, Always, Skip. The retval represents the chosen option.
Definition at line 184 of file dlg_verifycert.c.
void dlg_history | ( | char * | buf, |
size_t | buflen, | ||
char ** | matches, | ||
int | match_count | ||
) |
Select an item from a history list -.
[in] | buf | Buffer in which to save string |
[in] | buflen | Buffer length |
[out] | matches | Items to choose from |
[in] | match_count | Number of items |
The History Dialog lets the user select from the history of commands, functions or files.
Definition at line 139 of file dlg_history.c.
struct Mailbox * dlg_index | ( | struct MuttWindow * | dlg, |
struct Mailbox * | m_init | ||
) |
Display a list of emails -.
dlg | Dialog containing Windows to draw on |
m_init | Initial mailbox |
ptr | Mailbox open in the index |
The Index Dialog is the heart of NeoMutt. From here, the user can read and reply to emails, organise them into folders, set labels, etc.
Definition at line 1070 of file dlg_index.c.
struct CryptKeyInfo * dlg_gpgme | ( | struct CryptKeyInfo * | keys, |
struct Address * | p, | ||
const char * | s, | ||
unsigned int | app, | ||
bool * | forced_valid | ||
) |
Get the user to select a key -.
[in] | keys | List of keys to select from |
[in] | p | Address to match |
[in] | s | Real name to display |
[in] | app | Flags, e.g. APPLICATION_PGP |
[out] | forced_valid | Set to true if user overrode key's validity |
ptr | Key selected by user |
The Select GPGME Key Dialog lets the user select a PGP Key to use.
Definition at line 636 of file dlg_gpgme.c.
struct PgpKeyInfo * dlg_pgp | ( | struct PgpKeyInfo * | keys, |
struct Address * | p, | ||
const char * | s | ||
) |
Let the user select a key to use -.
keys | List of PGP keys |
p | Address to match |
s | String to match |
ptr | Selected PGP key |
The Select PGP Key Dialog lets the user select an PGP Key to use.
Definition at line 628 of file dlg_pgp.c.
Get the user to select a key -.
keys | List of keys to select from |
query | String to match |
ptr | Key selected by user |
The Select SMIME Key Dialog lets the user select an SMIME Key to use.
Definition at line 200 of file dlg_smime.c.
int dlg_pager | ( | struct PagerView * | pview | ) |
Display an email, attachment, or help, in a window -.
pview | Pager view settings |
0 | Success |
-1 | Error |
The Pager Dialog displays an Email to the user.
They can navigate through the Email, search through it and user color
commands to highlight it.
From the Pager, the user can also use some Index functions, such as <next-entry>
or <delete>
.
This pager is actually not so simple as it once was. But it will be again. Currently it operates in 3 modes:
Definition at line 215 of file dlg_pager.c.
bool dlg_pattern | ( | char * | buf, |
size_t | buflen | ||
) |
Show menu to select a Pattern -.
true | A selection was made |
The Select Pattern Dialog shows the user a help page of Patterns. They can select one to auto-complete some functions, e.g. <limit>
Definition at line 342 of file dlg_pattern.c.
Create a Menu to select a postponed message -.
m | Mailbox |
ptr |
The Select Postponed Email Dialog shows the user a list of draft emails. They can select one to use in the Compose Dialog.
This dialog is only shown if there are two or more postponed emails.
Definition at line 208 of file dlg_postpone.c.