mirror of
https://github.com/gnustep/libs-gui.git
synced 2025-04-25 01:01:10 +00:00
35ab35ded0
subclasses. git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/libs/gui/trunk@11489 72102866-910b-0410-8b05-ffd578937521
149 lines
4.7 KiB
Objective-C
149 lines
4.7 KiB
Objective-C
/*
|
|
NSTextStorage.h
|
|
|
|
NSTextStorage is a semi-abstract subclass of
|
|
NSMutableAttributedString. It implements change management
|
|
(beginEditing/endEditing), verification of attributes, delegate
|
|
handling, and layout management notification. The one aspect it
|
|
does not implement is the actual attributed string storage ---
|
|
this is left up to the subclassers, which need to override the
|
|
four NSAttributedString and NSMutableAttributedString primitives:
|
|
|
|
- (NSString*) string;
|
|
- (NSDictionary*) attributesAtIndex: (unsigned)index
|
|
effectiveRange: (NSRange*)aRange;
|
|
|
|
- (void) replaceCharactersInRange: (NSRange)range
|
|
withString: (NSString *)str;
|
|
- (void) setAttributes: (NSDictionary *)attrs
|
|
range: (NSRange)range;
|
|
|
|
These primitives should perform the change then call
|
|
edited:range:changeInLength: to get everything else to happen.
|
|
|
|
Copyright (C) 1996,1999 Free Software Foundation, Inc.
|
|
|
|
Author: Daniel Bðhringer <boehring@biomed.ruhr-uni-bochum.de>
|
|
Date: August 1998
|
|
Source by Daniel Bðhringer integrated into GNUstep gui
|
|
by Felipe A. Rodriguez <far@ix.netcom.com>
|
|
Update: Richard Frith-Macdonald <richard@brainstorm.co.uk>
|
|
|
|
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., 59 Temple Place, Suite 330, Boston, MA 02111 USA. */
|
|
|
|
#ifndef _GNUstep_H_NSTextStorage
|
|
#define _GNUstep_H_NSTextStorage
|
|
|
|
#import <Foundation/Foundation.h>
|
|
#import <AppKit/NSStringDrawing.h>
|
|
|
|
@class NSLayoutManager;
|
|
|
|
/*
|
|
* These values are or'ed together in notifications to indicate
|
|
* what got changed.
|
|
*/
|
|
enum
|
|
{
|
|
NSTextStorageEditedAttributes = 1,
|
|
NSTextStorageEditedCharacters = 2
|
|
};
|
|
|
|
@interface NSTextStorage : NSMutableAttributedString
|
|
{
|
|
NSRange _editedRange;
|
|
int _editedDelta;
|
|
NSMutableArray *_layoutManagers;
|
|
id _delegate;
|
|
unsigned _editedMask;
|
|
unsigned _editCount;
|
|
}
|
|
|
|
/*
|
|
* Managing NSLayoutManagers
|
|
*/
|
|
- (void) addLayoutManager: (NSLayoutManager*)obj;
|
|
- (void) removeLayoutManager: (NSLayoutManager*)obj;
|
|
- (NSArray*) layoutManagers;
|
|
|
|
/*
|
|
* If there are no outstanding beginEditing calls, this method calls
|
|
* processEditing to cause post-editing stuff to happen. This method
|
|
* has to be called by the primitives after changes are made.
|
|
* The range argument to edited:... is the range in the original string
|
|
* (before the edit).
|
|
*/
|
|
- (void) edited: (unsigned)mask range: (NSRange)old changeInLength: (int)delta;
|
|
|
|
/*
|
|
* This is called from edited:range:changeInLength: or endEditing.
|
|
* This method sends out NSTextStorageWillProcessEditing, then fixes
|
|
* the attributes, then sends out NSTextStorageDidProcessEditing,
|
|
* and finally notifies the layout managers of change with the
|
|
* textStorage:edited:range:changeInLength:invalidatedRange: method.
|
|
*/
|
|
- (void) processEditing;
|
|
|
|
- (void) beginEditing;
|
|
- (void) endEditing;
|
|
|
|
/*
|
|
* These methods return information about the editing status.
|
|
* Especially useful when there are outstanding beginEditing calls or
|
|
* during processEditing... editedRange.location will be NSNotFound if
|
|
* nothing has been edited.
|
|
*/
|
|
- (unsigned) editedMask;
|
|
- (NSRange) editedRange;
|
|
- (int) changeInLength;
|
|
|
|
/*
|
|
* Set/get the delegate
|
|
*/
|
|
- (void) setDelegate: (id)delegate;
|
|
- (id) delegate;
|
|
|
|
#ifndef STRICT_OPENSTEP
|
|
- (void) ensureAttributesAreFixedInRange: (NSRange)range;
|
|
- (BOOL) fixesAttributesLazily;
|
|
- (void) invalidateAttributesInRange: (NSRange)range;
|
|
#endif
|
|
|
|
@end
|
|
|
|
|
|
/**** NSTextStorage delegate methods ****/
|
|
|
|
@interface NSObject (NSTextStorageDelegate)
|
|
|
|
/*
|
|
* These methods are sent during processEditing:. The receiver can use
|
|
* the callback methods editedMask, editedRange, and changeInLength to
|
|
* see what has changed. Although these methods can change the contents
|
|
* of the text storage, it's best if only the delegate did this.
|
|
*/
|
|
- (void) textStorageWillProcessEditing: (NSNotification*)notification;
|
|
- (void) textStorageDidProcessEditing: (NSNotification*)notification;
|
|
|
|
@end
|
|
|
|
/**** Notifications ****/
|
|
|
|
APPKIT_EXPORT NSString *NSTextStorageWillProcessEditingNotification;
|
|
APPKIT_EXPORT NSString *NSTextStorageDidProcessEditingNotification;
|
|
|
|
#endif
|