#include <RBSplitSubview.h>

Inheritance diagram for RBSplitSubview:

Collaboration diagram for RBSplitSubview:

Instance Methods
(id)	- initWithFrame:

(RBSplitView *)	- splitView

(RBSplitView *)	- couplingSplitView

(RBSplitView *)	- outermostSplitView

(RBSplitView *)	- asSplitView

(RBSplitView *)	- coupledSplitView

(void)	- setCoupled:

(BOOL)	- isCoupled

(BOOL)	- splitViewIsHorizontal

(NSUInteger)	- numberOfSubviews

(void)	- setTag:

(NSInteger)	- tag

(void)	- setIdentifier:

(NSString *)	- identifier

(NSUInteger)	- position

(void)	- setPosition:

(BOOL)	- isCollapsed

(RBSSubviewStatus)	- status

(BOOL)	- canCollapse

(void)	- setCanCollapse:

(BOOL)	- canShrink

(BOOL)	- canExpand

(CGFloat)	- minDimension

(CGFloat)	- maxDimension

(void)	- setMinDimension:andMaxDimension:

(CGFloat)	- expand

(CGFloat)	- collapse

(BOOL)	- collapseWithAnimation

(BOOL)	- expandWithAnimation

(BOOL)	- collapseWithAnimation:withResize:

(BOOL)	- expandWithAnimation:withResize:

(CGFloat)	- dimension

(void)	- setDimension:

(CGFloat)	- changeDimensionBy:mayCollapse:move:

(void)	- dealloc `[implementation]`

(BOOL)	- isFlipped `[implementation]`

(BOOL)	- isOpaque `[implementation]`

(void)	- setHidden: `[implementation]`

(BOOL)	- acceptsFirstResponder `[implementation]`

(NSString *)	- description `[implementation]`

(void)	- drawRect: `[implementation]`

(void)	- display `[implementation]`

(BOOL)	- autoresizesSubviews `[implementation]`

(void)	- setAutoresizesSubviews: `[implementation]`

(void)	- resizeSubviewsWithOldSize: `[implementation]`

(NSView *)	- hitTest: `[implementation]`

(void)	- mouseDown: `[implementation]`

(void)	- encodeWithCoder: `[implementation]`

(id)	- initWithCoder: `[implementation]`

(void)	- RB___setHidden: `[implementation]`

(animationData *)	- RB___animationData:resize: `[implementation]`

(void)	- RB___stepAnimation `[implementation]`

(BOOL)	- RB___stopAnimation `[implementation]`

(CGFloat)	- RB___visibleDimension `[implementation]`

(CGFloat)	- RB___setMinAndMaxTo:savingMin:andMax: `[implementation]`

(CGFloat)	- RB___collapse `[implementation]`

(CGFloat)	- RB___expandAndSetToMinimum: `[implementation]`

(void)	- RB___finishCollapse:withFraction: `[implementation]`

(void)	- RB___finishExpand:withFraction: `[implementation]`

(void)	- RB___setFrameSize:withFraction: `[implementation]`

(void)	- RB___setFrame:withFraction:notify: `[implementation]`

(double)	- RB___fraction `[implementation]`

(void)	- RB___copyIntoCache: `[implementation]`

(void)	- RB___updateFromCache:withTotalDimension: `[implementation]`

(BOOL)	- RB___clearResponder `[implementation]`

Class Methods
(BOOL)	+ animating

Protected Attributes
NSString *	identifier

NSInteger	tag

CGFloat	minDimension

CGFloat	maxDimension

double	fraction

NSRect	previous

NSSize	savedSize

NSUInteger	actDivider

BOOL	canDragWindow

BOOL	canCollapse

BOOL	notInLimits

Detailed Description

Definition at line 22 of file RBSplitSubview.h.

Method Documentation

◆ acceptsFirstResponder

- (BOOL) acceptsFirstResponder

implementation

Definition at line 16 of file RBSplitSubview.m.

                              {
    return NO;
}

References currentAnimation.

◆ animating

+ (BOOL) animating

Definition at line 16 of file RBSplitSubview.m.

                  {
    return currentAnimation!=NULL;
}

◆ asSplitView

- (RBSplitView *) asSplitView

Reimplemented in RBSplitView.

Definition at line 16 of file RBSplitSubview.m.

                            {
    return nil;
}

◆ autoresizesSubviews

- (BOOL) autoresizesSubviews

implementation

Reimplemented in RBSplitView.

Definition at line 16 of file RBSplitSubview.m.

                            {
    return YES;
}

◆ canCollapse

- (BOOL) canCollapse

◆ canExpand

- (BOOL) canExpand

Definition at line 16 of file RBSplitSubview.m.

                  {
    return [self RB___visibleDimension]<maxDimension;
}

◆ canShrink

- (BOOL) canShrink

Definition at line 16 of file RBSplitSubview.m.

                  {
    return [self RB___visibleDimension]>([self canCollapse]?0.0:minDimension);
}

◆ changeDimensionBy:mayCollapse:move:

- (CGFloat) changeDimensionBy:	(CGFloat)	increment
mayCollapse:	(BOOL)	mayCollapse
move:	(BOOL)	move

