Dialog API 1.0

It's simple - UNCONTROLLABLE DIALOGS! Dialogs of this type are created with either Dialog or DialogEx function call with the DlgProc parameter set to NULL.

This style defines the following dialog behavior:

• any changes in control element state become known to the plugin only after dialog is closed;
• dialog is closed when user presses one of the following keys: Esc, Ctrl-Enter, Enter (pressing Enter closes the dialog regardless of which control element has the focus, with the exception of edit boxes with DIF_EDITOR flag set), or clicks a mouse button beyond the dialog bounds.
• This style is intended for simple dialogs.

This is the most interesting style. Plugin has ultimate control over the dialog.

• dialog has its own callback function which reacts to a lot of messages sent by the Dialog Manager;
• the callback function communicates with the Dialog Manager by sending messages with the SendDlgMessage function;
• the callback function can delegate control to the Dialog Manager with the DefDlgProc function;
• when user tries to interact with inaccessible FAR Manager objects, clicking mouse buttons outside the dialog, the Dialog Manager warns him/her with beeps.
• the plugin is in control of the dialog session ending.
• this style is intended for dialogs implementing complex user interaction logic.

If one simply delegates control to the kernel in a dialog callback function with the DefDlgProc function call, then one gets simple About-styled dialog:

// dialog callback function with minimal code
LONG_PTR WINAPI MyDlgProc(HANDLE hDlg,int Msg,int Param1,LONG_PTR Param2)
{
  return Info.DefDlgProc(hDlg,Msg,Param1,Param2);
}

Functions
Structures
Macros and types
Dialog elements
Dialog element flags
Events and Messages
Input focus
Working with lists

To get more familiar with the Dialog API see the dialog.cpp file from "Reversi" plugin sources.