Úvod

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.

Požadavky

This module uses the functions of the RedHat Newt library. You need libnewt version >= 0.51.0.

Instalace

Toto rozšíření » PECL není přibaleno k PHP. Informace o instalaci tohoto PECL rozšíření lze najít v kapitole manuálu nazvané Instalace rozšíření PECL. Další informace, jako nové verze, soubory ke stažení, zdrojové soubory, správcovské informace a CHANGELOG, lze najít zde: » http://pecl.php.net/package/newt.

V PHP 4 lze zdroje k těmto rozšířením PECL najít v adresáři ext/ ve zdrojích PHP source or nebo přes výše uvedený odkaz na 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.

Poznámka: 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

Typy prostředků

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())

Předdefinované konstanty

Tyto konstanty jsou definovány tímto rozšířením a budou k dispozici pouze tehdy, bylo-li rozšíření zkompilováno společně s PHP nebo dynamicky zavedeno za běhu.

Příklady

This example is a PHP port of RedHat 'setup' utility dialog, executed in text mode.

Obsah

newt_bell — Send a beep to the terminal

newt_button_bar

newt_button — Create a new button

newt_centered_window — Open a centered window of the specified size

newt_checkbox_get_value

newt_checkbox_set_flags

newt_checkbox_set_value

newt_checkbox_tree_add_item — *

newt_checkbox_tree_find_item

newt_checkbox_tree_get_current

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