Definition at line 16 of file RBSplitSubview.m.

                            :(CGFloat)increment mayCollapse:(BOOL)mayCollapse move:(BOOL)move {
    RBSplitView* sv = [self splitView];
    if (!sv||(fabs(increment)<1.0)) {
        return 0.0;
    }
    BOOL ishor = [sv isHorizontal];
    NSRect frame = [self frame];
    CGFloat olddim = DIM(frame.size);
    CGFloat newdim = MAX(0.0,olddim+increment);
    if (newdim<olddim) {
        if (newdim<minDimension) {
// Collapse if needed
            if (mayCollapse&&[self canCollapse]&&(newdim<MAX(1.0,minDimension*(0.5-HYSTERESIS)))) {
                return [self RB___collapse];
            }
            newdim = minDimension;
        }
    } else if (newdim>olddim) {
        if (olddim<1.0) {
// Expand if needed.
            if (newdim>(minDimension*(0.5+HYSTERESIS))) {
                newdim = MAX(newdim,[self RB___expandAndSetToMinimum:YES]);
            } else {
                return 0.0;
            }
        }
        if (newdim>maxDimension) {
            newdim = maxDimension;
        }
    }
    if ((int)newdim!=(int)olddim) {
// The dimension has changed.
        increment = newdim-olddim;
        DIM(frame.size) = newdim;
        if (move) {
            DIM(frame.origin) -= increment;
        }
// We call super instead of self here to postpone adjusting subviews for nested splitviews.
//      [super setFrameSize:frame.size];
        [super setFrame:frame];
        [sv RB___setMustClearFractions];
        [sv setMustAdjust];
    }
    return newdim-olddim;
}

◆ collapse

- (CGFloat) collapse

Definition at line 16 of file RBSplitSubview.m.

                    {
    return [self RB___collapse];
}

◆ collapseWithAnimation

- (BOOL) collapseWithAnimation

Definition at line 16 of file RBSplitSubview.m.

                              {
    return [self collapseWithAnimation:YES withResize:YES];
}

◆ collapseWithAnimation:withResize:

- (BOOL) collapseWithAnimation:		(BOOL)	animate
withResize:		(BOOL)	resize

Definition at line 16 of file RBSplitSubview.m.

                             :(BOOL)animate withResize:(BOOL)resize {
    if ([self status]==RBSSubviewNormal) {
        if ([self canCollapse]) {
            if (animate&&[self RB___animationData:YES resize:resize]) {
                [self RB___clearResponder];
                [self RB___stepAnimation];
                return YES;
            } else {
                [self RB___collapse];
            }
        }
    }
    return NO;
}

◆ coupledSplitView

- (RBSplitView *) coupledSplitView

Reimplemented in RBSplitView.

Definition at line 16 of file RBSplitSubview.m.

                                 {
    return nil;
}

◆ couplingSplitView

- (RBSplitView *) couplingSplitView

Reimplemented in RBSplitView.

Definition at line 16 of file RBSplitSubview.m.

                                  {
    id result = [self superview];
    if ([result isKindOfClass:[RBSplitView class]]) {
        return (RBSplitView*)result;
    }
    return nil;
}

◆ dealloc

- (void) dealloc

implementation

Reimplemented in RBSplitView.

Definition at line 16 of file RBSplitSubview.m.

                {
    [identifier release];
    [super dealloc];
}

◆ description

- (NSString *) description

implementation

Reimplemented in RBSplitView.

Definition at line 16 of file RBSplitSubview.m.

                         {
    return [identifier length]>0?[NSString stringWithFormat:@"%@(%@)",[super description],identifier]:[super description];
}

◆ dimension

- (CGFloat) dimension

Definition at line 16 of file RBSplitSubview.m.

                     {
    CGFloat dim = [self RB___visibleDimension];
    if (dim<=0.0) {
        dim = [[self splitView] RB___dimensionWithoutDividers]*fraction;
        if (dim<minDimension) {
            dim = minDimension;
        } else if (dim>maxDimension) {
            dim = maxDimension;
        }
    }
    return dim;
}

◆ display

- (void) display

implementation

Reimplemented in RBSplitView.

Definition at line 16 of file RBSplitSubview.m.

                {
    RBSplitView* sv = [self splitView];
    if (sv) {
        if ([sv mustAdjust]) {
            [sv display];
        } else {
            [super display];
        }
    }
}

◆ drawRect:

- (void) drawRect: (NSRect) rect

implementation

Reimplemented in RBSplitView.

Definition at line 16 of file RBSplitSubview.m.

                :(NSRect)rect {
    RBSplitView* sv = [self splitView];
    NSColor* bg = [sv background];
    if (bg) {
        [bg set];
        NSRectFillUsingOperation(rect,NSCompositeSourceOver);
    }
    id del = [sv delegate];
    if ([del respondsToSelector:@selector(splitView:willDrawSubview:inRect:)]) {
        [del splitView:sv willDrawSubview:self inRect:rect];
    }
}

◆ encodeWithCoder:

- (void) encodeWithCoder: (NSCoder*) coder

implementation

Reimplemented in RBSplitView.

Definition at line 16 of file RBSplitSubview.m.

                       :(NSCoder*)coder {
    NSRect frame;
    BOOL coll = [self isCollapsed];
    if (coll) {
// We can't encode a collapsed subview as-is, so we correct the frame size first and add WAYOUT
// to the origin to signal it was collapsed. 
        NSRect newf = frame = [self frame];
        newf.origin.x += WAYOUT;
        [super setFrameOrigin:newf.origin];
        newf.size = savedSize;
        [super setFrameSize:newf.size];
    }
    [super encodeWithCoder:coder];
    if (coll) {
        [super setFrame:frame];
    }
    if ([coder allowsKeyedCoding]) {
        [coder encodeObject:identifier forKey:@"identifier"];
        [coder encodeInteger:tag forKey:@"tag"];
        [coder encodeDouble:minDimension forKey:@"minDimension"];
        [coder encodeDouble:maxDimension forKey:@"maxDimension"];
        [coder encodeDouble:fraction forKey:@"fraction"];
        [coder encodeBool:canCollapse forKey:@"canCollapse"];
    } else {
        [coder encodeObject:identifier];
        [coder encodeValueOfObjCType:@encode(typeof(tag)) at:&tag];
        [coder encodeValueOfObjCType:@encode(typeof(minDimension)) at:&minDimension];
        [coder encodeValueOfObjCType:@encode(typeof(maxDimension)) at:&maxDimension];
        [coder encodeValueOfObjCType:@encode(typeof(fraction)) at:&fraction];
        [coder encodeValueOfObjCType:@encode(typeof(canCollapse)) at:&canCollapse];
    }
}

