office-gobmx/sw/inc/flddropdown.hxx
Jens-Heiner Rechtien d2658d9dec INTEGRATION: CWS swwarnings (1.6.28); FILE MERGED
2007/04/18 14:44:48 tl 1.6.28.1: #i69287# warning-free code
2007-09-27 07:02:06 +00:00

292 lines
6.7 KiB
C++

/*************************************************************************
*
* OpenOffice.org - a multi-platform office productivity suite
*
* $RCSfile: flddropdown.hxx,v $
*
* $Revision: 1.7 $
*
* last change: $Author: hr $ $Date: 2007-09-27 08:02:06 $
*
* The Contents of this file are made available subject to
* the terms of GNU Lesser General Public License Version 2.1.
*
*
* GNU Lesser General Public License Version 2.1
* =============================================
* Copyright 2005 by Sun Microsystems, Inc.
* 901 San Antonio Road, Palo Alto, CA 94303, USA
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License version 2.1, as published by the Free Software Foundation.
*
* 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
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston,
* MA 02111-1307 USA
*
************************************************************************/
#ifndef _FLDDROPDOWN_HXX
#define _FLDDROPDOWN_HXX
#ifndef _COM_SUN_STAR_UNO_SEQUENCE_HXX
#include "com/sun/star/uno/Sequence.hxx"
#endif
#ifndef INCLUDED_SWDLLAPI_H
#include "swdllapi.h"
#endif
#ifndef _FLDBAS_HXX
#include "fldbas.hxx"
#endif
#ifndef INCLUDED_VECTOR
#include <vector>
#define INCLUDED_VECTOR
#endif
/**
Field type for dropdown boxes.
*/
class SwDropDownFieldType : public SwFieldType
{
public:
/**
Constructor
*/
SwDropDownFieldType();
/**
Destructor
*/
virtual ~SwDropDownFieldType();
/**
Create a copy of this field type.
@return a copy of this type
*/
virtual SwFieldType * Copy () const;
};
/**
Dropdown field.
The dropdown field contains a list of strings. At most one of them
can be selected.
*/
class SW_DLLPUBLIC SwDropDownField : public SwField
{
/**
the possible values (aka items) of the dropdown box
*/
std::vector<String> aValues;
/**
the selected item
*/
String aSelectedItem;
/**
the name of the field
*/
String aName;
/**
help text
*/
String aHelp;
/**
tool tip string
*/
String aToolTip;
public:
/**
Constructor
@param pTyp field type for this field
*/
SwDropDownField(SwFieldType * pTyp);
/**
Copy constructor
@param rSrc dropdown field to copy
*/
SwDropDownField(const SwDropDownField & rSrc);
/**
Destructor
*/
virtual ~SwDropDownField();
/**
Expands the field.
The expanded value of the field is the value of the selected
item. If no item is selected, an empty string is returned.
@return the expanded value of the field
*/
virtual String Expand() const;
/**
Creates a copy of this field.
@return the copy of this field
*/
virtual SwField * Copy() const;
/**
Returns the selected value.
@see Expand
@return the selected value
*/
virtual const String & GetPar1() const;
/**
Returns the name of the field.
@return the name of the field
*/
virtual String GetPar2() const;
/**
Sets the selected value.
If rStr is an item of the field that item will be
selected. Otherwise no item will be selected, i.e. the
resulting selection will be empty.
*/
virtual void SetPar1(const String & rStr);
/**
Sets the name of the field.
@param rStr the new name of the field
*/
virtual void SetPar2(const String & rStr);
/**
Sets the items of the dropdown box.
After setting the items the selection will be empty.
@param rItems the new items
*/
void SetItems(const std::vector<String> & rItems);
/**
Sets the items of the dropdown box.
After setting the items the selection will be empty.
@param rItems the new items
*/
void SetItems(const com::sun::star::uno::Sequence<rtl::OUString> & rItems);
/**
Returns the items of the dropdown box.
@return the items of the dropdown box
*/
com::sun::star::uno::Sequence<rtl::OUString> GetItemSequence() const;
/**
Returns the selected item.
@return the selected item
*/
const String & GetSelectedItem() const;
/**
Returns the name of the field.
@return the name of the field
*/
const String & GetName() const;
/**
Returns the help text of the field.
@return the help text of the field
*/
const String & GetHelp() const;
/**
Returns the tool tip of the field.
@return the tool tip of the field
*/
const String & GetToolTip() const;
/**
Sets the selected item.
If rItem is found in this dropdown field it is selected. If
rItem is not found the selection will be empty.
@param rItem the item to be set
@retval TRUE the selected item was successfully set
@retval TRUE failure (empty selection)
*/
BOOL SetSelectedItem(const String & rItem);
/**
Sets the name of the field.
@param rName the new name of the field
*/
void SetName(const String & rName);
/**
Sets the help text of the field.
@param rHelp the help text
*/
void SetHelp(const String & rHelp);
/**
Sets the tool tip of the field.
@param rToolTip the tool tip
*/
void SetToolTip(const String & rToolTip);
/**
API: Gets a property value from the dropdown field.
@param rVal return value
@param nMId
- FIELD_PROP_PAR1 Get selected item (String)
- FIELD_PROP_STRINGS Get all items (Sequence)
- FIELD_PROP_PAR3 Get the help text of the field.
- FIELD_PROP_PAR4 Get the tool tip of the field.
*/
virtual BOOL QueryValue(com::sun::star::uno::Any &rVal, USHORT nWhichId) const;
/**
API: Sets a property value on the dropdown field.
@param rVal value to set
@param nMId
- FIELD_PROP_PAR1 Set selected item (String)
- FIELD_PROP_STRINGS Set all items (Sequence)
- FIELD_PROP_PAR3 Set the help text of the field.
- FIELD_PROP_PAR4 Set the tool tip of the field.
*/
virtual BOOL PutValue(const com::sun::star::uno::Any &rVal, USHORT nWhichId);
};
#endif