[cydia.git] / CyteKit / ViewController.h

/* Cydia - iPhone UIKit Front-End for Debian APT
 * Copyright (C) 2008-2011  Jay Freeman (saurik)
*/

/* Modified BSD License {{{ */
/*
 *        Redistribution and use in source and binary
 * forms, with or without modification, are permitted
 * provided that the following conditions are met:
 *
 * 1. Redistributions of source code must retain the
 *    above copyright notice, this list of conditions
 *    and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the
 *    above copyright notice, this list of conditions
 *    and the following disclaimer in the documentation
 *    and/or other materials provided with the
 *    distribution.
 * 3. The name of the author may not be used to endorse
 *    or promote products derived from this software
 *    without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS''
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING,
 * BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE
 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
 * TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
 * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
 * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/
/* }}} */

#ifndef CyteKit_ViewController_H
#define CyteKit_ViewController_H

#include <CyteKit/UCPlatform.h>

#include <UIKit/UIKit.h>

@interface UIViewController (Cydia)
- (BOOL) hasLoaded;
- (void) reloadData;
- (void) unloadData;
@end

@interface CYViewController : UIViewController {
    _transient id delegate_;
    BOOL loaded_;
}

// The default implementation of this method is essentially a no-op,
// but calling the superclass implementation is *required*.
- (void) reloadData;

- (void) unloadData;

// This URL is used to save the state of the view controller. Return
// nil if you cannot or should not save the URL for this page.
- (NSURL *) navigationURL;

// By default, this delegate is unused. However, it's provided here in case
// you need some kind of delegate in a subclass.
- (void) setDelegate:(id)delegate;
- (id) delegate;

// Override this in subclasses if you manage the "has seen first load" state yourself.
- (BOOL) hasLoaded;

// This is called when the view managed by the view controller is released.
// That is not always when the controller itself is released: it also can
// happen when more memory is needed by the system or whenever the controller
// just happens not to be visible.
- (void) releaseSubviews;

@end

#endif//CyteKit_ViewController_H
Commit	Line	Data
449ef9d5 JF	1	/* Cydia - iPhone UIKit Front-End for Debian APT
	2	* Copyright (C) 2008-2011 Jay Freeman (saurik)
	3	*/
	4
	5	/* Modified BSD License {{{ */
	6	/*
	7	* Redistribution and use in source and binary
	8	* forms, with or without modification, are permitted
	9	* provided that the following conditions are met:
	10	*
	11	* 1. Redistributions of source code must retain the
	12	* above copyright notice, this list of conditions
	13	* and the following disclaimer.
	14	* 2. Redistributions in binary form must reproduce the
	15	* above copyright notice, this list of conditions
	16	* and the following disclaimer in the documentation
	17	* and/or other materials provided with the
	18	* distribution.
	19	* 3. The name of the author may not be used to endorse
	20	* or promote products derived from this software
	21	* without specific prior written permission.
	22	*
	23	* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS''
	24	* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING,
	25	* BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
	26	* MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
	27	* ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE
	28	* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
	29	* EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
	30	* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
	31	* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
	32	* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
	33	* LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
	34	* TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
	35	* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
	36	* ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
	37	*/
	38	/* }}} */
	39
d458596e JF	40	#ifndef CyteKit_ViewController_H
d458596e JF	41	#define CyteKit_ViewController_H
819a0ab1 JF	42
	43	#include <CyteKit/UCPlatform.h>
	44
	45	#include <UIKit/UIKit.h>
	46
	47	@interface UIViewController (Cydia)
	48	- (BOOL) hasLoaded;
	49	- (void) reloadData;
	50	- (void) unloadData;
	51	@end
	52
	53	@interface CYViewController : UIViewController {
	54	_transient id delegate_;
	55	BOOL loaded_;
	56	}
	57
	58	// The default implementation of this method is essentially a no-op,
	59	// but calling the superclass implementation is required.
	60	- (void) reloadData;
	61
	62	- (void) unloadData;
	63
	64	// This URL is used to save the state of the view controller. Return
	65	// nil if you cannot or should not save the URL for this page.
	66	- (NSURL *) navigationURL;
	67
	68	// By default, this delegate is unused. However, it's provided here in case
	69	// you need some kind of delegate in a subclass.
	70	- (void) setDelegate:(id)delegate;
	71	- (id) delegate;
	72
	73	// Override this in subclasses if you manage the "has seen first load" state yourself.
	74	- (BOOL) hasLoaded;
	75
	76	// This is called when the view managed by the view controller is released.
	77	// That is not always when the controller itself is released: it also can
	78	// happen when more memory is needed by the system or whenever the controller
	79	// just happens not to be visible.
	80	- (void) releaseSubviews;
449ef9d5	81
449ef9d5 JF	82	@end
449ef9d5 JF	83
d458596e	84	#endif//CyteKit_ViewController_H