◆ expand

- (CGFloat) expand

Definition at line 16 of file RBSplitSubview.m.

                  {
    return [self RB___expandAndSetToMinimum:NO];
}

◆ expandWithAnimation

- (BOOL) expandWithAnimation

Definition at line 16 of file RBSplitSubview.m.

                            {
    return [self expandWithAnimation:YES withResize:YES];
}

◆ expandWithAnimation:withResize:

- (BOOL) expandWithAnimation:		(BOOL)	animate
withResize:		(BOOL)	resize

Definition at line 16 of file RBSplitSubview.m.

                           :(BOOL)animate withResize:(BOOL)resize {
    if ([self status]==RBSSubviewCollapsed) {
        if (animate&&[self RB___animationData:YES resize:resize]) {
            [self RB___stepAnimation];
            return YES;
        } else {
            [self RB___expandAndSetToMinimum:NO];
        }
    }
    return NO;
}

◆ hitTest:

- (NSView *) hitTest: (NSPoint) aPoint

implementation

Definition at line 16 of file RBSplitSubview.m.

                  :(NSPoint)aPoint {
    if ([self mouse:aPoint inRect:[self frame]]) {
        RBSplitView* sv = [self splitView];
        id delegate = [sv delegate];
        if ([delegate respondsToSelector:@selector(splitView:dividerForPoint:inSubview:)]) {
            actDivider = [delegate splitView:sv dividerForPoint:aPoint inSubview:self];
            if ((actDivider+1)<[sv RB___numberOfSubviews]) {
                return self;
            }
        }
        actDivider = NSNotFound;
        NSView* result = [super hitTest:aPoint];
        canDragWindow = ![[result opaqueAncestor] isDescendantOf:[[result window] contentView]];
        return result;
    }
    return nil;
}

◆ identifier

- (NSString *) identifier

◆ initWithCoder:

- (id) initWithCoder: (NSCoder*) coder

implementation

Reimplemented in RBSplitView.

Definition at line 16 of file RBSplitSubview.m.

                   :(NSCoder*)coder {
    if ((self = [super initWithCoder:coder])) {
        fraction = 0.0;
        canCollapse = NO;
        notInLimits = NO;
        minDimension = 1.0;
        maxDimension = WAYOUT;
        identifier = @"";
        actDivider = NSNotFound;
        canDragWindow = NO;
        previous = [self frame];
        savedSize = previous.size;
        if (previous.origin.x>=WAYOUT) {
// The subview was collapsed when encoded, so we correct the origin and collapse it.
            BOOL ishor = [self splitViewIsHorizontal];
            previous.origin.x -= WAYOUT;
            DIM(previous.size) = 0.0;
            [self setFrameOrigin:previous.origin];
            [self setFrameSize:previous.size];
        }
        previous = NSZeroRect;
        if ([coder allowsKeyedCoding]) {
            [self setIdentifier:[coder decodeObjectForKey:@"identifier"]];
            tag = [coder decodeIntegerForKey:@"tag"];
            minDimension = [coder decodeDoubleForKey:@"minDimension"];
            maxDimension = [coder decodeDoubleForKey:@"maxDimension"];
            fraction = [coder decodeDoubleForKey:@"fraction"];
            canCollapse = [coder decodeBoolForKey:@"canCollapse"];
        } else {
            [self setIdentifier:[coder decodeObject]];
            [coder decodeValueOfObjCType:@encode(typeof(tag)) at:&tag];
            [coder decodeValueOfObjCType:@encode(typeof(minDimension)) at:&minDimension];
            [coder decodeValueOfObjCType:@encode(typeof(maxDimension)) at:&maxDimension];
            [coder decodeValueOfObjCType:@encode(typeof(fraction)) at:&fraction];
            [coder decodeValueOfObjCType:@encode(typeof(canCollapse)) at:&canCollapse];
        }
    }
    return self;
}

◆ initWithFrame:

- (id) initWithFrame: (NSRect) frame

Reimplemented in RBSplitView.

Definition at line 16 of file RBSplitSubview.m.

                   :(NSRect)frame {
    self = [super initWithFrame:frame];
    if (self) {
        fraction = 0.0;
        canCollapse = NO;
        notInLimits = NO;
        minDimension = 1.0;
        maxDimension = WAYOUT;
        identifier = @"";
        previous = NSZeroRect;
        savedSize = frame.size;
        actDivider = NSNotFound;
        canDragWindow = NO;
    }
    return self;
}

◆ isCollapsed

- (BOOL) isCollapsed

Definition at line 16 of file RBSplitSubview.m.

                    {
    return [self RB___visibleDimension]<=0.0;
}

◆ isCoupled

- (BOOL) isCoupled

Definition at line 16 of file RBSplitSubview.m.

                  {
    return NO;
}

