IFVerticallyExpandingTextField.h

/*
 Copyright (c) 2006, Andrew Bowman.  All rights reserved.
 
 Redistribution and use in source and binary forms, with or without 
 modification, are permitted provided that the following conditions are met:
 
 * Redistributions of source code must retain the above copyright notice, this 
 list of conditions and the following disclaimer.
 * Redistributions in binary form must reproduce the above copyright notice, 
 this list of conditions and the following disclaimer in the documentation 
 and/or other materials provided with the distribution.
 * Neither the name of Inverse Falcon nor the names of its contributors may be 
 used to endorse or promote products derived from this software without 
 specific prior written permission.
 
 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND 
 ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 
 WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 
 DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
 ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 
 (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 
  LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON 
 ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 
 (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 
 SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */

/* IFVerticallyExpandingTextField 

Published at:

http://www.cocoadev.com/index.pl?IFVerticallyExpandingTextField

This textfield expands and contracts as it is edited and resized, and behaves
in a similar manner to the input field in Apple's iChat message windows.

Superviews of the textfield and the window containing the textfield autosize 
accordingly.

Give it a try! You should be able to throw this into a project, read the files in
Interface Builder, and use the custom class pane to make an NSTextField into an
IFVerticallyExpandingTextField. You'll need to set the layout and linebreaking
attributes for word wrapping for this to work.

Although expansion should work properly when the textfield is embedded in a subview,
I'm having some trouble dealing with NSScrollViews. The field expands into the
scrollview's content view, but none of the controls on the scrollbar appear.
Some help here would be appreciated.

Added the setStringValue method, can't believe I forgot that. In my test
application I thought I saw a noticeable difference in speed when calling setString
on the field editor rather than setStringValue on super, but maybe it was just my
imagination. Can anyone confirm this?

Also added a slight time delay in this method to prevent display problems when autosizing.

Added the setHidden method. I haven't tested this one out, so I don't know what the
consequences are if the field is set visible when a view has been moved up to where the
field should be.

*/


#import <Cocoa/Cocoa.h>

enum { IFVerticalPadding = 5 };


@interface IFVerticallyExpandingTextField : NSTextField
{
	BOOL superviewsExpandOnGrowth;
	NSMutableArray *viewMaskPairs; 
}

- (void) awakeFromNib;
- (void) setSuperviewsExpandOnGrowth: (BOOL)shouldExpand;
- (BOOL) superviewsExpandOnGrowth;
- (void) forceAutosize;

@end