dialog.h File Reference

Dialog Widget. More...

#include "ntw.h"

Go to the source code of this file.

Functions
uint8	ntw_dialog_get_modal (ntwWidget *widget)
	Gets dialog's modal status.
char *	ntw_dialog_get_title (ntwWidget *widget)
	Gets dialog's title.
int	ntw_dialog_set_modal (ntwWidget *widget, uint8 modal)
	Sets dialog's modal status.
int	ntw_dialog_set_title (ntwWidget *widget, char *text)
	Sets dialog's title.
ntwWidget *	ntw_dialog_new (ntwWidget *parent, int32 width, int32 height, uint8 modal, char *title)
	Create dialog widget.

---

Detailed Description

Dialog Widget.

A dialog is a child window, usually used for simple yes/no/cancel user interaction. It can be made modal to force user interaction before the program continues. It can contain a single widget.

---

Function Documentation

uint8 ntw_dialog_get_modal (  ntwWidget *  widget  )

Gets dialog's modal status. Parameters: widget  Dialog widget Returns: TRUE if modal, FALSE if not

char* ntw_dialog_get_title (  ntwWidget *  widget  )

Gets dialog's title. Parameters: widget  Dialog widget Returns: Dialog widget's title string

ntwWidget* ntw_dialog_new (  ntwWidget *  parent, int32  width, int32  height, uint8  modal, char *  title )

Create dialog widget. A dialog is usually a modal window that takes the focus from the parent. Use it for simple yes/no/cancel user interaction. The width and height may be specified, but are not guaranteed. Parameters: parent  Parent window width  Width in pixels of dialog height  Height in pixels of dialog modal  TRUE if the dialog should steal focus from the parent, FALSE otherwise title  Title of the window (shown in the window titlebar) Returns: Newly created dialog widget

int ntw_dialog_set_modal (  ntwWidget *  widget, uint8  modal )

Sets dialog's modal status. Parameters: widget  dialog widget modal  TRUE or FALSE Returns: -1 on failure

int ntw_dialog_set_title (  ntwWidget *  widget, char *  text )

Sets dialog's title. Parameters: widget  dialog widget text  UTF-8 string to set title to Returns: -1 on failure

---