◆ isFlipped

- (BOOL) isFlipped

implementation

Reimplemented in RBSplitView.

Definition at line 16 of file RBSplitSubview.m.

                  {
    return NO;
}

◆ isOpaque

- (BOOL) isOpaque

implementation

Reimplemented in RBSplitView.

Definition at line 16 of file RBSplitSubview.m.

                 {
    return [[self couplingSplitView] isOpaque];
}

◆ maxDimension

- (CGFloat) maxDimension

◆ minDimension

- (CGFloat) minDimension

◆ mouseDown:

- (void) mouseDown: (NSEvent*) theEvent

implementation

Reimplemented in RBSplitView.

Definition at line 16 of file RBSplitSubview.m.

                 :(NSEvent*)theEvent {
    NSWindow* window = [self window];
    NSPoint where = [theEvent locationInWindow];
    if (actDivider<NSNotFound) {
        // Cache divider# here for the loop
        NSUInteger thediv = actDivider;
// The mouse down was inside an alternate drag view; actDivider was just set in hitTest.
        RBSplitView* sv = [self splitView];
        NSPoint point = [sv convertPoint:where fromView:nil];
        [[RBSplitView cursor:RBSVDragCursor] push];
        NSPoint base = NSZeroPoint;
// Record the current divider coordinate.
        CGFloat divc = [sv RB___dividerOrigin:thediv];
        BOOL ishor = [sv isHorizontal];
        [sv RB___setDragging:YES];
// Loop while the button is down.
        while ((theEvent = [NSApp nextEventMatchingMask:NSLeftMouseDownMask|NSLeftMouseDraggedMask|NSLeftMouseUpMask untilDate:[NSDate distantFuture] inMode:NSEventTrackingRunLoopMode dequeue:YES])&&([theEvent type]!=NSLeftMouseUp)) {
// Set up a local autorelease pool for the loop to prevent buildup of temporary objects.
            NSAutoreleasePool* pool = [[NSAutoreleasePool alloc] init];
            NSDisableScreenUpdates();
// This does the actual movement.
            [sv RB___trackMouseEvent:theEvent from:point withBase:base inDivider:thediv];
            if ([sv mustAdjust]) {
// If something changed, we clear fractions and redisplay.
                [sv RB___setMustClearFractions];
                [sv display];
            }
// Change the drag point by the actual amount moved.
            CGFloat newc = [sv RB___dividerOrigin:thediv];
            DIM(point) += newc-divc;
            divc = newc;
            NSEnableScreenUpdates();
            [pool drain];
        }
        [sv RB___setDragging:NO];
        [NSCursor pop];
        actDivider = NSNotFound;
        return;
    }
    if (canDragWindow&&[window isMovableByWindowBackground]&&![[self couplingSplitView] background]) {
// If we get here, it's a textured (metal) window, the mouse has gone down on an non-opaque portion
// of the subview, and our RBSplitView has a transparent background. RBSplitView returns NO to
// mouseDownCanMoveWindow, but the window should move here - after all, the window background
// is visible right here! So we fake it and move the window as intended. Mwahahaha!
        where =  [window convertBaseToScreen:where];
        NSPoint origin = [window frame].origin;
// Now we loop handling mouse events until we get a mouse up event.
        while ((theEvent = [NSApp nextEventMatchingMask:NSLeftMouseDownMask|NSLeftMouseDraggedMask|NSLeftMouseUpMask untilDate:[NSDate distantFuture] inMode:NSEventTrackingRunLoopMode dequeue:YES])&&([theEvent type]!=NSLeftMouseUp)) {
// Set up a local autorelease pool for the loop to prevent buildup of temporary objects.
            NSAutoreleasePool* pool = [[NSAutoreleasePool alloc] init];
            NSPoint now = [window convertBaseToScreen:[theEvent locationInWindow]];
            origin.x += now.x-where.x;
            origin.y += now.y-where.y;
// Move the window by the mouse displacement since the last event.
            [window setFrameOrigin:origin];
            where = now;
            [pool drain];
        }
    }
}

◆ numberOfSubviews

- (NSUInteger) numberOfSubviews

Definition at line 16 of file RBSplitSubview.m.

                               {
    return [[self subviews] count];
}

◆ outermostSplitView

- (RBSplitView *) outermostSplitView

Definition at line 16 of file RBSplitSubview.m.

                                   {
    id result = nil;
    id sv = self;
    while ((sv = [sv superview])&&[sv isKindOfClass:[RBSplitView class]]) {
        result = sv;
    }
    return result;
}

◆ position

- (NSUInteger) position

Definition at line 16 of file RBSplitSubview.m.

                       {
    RBSplitView* sv = [self splitView];
    return sv?[[sv subviews] indexOfObjectIdenticalTo:self]:0;
}

◆ RB___animationData:resize:

- (animationData *) RB___animationData:		(BOOL)	start
resize:		(BOOL)	resize

implementation

Provided by category RBSplitSubview(RB___SubviewAdditions).

