01: /*
02: * Copyright (c) 2001-2006 JGoodies Karsten Lentzsch. All Rights Reserved.
03: *
04: * Redistribution and use in source and binary forms, with or without
05: * modification, are permitted provided that the following conditions are met:
06: *
07: * o Redistributions of source code must retain the above copyright notice,
08: * this list of conditions and the following disclaimer.
09: *
10: * o Redistributions in binary form must reproduce the above copyright notice,
11: * this list of conditions and the following disclaimer in the documentation
12: * and/or other materials provided with the distribution.
13: *
14: * o Neither the name of JGoodies Karsten Lentzsch nor the names of
15: * its contributors may be used to endorse or promote products derived
16: * from this software without specific prior written permission.
17: *
18: * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
19: * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
20: * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
21: * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
22: * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
23: * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
24: * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
25: * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
26: * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
27: * OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
28: * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29: */
30:
31: package com.jgoodies.animation;
32:
33: import javax.swing.SwingUtilities;
34:
35: /**
36: * Provides some behavior useful in the animation framework,
37: * or to implement custom animation functions and animations.
38: *
39: * @author Karsten Lentzsch
40: * @version $Revision: 1.1 $
41: */
42: public final class AnimationUtils {
43:
44: private AnimationUtils() {
45: // Override the default constructor; prevents instantiation.
46: }
47:
48: /**
49: * Invokes the given runnable when the specified animation stopped.
50: *
51: * @param animation the animation that is observed
52: * @param runnable the runnable that will be executed on animation stop
53: */
54: public static void invokeOnStop(Animation animation,
55: Runnable runnable) {
56: animation.addAnimationListener(new StopListener(runnable));
57: }
58:
59: /**
60: * Returns an array of strings by splitting a given text
61: * into tokens, that are separated by the '|' character.
62: *
63: * @param separatedTexts a string that encodes a bunch of texts
64: * separated by a | character
65: * @return an array of the separated texts
66: * @deprecated Use {@link String#split(java.lang.String)} instead.
67: */
68: public static String[] splitTexts(String separatedTexts) {
69: return separatedTexts.split("\\|");
70: }
71:
72: // Helper Code ***********************************************************
73:
74: /**
75: * Performs a runnable at animation stop.
76: */
77: private static final class StopListener extends AnimationAdapter {
78:
79: private final Runnable runnable;
80:
81: private StopListener(Runnable runnable) {
82: this .runnable = runnable;
83: }
84:
85: public void animationStopped(AnimationEvent e) {
86: SwingUtilities.invokeLater(runnable);
87: }
88: }
89:
90: }
|