Newt Functions
소개
This is a PHP language extension for RedHat Newt library, a terminal-based window and widget library for writing applications with user friendly interface. Once this extension is enabled in PHP it will provide the use of Newt widgets, such as windows, buttons, checkboxes, radiobuttons, labels, editboxes, scrolls, textareas, scales, etc. Use of this extension if very similar to the original Newt API of C programming language.
요구 조건
This module uses the functions of the RedHat Newt library. You need libnewt version >= 0.51.0.
설치
이 » PECL 확장은 PHP 배포판에서 제공하지 않습니다. PECL 확장 설치에 관한 정보는 매뉴얼의 PECL 확장 설치에 있습니다. 새 릴리즈, 내려받기, 소스파일, 개발자 정보, CHANGELOG 등의 추가 정보는 여기에 있습니다: » https://pecl.php.net/package/newt.
PHP 4에서 이 PECL 확장의 소스는 PHP 소스의 ext/ 디렉토리 안이나, 위의 PECL 링크에서 찾을 수 있습니다. In order to use these functions you must compile CGI or CLI PHP with newt support by using the --with-newt[=DIR] configure option.
Note: This extension is not available for Windows platform.
You may need also curses and slang libraries, in order to compile this extension. To specify locations of these libraries, use the following configuration options: --with-curses-dir=/path/to/libcurses --with-slang-dir=/path/to/libslang
자원형
This extension uses two resource types: "newt component" and "newt grid". Resource type "newt component" is returned by functions, which create common newt widgets (for example: newt_button()) Resource type "newt grid" is a special link identifier for components, returned by newt grid factory functions (for example: newt_create_grid())
예약 상수
이 확장은 다음의 상수들을 정의합니다. 이 확장을 PHP에 내장했거나, 실행시에 동적으로 읽어들일 경우에만 사용할 수 있습니다.
Newt form exit reasons
constant | meaning |
---|---|
NEWT_EXIT_HOTKEY | hotkey defined by newt_form_add_hot_key() was pressed |
NEWT_EXIT_COMPONENT | some component has caused form to exit |
NEWT_EXIT_FDREADY | file descriptor specified in newt_form_watch_fd() is ready to be read or written to |
NEWT_EXIT_TIMER | time specified in newt_form_set_timer() has elapsed |
Newt colorsets
constant | meaning |
---|---|
NEWT_COLORSET_ROOT | |
NEWT_COLORSET_BORDER | |
NEWT_COLORSET_WINDOW | |
NEWT_COLORSET_SHADOW | |
NEWT_COLORSET_TITLE | |
NEWT_COLORSET_BUTTON | |
NEWT_COLORSET_ACTBUTTON | |
NEWT_COLORSET_CHECKBOX | |
NEWT_COLORSET_ACTCHECKBOX | |
NEWT_COLORSET_ENTRY | |
NEWT_COLORSET_LABEL | |
NEWT_COLORSET_LISTBOX | |
NEWT_COLORSET_ACTLISTBOX | |
NEWT_COLORSET_TEXTBOX | |
NEWT_COLORSET_ACTTEXTBOX | |
NEWT_COLORSET_HELPLINE | |
NEWT_COLORSET_ROOTTEXT | |
NEWT_COLORSET_ROOTTEXT | |
NEWT_COLORSET_EMPTYSCALE | |
NEWT_COLORSET_FULLSCALE | |
NEWT_COLORSET_DISENTRY | |
NEWT_COLORSET_COMPACTBUTTON | |
NEWT_COLORSET_ACTSELLISTBOX | |
NEWT_COLORSET_SELLISTBOX |
Newt argument flags
constant | meaning |
---|---|
NEWT_ARG_LAST | |
NEWT_ARG_APPEND |
Newt Flags Sense
constant | meaning |
---|---|
NEWT_FLAGS_SET | |
NEWT_FLAGS_RESET | |
NEWT_FLAGS_TOGGLE |
Newt Components Flags
constant | meaning |
---|---|
NEWT_FLAG_RETURNEXIT | Exit form, when component is activated |
NEWT_FLAG_HIDDEN | Component is hidden |
NEWT_FLAG_SCROLL | Component is scrollable |
NEWT_FLAG_DISABLED | Component is disabled |
NEWT_FLAG_BORDER | |
NEWT_FLAG_WRAP | Wrap text |
NEWT_FLAG_NOF12 | Don't exit form on pressing F12 |
NEWT_FLAG_MULTIPLE | |
NEWT_FLAG_SELECTED | Component is selected |
NEWT_FLAG_CHECKBOX | Component is checkbox |
NEWT_FLAG_PASSWORD | Entry component is password entry |
NEWT_FLAG_SHOWCURSOR | Show cursor |
File Descriptor Flags
constant | meaning |
---|---|
NEWT_FD_READ | |
NEWT_FD_WRITE | |
NEWT_FD_EXCEPT |
Checkbox Tree Flags
constant | meaning |
---|---|
NEWT_CHECKBOXTREE_UNSELECTABLE | |
NEWT_CHECKBOXTREE_HIDE_BOX | |
NEWT_CHECKBOXTREE_COLLAPSED | |
NEWT_CHECKBOXTREE_EXPANDED | |
NEWT_CHECKBOXTREE_UNSELECTED | |
NEWT_CHECKBOXTREE_SELECTED |
Entry Flags
constant | meaning |
---|---|
NEWT_ENTRY_SCROLL | |
NEWT_ENTRY_HIDDEN | |
NEWT_ENTRY_RETURNEXIT | |
NEWT_ENTRY_DISABLED |
Listbox Flags
constant | meaning |
---|---|
NEWT_LISTBOX_RETURNEXIT |
Textbox Flags
constant | meaning |
---|---|
NEWT_TEXTBOX_WRAP | Wrap text in the textbox |
NEWT_TEXTBOX_SCROLL | Scroll text in the textbox |
Form Flags
constant | meaning |
---|---|
NEWT_FORM_NOF12 | Don't exit form on F12 press |
Newt Keys
constant | meaning |
---|---|
NEWT_KEY_TAB | |
NEWT_KEY_ENTER | |
NEWT_KEY_SUSPEND | |
NEWT_KEY_ESCAPE | |
NEWT_KEY_RETURN | |
NEWT_KEY_EXTRA_BASE | |
NEWT_KEY_UP | |
NEWT_KEY_DOWN | |
NEWT_KEY_LEFT | |
NEWT_KEY_RIGHT | |
NEWT_KEY_BKSPC | |
NEWT_KEY_DELETE | |
NEWT_KEY_HOME | |
NEWT_KEY_END | |
NEWT_KEY_UNTAB | |
NEWT_KEY_PGUP | |
NEWT_KEY_PGDN | |
NEWT_KEY_INSERT | |
NEWT_KEY_F1 | |
NEWT_KEY_F2 | |
NEWT_KEY_F3 | |
NEWT_KEY_F4 | |
NEWT_KEY_F5 | |
NEWT_KEY_F6 | |
NEWT_KEY_F7 | |
NEWT_KEY_F8 | |
NEWT_KEY_F9 | |
NEWT_KEY_F10 | |
NEWT_KEY_F11 | |
NEWT_KEY_F12 | |
NEWT_KEY_RESIZE |
Newt Anchors
constant | meaning |
---|---|
NEWT_ANCHOR_LEFT | |
NEWT_ANCHOR_RIGHT | |
NEWT_ANCHOR_TOP | |
NEWT_ANCHOR_BOTTOM |
Grid Flags
constant | meaning |
---|---|
NEWT_GRID_FLAG_GROWX | |
NEWT_GRID_FLAG_GROWY | |
NEWT_GRID_EMPTY | |
NEWT_GRID_COMPONENT | |
NEWT_GRID_SUBGRID |
예제
This example is a PHP port of RedHat 'setup' utility dialog, executed in text mode.
Example#1 Newt Usage Example
<?php
newt_init ();
newt_cls ();
newt_draw_root_text (0, 0, "Test Mode Setup Utility 1.12");
newt_push_help_line (null);
newt_draw_root_text (-30, 0, "(c) 1999-2002 RedHat, Inc");
newt_get_screen_size (&$rows, &$cols);
newt_open_window ($rows/2-17, $cols/2-10, 34, 17, "Choose a Tool");
$form = newt_form ();
$list = newt_listbox (3, 2, 10);
foreach (array (
"Authentication configuration",
"Firewall configuration",
"Mouse configuration",
"Network configuration",
"Printer configuration",
"System services") as $l_item)
{
newt_listbox_add_entry ($list, $l_item, $l_item);
}
$b1 = newt_button (5, 12, "Run Tool");
$b2 = newt_button (21, 12, "Quit");
newt_form_add_component ($form, $list);
newt_form_add_components ($form, array($b1, $b2));
newt_refresh ();
newt_run_form ($form);
newt_pop_window ();
newt_pop_help_line ();
newt_finished ();
newt_form_destroy ($form);
?>
Table of Contents
- newt_bell — Send a beep to the terminal
- newt_button_bar — This function returns a grid containing the buttons created.
- newt_button — Create a new button
- newt_centered_window — Open a centered window of the specified size
- newt_checkbox_get_value — Retreives value of checkox resource
- newt_checkbox_set_flags — Configures checkbox resource
- newt_checkbox_set_value — Sets the value of the checkbox
- newt_checkbox_tree_add_item — Adds new item to the checkbox tree
- newt_checkbox_tree_find_item — Finds an item in the checkbox tree
- newt_checkbox_tree_get_current — Returns checkbox tree selected item
- newt_checkbox_tree_get_entry_value — 설명
- newt_checkbox_tree_get_multi_selection — 설명
- newt_checkbox_tree_get_selection — 설명
- newt_checkbox_tree_multi — 설명
- newt_checkbox_tree_set_current — 설명
- newt_checkbox_tree_set_entry_value — 설명
- newt_checkbox_tree_set_entry — 설명
- newt_checkbox_tree_set_width — 설명
- newt_checkbox_tree — 설명
- newt_checkbox — 설명
- newt_clear_key_buffer — Discards the contents of the terminal's input buffer without waiting for additional input
- newt_cls — 설명
- newt_compact_button — 설명
- newt_component_add_callback — 설명
- newt_component_takes_focus — 설명
- newt_create_grid — 설명
- newt_cursor_off — 설명
- newt_cursor_on — 설명
- newt_delay — 설명
- newt_draw_form — 설명
- newt_draw_root_text — Displays the string text at the position indicated
- newt_entry_get_value — 설명
- newt_entry_set_filter — 설명
- newt_entry_set_flags — 설명
- newt_entry_set — 설명
- newt_entry — 설명
- newt_finished — Uninitializes newt interface
- newt_form_add_component — Adds a single component to the form
- newt_form_add_components — Add several components to the form
- newt_form_add_hot_key — 설명
- newt_form_destroy — Destroys a form
- newt_form_get_current — 설명
- newt_form_run — Runs a form
- newt_form_set_background — 설명
- newt_form_set_height — 설명
- newt_form_set_size — 설명
- newt_form_set_timer — 설명
- newt_form_set_width — 설명
- newt_form_watch_fd — 설명
- newt_form — Create a form
- newt_get_screen_size — Fills in the passed references with the current size of the terminal
- newt_grid_add_components_to_form — 설명
- newt_grid_basic_window — 설명
- newt_grid_free — 설명
- newt_grid_get_size — 설명
- newt_grid_h_close_stacked — 설명
- newt_grid_h_stacked — 설명
- newt_grid_place — 설명
- newt_grid_set_field — 설명
- newt_grid_simple_window — 설명
- newt_grid_v_close_stacked — 설명
- newt_grid_v_stacked — 설명
- newt_grid_wrapped_window_at — 설명
- newt_grid_wrapped_window — 설명
- newt_init — Initialize newt
- newt_label_set_text — 설명
- newt_label — 설명
- newt_listbox_append_entry — 설명
- newt_listbox_clear_selection — 설명
- newt_listbox_clear — 설명
- newt_listbox_delete_entry — 설명
- newt_listbox_get_current — 설명
- newt_listbox_get_selection — 설명
- newt_listbox_insert_entry — 설명
- newt_listbox_item_count — 설명
- newt_listbox_select_item — 설명
- newt_listbox_set_current_by_key — 설명
- newt_listbox_set_current — 설명
- newt_listbox_set_data — 설명
- newt_listbox_set_entry — 설명
- newt_listbox_set_width — 설명
- newt_listbox — 설명
- newt_listitem_get_data — 설명
- newt_listitem_set — 설명
- newt_listitem — 설명
- newt_open_window — Open a window of the specified size and position
- newt_pop_help_line — Replaces the current help line with the one from the stack
- newt_pop_window — Removes the top window from the display
- newt_push_help_line — Saves the current help line on a stack, and displays the new line
- newt_radio_get_current — 설명
- newt_radiobutton — 설명
- newt_redraw_help_line — 설명
- newt_reflow_text — 설명
- newt_refresh — Updates modified portions of the screen
- newt_resize_screen — 설명
- newt_resume — Resume using the newt interface after calling newt_suspend
- newt_run_form — Runs a form
- newt_scale_set — 설명
- newt_scale — 설명
- newt_scrollbar_set — 설명
- newt_set_help_callback — 설명
- newt_set_suspend_callback — Set a callback function which gets invoked when user presses the suspend key
- newt_suspend — Tells newt to return the terminal to its initial state
- newt_textbox_get_num_lines — 설명
- newt_textbox_reflowed — 설명
- newt_textbox_set_height — 설명
- newt_textbox_set_text — 설명
- newt_textbox — 설명
- newt_vertical_scrollbar — 설명
- newt_wait_for_key — Doesn't return until a key has been pressed
- newt_win_choice — 설명
- newt_win_entries — 설명
- newt_win_menu — 설명
- newt_win_message — 설명
- newt_win_messagev — 설명
- newt_win_ternary — 설명