【类库与框架】-MBProgressHUD.7z

// // MBProgressHUD.h // Version 0.4 // Created by Matej Bukovinski on 2.4.09. // // This code is distributed under the terms and conditions of the MIT license. // Copyright (c) 2009 Matej Bukovinski // // Permission is hereby granted, free of charge, to any person obtaining a copy // of this software and associated documentation files (the "Software"), to deal // in the Software without restriction, including without limitation the rights // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell // copies of the Software, and to permit persons to whom the Software is // furnished to do so, subject to the following conditions: // // The above copyright notice and this permission notice shall be included in // all copies or substantial portions of the Software. // // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN // THE SOFTWARE. #import <UIKit/UIKit.h> ///////////////////////////////////////////////////////////////////////////////////////////// typedef enum { /** Progress is shown using an UIActivityIndicatorView. This is the default. */ MBProgressHUDModeIndeterminate, /** Progress is shown using a MBRoundProgressView. */ MBProgressHUDModeDeterminate, /** Shows a custom view */ MBProgressHUDModeCustomView } MBProgressHUDMode; typedef enum { /** Opacity animation */ MBProgressHUDAnimationFade, /** Opacity + scale animation */ MBProgressHUDAnimationZoom } MBProgressHUDAnimation; ///////////////////////////////////////////////////////////////////////////////////////////// @protocol MBProgressHUDDelegate <NSObject> @required /** * A callback function that is called after the HUD was fully hidden from the screen. */ - (void)hudWasHidden; @end ///////////////////////////////////////////////////////////////////////////////////////////// /** * A progress view for showing definite progress by filling up a circle (similar to the indicator for building in xcode). */ @interface MBRoundProgressView : UIProgressView {} /** * Create a 37 by 37 pixel indicator. * This is the same size as used by the larger UIActivityIndicatorView. */ - (id)initWithDefaultSize; @end ///////////////////////////////////////////////////////////////////////////////////////////// /** * Displays a simple HUD window containing a progress indicator and two optional labels for short messages. * * This is a simple drop-in class for displaying a progress HUD view similar to Apples private UIProgressHUD class. * The MBProgressHUD window spans over the entire space given to it by the initWithFrame constructor and catches all * user input on this region, thereby preventing the user operations on components below the view. The HUD itself is * drawn centered as a rounded semi-transparent view witch resizes depending on the user specified content. * * This view supports three modes of operation: * - MBProgressHUDModeIndeterminate - shows a UIActivityIndicatorView * - MBProgressHUDModeDeterminate - shows a custom round progress indicator (MBRoundProgressView) * - MBProgressHUDModeCustomView - shows an arbitrary, user specified view (@see customView) * * All three modes can have optional labels assigned: * - If the labelText property is set and non-empty then a label containing the provided content is placed below the * indicator view. * - If also the detailsLabelText property is set then another label is placed below the first label. */ @interface MBProgressHUD : UIView { MBProgressHUDMode mode; MBProgressHUDAnimation animationType; SEL methodForExecution; id targetForExecution; id objectForExecution; BOOL useAnimation; float yOffset; float xOffset; float width; float height; float margin; BOOL taskInProgress; float graceTime; float minShowTime; NSTimer *graceTimer; NSTimer *minShowTimer; NSDate *showStarted; UIView *indicator; UILabel *label; UILabel *detailsLabel; float progress; id<MBProgressHUDDelegate> delegate; NSString *labelText; NSString *detailsLabelText; float opacity; UIFont *labelFont; UIFont *detailsLabelFont; BOOL isFinished; BOOL removeFromSuperViewOnHide; UIView *customView; CGAffineTransform rotationTransform; } /** * Creates a new hud, adds it to provided view and shows it. The counterpart to this method is hideHUDForView:animated:. * * @param view The view that the HUD will be added to * @param animated If set to YES the HUD will disappear using the current animationType. If set to NO the HUD will not use * animations while disappearing. * @return A reference to the created HUD. * * @see hideHUDForView:animated: */ + (MBProgressHUD *)showHUDAddedTo:(UIView *)view animated:(BOOL)animated; /** * Finds a HUD sibview and hides it. The counterpart to this method is showHUDAddedTo:animated:. * * @param view The view that is going to be searched for a HUD subview. * @param animated If set to YES the HUD will disappear using the current animationType. If set to NO the HUD will not use * animations while disappearing. * @return YES if a HUD was found and removed, NO otherwise. * * @see hideHUDForView:animated: */ + (BOOL)hideHUDForView:(UIView *)view animated:(BOOL)animated; /** * A convenience constructor that initializes the HUD with the window's bounds. Calls the designated constructor with * window.bounds as the parameter. * * @param window The window instance that will provide the bounds for the HUD. Should probably be the same instance as * the HUD's superview (i.e., the window that the HUD will be added to). */ - (id)initWithWindow:(UIWindow *)window; /** * A convenience constructor that initializes the HUD with the view's bounds. Calls the designated constructor with * view.bounds as the parameter * * @param view The view instance that will provide the bounds for the HUD. Should probably be the same instance as * the HUD's superview (i.e., the view that the HUD will be added to). */ - (id)initWithView:(UIView *)view; /** * The UIView (i.g., a UIIMageView) to be shown when the HUD is in MBProgressHUDModeCustomView. * For best results use a 37 by 37 pixel view (so the bounds match the build in indicator bounds). */ @property (retain) UIView *customView; /** * MBProgressHUD operation mode. Switches between indeterminate (MBProgressHUDModeIndeterminate) and determinate * progress (MBProgressHUDModeDeterminate). The default is MBProgressHUDModeIndeterminate. * * @see MBProgressHUDMode */ @property (assign) MBProgressHUDMode mode; /** * The animation type that should be used when the HUD is shown and hidden. * * @see MBProgressHUDAnimation */ @property (assign) MBProgressHUDAnimation animationType; /** * The HUD delegate object. If set the delegate will receive hudWasHidden callbacks when the HUD was hidden. The * delegate should conform to the MBProgressHUDDelegate protocol and implement the hudWasHidden method. The delegate * object will not be retained. */ @property (assign) id<MBProgressHUDDelegate> delegate; /** * An optional short message to be displayed below the activity indicator. The HUD is automatically resized to fit * the entire text. If the text is too long it will get clipped by displaying "..." at the end. If left unchanged or * set to @"", then no message is displayed. */ @property (copy) NSString *labelText; /** * An optional details message displayed below the labelText message. This message is displayed only if the labelText * property is also set and is different from an empty string (@""). */ @property (copy) NSString *det