Added documentation
This commit is contained in:
parent
6f8a582710
commit
67622d447d
@ -33,7 +33,10 @@ import de.danoeh.antennapod.AppConfig;
|
|||||||
import de.danoeh.antennapod.PodcastApp;
|
import de.danoeh.antennapod.PodcastApp;
|
||||||
import de.danoeh.antennapod.R;
|
import de.danoeh.antennapod.R;
|
||||||
|
|
||||||
/** Let's the user choose a directory on the storage device. */
|
/**
|
||||||
|
* Let's the user choose a directory on the storage device. The selected folder
|
||||||
|
* will be sent back to the starting activity as an activity result.
|
||||||
|
*/
|
||||||
public class DirectoryChooserActivity extends SherlockActivity {
|
public class DirectoryChooserActivity extends SherlockActivity {
|
||||||
private static final String TAG = "DirectoryChooserActivity";
|
private static final String TAG = "DirectoryChooserActivity";
|
||||||
|
|
||||||
@ -47,6 +50,7 @@ public class DirectoryChooserActivity extends SherlockActivity {
|
|||||||
|
|
||||||
private ArrayAdapter<String> listDirectoriesAdapter;
|
private ArrayAdapter<String> listDirectoriesAdapter;
|
||||||
private ArrayList<String> filenames;
|
private ArrayList<String> filenames;
|
||||||
|
/** The directory that is currently being shown. */
|
||||||
private File selectedDir;
|
private File selectedDir;
|
||||||
private File[] filesInDir;
|
private File[] filesInDir;
|
||||||
|
|
||||||
@ -130,6 +134,14 @@ public class DirectoryChooserActivity extends SherlockActivity {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Change the directory that is currently being displayed.
|
||||||
|
*
|
||||||
|
* @param dir
|
||||||
|
* The file the activity should switch to. This File must be
|
||||||
|
* non-null and a directory, otherwise the displayed directory
|
||||||
|
* will not be changed
|
||||||
|
*/
|
||||||
private void changeDirectory(File dir) {
|
private void changeDirectory(File dir) {
|
||||||
if (dir != null && dir.isDirectory()) {
|
if (dir != null && dir.isDirectory()) {
|
||||||
File[] contents = dir.listFiles();
|
File[] contents = dir.listFiles();
|
||||||
@ -174,12 +186,14 @@ public class DirectoryChooserActivity extends SherlockActivity {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/** Refresh the contents of the directory that is currently shown. */
|
||||||
private void refreshDirectory() {
|
private void refreshDirectory() {
|
||||||
if (selectedDir != null) {
|
if (selectedDir != null) {
|
||||||
changeDirectory(selectedDir);
|
changeDirectory(selectedDir);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/** Sets up a FileObserver to watch the current directory. */
|
||||||
private FileObserver createFileObserver(String path) {
|
private FileObserver createFileObserver(String path) {
|
||||||
return new FileObserver(path, FileObserver.CREATE | FileObserver.DELETE
|
return new FileObserver(path, FileObserver.CREATE | FileObserver.DELETE
|
||||||
| FileObserver.MOVED_FROM | FileObserver.MOVED_TO) {
|
| FileObserver.MOVED_FROM | FileObserver.MOVED_TO) {
|
||||||
@ -220,6 +234,10 @@ public class DirectoryChooserActivity extends SherlockActivity {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Shows a confirmation dialog that asks the user if he wants to create a
|
||||||
|
* new folder.
|
||||||
|
*/
|
||||||
private void openNewFolderDialog() {
|
private void openNewFolderDialog() {
|
||||||
AlertDialog.Builder builder = new AlertDialog.Builder(this);
|
AlertDialog.Builder builder = new AlertDialog.Builder(this);
|
||||||
builder.setTitle(R.string.create_folder_label);
|
builder.setTitle(R.string.create_folder_label);
|
||||||
@ -248,6 +266,10 @@ public class DirectoryChooserActivity extends SherlockActivity {
|
|||||||
builder.create().show();
|
builder.create().show();
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Creates a new folder in the current directory with the name
|
||||||
|
* CREATE_DIRECTORY_NAME.
|
||||||
|
*/
|
||||||
private int createFolder() {
|
private int createFolder() {
|
||||||
if (selectedDir != null && selectedDir.canWrite()) {
|
if (selectedDir != null && selectedDir.canWrite()) {
|
||||||
File newDir = new File(selectedDir, CREATE_DIRECTORY_NAME);
|
File newDir = new File(selectedDir, CREATE_DIRECTORY_NAME);
|
||||||
|
Loading…
x
Reference in New Issue
Block a user