OODebugInspector Class Reference

#include <OODebugInspector.h>

Inheritance diagram for OODebugInspector:

Collaboration diagram for OODebugInspector:

Instance Methods
(void)	- bringToFront
(id< OOWeakReferenceSupport >)	- object
(void)	- dealloc [implementation]
(id)	- initWithObject: [implementation]
(void)	- placeModules [implementation]
(void)	- update [implementation]
(void)	- updateTick: [implementation]
(void)	- windowWillClose: [implementation]
(void)	- cleanSelfUp [implementation]

Class Methods
(id)	+ inspectorForObject:
(void)	+ cleanUpInspectors

Private Attributes
OOWeakReference *	_object
IBOutlet NSPanel *	_panel
NSTimer *	_timer
NSValue *	_key
NSArray *	_modules

Detailed Description

Definition at line 34 of file OODebugInspector.h.

Method Documentation

bringToFront

- (void) bringToFront

Definition at line 35 of file OODebugInspector.m.

{
    if (![_panel isVisible])  [self update];
    [_panel orderFront:nil];
}

References nil.

cleanSelfUp

- (void) cleanSelfUp

implementation

Definition at line 35 of file OODebugInspector.m.

{
    if ([self object] == nil)  [_panel close];
}

cleanUpInspectors

+ (void) cleanUpInspectors

Definition at line 35 of file OODebugInspector.m.

{
    [[sActiveInspectors allValues] makeObjectsPerformSelector:@selector(cleanSelfUp)];
}

dealloc

- (void) dealloc

implementation

Definition at line 35 of file OODebugInspector.m.

{
    [_timer invalidate];
    _timer = nil;
    _panel = nil;
    [_object release];
    _object = nil;
    if (_key != nil)  [sActiveInspectors removeObjectForKey:_key];
    [_key release];
    _key = nil;
    [_modules release];
    [_panel close];
    
    [super dealloc];
}

initWithObject:

- (id) initWithObject: (id <OOWeakReferenceSupport>) object

implementation

Definition at line 35 of file OODebugInspector.m.

                     :(id <OOWeakReferenceSupport>)object
{
    if ((self = [super init]))
    {
        _key = [[NSValue valueWithNonretainedObject:object] retain];
        _object = [object weakRetain];
        
        [NSBundle loadNibNamed:@"OODebugInspector" owner:self];
        [self update];
        _timer = [NSTimer scheduledTimerWithTimeInterval:0.1
                                                  target:self
                                                selector:@selector(updateTick:)
                                                userInfo:nil
                                                 repeats:YES];
        
        _modules = [[(id)object debugInspectorModules] retain];
        [self placeModules];
        
        if (sActiveInspectors == nil)  sActiveInspectors = [[NSMutableDictionary alloc] init];
        [sActiveInspectors setObject:self forKey:_key];
    }
    
    return self;
}

inspectorForObject:

+ (id) inspectorForObject:

(id <OOWeakReferenceSupport>)

object

Definition at line 35 of file OODebugInspector.m.

                         :(id <OOWeakReferenceSupport>)object
{
    OODebugInspector        *inspector = nil;
    NSValue                 *key = nil;
    
    if (object == nil)  return nil;
    
    // Look for existing inspector
    key = [NSValue valueWithNonretainedObject:object];
    inspector = [sActiveInspectors objectForKey:key];
    if (inspector != nil)
    {
        if ([inspector object] == object)  return inspector;
        else
        {
            // Existing inspector is for an old object that used to be at the same address.
            [sActiveInspectors removeObjectForKey:key];
        }
    }
    
    // No existing inspector; create one.
    inspector = [[[self alloc] initWithObject:object] autorelease];
    
    return inspector;
}

object

- (id< OOWeakReferenceSupport >) object

Definition at line 35 of file OODebugInspector.m.

{
    if (_object != nil)
    {
        id result = [_object weakRefUnderlyingObject];
        if (result == nil)
        {
            [_object release];
            _object = nil;
        }
        return result;
    }
    else
    {
        return nil;
    }
}

placeModules

- (void) placeModules

implementation

Definition at line 35 of file OODebugInspector.m.

{
    // Lay out modules vertically in panel.
    CGFloat             totalHeight = 4; // Margin at bottom
    NSRect              frame;
    NSView              *contentView = nil, *moduleView = nil;
    NSSize              size;
    
    // Sum heights of modules.
    for (OODebugInspectorModule *module in _modules)
    {
        totalHeight += [[module rootView] frame].size.height;
    }
    
    // Resize panel appropriately.
    frame = [_panel contentRectForFrameRect:[_panel frame]];
    frame.size.height = totalHeight + 4; // Margin at top
    [_panel setFrame:[_panel frameRectForContentRect:frame] display:NO];
    
    size = [_panel contentMinSize];
    size.height = frame.size.height;
    [_panel setContentMinSize:size];
    
    size = [_panel contentMaxSize];
    size.height = frame.size.height;
    [_panel setContentMaxSize:size];
    
    // Position each module.
    contentView = [_panel contentView];
    for (OODebugInspectorModule *module in _modules)
    {
        moduleView = [module rootView];
        frame = [moduleView frame];
        totalHeight -= frame.size.height;
        frame.origin.y = totalHeight;
        [moduleView setFrame:frame];
        [contentView addSubview:moduleView];
    }
    
    [self update];
}

update

- (void) update

implementation

Definition at line 35 of file OODebugInspector.m.

{
    [_modules makeObjectsPerformSelector:@selector(update)];
}

updateTick:

- (void) updateTick: (NSTimer *) timer

implementation

Definition at line 35 of file OODebugInspector.m.

                   :(NSTimer *)timer
{
    if ([_panel isVisible])  [self update];
}

windowWillClose:

- (void) windowWillClose: (NSNotification *) notification

implementation

Definition at line 35 of file OODebugInspector.m.

                       :(NSNotification *)notification
{
    _panel = nil;
    NSValue *key = _key;
    _key = nil;
    if (key != nil)  [sActiveInspectors removeObjectForKey:key];
    [key release];
}

Member Data Documentation

_key

- (NSValue*) _key

private

Definition at line 40 of file OODebugInspector.h.

_modules

- (NSArray*) _modules

private

Definition at line 42 of file OODebugInspector.h.

_object

- (OOWeakReference*) _object

private

Definition at line 37 of file OODebugInspector.h.

_panel

- (IBOutlet NSPanel*) _panel

private

Definition at line 38 of file OODebugInspector.h.

_timer

- (NSTimer*) _timer

private

Definition at line 39 of file OODebugInspector.h.

---

The documentation for this class was generated from the following files:

• Mac-specific/DebugBundle/Source/OODebugInspector.h
• Mac-specific/DebugBundle/Source/OODebugInspector.m