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 | 18 | * programa; se não, escreva para a Free Software Foundation, Inc., 59 Temple |
| 19 | 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 | 23 | * Contatos: |
| 24 | 24 | * |
| ... | ... | @@ -46,6 +46,9 @@ public class terminal |
| 46 | 46 | * ready for reading. |
| 47 | 47 | * |
| 48 | 48 | * @param seconds Maximum time (in seconds) to wait for. |
| 49 | + * | |
| 50 | + * @return 0 for success, error code if not. | |
| 51 | + * | |
| 49 | 52 | */ |
| 50 | 53 | public native int wait_for_ready(int seconds); |
| 51 | 54 | |
| ... | ... | @@ -98,23 +101,115 @@ public class terminal |
| 98 | 101 | */ |
| 99 | 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 | 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 | 126 | public native int cmp_string_at(int row, int col, String text); |
| 127 | + | |
| 128 | + | |
| 103 | 129 | public native int input_string(String str); |
| 104 | 130 | |
| 105 | 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 | 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 | 152 | public native int set_cursor_addr(int addr); |
| 153 | + | |
| 154 | + /** | |
| 155 | + * Get cursor offset | |
| 156 | + * | |
| 157 | + * @return Current cursor offset. | |
| 158 | + * | |
| 159 | + */ | |
| 108 | 160 | public native int get_cursor_addr(); |
| 109 | 161 | |
| 110 | 162 | // Keyboard actions |
| 163 | + | |
| 164 | + /** | |
| 165 | + * Send an "ENTER" action. | |
| 166 | + * | |
| 167 | + * @return reserved. | |
| 168 | + * | |
| 169 | + */ | |
| 111 | 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 | 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 | 190 | public native int pakey(int key); |
| 114 | 191 | |
| 115 | 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 | 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 | 210 | public native int erase_eof(); |
| 211 | + | |
| 212 | + | |
| 118 | 213 | public native int print(); |
| 119 | 214 | |
| 120 | 215 | // Connect/Disconnect |
| ... | ... | @@ -133,12 +228,16 @@ public class terminal |
| 133 | 228 | * @param host Host URI. |
| 134 | 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 | 234 | public native int connect(String host, int seconds); |
| 138 | 235 | |
| 139 | 236 | /** |
| 140 | 237 | * Disconnect from host. |
| 141 | 238 | * |
| 239 | + * @return 0 if ok, error code if not. | |
| 240 | + * | |
| 142 | 241 | */ |
| 143 | 242 | public native int disconnect(); |
| 144 | 243 | ... | ... |