/core/externals/update-engine/externals/google-toolbox-for-mac/AppKit/GTMNSAnimatablePropertyContainer.h

 1//
 2//  GTMNSAnimatablePropertyContainer.h
 3//
 4//  Copyright (c) 2010 Google Inc. All rights reserved.
 5//
 6//  Licensed under the Apache License, Version 2.0 (the "License"); you may not
 7//  use this file except in compliance with the License.  You may obtain a copy
 8//  of the License at
 9//
10//  http://www.apache.org/licenses/LICENSE-2.0
11//
12//  Unless required by applicable law or agreed to in writing, software
13//  distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
14//  WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
15//  License for the specific language governing permissions and limitations under
16//  the License.
17//
18
19#import <Cocoa/Cocoa.h>
20#import "GTMDefines.h"
21
22#if MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_5
23
24// There is a bug in 10.5 where you cannot stop an animation on a 
25// NSAnimatablePropertyContainer by just setting it's duration to 0.0.
26// The work around is rather complex requiring you to NULL out animation 
27// dictionary entries temporarily (see the code for details).
28// These categories are to make stopping animations simpler.
29// When you want to stop an animation, you just call it like you would
30// an animator.
31//
32// [[myWindow gtm_animatorStopper] setAlphaValue:0.0];
33//
34// This will stop any current animations that are going on, and will immediately
35// set the alpha value of the window to 0.
36// If there is no animation, it will still set the alpha value to 0.0 for you.
37@interface NSView (GTMNSAnimatablePropertyContainer)
38
39- (id)gtm_animatorStopper;
40
41@end
42
43@interface NSWindow (GTMNSAnimatablePropertyContainer)
44
45- (id)gtm_animatorStopper;
46
47@end
48
49#endif  // MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_5