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>Target arguments and their descriptions</caption>
119 * <thead>
120 * <tr><th>Target Argument</th>
121 * <th>Description</th></tr>
122 * </thead>
123 * <tbody>
124 * <tr><td>{@code "_self"} <td>Show in the window and frame that
125 * contain the applet.</tr>
126 * <tr><td>{@code "_parent"}<td>Show in the applet's parent frame. If
127 * the applet's frame has no parent frame,
128 * acts the same as "_self".</tr>
129 * <tr><td>{@code "_top"} <td>Show in the top-level frame of the applet's
130 * window. If the applet's frame is the
131 * top-level frame, acts the same as "_self".</tr>
132 * <tr><td>{@code "_blank"} <td>Show in a new, unnamed
133 * top-level window.</tr>
134 * <tr><td><i>name</i><td>Show in the frame or window named <i>name</i>. If
135 * a target named <i>name</i> does not already exist, a
136 * new top-level window with the specified name is created,
137 * and the document is shown there.</tr>
138 * </tbody>
139 * </table>
140 * <p>
141 * An applet viewer or browser is free to ignore {@code showDocument}.
142 *
143 * @param url an absolute URL giving the location of the document.
144 * @param target a {@code String} indicating where to display
145 * the page.
146 */
147 public void showDocument(URL url, String target);
148
149 /**
150 * Requests that the argument string be displayed in the
151 * "status window". Many browsers and applet viewers
152 * provide such a window, where the application can inform users of
153 * its current state.
154 *
155 * @param status a string to display in the status window.
156 */
157 void showStatus(String status);
158
159 /**
|