/*
 *  R.app : a Cocoa front end to: "R A Computer Language for Statistical Data Analysis"
 *  
 *  R.app Copyright notes:
 *                     Copyright (C) 2004-5  The R Foundation
 *                     written by Stefano M. Iacus and Simon Urbanek
 *
 *                  
 *  R Copyright notes:
 *                     Copyright (C) 1995-1996   Robert Gentleman and Ross Ihaka
 *                     Copyright (C) 1998-2001   The R Development Core Team
 *                     Copyright (C) 2002-2004   The R Foundation
 *
 *  This program is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation; either version 2 of the License, or
 *  (at your option) any later version.
 *
 *  This program 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 General Public License for more details.
 *
 *  A copy of the GNU General Public License is available via WWW at
 *  http://www.gnu.org/copyleft/gpl.html.  You can also obtain it by
 *  writing to the Free Software Foundation, Inc., 59 Temple Place,
 *  Suite 330, Boston, MA  02111-1307  USA.
 *
 *  RChooseEncodingPopupAccessory.h
 *
 *  Created by Hans-J. Bibiko on 16/03/2011.
 */

#import <Cocoa/Cocoa.h>


#define kNoStringEncoding 0xFFFFFFFF
#define kAutoStringEncoding 0xFFFFFFFE
#define kWantsAutomaticTag -1

@interface EncodingPopUpButtonCell : NSPopUpButtonCell
{
}
@end

@interface RChooseEncodingPopupAccessory : NSObject 
{

	@private

	IBOutlet NSTextField *label;
	IBOutlet NSMatrix *encodingMatrix;

	NSArray *encodings;

}

// There is just one instance...
+ (RChooseEncodingPopupAccessory *)sharedInstance;

// List of encodings that should be shown in encoding lists
- (NSArray *)enabledEncodings;

// Empties then initializes the supplied popup with the supported encodings
- (void)setupPopUpCell:(EncodingPopUpButtonCell *)button selectedEncoding:(NSStringEncoding)selectedEncoding withDefaultEntry:(BOOL)includeDefaultItem;

// Action methods for bringing up and dealing with changes in the encodings list panel
- (IBAction)showPanel:(id)sender;
- (IBAction)encodingListChanged:(id)sender;
- (IBAction)clearAll:(id)sender;
- (IBAction)selectAll:(id)sender;
- (IBAction)revertToDefault:(id)sender;
    
// Internal method to save and communicate changes to the encoding list
- (void)noteEncodingListChange:(BOOL)writeDefault updateList:(BOOL)updateList postNotification:(BOOL)post;

@end