DI_SINGLEBOX
The DI_SINGLEBOX dialog item describes a single line frame.
struct FarDialogItem
{
int Type = DI_SINGLEBOX
int X1 = X1
int Y1 = Y1
int X2 = X2
int Y2 = Y2
int Focus = 0
int Selected = 0
DWORD Flags = Flags
int DefaultButton = 0
char Data[512] = Caption
};
Attention!
- This is an exemplary structure; read full description here.
Flags
There are several flags applicable to the DI_SINGLEBOX control:
| Flag | Description |
|---|---|
| DIF_SETCOLOR | The low byte of Flags will be used as the frame color. |
| DIF_LEFTTEXT | The caption of the frame will be left aligned. |
| DIF_SHOWAMPERSAND | Show ampersand symbol in caption instead of using it for defining hotkeys. |
Events
| Event | Description |
|---|---|
| DN_DRAWDLGITEM | This event is sent to the dialog callback function before the double line box is drawn. |
| DN_CTLCOLORDLGITEM | Plugin should pass the color attributes of the frame when this event comes. Param2 parameter:
LoWord LoByte - color of text in the caption
(COL_WARNDIALOGBOXTITLE or
COL_DIALOGBOXTITLE)
LoWord HiByte - color of highlighted text in the caption
(COL_WARNDIALOGHIGHLIGHTBOXTITLE or
COL_DIALOGHIGHLIGHTBOXTITLE)
HiWord LoByte - color of the frame lines
(COL_WARNDIALOGBOX or COL_DIALOGBOX)
HiWord HiByte - 0 (not used)
|
| DN_HOTKEY | Hotkey was pressed (Alt-<letter>). |
| DN_MOUSECLICK | This event comes after the user has clicked one of the dialog items or outside the dialog with the mouse button. |
Remarks
- If this item is the first in the dialog items array, its caption is copied into the FAR console window title.
- When X1==X2 or Y1==Y2, a line (vertical or horizontal) will be drawn instead of a frame.
See also: