/*******************************************************************************
/
/	File:			OptionControl.h
/
/   Description:   A BOptionControl is an abstract interface for BControls that select 
/	between a set of named values; the names are displayed to the user, but the 
/	corresponding values are returned in Value().
/
/	Copyright 1997-99, Be Incorporated, All Rights Reserved
/
*******************************************************************************/

#if !defined(_OPTION_CONTROL_H)
#define _OPTION_CONTROL_H

#include <InterfaceDefs.h>
#include <Control.h>

enum {
	B_OPTION_CONTROL_VALUE = '_BMV'
};


class BOptionControl :
	public BControl
{
public:

							BOptionControl(
									BRect frame,
									const char * name,
									const char * label, 
									BMessage * message,
									uint32 resize = B_FOLLOW_LEFT | B_FOLLOW_TOP,
									uint32 flags = B_WILL_DRAW);
virtual						~BOptionControl();

virtual	void				MessageReceived(
									BMessage * message);

		status_t			AddOption(
									const char * name,
									int32 value);
virtual	bool				GetOptionAt(
									int32 index,
									const char ** out_name,
									int32 * out_value) = 0;
virtual	void				RemoveOptionAt(
									int32 index) = 0;
virtual	int32				CountOptions() const = 0;
virtual	status_t			AddOptionAt(
									const char * name,
									int32 value,
									int32 index) = 0;
virtual	int32				SelectedOption(		//	index >= 0 returned directly
									const char ** name = 0,
									int32 * value = 0) const = 0;

virtual	status_t			SelectOptionFor(
									int32 value);
virtual	status_t			SelectOptionFor(
									const char *name);
protected:

		BMessage *			MakeValueMessage(
									int32 value);

private:

		BOptionControl();	/* private unimplemented */
		BOptionControl(
				const BOptionControl & clone);
		BOptionControl & operator=(
				const BOptionControl & clone);

		/* Mmmh, stuffing! */
virtual		status_t _Reserved_OptionControl_0(void *, ...);
virtual		status_t _Reserved_OptionControl_1(void *, ...);
virtual		status_t _Reserved_OptionControl_2(void *, ...);
virtual		status_t _Reserved_OptionControl_3(void *, ...);
virtual		status_t _Reserved_OptionControl_4(void *, ...);
virtual		status_t _Reserved_OptionControl_5(void *, ...);
virtual		status_t _Reserved_OptionControl_6(void *, ...);
virtual		status_t _Reserved_OptionControl_7(void *, ...);
virtual		status_t _Reserved_OptionControl_8(void *, ...);
virtual		status_t _Reserved_OptionControl_9(void *, ...);
virtual		status_t _Reserved_OptionControl_10(void *, ...);
virtual		status_t _Reserved_OptionControl_11(void *, ...);

		uint32 _reserved_selection_control_[8];

};


#endif	/* _OPTION_CONTROL_H */