Definition at line 16 of file RBSplitSubview.m.

                                    :(BOOL)start resize:(BOOL)resize {
    if (currentAnimation&&(currentAnimation->owner!=self)) {
// There already is an animation in progress on some other subview.
        return nil;
    }
    if (start) {
// We want to start (or restart) an animation.
        RBSplitView* sv = [self splitView];
        if (sv) {
            CGFloat dim = [self dimension];
// First assume the default time, then ask the delegate.
            NSTimeInterval total = dim*(0.2/150.0);
            id delegate = [sv delegate];
            if ([delegate respondsToSelector:@selector(splitView:willAnimateSubview:withDimension:)]) {
                total = [delegate splitView:sv willAnimateSubview:self withDimension:dim];
            }
// No use animating anything shorter than the frametime.
            if (total>FRAMETIME) {
                if (!currentAnimation) {
                    currentAnimation = (animationData*)malloc(sizeof(animationData));
                }
                if (currentAnimation) {
                    currentAnimation->owner = self;
                    currentAnimation->stepsDone = 0;
                    currentAnimation->elapsedTime = 0.0;
                    currentAnimation->dimension = dim;
                    currentAnimation->collapsing = ![self isCollapsed];
                    currentAnimation->totalTime = total;
                    currentAnimation->finishTime = [NSDate timeIntervalSinceReferenceDate]+total;
                    currentAnimation->resizing = resize;
                    [sv RB___setDragging:YES];
                }
            } else if (currentAnimation) {
                free(currentAnimation);
                currentAnimation = NULL;
            }
        }
    }
    return currentAnimation;
}

◆ RB___clearResponder

- (BOOL) RB___clearResponder

implementation

Provided by category RBSplitSubview(RB___SubviewAdditions).

Definition at line 16 of file RBSplitSubview.m.

                            {
    NSWindow* window = [self window];
    if (window) {
        NSView* responder = (NSView*)[window firstResponder];
        if (responder&&[responder respondsToSelector:@selector(isDescendantOf:)]) {
            if ([responder isDescendantOf:self]) {
                if ([window makeFirstResponder:nil]) {
                    [responder display];
                    return YES;
                }
            }
        }
    }
    return NO;
}

◆ RB___collapse

- (CGFloat) RB___collapse

implementation

Provided by category RBSplitSubview(RB___SubviewAdditions).

Definition at line 16 of file RBSplitSubview.m.

                         {
    CGFloat result = 0.0;
    if (![self isCollapsed]) {
        RBSplitView* sv = [self splitView];
        if (sv&&[self canCollapse]) {
            [self RB___clearResponder];
            NSRect frame = [self frame];
            BOOL ishor = [sv isHorizontal];
            result = DIM(frame.size);
// For collapsed views, fraction will contain the fraction of the dimension previously occupied
            DIM(frame.size) = 0.0;
            [self RB___finishCollapse:frame withFraction:result/[sv RB___dimensionWithoutDividers]];
        }
    }
    return -result;
}

◆ RB___copyIntoCache:

- (void) RB___copyIntoCache: (subviewCache*) cache

implementation

Provided by category RBSplitSubview(RB___SubviewAdditions).

Definition at line 16 of file RBSplitSubview.m.

                          :(subviewCache*)cache {
    cache->sub = self;
    cache->rect = [self frame];
    cache->size = [self RB___visibleDimension];
    cache->fraction = fraction;
    cache->constrain = NO;
}

◆ RB___expandAndSetToMinimum:

- (CGFloat) RB___expandAndSetToMinimum: (BOOL) setToMinimum

implementation

Provided by category RBSplitSubview(RB___SubviewAdditions).

Definition at line 16 of file RBSplitSubview.m.

                                     :(BOOL)setToMinimum {
    CGFloat result = 0.0;
    RBSplitView* sv = [self splitView];
    if (sv&&[self isCollapsed]) {
        NSRect frame = [super frame];
        double frac = fraction;
        BOOL ishor = [sv isHorizontal];
        if (setToMinimum) {
            result = DIM(frame.size) = minDimension;
        } else {
            result = [sv RB___dimensionWithoutDividers]*frac;
// We need to apply a compensation factor for proportional resizing in adjustSubviews.
            CGFloat newdim = floor((frac>=1.0)?result:result/(1.0-frac));
            DIM(frame.size) = newdim;
            result = floor(result);
        }
        [self RB___finishExpand:frame withFraction:0.0];
    }
    return result;
}

◆ RB___finishCollapse:withFraction:

- (void) RB___finishCollapse:		(NSRect)	rect
withFraction:		(double)	value

implementation

Provided by category RBSplitSubview(RB___SubviewAdditions).

Definition at line 16 of file RBSplitSubview.m.

                           :(NSRect)rect withFraction:(double)value {
    RBSplitView* sv = [self splitView];
    BOOL finish = [self RB___stopAnimation];
    [self RB___setFrame:rect withFraction:value notify:YES];
    [sv RB___setMustClearFractions];
    if (finish) {
        [self display];
    }
    id delegate = [sv delegate];
    if ([delegate respondsToSelector:@selector(splitView:didCollapse:)]) {
        [delegate splitView:sv didCollapse:self];
    }
}

◆ RB___finishExpand:withFraction:

- (void) RB___finishExpand:		(NSRect)	rect
withFraction:		(double)	value

implementation

Provided by category RBSplitSubview(RB___SubviewAdditions).

Definition at line 16 of file RBSplitSubview.m.

                         :(NSRect)rect withFraction:(double)value {
    RBSplitView* sv = [self splitView];
    BOOL finish = [self RB___stopAnimation];
    [self RB___setFrame:rect withFraction:value notify:YES];
    [sv RB___setMustClearFractions];
    if (finish) {
        [self display];
    }
    id delegate = [sv delegate];
    if ([delegate respondsToSelector:@selector(splitView:didExpand:)]) {
        [delegate splitView:sv didExpand:self];
    }
}

◆ RB___fraction

- (double) RB___fraction

implementation

Provided by category RBSplitSubview(RB___SubviewAdditions).

Definition at line 16 of file RBSplitSubview.m.

                        {
    return fraction;
}

