OOTextFieldHistoryManager(Private) Category Reference

Instance Methods
(void)	- checkInvariant
(void)	- maintainInvariant
(void)	- moveHistoryCursorTo:fieldEditor:
(void)	- moveHistoryCursorBy:fieldEditor:

Detailed Description

Definition at line 35 of file OOTextFieldHistoryManager.m.

Method Documentation

checkInvariant

- (void) checkInvariant

Extends class OOTextFieldHistoryManager.

Definition at line 1 of file OOTextFieldHistoryManager.m.

{
    NSAssert(_history != nil &&  // History buffer must exist
             _historyCurrSize == [_history count] &&  // Size must be correct
             ((_historyCurrSize <= _historyMaxSize) || (_historyMaxSize == 0)) &&  // Size must be in bounds
             _historyCursor <= _historyCurrSize + 1,  // Cursor must be in bounds
             @"Invalid history buffer state in OOTextFieldHistoryManager.");
}

maintainInvariant

- (void) maintainInvariant

Extends class OOTextFieldHistoryManager.

Definition at line 1 of file OOTextFieldHistoryManager.m.

{
    _historyCurrSize = [_history count];
    
    if (_historyMaxSize && (_historyMaxSize < _historyCurrSize))
    {
        [_history removeObjectsInRange:NSMakeRange(0, _historyCurrSize - _historyMaxSize)];
        _historyCurrSize = _historyMaxSize;
    }
    
    [self checkInvariant];
}

moveHistoryCursorBy:fieldEditor:

- (void) moveHistoryCursorBy:		(NSInteger)	offset
fieldEditor:		(NSTextView *)	fieldEditor

Extends class OOTextFieldHistoryManager.

Definition at line 1 of file OOTextFieldHistoryManager.m.

                            :(NSInteger)offset fieldEditor:(NSTextView *)fieldEditor
{
    // Range check
    if (((offset < 0) && (_historyCursor < (NSUInteger)-offset))    // Destination < 0
        || (_historyCurrSize < (offset + _historyCursor)))  // Destination > _historyCurrSize
    {
        NSBeep();
        return;
    }
    [self moveHistoryCursorTo:_historyCursor + offset fieldEditor:fieldEditor];
}

moveHistoryCursorTo:fieldEditor:

- (void) moveHistoryCursorTo:		(NSUInteger)	newCursor
fieldEditor:		(NSTextView *)	fieldEditor

Extends class OOTextFieldHistoryManager.

Definition at line 1 of file OOTextFieldHistoryManager.m.

                            :(NSUInteger)newCursor fieldEditor:(NSTextView *)fieldEditor
{
    NSString                    *value = nil;
    NSTextStorage               *textStorage = nil;
    
    if (_historyCurrSize < newCursor)
    {
        NSBeep();
        return;
    }
    
    [self checkInvariant];
    textStorage = [fieldEditor textStorage];
    
    if (newCursor > 0)
    {
        NSUInteger index = _historyCurrSize - newCursor;
        value = [_history objectAtIndex:index];
        if (_historyCursor == 0)  _latest = [[textStorage string] copy];
    }
    else
    {
        value = [_latest autorelease];
        _latest = nil;
    }
    
    _historyCursor = newCursor;
    
    [textStorage setString:value];
    [textField selectText:self];
    
    [self checkInvariant];
}

---

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

• Mac-specific/DebugBundle/Source/OOTextFieldHistoryManager.m