de data dialog()

de_data_dialog()

Displays a scrollable multiline text editor. Returns: none.

Syntax:

de_data_dialog (title, dataStr, editable, okCB, [userData]);

where

title is the dialog box title.

dataStr is the initial text to display in the dialog box.

editable indicates whether text is editable, where:

0 = text is not editable

1 = text is editable

okCB is the AEL function to execute when OK is pressed. If this is Null, then userData needs to specify a function which expects 1 string argument ( See Example 2 )

userData is optional; the AEL function executed when OK is selected. This function expects 1 string argument, dataStr. It will unmanage the data dialog.

Example 1: unmanage the dlg in the specified callback

// prints the text in the data dialog to stderr
 defun print_data_dialog_text_stderr(okH, dlgH, winInst)
 {
     decl infoH, text;
     infoH = api_dlg_find_item(dlgH, DE_TEXT_EDIT_PRINT_ITEM);
     api_dlg_get_resources(infoH, API_RN_VALUE, &text);
     fputs(stderr, text);
     api_dlg_unmanage(dlgH);  // this is required when a callback func
                               // is specified as the 4th arg
                               // in 'de_data_dialog'
 }
 de_data_dialog("Date/Time Editor", "Date:12/12/94\n Time: 12:00PM\n",
 1, "print_data_dialog_text_stderr");

Example 2: using NULL as the 4th arg in de_data_dialog

// prints the text in the data dialog to stderr
// dataStr is the text from the dialog box (the second parameter to
// 'de_data_dialog')
 defun print_data_dialog_text_stderr(dataStr)
{
     fputs(stderr, dataStr);
     // api_dlg_unmanage is not required when a func is
     // specified as the 5th arg in 'de_data_dialog' and the 4th arg is
     // NULL
 }
 de_data_dialog("Date/Time Editor", "Date:12/12/94\n Time: 12:00PM\n",
 1, NULL, "print_data_dialog_text_stderr");

Download Example File:

The following link(s) lead to the Agilent EEsof EDA Knowledge center website. You will need to register at this site with a valid support contract to download an example file.

Get Path Info
Netlist with Node Names

Where Used:

Graphical user interface