RBSplitSubview(RB___SubviewAdditions) Category Reference

#include <RBSplitViewPrivateDefines.h>

Instance Methods
(void)	- RB___setHidden:
(animationData *)	- RB___animationData:resize:
(void)	- RB___stepAnimation
(BOOL)	- RB___stopAnimation
(CGFloat)	- RB___visibleDimension
(CGFloat)	- RB___setMinAndMaxTo:savingMin:andMax:
(CGFloat)	- RB___collapse
(CGFloat)	- RB___expandAndSetToMinimum:
(void)	- RB___finishCollapse:withFraction:
(void)	- RB___finishExpand:withFraction:
(void)	- RB___setFrameSize:withFraction:
(void)	- RB___setFrame:withFraction:notify:
(double)	- RB___fraction
(void)	- RB___copyIntoCache:
(void)	- RB___updateFromCache:withTotalDimension:
(BOOL)	- RB___clearResponder

Detailed Description

Definition at line 620 of file RBSplitSubview.m.

Method Documentation

RB___animationData:resize:

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

Extends class RBSplitSubview.

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

Extends class RBSplitSubview.

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

Extends class RBSplitSubview.

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

Extends class RBSplitSubview.

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

Extends class RBSplitSubview.

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

Extends class RBSplitSubview.

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

Extends class RBSplitSubview.

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

Extends class RBSplitSubview.

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

Extends class RBSplitSubview.

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

Extends class RBSplitSubview.

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

Extends class RBSplitSubview.

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

Extends class RBSplitSubview.

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

Extends class RBSplitSubview.

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

Extends class RBSplitSubview.

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

Extends class RBSplitSubview.

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

Extends class RBSplitSubview.

Definition at line 16 of file RBSplitSubview.m.

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

---

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

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