1 /*
2 * Tethys: GUI Utilities
3 * Copyright 2012-2026. Tony Washer
4 *
5 * Licensed under the Apache License, Version 2.0 (the "License"); you may not
6 * use this file except in compliance with the License. You may obtain a copy
7 * of the License at
8 *
9 * http://www.apache.org/licenses/LICENSE-2.0
10 *
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
13 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
14 * License for the specific language governing permissions and limitations under
15 * the License.
16 */
17 package io.github.tonywasher.joceanus.tethys.api.dialog;
18
19 import java.io.File;
20
21 /**
22 * File Selector.
23 */
24 public interface TethysUIFileSelector {
25 /**
26 * Set the title.
27 *
28 * @param pTitle the title
29 */
30 void setTitle(String pTitle);
31
32 /**
33 * Set the initial directory.
34 *
35 * @param pDir the directory
36 */
37 void setInitialDirectory(File pDir);
38
39 /**
40 * Set the initial file name.
41 *
42 * @param pName the name
43 */
44 void setInitialFileName(String pName);
45
46 /**
47 * Set the initial file.
48 *
49 * @param pFile the file
50 */
51 void setInitialFile(File pFile);
52
53 /**
54 * Set the extension.
55 *
56 * @param pExt the extension
57 */
58 void setExtension(String pExt);
59
60 /**
61 * Use save rather than open.
62 *
63 * @param pSave true/false
64 */
65 void setUseSave(boolean pSave);
66
67 /**
68 * Select file via dialog.
69 *
70 * @return the selected file or null.
71 */
72 File selectFile();
73 }