◆ RB___setFrame:withFraction:notify:

- (void) RB___setFrame:	(NSRect)	rect
withFraction:	(double)	value
notify:	(BOOL)	notify

implementation

Provided by category RBSplitSubview(RB___SubviewAdditions).

Definition at line 16 of file RBSplitSubview.m.

                     :(NSRect)rect withFraction:(double)value notify:(BOOL)notify {
    RBSplitView* sv = [self splitView];
    id delegate = nil;
    if (notify) {
        delegate = [sv delegate];
// If the delegate method isn't implemented, we ignore the delegate altogether.
        if ([delegate respondsToSelector:@selector(splitView:changedFrameOfSubview:from:to:)]) {
// If the rects are equal, the delegate isn't called.
            if (NSEqualRects(previous,rect)) {
                delegate = nil;
            }
        } else {
            delegate = nil;
        }
    }
    [sv setMustAdjust];
    [self setFrame:rect];
    fraction = value;
    [delegate splitView:sv changedFrameOfSubview:self from:previous to:rect];
    previous = delegate?rect:NSZeroRect;
}

◆ RB___setFrameSize:withFraction:

- (void) RB___setFrameSize:		(NSSize)	size
withFraction:		(double)	value

implementation

Provided by category RBSplitSubview(RB___SubviewAdditions).

Definition at line 16 of file RBSplitSubview.m.

                         :(NSSize)size withFraction:(double)value {
    [[self splitView] setMustAdjust];
    [self setFrameSize:size];
    fraction = value;
}

◆ RB___setHidden:

- (void) RB___setHidden: (BOOL) flag

implementation

Provided by category RBSplitSubview(RB___SubviewAdditions).

Definition at line 16 of file RBSplitSubview.m.

                      :(BOOL)flag {
    [super setHidden:flag];
}

◆ RB___setMinAndMaxTo:savingMin:andMax:

- (CGFloat) RB___setMinAndMaxTo:	(CGFloat)	value
savingMin:	(CGFloat*)	oldmin
andMax:	(CGFloat*)	oldmax

implementation

Provided by category RBSplitSubview(RB___SubviewAdditions).

Definition at line 16 of file RBSplitSubview.m.

                              :(CGFloat)value savingMin:(CGFloat*)oldmin andMax:(CGFloat*)oldmax {
    *oldmin = [self minDimension];
    *oldmax = [self maxDimension];
    if (value<*oldmin) {
        value = *oldmin;
    }
    if (value>*oldmax) {
        value = *oldmax;
    }
    minDimension = maxDimension = value;
    return value;
}

◆ RB___stepAnimation

- (void) RB___stepAnimation

implementation

Provided by category RBSplitSubview(RB___SubviewAdditions).

Definition at line 16 of file RBSplitSubview.m.

                           {
    NSTimeInterval now = [NSDate timeIntervalSinceReferenceDate];
    animationData* anim = [self RB___animationData:NO resize:NO];
    if (anim) {
        RBSplitView* sv = [self splitView];
        NSTimeInterval remain = anim->finishTime-now;
        NSRect frame = [self frame];
        BOOL ishor = [sv isHorizontal];
// Continuing animation only makes sense if we still have at least FRAMETIME available.
        if (remain>=FRAMETIME) {
            CGFloat avg = anim->elapsedTime;
// We try to keep a record of how long it takes, on the average, to resize and adjust
// one animation frame.
            if (anim->stepsDone) {
                avg /= anim->stepsDone;
            }
            NSTimeInterval delay = MIN(0.0,FRAMETIME-avg);
// We adjust the new dimension proportionally to how much of the designated time has passed.
            CGFloat dim = floor(anim->dimension*(remain-avg)/anim->totalTime);
            if (dim>4.0) {
                if (!anim->collapsing) {
                    dim = anim->dimension-dim;
                } 
                DIM(frame.size) = dim;
                [self RB___setFrame:frame withFraction:0.0 notify:NO];
                [sv adjustSubviews];
                [self display];
                anim->elapsedTime += [NSDate timeIntervalSinceReferenceDate]-now;
                ++anim->stepsDone;
// Schedule a timer to do the next animation step.
                [self performSelector:@selector(RB___stepAnimation) withObject:nil afterDelay:delay inModes:[NSArray arrayWithObjects:NSDefaultRunLoopMode,NSModalPanelRunLoopMode,
                    NSEventTrackingRunLoopMode,nil]];
                return;
            }
        }
// We're finished, either collapse or expand entirely now.
        if (anim->collapsing) {
            DIM(frame.size) = 0.0;
            [self RB___finishCollapse:frame withFraction:anim->dimension/[sv RB___dimensionWithoutDividers]];
        } else {
            CGFloat savemin,savemax;
            CGFloat dim = [self RB___setMinAndMaxTo:anim->dimension savingMin:&savemin andMax:&savemax];
            DIM(frame.size) = dim;
            [self RB___finishExpand:frame withFraction:0.0];
            minDimension = savemin;
            maxDimension = savemax;
        }
    }
}

◆ RB___stopAnimation

- (BOOL) RB___stopAnimation

implementation

Provided by category RBSplitSubview(RB___SubviewAdditions).

Definition at line 16 of file RBSplitSubview.m.

                           {
    if (currentAnimation&&(currentAnimation->owner==self)) {
        [NSObject cancelPreviousPerformRequestsWithTarget:self selector:@selector(RB___stepAnimation) object:nil];
        free(currentAnimation);
        currentAnimation = NULL;
        [[self splitView] RB___setDragging:NO];
        return YES;
    }
    return NO;
}

