1 /*
2 * Copyright (c) 1995, 2016, Oracle and/or its affiliates. All rights reserved.
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 *
5 * This code is free software; you can redistribute it and/or modify it
6 * under the terms of the GNU General Public License version 2 only, as
7 * published by the Free Software Foundation. Oracle designates this
8 * particular file as subject to the "Classpath" exception as provided
9 * by Oracle in the LICENSE file that accompanied this code.
10 *
11 * This code is distributed in the hope that it will be useful, but WITHOUT
12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 * version 2 for more details (a copy is included in the LICENSE file that
15 * accompanied this code).
16 *
17 * You should have received a copy of the GNU General Public License version
18 * 2 along with this work; if not, write to the Free Software Foundation,
19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20 *
21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
22 * or visit www.oracle.com if you need additional information or have any
97 Enumeration<Applet> getApplets();
98
99 /**
100 * Requests that the browser or applet viewer show the Web page
101 * indicated by the {@code url} argument. The browser or
102 * applet viewer determines which window or frame to display the
103 * Web page. This method may be ignored by applet contexts that
104 * are not browsers.
105 *
106 * @param url an absolute URL giving the location of the document.
107 */
108 void showDocument(URL url);
109
110 /**
111 * Requests that the browser or applet viewer show the Web page
112 * indicated by the {@code url} argument. The
113 * {@code target} argument indicates in which HTML frame the
114 * document is to be displayed.
115 * The target argument is interpreted as follows:
116 *
117 * <center><table border="3" summary="Target arguments and their descriptions">
118 * <tr><th>Target Argument</th><th>Description</th></tr>
119 * <tr><td>{@code "_self"} <td>Show in the window and frame that
120 * contain the applet.</tr>
121 * <tr><td>{@code "_parent"}<td>Show in the applet's parent frame. If
122 * the applet's frame has no parent frame,
123 * acts the same as "_self".</tr>
124 * <tr><td>{@code "_top"} <td>Show in the top-level frame of the applet's
125 * window. If the applet's frame is the
126 * top-level frame, acts the same as "_self".</tr>
127 * <tr><td>{@code "_blank"} <td>Show in a new, unnamed
128 * top-level window.</tr>
129 * <tr><td><i>name</i><td>Show in the frame or window named <i>name</i>. If
130 * a target named <i>name</i> does not already exist, a
131 * new top-level window with the specified name is created,
132 * and the document is shown there.</tr>
133 * </table> </center>
134 * <p>
135 * An applet viewer or browser is free to ignore {@code showDocument}.
136 *
137 * @param url an absolute URL giving the location of the document.
138 * @param target a {@code String} indicating where to display
139 * the page.
140 */
141 public void showDocument(URL url, String target);
142
143 /**
144 * Requests that the argument string be displayed in the
145 * "status window". Many browsers and applet viewers
146 * provide such a window, where the application can inform users of
147 * its current state.
148 *
149 * @param status a string to display in the status window.
150 */
151 void showStatus(String status);
152
153 /**
|
1 /*
2 * Copyright (c) 1995, 2017, Oracle and/or its affiliates. All rights reserved.
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 *
5 * This code is free software; you can redistribute it and/or modify it
6 * under the terms of the GNU General Public License version 2 only, as
7 * published by the Free Software Foundation. Oracle designates this
8 * particular file as subject to the "Classpath" exception as provided
9 * by Oracle in the LICENSE file that accompanied this code.
10 *
11 * This code is distributed in the hope that it will be useful, but WITHOUT
12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 * version 2 for more details (a copy is included in the LICENSE file that
15 * accompanied this code).
16 *
17 * You should have received a copy of the GNU General Public License version
18 * 2 along with this work; if not, write to the Free Software Foundation,
19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20 *
21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
22 * or visit www.oracle.com if you need additional information or have any
97 Enumeration<Applet> getApplets();
98
99 /**
100 * Requests that the browser or applet viewer show the Web page
101 * indicated by the {@code url} argument. The browser or
102 * applet viewer determines which window or frame to display the
103 * Web page. This method may be ignored by applet contexts that
104 * are not browsers.
105 *
106 * @param url an absolute URL giving the location of the document.
107 */
108 void showDocument(URL url);
109
110 /**
111 * Requests that the browser or applet viewer show the Web page
112 * indicated by the {@code url} argument. The
113 * {@code target} argument indicates in which HTML frame the
114 * document is to be displayed.
115 * The target argument is interpreted as follows:
116 *
117 * <table class="striped">
118 * <caption style="display:none">Target arguments and their descriptions
119 * </caption>
120 * <thead>
121 * <tr><th>Target Argument</th>
122 * <th>Description</th></tr>
123 * </thead>
124 * <tbody>
125 * <tr><td>{@code "_self"} <td>Show in the window and frame that
126 * contain the applet.</tr>
127 * <tr><td>{@code "_parent"}<td>Show in the applet's parent frame. If
128 * the applet's frame has no parent frame,
129 * acts the same as "_self".</tr>
130 * <tr><td>{@code "_top"} <td>Show in the top-level frame of the applet's
131 * window. If the applet's frame is the
132 * top-level frame, acts the same as "_self".</tr>
133 * <tr><td>{@code "_blank"} <td>Show in a new, unnamed
134 * top-level window.</tr>
135 * <tr><td><i>name</i><td>Show in the frame or window named <i>name</i>. If
136 * a target named <i>name</i> does not already exist, a
137 * new top-level window with the specified name is created,
138 * and the document is shown there.</tr>
139 * </tbody>
140 * </table>
141 * <p>
142 * An applet viewer or browser is free to ignore {@code showDocument}.
143 *
144 * @param url an absolute URL giving the location of the document.
145 * @param target a {@code String} indicating where to display
146 * the page.
147 */
148 public void showDocument(URL url, String target);
149
150 /**
151 * Requests that the argument string be displayed in the
152 * "status window". Many browsers and applet viewers
153 * provide such a window, where the application can inform users of
154 * its current state.
155 *
156 * @param status a string to display in the status window.
157 */
158 void showStatus(String status);
159
160 /**
|