/*
* ReadFileButton.java 0.1.0.3 24th January 2001
*
* Copyright (C) 2000 Adam Kirby
*
* <This Java Class is part of the jMusic API version 1.5, March 2004.>
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License
* as published by the Free Software Foundation; either version 2
* of the License, or (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
*
* See the GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
*/
package jm.util;
import jm.music.data.Score;
import java.awt.*;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
/**
* A button which allows user to select a MIDI or jMusic file to import.
* <p/>
* <P>After each successful import of a Score, any registered ReadListeners
* are notified and can update and use the score read. The listeners are
* guaranteed to be notified in a LILO (Last In Last Out) order. As an example,
* if you wanted a Score quantised and then analysed, you would the quantising
* ReadListener first, then the analysing one.
*
* @author Adam Kirby
* @version 1.0, Sun Feb 25 18:43:58 2001
*/
public class ReadFileButton extends Button {
/**
* List of ReadListener's associated with this button
*/
private ReadListenerLinkedList readListenerList;
/**
* Constructs a button for reading in a music file.
*
* @param owner {@link Frame} which is the owner of this button. Access to
* this <CODE>Frame</CODE> will be suspended when the user is
* selecting a music file and when error messages are
* displayed.
*/
public ReadFileButton(final Frame owner) {
super("Read File");
final FileDialog load = new FileDialog(owner,
"Select a Midi or jMusic file to import",
FileDialog.LOAD);
load.setFilenameFilter(new ReadFilenameFilter());
addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent evt) {
load.show();
Score score = Read.midiOrJmWithAWTMessaging(load.getDirectory(),
load.getFile(),
owner);
if (score == null) {
return;
}
if (readListenerList != null) {
score = readListenerList.scoreRead(score);
readListenerList.finishedReading();
}
}
}
);
}
/**
* Registers a ReadListener to recieve successful read notifications
*
* @param l ReadListener to add
* @see #removeReadListener
*/
public void addReadListener(ReadListener l) {
if (l == null) {
return;
}
if (readListenerList == null) {
readListenerList = new ReadListenerLinkedList(l);
} else {
readListenerList.add(l);
}
}
/**
* Unregisters a ReadListener from recieving read notifications
*
* @param l ReadListner to remove
* @see #addReadListener
*/
public void removeReadListener(ReadListener l) {
if (readListenerList == null) {
return;
}
if (readListenerList.getListener() == l) {
readListenerList = readListenerList.getNext();
}
}
}