◆ RB___updateFromCache:withTotalDimension:

- (void) RB___updateFromCache:		(subviewCache*)	cache
withTotalDimension:		(CGFloat)	value

implementation

Provided by category RBSplitSubview(RB___SubviewAdditions).

Definition at line 16 of file RBSplitSubview.m.

                            :(subviewCache*)cache withTotalDimension:(CGFloat)value {
    CGFloat dim = [self RB___visibleDimension];
    if (cache->size>=1.0) {
// New state is not collapsed.
        if (dim>=1.0) {
// Old state was not collapsed, so we just change the frame.
            [self RB___setFrame:cache->rect withFraction:cache->fraction notify:YES];
        } else {
// Old state was collapsed, so we expand it.
            [self RB___finishExpand:cache->rect withFraction:cache->fraction];
        }
    } else {
// New state is collapsed.
        if (dim>=1.0) {
// Old state was not collapsed, so we clear first responder and change the frame.
            [self RB___clearResponder];
            [self RB___finishCollapse:cache->rect withFraction:dim/value];
        } else {
// It was collapsed already, but the frame may have changed, so we set it.
            [self RB___setFrame:cache->rect withFraction:cache->fraction notify:YES];
        }
    }
}

◆ RB___visibleDimension

- (CGFloat) RB___visibleDimension

implementation

Provided by category RBSplitSubview(RB___SubviewAdditions).

Definition at line 16 of file RBSplitSubview.m.

                                 {
    BOOL ishor = [self splitViewIsHorizontal];
    NSRect frame = [self frame];
    return MAX(0.0,DIM(frame.size));
}

◆ resizeSubviewsWithOldSize:

- (void) resizeSubviewsWithOldSize: (NSSize) oldBoundsSize

implementation

Definition at line 16 of file RBSplitSubview.m.

                                 :(NSSize)oldBoundsSize {
    RBSplitView* sv = [self splitView];
    if (sv) {
        BOOL ishor = [sv isHorizontal];
        NSRect frame = [self frame];
        CGFloat dim = DIM(frame.size);
        CGFloat other = OTHER(frame.size);
// We resize subviews only when we're inside the subview's limits and the containing splitview's limits.
        animationData* anim = [self RB___animationData:NO resize:NO];
        if ((dim>=(anim&&!anim->resizing?anim->dimension:minDimension))&&(dim<=maxDimension)&&(other>=[sv minDimension])&&(other<=[sv maxDimension])) {
            if (notInLimits) {
// The subviews can be resized, so we restore the saved size.
                oldBoundsSize = savedSize;
            }
// We save the size every time the subview's subviews are resized within the limits.
            notInLimits = NO;
            savedSize = frame.size;
            [super resizeSubviewsWithOldSize:oldBoundsSize];
        } else {
            notInLimits = YES;
        }
    }
}

◆ setAutoresizesSubviews:

- (void) setAutoresizesSubviews: (BOOL) flag

implementation

Definition at line 16 of file RBSplitSubview.m.

379 :(BOOL)flag {

380}

◆ setCanCollapse:

- (void) setCanCollapse: (BOOL) flag

Definition at line 16 of file RBSplitSubview.m.

                      :(BOOL)flag {
    canCollapse = flag;
}

◆ setCoupled:

- (void) setCoupled: (BOOL) flag

Reimplemented in RBSplitView.

Definition at line 16 of file RBSplitSubview.m.

61 :(BOOL)flag {

62}

◆ setDimension:

- (void) setDimension: (CGFloat) value

Definition at line 16 of file RBSplitSubview.m.

                    :(CGFloat)value {
    if (value<minDimension) {
        value = minDimension;
    } else if (value>maxDimension) {
        value = maxDimension;
    }
    RBSplitView* sv = [self splitView];
    NSSize size = [self frame].size;
    BOOL ishor = [sv isHorizontal];
    if (DIM(size)>0.0) {
// We're not collapsed, set the size and adjust other subviews.
        DIM(size) = value;
        [self setFrameSize:size];
        [sv adjustSubviewsExcepting:self];
    } else {
// We're collapsed, adjust the fraction so that we'll have the (approximately) correct
// dimension after expanding.
        fraction = value/[sv RB___dimensionWithoutDividers];
    }
}

◆ setHidden:

- (void) setHidden: (BOOL) flag

implementation

Definition at line 16 of file RBSplitSubview.m.

                 :(BOOL)flag {
    if ([self isHidden]!=flag) {
        RBSplitView* sv = [self splitView];
        [self RB___setHidden:flag];
        if (flag) {
            [sv adjustSubviews];
        } else {
            [sv adjustSubviewsExcepting:self];
        }
    }
}

◆ setIdentifier:

- (void) setIdentifier: (NSString*) aString

Definition at line 16 of file RBSplitSubview.m.

                     :(NSString*)aString {
    [identifier autorelease];
    identifier = aString?[aString retain]:@"";
}

◆ setMinDimension:andMaxDimension:

- (void) setMinDimension:		(CGFloat)	newMinDimension
andMaxDimension:		(CGFloat)	newMaxDimension

Definition at line 16 of file RBSplitSubview.m.

                       :(CGFloat)newMinDimension andMaxDimension:(CGFloat)newMaxDimension {
    minDimension = MAX(1.0,floor(newMinDimension));
    if (newMaxDimension<1.0) {
        newMaxDimension = WAYOUT;
    }
    maxDimension = MAX(minDimension,floor(newMaxDimension));
    CGFloat dim = [self dimension];
    if ((dim<minDimension)||(dim>maxDimension)) {
        [[self splitView] setMustAdjust];
    }
}

