libs-gui/Source/NSScroller.m

899 lines
22 KiB
Mathematica
Raw Normal View History

/*
NSScroller.m
Copyright (C) 1996 Free Software Foundation, Inc.
Author: Ovidiu Predescu <ovidiu@net-community.com>
A completely rewritten version of the original source by Scott Christley.
Date: July 1997
* NSApplication.h added windows_need_update as autodisplay ivar. * NSApplication.m in init set default for main_menu, windows_need_update. * NSApplication.m in run added support for OPENSTEP autodisplay mechanism. * NSApplication.m _eventMatchingMask: reformat. * NSApplication.m nextEventMatchingMask:untilDate:inMode:dequeue: move calls to _flushWindows to XDPS backend. * NSApplication.m implemented updateWindows. * NSApplication.m implemented setWindowsNeedUpdate:. * NSApplication.m setMainMenu: test for menu prior to release. * NSActionCell.m removed setState: method. * NSActionCell.m copyWithZone: optimized ivar copying. * NSButtonCell.m added _init and moved common defaults to this method. * NSButtonCell.m initImageCell: and initTextCell: minor optimizations. * NSButtonCell.m setAlternateTitle: optimize and use ASSIGN macro. * NSButtonCell.m setKeyEquivalent: remove [copy release]. * NSButtonCell.m setKeyEquivalentFont:size: optimize. * NSButtonCell.m copyWithZone: optimized ivar copying where possible. * NSCell.m _init removed call to [super init]. * NSCell.m initTextCell: removed duplicate default initializers. * NSCell.m setImage: rewrote to use ASSIGN macro. * NSCell.m setDoubleValue: rewrote to use ASSIGN macro. * NSCell.m setFloatValue: rewrote to use ASSIGN macro. * NSCell.m setIntValue: rewrote to use ASSIGN macro. * NSCell.m setStringValue: rewrote to use ASSIGN macro. * NSCell.m setFont: rewrote to use ASSIGN macro. * NSCell.m setRepresentedObject: rewrote to use ASSIGN macro. * NSCell.m copyWithZone: optimized ivar copying where possible. * NSClipView.m viewBoundsChanged: minor optimization. * NSClipView.m viewFrameChanged: minor optimization. * NSClipView.m scaleUnitSquareToSize: minor optimization. * NSClipView.m setBoundsOrigin: minor optimization. * NSClipView.m setBoundsSize: minor optimization. * NSClipView.m setFrameSize: minor optimization. * NSClipView.m setFrameOrigin: minor optimization. * NSClipView.m setFrame: minor optimization. * NSClipView.m translateOriginToPoint: minor optimization. * NSMatrix.m eliminate retain/release of selected cell via ASSIGN. * NSMatrix.m initWithFrame: remove duplicate setting of selected row and column. * NSMatrix.m removeColumn: rewrite so that col is removed before new selection is attempted (needed because selected cell is not retained). * NSMatrix.m removeRow: rewrite so that row is removed before new selection is attempted (needed because selected cell is not retained). * NSMatrix.m deselectAllCells per OS spec try to select a cell at end if empty selection is not allowed. * NSMatrix.m deselectSelectedCell set default selected row/col to 0. * NSMatrix.m mouseDown: optimize for new drawing behaviour. * NSMenu.m setSelectedCell: eliminate use of retain/release of selected cell via ASSIGN. * NSMenuItem.m copyWithZone: optimized ivar copying where possible. * NSMenuItem.m dealloc minor optimization. * NSMenuItem.m setTarget: minor optimization. * NSScroller.m trackScrollButtons: heavily optimized. * NSScroller.m sendAction: reimplemented to use sendAction: per spec also optimized. * NSText.m implemented init method. * NSText.m initWithFrame: fixed initialization of ivars which are released to retain. * NSText.m dealloc add release of retained ivars. * NSView.m dealloc add release of retained ivars. * NSView.m displayRect: and _addSubviewForNeedingDisplay reformatted code and rewrote comments. * NSWindow.m setFrame:display: rewrote for clarity. * NSWindow.m implemented update method per OPENSTEP spec. git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/libs/gui/trunk@2941 72102866-910b-0410-8b05-ffd578937521
1998-08-30 16:06:47 +00:00
Author: Felipe A. Rodriguez <far@ix.netcom.com>
Date: August 1998
Author: Richard frith-Macdonald <richard@brainstorm.co.uk>
Date: Mar 1999 - Use flipped views and make conform to spec
This file is part of the GNUstep GUI Library.
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Library General Public License for more details.
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
*/
#include <gnustep/gui/config.h>
#include <math.h>
#include <Foundation/NSDate.h>
#include <Foundation/NSRunLoop.h>
#include <AppKit/NSScroller.h>
#include <AppKit/NSScrollView.h>
#include <AppKit/NSWindow.h>
#include <AppKit/NSButtonCell.h>
#include <AppKit/NSApplication.h>
#include <AppKit/NSImage.h>
#include <AppKit/NSColor.h>
#include <AppKit/NSGraphics.h>
@implementation NSScroller
//
// Class variables
//
static NSButtonCell* upCell = nil; // button cells used by
static NSButtonCell* downCell = nil; // scroller instances
static NSButtonCell* leftCell = nil; // to draw scroller
static NSButtonCell* rightCell = nil; // buttons and knob.
static NSButtonCell* knobCell = nil;
static const float scrollerWidth = 17;
static const float buttonsWidth = 16;
static const float buttonsDistance = 1;
static float halfKnobRectHeight;
static float slotOriginPlusKnobHeight;
static float slotOriginPlusSlotHeightMinusKnobHeight;
static float slotHeightMinusKnobHeight;
static float halfKnobRectWidth;
static float slotOriginPlusKnobWidth;
static float slotOriginPlusSlotWidthMinusHalfKnobWidth;
static float slotWidthMinusKnobWidth;
static NSRect slotRect = {{0,0},{0,0}};
static BOOL preCalcValues = NO;
//
// Class methods
//
+ (void) initialize
{
if (self == [NSScroller class])
[self setVersion: 1];
}
+ (float) scrollerWidth
{
return scrollerWidth;
}
- (BOOL) isFlipped
{
return YES;
}
- (NSScrollArrowPosition) arrowsPosition
{
return _arrowsPosition;
}
- (NSUsableScrollerParts) usableParts
{
return _usableParts;
}
- (float) knobProportion
{
return _knobProportion;
}
- (NSScrollerPart) hitPart
{
return _hitPart;
}
- (float) floatValue
{
return _floatValue;
}
- (void) setAction: (SEL)action
{
_action = action;
}
- (SEL) action
{
return _action;
}
- (void) setTarget: (id)target
{
ASSIGN(_target, target);
}
- (id) target
{
return _target;
}
- (void) encodeWithCoder: (NSCoder*)aCoder
{
}
- (id) initWithCoder: (NSCoder*)aDecoder
{
return self;
}
- (BOOL) isOpaque
{
return YES;
}
- (id) initWithFrame: (NSRect)frameRect
{
// determine the orientation of the scroller and adjust it's size accordingly
if (frameRect.size.width > frameRect.size.height)
{
_isHorizontal = YES;
frameRect.size.height = [isa scrollerWidth];
}
else
{
_isHorizontal = NO;
frameRect.size.width = [isa scrollerWidth];
}
[super initWithFrame: frameRect];
if (_isHorizontal)
{
_arrowsPosition = NSScrollerArrowsMinEnd;
_floatValue = 0.0;
}
else
{
_arrowsPosition = NSScrollerArrowsMaxEnd;
_floatValue = 1.0;
}
_hitPart = NSScrollerNoPart;
[self drawParts];
[self setEnabled: NO];
[self checkSpaceForParts];
return self;
}
- (id) init
{
return [self initWithFrame: NSZeroRect];
}
- (void) drawParts
{
// Create the class variable button cells if they do not yet exist.
if (knobCell)
return;
upCell = [NSButtonCell new];
[upCell setHighlightsBy: NSChangeBackgroundCellMask|NSContentsCellMask];
[upCell setImage: [NSImage imageNamed: @"common_ArrowUp"]];
[upCell setAlternateImage: [NSImage imageNamed: @"common_ArrowUpH"]];
[upCell setImagePosition: NSImageOnly];
[upCell setContinuous: YES];
[upCell setPeriodicDelay: 0.05 interval: 0.05];
downCell = [NSButtonCell new];
[downCell setHighlightsBy: NSChangeBackgroundCellMask|NSContentsCellMask];
[downCell setImage: [NSImage imageNamed: @"common_ArrowDown"]];
[downCell setAlternateImage: [NSImage imageNamed: @"common_ArrowDownH"]];
[downCell setImagePosition: NSImageOnly];
[downCell setContinuous: YES];
[downCell setPeriodicDelay: 0.05 interval: 0.05];
leftCell = [NSButtonCell new];
[leftCell setHighlightsBy: NSChangeBackgroundCellMask|NSContentsCellMask];
[leftCell setImage: [NSImage imageNamed: @"common_ArrowLeft"]];
[leftCell setAlternateImage: [NSImage imageNamed: @"common_ArrowLeftH"]];
[leftCell setImagePosition: NSImageOnly];
[leftCell setContinuous: YES];
[leftCell setPeriodicDelay: 0.05 interval: 0.05];
rightCell = [NSButtonCell new];
[rightCell setHighlightsBy: NSChangeBackgroundCellMask|NSContentsCellMask];
[rightCell setImage: [NSImage imageNamed: @"common_ArrowRight"]];
[rightCell setAlternateImage: [NSImage imageNamed: @"common_ArrowRightH"]];
[rightCell setImagePosition: NSImageOnly];
[rightCell setContinuous: YES];
[rightCell setPeriodicDelay: 0.05 interval: 0.05];
knobCell = [NSButtonCell new];
[knobCell setButtonType: NSMomentaryChangeButton];
[knobCell setImage: [NSImage imageNamed: @"common_Dimple"]];
[knobCell setImagePosition: NSImageOnly];
}
- (void) _setTargetAndActionToCells
{
[upCell setTarget: _target];
[upCell setAction: _action];
[downCell setTarget: _target];
[downCell setAction: _action];
[leftCell setTarget: _target];
[leftCell setAction: _action];
[rightCell setTarget: _target];
[rightCell setAction: _action];
[knobCell setTarget: _target];
[knobCell setAction: _action];
}
- (void) checkSpaceForParts
{
NSSize frameSize = [self frame].size;
float size = (_isHorizontal ? frameSize.width : frameSize.height);
float scrollerWidth = [isa scrollerWidth];
if (_arrowsPosition == NSScrollerArrowsNone)
{
if (size > scrollerWidth + 1)
_usableParts = NSAllScrollerParts;
else
_usableParts = NSNoScrollerParts;
}
else
{
if (size > 3 * scrollerWidth + 2)
_usableParts = NSAllScrollerParts;
else if (size > 2 * scrollerWidth + 1)
_usableParts = NSOnlyScrollerArrows;
else
_usableParts = NSNoScrollerParts;
}
}
- (void) setEnabled: (BOOL)flag
{
if (_isEnabled == flag)
return;
_isEnabled = flag;
[self setNeedsDisplay: YES];
}
- (void) setArrowsPosition: (NSScrollArrowPosition)where
{
if (_arrowsPosition == where)
return;
_arrowsPosition = where;
[self setNeedsDisplay: YES];
}
- (void) setFloatValue: (float)aFloat
{
if (aFloat < 0)
_floatValue = 0;
else if (aFloat > 1)
_floatValue = 1;
else
_floatValue = aFloat;
[self setNeedsDisplayInRect: [self rectForPart: NSScrollerKnobSlot]];
}
- (void) setFloatValue: (float)aFloat knobProportion: (float)ratio
{
if (ratio < 0)
_knobProportion = 0;
else if (ratio > 1)
_knobProportion = 1;
else
_knobProportion = ratio;
[self setFloatValue: aFloat];
}
- (void) setFrame: (NSRect)frameRect
{
// determine the orientation of the scroller and adjust it's size accordingly
if (frameRect.size.width > frameRect.size.height)
{
_isHorizontal = YES;
frameRect.size.height = [isa scrollerWidth];
}
else
{
_isHorizontal = NO;
frameRect.size.width = [isa scrollerWidth];
}
[super setFrame: frameRect];
if (_isHorizontal)
_arrowsPosition = NSScrollerArrowsMinEnd;
else
_arrowsPosition = NSScrollerArrowsMaxEnd;
_hitPart = NSScrollerNoPart;
[self checkSpaceForParts];
}
- (void) setFrameSize: (NSSize)size
{
[super setFrameSize: size];
[self checkSpaceForParts];
[self setNeedsDisplay: YES];
}
- (NSScrollerPart)testPart: (NSPoint)thePoint
{
// return what part of the scroller the mouse hit
NSRect rect;
if (thePoint.x < 0 || thePoint.x > frame.size.width
|| thePoint.y < 0 || thePoint.y > frame.size.height)
return NSScrollerNoPart;
rect = [self rectForPart: NSScrollerDecrementLine];
if ([self mouse: thePoint inRect: rect])
return NSScrollerDecrementLine;
rect = [self rectForPart: NSScrollerIncrementLine];
if ([self mouse: thePoint inRect: rect])
return NSScrollerIncrementLine;
rect = [self rectForPart: NSScrollerKnob];
if ([self mouse: thePoint inRect: rect])
return NSScrollerKnob;
rect = [self rectForPart: NSScrollerDecrementPage];
if ([self mouse: thePoint inRect: rect])
return NSScrollerDecrementPage;
rect = [self rectForPart: NSScrollerIncrementPage];
if ([self mouse: thePoint inRect: rect])
return NSScrollerIncrementPage;
rect = [self rectForPart: NSScrollerKnobSlot];
if ([self mouse: thePoint inRect: rect])
return NSScrollerKnobSlot;
return NSScrollerNoPart;
}
- (float) _floatValueForMousePoint: (NSPoint)point
{
NSRect knobRect = [self rectForPart: NSScrollerKnob];
NSRect slotRect = [self rectForPart: NSScrollerKnobSlot];
float floatValue = 0;
float position;
// Adjust point to lie within the knob slot
if (_isHorizontal)
{
float halfKnobRectWidth = knobRect.size.width / 2;
if (point.x < slotRect.origin.x + halfKnobRectWidth)
position = slotRect.origin.x + halfKnobRectWidth;
else
{
if (point.x > slotRect.origin.x + slotRect.size.width -
halfKnobRectWidth)
position = slotRect.origin.x + slotRect.size.width -
halfKnobRectWidth;
else
position = point.x;
}
// Compute float value given the knob size
floatValue = (position - (slotRect.origin.x + halfKnobRectWidth))
/ (slotRect.size.width - knobRect.size.width);
}
else
{
float halfKnobRectHeight = knobRect.size.height / 2;
if (point.y < slotRect.origin.y + halfKnobRectHeight)
position = slotRect.origin.y + halfKnobRectHeight;
else
{
if (point.y > slotRect.origin.y + slotRect.size.height -
halfKnobRectHeight)
position = slotRect.origin.y + slotRect.size.height -
halfKnobRectHeight;
else
position = point.y;
}
// Compute float value given the knob size
floatValue = (position - (slotRect.origin.y + halfKnobRectHeight)) /
(slotRect.size.height - knobRect.size.height);
}
return floatValue;
}
- (void) _preCalcParts
{
NSRect knobRect = [self rectForPart: NSScrollerKnob];
slotRect = [self rectForPart: NSScrollerKnobSlot];
halfKnobRectWidth = knobRect.size.width / 2;
slotOriginPlusKnobWidth = slotRect.origin.x + halfKnobRectWidth;
slotOriginPlusSlotWidthMinusHalfKnobWidth = slotRect.origin.x +
slotRect.size.width - halfKnobRectWidth;
slotWidthMinusKnobWidth = slotRect.size.width - knobRect.size.width;
halfKnobRectHeight = knobRect.size.height / 2;
slotOriginPlusKnobHeight = slotRect.origin.y + halfKnobRectHeight;
slotOriginPlusSlotHeightMinusKnobHeight = slotRect.origin.y +
slotRect.size.height - halfKnobRectHeight;
slotHeightMinusKnobHeight = slotRect.size.height - knobRect.size.height;
}
- (float) _floatValueForMousePointFromPreCalc: (NSPoint)point
{
float floatValue = 0;
float position;
if (_isHorizontal)
{
if (point.x < slotOriginPlusKnobWidth)
position = slotOriginPlusKnobWidth;
else
{
if (point.x > slotOriginPlusSlotWidthMinusHalfKnobWidth)
position = slotOriginPlusSlotWidthMinusHalfKnobWidth;
else
position = point.x;
}
floatValue = (position - slotOriginPlusKnobWidth) /
slotWidthMinusKnobWidth;
}
else
{
if (point.y < slotOriginPlusKnobHeight)
position = slotOriginPlusKnobHeight;
else
{
if (point.y > slotOriginPlusSlotHeightMinusKnobHeight)
position = slotOriginPlusSlotHeightMinusKnobHeight;
else
position = point.y;
}
floatValue = (position - slotOriginPlusKnobHeight) /
slotHeightMinusKnobHeight;
}
return floatValue;
}
- (void) mouseDown: (NSEvent*)theEvent
{
NSPoint location = [self convertPoint: [theEvent locationInWindow]
fromView: nil];
_hitPart = [self testPart: location];
[self _setTargetAndActionToCells];
switch (_hitPart)
{
case NSScrollerIncrementLine:
case NSScrollerDecrementLine:
case NSScrollerIncrementPage:
case NSScrollerDecrementPage:
[self trackScrollButtons: theEvent];
break;
case NSScrollerKnob:
[self trackKnob: theEvent];
break;
case NSScrollerKnobSlot:
{
float floatValue = [self _floatValueForMousePoint: location];
[self setFloatValue: floatValue];
[self sendAction: _action to: _target];
[self trackKnob: theEvent];
break;
}
case NSScrollerNoPart:
break;
}
_hitPart = NSScrollerNoPart;
}
- (void) trackKnob: (NSEvent*)theEvent
{
unsigned int eventMask = NSLeftMouseDownMask | NSLeftMouseUpMask
| NSLeftMouseDraggedMask | NSMouseMovedMask
| NSPeriodicMask;
NSApplication *app = [NSApplication sharedApplication];
NSPoint point, apoint;
float oldFloatValue = _floatValue;
float floatValue;
float xoffset = 0;
float yoffset = 0;
NSDate *theDistantFuture = [NSDate distantFuture];
NSEventType eventType;
NSRect knobRect = {{0,0},{0,0}};
int periodCount = 0; // allows a forced update
[self _preCalcParts]; // pre calc scroller parts
preCalcValues = YES;
knobRect = [self rectForPart: NSScrollerKnob];
if (_hitPart == NSScrollerKnob)
{
apoint = [theEvent locationInWindow];
point = [self convertPoint: apoint fromView: nil];
if (_isHorizontal)
{
if (point.x != knobRect.origin.x + knobRect.size.width/2)
{
xoffset = knobRect.origin.x + knobRect.size.width/2 - point.x;
}
}
else
{
if (point.y != knobRect.origin.y + knobRect.size.height/2)
{
yoffset = knobRect.origin.y + knobRect.size.height/2 - point.y;
}
}
}
_hitPart = NSScrollerKnob;
// set periodic events rate to achieve max of ~30fps
[NSEvent startPeriodicEventsAfterDelay: 0.02 withPeriod: 0.03];
[[NSRunLoop currentRunLoop] limitDateForMode: NSEventTrackingRunLoopMode];
while ((eventType = [theEvent type]) != NSLeftMouseUp)
{
if (eventType != NSPeriodic)
{
apoint = [theEvent locationInWindow];
// zero the periodic count whenever a real position event is received
periodCount = 0;
}
else
{
// if 6x periods have gone by w/o movement
// check mouse and update if necessary
if (periodCount == 6)
apoint = [window mouseLocationOutsideOfEventStream];
point = [self convertPoint: apoint fromView: nil];
point.x += xoffset;
point.y += yoffset;
if (point.x != knobRect.origin.x || point.y != knobRect.origin.y)
{
floatValue = [self _floatValueForMousePointFromPreCalc: point];
if (floatValue != oldFloatValue)
{
[self setFloatValue: floatValue];
[self sendAction: _action to: _target];
/*
* Get current float value - which may have been changed
* when we sent the action to the target.
*/
oldFloatValue = _floatValue;
[window update];
}
knobRect.origin = point;
}
// avoid timing related scrolling hesitation by counting number of
// periodic events since scroll pos was updated, when this reaches
// 6x periodic rate an update is forced on next periodic event
periodCount++;
}
theEvent = [app nextEventMatchingMask: eventMask
untilDate: theDistantFuture
inMode: NSEventTrackingRunLoopMode
dequeue: YES];
}
[NSEvent stopPeriodicEvents];
preCalcValues = NO;
}
- (void) trackScrollButtons: (NSEvent*)theEvent
{
NSApplication *theApp = [NSApplication sharedApplication];
unsigned int eventMask = NSLeftMouseDownMask | NSLeftMouseUpMask |
NSLeftMouseDraggedMask | NSMouseMovedMask;
NSPoint location;
BOOL shouldReturn = NO;
id theCell = nil;
NSRect rect;
NSDebugLog (@"trackScrollButtons");
do
{
location = [self convertPoint: [theEvent locationInWindow]fromView: nil];
_hitPart = [self testPart: location];
rect = [self rectForPart: _hitPart];
switch (_hitPart)
{
case NSScrollerIncrementLine:
case NSScrollerIncrementPage:
theCell = (_isHorizontal ? rightCell : downCell);
break;
case NSScrollerDecrementLine:
case NSScrollerDecrementPage:
theCell = (_isHorizontal ? leftCell : upCell);
break;
default:
theCell = nil;
break;
}
if (theCell)
{
[self lockFocus];
[theCell highlight: YES withFrame: rect inView: self];
[self unlockFocus];
[window flushWindow];
NSLog (@"tracking cell %x", theCell);
shouldReturn = [theCell trackMouse: theEvent
inRect: rect
ofView: self
untilMouseUp: YES];
[self lockFocus];
[theCell highlight: NO withFrame: rect inView: self];
[self unlockFocus];
[window flushWindow];
}
if (shouldReturn)
break;
theEvent = [theApp nextEventMatchingMask: eventMask
untilDate: [NSDate distantFuture]
inMode: NSEventTrackingRunLoopMode
dequeue: YES];
}
while ([theEvent type] != NSLeftMouseUp);
NSDebugLog (@"return from trackScrollButtons");
}
//
// draw the scroller
//
- (void) drawRect: (NSRect)rect
{
NSDebugLog (@"NSScroller drawRect: ((%f, %f), (%f, %f))",
rect.origin.x, rect.origin.y, rect.size.width, rect.size.height);
[self drawKnobSlot];
[self drawKnob];
[self drawArrow: NSScrollerDecrementArrow highlight: NO];
[self drawArrow: NSScrollerIncrementArrow highlight: NO];
}
- (void) drawArrow: (NSScrollerArrow)whichButton highlight: (BOOL)flag
{
NSRect rect = [self rectForPart: (whichButton == NSScrollerIncrementArrow
? NSScrollerIncrementLine : NSScrollerDecrementLine)];
id theCell = nil;
NSDebugLog (@"position of %s cell is (%f, %f)",
(whichButton == NSScrollerIncrementArrow ? "increment" : "decrement"),
rect.origin.x, rect.origin.y);
switch (whichButton)
{
case NSScrollerDecrementArrow:
theCell = (_isHorizontal ? leftCell : upCell);
break;
case NSScrollerIncrementArrow:
theCell = (_isHorizontal ? rightCell : downCell);
break;
}
[theCell drawWithFrame: rect inView: self];
}
- (void) drawKnob
{
[knobCell drawWithFrame: [self rectForPart: NSScrollerKnob] inView: self];
}
- (void) drawKnobSlot
{
NSRect rect;
// in a modal loop we have already pre calc'd our parts
if (preCalcValues)
rect = slotRect;
else
rect = [self rectForPart: NSScrollerKnobSlot];
[[NSColor darkGrayColor] set];
NSRectFill(rect);
}
- (void) highlight: (BOOL)flag
{
switch (_hitPart)
{
case NSScrollerIncrementLine:
case NSScrollerIncrementPage:
[self drawArrow: NSScrollerIncrementArrow highlight: flag];
break;
case NSScrollerDecrementLine:
case NSScrollerDecrementPage:
[self drawArrow: NSScrollerDecrementArrow highlight: flag];
break;
default: // No button currently hit for highlighting.
break;
}
}
- (NSRect) rectForPart: (NSScrollerPart)partCode
{
NSRect scrollerFrame = frame;
float x = 0, y = 0;
float width, height;
NSUsableScrollerParts usableParts;
// If the scroller is disabled then the scroller buttons and the
// knob are not displayed at all.
if (!_isEnabled)
usableParts = NSNoScrollerParts;
else
usableParts = _usableParts;
// Assign to `width' and `height' values describing
// the width and height of the scroller regardless
// of its orientation.
// but keeps track of the scroller's orientation.
if (_isHorizontal)
{
width = scrollerFrame.size.height;
height = scrollerFrame.size.width;
}
else
{
width = scrollerFrame.size.width;
height = scrollerFrame.size.height;
}
// The x, y, width and height values are computed below for the vertical
// scroller. The height of the scroll buttons is assumed to be equal to
// the width.
switch (partCode)
{
case NSScrollerKnob:
{
float knobHeight, knobPosition, slotHeight;
// If the scroller does not have parts or a knob return a zero rect.
if (usableParts == NSNoScrollerParts ||
usableParts == NSOnlyScrollerArrows)
return NSZeroRect;
// calc the slot Height
slotHeight = height - (_arrowsPosition == NSScrollerArrowsNone ?
0 : 2 * (buttonsWidth + buttonsDistance));
knobHeight = _knobProportion * slotHeight;
if (knobHeight < buttonsWidth)
knobHeight = buttonsWidth;
// calc knob's position
knobPosition = _floatValue * (slotHeight - knobHeight);
knobPosition = (float)floor(knobPosition); // avoid rounding error
// calc actual position
y = knobPosition + (_arrowsPosition == NSScrollerArrowsMaxEnd
|| _arrowsPosition == NSScrollerArrowsNone ?
0 : 2 * (buttonsWidth + buttonsDistance));
height = knobHeight;
width = buttonsWidth;
if (_isHorizontal) // keeps horiz knob off of the buttons
y++;
break;
}
case NSScrollerKnobSlot:
// if the scroller does not have buttons the slot completely
// fills the scroller.
if (usableParts == NSNoScrollerParts)
{
break;
}
if (_arrowsPosition == NSScrollerArrowsMaxEnd)
{
height -= 2 * (buttonsWidth + buttonsDistance);
}
else if (_arrowsPosition == NSScrollerArrowsMinEnd)
{
y = 2 * (buttonsWidth + buttonsDistance);
height -= y;
}
break;
case NSScrollerDecrementLine:
case NSScrollerDecrementPage:
// if scroller has no parts or knob then return a zero rect
if (usableParts == NSNoScrollerParts)
return NSZeroRect;
if (_arrowsPosition == NSScrollerArrowsMaxEnd)
{
y = height - 2 * (buttonsWidth + buttonsDistance);
}
else if (_arrowsPosition == NSScrollerArrowsMinEnd)
{
y = buttonsDistance;
}
else
return NSZeroRect;
width = buttonsWidth;
height = buttonsWidth;
break;
case NSScrollerIncrementLine:
case NSScrollerIncrementPage:
if (usableParts == NSNoScrollerParts)
return NSZeroRect;
if (_arrowsPosition == NSScrollerArrowsMaxEnd)
{
y = height - (buttonsWidth + buttonsDistance);
}
else if (_arrowsPosition == NSScrollerArrowsMinEnd)
{
y = buttonsWidth + buttonsDistance;
}
else
return NSZeroRect;
height = buttonsWidth;
width = buttonsWidth;
break;
case NSScrollerNoPart:
return NSZeroRect;
}
if (_isHorizontal)
return NSMakeRect (y, x, height, width);
else
return NSMakeRect (x, y, width, height);
}
@end