Commit 9104084ea23f4fd6fb92af014a3693df33dc82b6
1 parent
9fb62a82
Exists in
master
and in
5 other branches
Atualizando documentação
Showing
1 changed file
with
100 additions
and
1 deletions
Show diff stats
src/java/terminal.java
| @@ -18,7 +18,7 @@ | @@ -18,7 +18,7 @@ | ||
| 18 | * programa; se não, escreva para a Free Software Foundation, Inc., 59 Temple | 18 | * programa; se não, escreva para a Free Software Foundation, Inc., 59 Temple |
| 19 | * Place, Suite 330, Boston, MA, 02111-1307, USA | 19 | * Place, Suite 330, Boston, MA, 02111-1307, USA |
| 20 | * | 20 | * |
| 21 | - * Este programa está nomeado como lib3270.java e possui - linhas de código. | 21 | + * Este programa está nomeado como terminal.java e possui - linhas de código. |
| 22 | * | 22 | * |
| 23 | * Contatos: | 23 | * Contatos: |
| 24 | * | 24 | * |
| @@ -46,6 +46,9 @@ public class terminal | @@ -46,6 +46,9 @@ public class terminal | ||
| 46 | * ready for reading. | 46 | * ready for reading. |
| 47 | * | 47 | * |
| 48 | * @param seconds Maximum time (in seconds) to wait for. | 48 | * @param seconds Maximum time (in seconds) to wait for. |
| 49 | + * | ||
| 50 | + * @return 0 for success, error code if not. | ||
| 51 | + * | ||
| 49 | */ | 52 | */ |
| 50 | public native int wait_for_ready(int seconds); | 53 | public native int wait_for_ready(int seconds); |
| 51 | 54 | ||
| @@ -98,23 +101,115 @@ public class terminal | @@ -98,23 +101,115 @@ public class terminal | ||
| 98 | */ | 101 | */ |
| 99 | public native String get_string_at(int row, int col, int sz); | 102 | public native String get_string_at(int row, int col, int sz); |
| 100 | 103 | ||
| 104 | + /** | ||
| 105 | + * Set terminal contents at position. | ||
| 106 | + * | ||
| 107 | + * @param row Row for starting of change. | ||
| 108 | + * @param col Column for starting of change. | ||
| 109 | + * @param str Text to set. | ||
| 110 | + * | ||
| 111 | + * @return 0 if ok, error code if not. | ||
| 112 | + * | ||
| 113 | + */ | ||
| 101 | public native int set_string_at(int row, int col, String str); | 114 | public native int set_string_at(int row, int col, String str); |
| 115 | + | ||
| 116 | + /** | ||
| 117 | + * Compare terminal contents. | ||
| 118 | + * | ||
| 119 | + * @param row Row for text to compare. | ||
| 120 | + * @param col Column for text to compare. | ||
| 121 | + * @param text String to compare. | ||
| 122 | + * | ||
| 123 | + * @return result of strcmp() from text and terminal contents. | ||
| 124 | + * | ||
| 125 | + */ | ||
| 102 | public native int cmp_string_at(int row, int col, String text); | 126 | public native int cmp_string_at(int row, int col, String text); |
| 127 | + | ||
| 128 | + | ||
| 103 | public native int input_string(String str); | 129 | public native int input_string(String str); |
| 104 | 130 | ||
| 105 | // Cursor management | 131 | // Cursor management |
| 132 | + | ||
| 133 | + /** | ||
| 134 | + * Move cursor to selected position. | ||
| 135 | + * | ||
| 136 | + * @param row Row of the new cursor position. | ||
| 137 | + * @param col Column of the new cursor position. | ||
| 138 | + * | ||
| 139 | + * @return Address of current cursor position. | ||
| 140 | + * | ||
| 141 | + */ | ||
| 106 | public native int set_cursor_position(int row, int col); | 142 | public native int set_cursor_position(int row, int col); |
| 143 | + | ||
| 144 | + /** | ||
| 145 | + * Set cursor offset in the terminal buffer. | ||
| 146 | + * | ||
| 147 | + * @param addr New cursor offset. | ||
| 148 | + * | ||
| 149 | + * @return Original cursor offset. | ||
| 150 | + * | ||
| 151 | + */ | ||
| 107 | public native int set_cursor_addr(int addr); | 152 | public native int set_cursor_addr(int addr); |
| 153 | + | ||
| 154 | + /** | ||
| 155 | + * Get cursor offset | ||
| 156 | + * | ||
| 157 | + * @return Current cursor offset. | ||
| 158 | + * | ||
| 159 | + */ | ||
| 108 | public native int get_cursor_addr(); | 160 | public native int get_cursor_addr(); |
| 109 | 161 | ||
| 110 | // Keyboard actions | 162 | // Keyboard actions |
| 163 | + | ||
| 164 | + /** | ||
| 165 | + * Send an "ENTER" action. | ||
| 166 | + * | ||
| 167 | + * @return reserved. | ||
| 168 | + * | ||
| 169 | + */ | ||
| 111 | public native int enter(); | 170 | public native int enter(); |
| 171 | + | ||
| 172 | + /** | ||
| 173 | + * Send a pfkey to host. | ||
| 174 | + * | ||
| 175 | + * @param key PFkey number. | ||
| 176 | + * | ||
| 177 | + * @return reserved. | ||
| 178 | + * | ||
| 179 | + */ | ||
| 112 | public native int pfkey(int key); | 180 | public native int pfkey(int key); |
| 181 | + | ||
| 182 | + /** | ||
| 183 | + * Send a pakey to host. | ||
| 184 | + * | ||
| 185 | + * @param key PFkey number. | ||
| 186 | + * | ||
| 187 | + * @return reserved. | ||
| 188 | + * | ||
| 189 | + */ | ||
| 113 | public native int pakey(int key); | 190 | public native int pakey(int key); |
| 114 | 191 | ||
| 115 | // Actions | 192 | // Actions |
| 193 | + | ||
| 194 | + /** | ||
| 195 | + * quit remote pw3270 window. | ||
| 196 | + * <p> | ||
| 197 | + * Only valid if connected to a remote window | ||
| 198 | + * | ||
| 199 | + * @return reserved. | ||
| 200 | + * | ||
| 201 | + */ | ||
| 116 | public native int quit(); | 202 | public native int quit(); |
| 203 | + | ||
| 204 | + /** | ||
| 205 | + * Erase from cursor position until the end of the field. | ||
| 206 | + * | ||
| 207 | + * @return reserved. | ||
| 208 | + * | ||
| 209 | + */ | ||
| 117 | public native int erase_eof(); | 210 | public native int erase_eof(); |
| 211 | + | ||
| 212 | + | ||
| 118 | public native int print(); | 213 | public native int print(); |
| 119 | 214 | ||
| 120 | // Connect/Disconnect | 215 | // Connect/Disconnect |
| @@ -133,12 +228,16 @@ public class terminal | @@ -133,12 +228,16 @@ public class terminal | ||
| 133 | * @param host Host URI. | 228 | * @param host Host URI. |
| 134 | * @param seconds How many seconds to wait for a connection. | 229 | * @param seconds How many seconds to wait for a connection. |
| 135 | * | 230 | * |
| 231 | + * @return 0 if ok, error code if not. | ||
| 232 | + * | ||
| 136 | */ | 233 | */ |
| 137 | public native int connect(String host, int seconds); | 234 | public native int connect(String host, int seconds); |
| 138 | 235 | ||
| 139 | /** | 236 | /** |
| 140 | * Disconnect from host. | 237 | * Disconnect from host. |
| 141 | * | 238 | * |
| 239 | + * @return 0 if ok, error code if not. | ||
| 240 | + * | ||
| 142 | */ | 241 | */ |
| 143 | public native int disconnect(); | 242 | public native int disconnect(); |
| 144 | 243 |