◆ setPosition:

- (void) setPosition: (NSUInteger) newPosition

Definition at line 16 of file RBSplitSubview.m.

                   :(NSUInteger)newPosition {
    RBSplitView* sv = [self splitView];
    if (sv) {
        [self retain];
        [self removeFromSuperviewWithoutNeedingDisplay];
        NSArray* subviews = [sv subviews];
        if (newPosition>=[subviews count]) {
            [sv addSubview:self positioned:NSWindowAbove relativeTo:nil];
        } else {
            [sv addSubview:self positioned:NSWindowBelow relativeTo:[subviews objectAtIndex:newPosition]];
        }
        [self release];
    }
}

◆ setTag:

- (void) setTag: (NSInteger) theTag

Definition at line 16 of file RBSplitSubview.m.

              :(NSInteger)theTag {
    tag = theTag;
}

◆ splitView

- (RBSplitView *) splitView

Definition at line 16 of file RBSplitSubview.m.

                          {
    id result = [self superview];
    if ([result isKindOfClass:[RBSplitView class]]) {
        return (RBSplitView*)result;
    }
    return nil;
}

◆ splitViewIsHorizontal

- (BOOL) splitViewIsHorizontal

Definition at line 16 of file RBSplitSubview.m.

                              {
    return [[self splitView] isHorizontal];
}

◆ status

- (RBSSubviewStatus) status

Definition at line 16 of file RBSplitSubview.m.

                           {
    animationData* anim = [self RB___animationData:NO resize:NO];
    if (anim) {
        return anim->collapsing?RBSSubviewCollapsing:RBSSubviewExpanding;
    }
    return [self RB___visibleDimension]<=0.0?RBSSubviewCollapsed:RBSSubviewNormal;
}

◆ tag

- (NSInteger) tag

Member Data Documentation

◆ actDivider

- (NSUInteger) actDivider

protected

Definition at line 38 of file RBSplitSubview.h.

◆ canCollapse

- (BOOL) canCollapse

protected

Definition at line 40 of file RBSplitSubview.h.

◆ canDragWindow

- (BOOL) canDragWindow

protected

Definition at line 39 of file RBSplitSubview.h.

◆ fraction

- (double) fraction

protected

Definition at line 31 of file RBSplitSubview.h.

◆ identifier

- (NSString *) identifier

protected

Definition at line 26 of file RBSplitSubview.h.

◆ maxDimension

- (CGFloat) maxDimension

protected

Definition at line 29 of file RBSplitSubview.h.

◆ minDimension

- (CGFloat) minDimension

protected

Definition at line 28 of file RBSplitSubview.h.

◆ notInLimits

- (BOOL) notInLimits

protected

Definition at line 41 of file RBSplitSubview.h.

◆ previous

- (NSRect) previous

protected

Definition at line 35 of file RBSplitSubview.h.

◆ savedSize

- (NSSize) savedSize

protected

Definition at line 36 of file RBSplitSubview.h.

◆ tag

- (NSInteger) tag

protected

Definition at line 27 of file RBSplitSubview.h.

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

Mac-specific/DebugBundle/Source/RBSplitView/RBSplitSubview.h
Mac-specific/DebugBundle/Source/RBSplitView/RBSplitSubview.m

Instance Methods

Class Methods

Protected Attributes

Detailed Description

Method Documentation

◆ acceptsFirstResponder

◆ animating

◆ asSplitView

◆ autoresizesSubviews

◆ canCollapse

◆ canExpand

◆ canShrink

◆ changeDimensionBy:mayCollapse:move:

◆ collapse

◆ collapseWithAnimation

◆ collapseWithAnimation:withResize:

◆ coupledSplitView

◆ couplingSplitView

◆ dealloc

◆ description

◆ dimension

◆ display

◆ drawRect:

◆ encodeWithCoder:

◆ expand

◆ expandWithAnimation

◆ expandWithAnimation:withResize:

◆ hitTest:

◆ identifier

◆ initWithCoder:

◆ initWithFrame:

◆ isCollapsed

◆ isCoupled

◆ isFlipped

◆ isOpaque

◆ maxDimension

◆ minDimension

◆ mouseDown:

◆ numberOfSubviews

◆ outermostSplitView

◆ position

◆ RB___animationData:resize:

◆ RB___clearResponder

◆ RB___collapse

◆ RB___copyIntoCache:

◆ RB___expandAndSetToMinimum:

◆ RB___finishCollapse:withFraction:

◆ RB___finishExpand:withFraction:

◆ RB___fraction

◆ RB___setFrame:withFraction:notify:

◆ RB___setFrameSize:withFraction:

◆ RB___setHidden:

◆ RB___setMinAndMaxTo:savingMin:andMax:

◆ RB___stepAnimation

◆ RB___stopAnimation

◆ RB___updateFromCache:withTotalDimension:

◆ RB___visibleDimension

◆ resizeSubviewsWithOldSize:

◆ setAutoresizesSubviews:

◆ setCanCollapse:

◆ setCoupled:

◆ setDimension:

◆ setHidden:

◆ setIdentifier:

◆ setMinDimension:andMaxDimension:

◆ setPosition:

◆ setTag:

◆ splitView

◆ splitViewIsHorizontal

◆ status

◆ tag

Member Data Documentation

◆ actDivider

◆ canCollapse

◆ canDragWindow

◆ fraction

◆ identifier

◆ maxDimension

◆ minDimension

◆ notInLimits