summaryrefslogtreecommitdiffstats
path: root/tdeabc/address.h
diff options
context:
space:
mode:
authorTimothy Pearson <kb9vqf@pearsoncomputing.net>2013-02-15 21:57:54 -0600
committerTimothy Pearson <kb9vqf@pearsoncomputing.net>2013-02-15 21:57:54 -0600
commited99a30644c19b0a3cf0d2147243532df4daa16b (patch)
tree7f3f2850e59824fdf100a642367a82b1e7f0204f /tdeabc/address.h
parente5f2d46e9caf6942f365f1b454087dda71a340f7 (diff)
downloadtdelibs-ed99a30644c19b0a3cf0d2147243532df4daa16b.tar.gz
tdelibs-ed99a30644c19b0a3cf0d2147243532df4daa16b.zip
Rename additional header files to avoid conflicts with KDE4
Diffstat (limited to 'tdeabc/address.h')
-rw-r--r--tdeabc/address.h341
1 files changed, 341 insertions, 0 deletions
diff --git a/tdeabc/address.h b/tdeabc/address.h
new file mode 100644
index 000000000..b4165a098
--- /dev/null
+++ b/tdeabc/address.h
@@ -0,0 +1,341 @@
+/*
+ This file is part of libkabc.
+ Copyright (c) 2001 Cornelius Schumacher <schumacher@kde.org>
+
+ 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; see the file COPYING.LIB. If not, write to
+ the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ Boston, MA 02110-1301, USA.
+*/
+
+#ifndef KABC_ADDRESS_H
+#define KABC_ADDRESS_H
+
+#include <tqmap.h>
+#include <tqstring.h>
+#include <tqvaluelist.h>
+
+#include <tdelibs_export.h>
+
+// template tags for address formatting localization
+#define KABC_FMTTAG_realname TQString("%n")
+#define KABC_FMTTAG_REALNAME TQString("%N")
+#define KABC_FMTTAG_company TQString("%cm")
+#define KABC_FMTTAG_COMPANY TQString("%CM")
+#define KABC_FMTTAG_pobox TQString("%p")
+#define KABC_FMTTAG_street TQString("%s")
+#define KABC_FMTTAG_STREET TQString("%S")
+#define KABC_FMTTAG_zipcode TQString("%z")
+#define KABC_FMTTAG_location TQString("%l")
+#define KABC_FMTTAG_LOCATION TQString("%L")
+#define KABC_FMTTAG_region TQString("%r")
+#define KABC_FMTTAG_REGION TQString("%R")
+#define KABC_FMTTAG_newline TQString("\\n")
+#define KABC_FMTTAG_condcomma TQString("%,")
+#define KABC_FMTTAG_condwhite TQString("%w")
+#define KABC_FMTTAG_purgeempty TQString("%0")
+
+namespace KABC {
+
+/**
+ @short Postal address information.
+
+ This class represents information about a postal address.
+*/
+class KABC_EXPORT Address
+{
+ friend KABC_EXPORT TQDataStream &operator<<( TQDataStream &, const Address & );
+ friend KABC_EXPORT TQDataStream &operator>>( TQDataStream &, Address & );
+
+ public:
+ /**
+ List of addresses.
+ */
+ typedef TQValueList<Address> List;
+ typedef TQValueList<int> TypeList;
+
+ /**
+ Address types:
+
+ @li @p Dom - domestic
+ @li @p Intl - international
+ @li @p Postal - postal
+ @li @p Parcel - parcel
+ @li @p Home - home address
+ @li @p Work - address at work
+ @li @p Pref - preferred address
+ */
+ enum Type { Dom = 1, Intl = 2, Postal = 4, Parcel = 8, Home = 16, Work = 32,
+ Pref = 64 };
+
+ /**
+ Constructor that creates an empty Address, which is initialized
+ with a unique id (see id()).
+ */
+ Address();
+
+ /**
+ This is like Address() just above, with the difference
+ that you can specify the type.
+ */
+ Address( int );
+
+ bool operator==( const Address & ) const;
+ bool operator!=( const Address & ) const;
+
+ /**
+ Returns true, if the address is empty.
+ */
+ bool isEmpty() const;
+
+ /**
+ Clears all entries of the address.
+ */
+ void clear();
+
+ /**
+ Sets the unique id.
+ */
+ void setId( const TQString & );
+
+ /*
+ Returns the unique id.
+ */
+ TQString id() const;
+
+ /**
+ Sets the type of address. See enum for definiton of types.
+
+ @param type type, can be a bitwise or of multiple types.
+ */
+ void setType( int type );
+
+ /**
+ Returns the type of address. Can be a bitwise or of multiple types.
+ */
+ int type() const;
+
+ /**
+ Returns a translated string of all types the address has.
+ */
+ TQString typeLabel() const;
+
+ /**
+ Sets the post office box.
+ */
+ void setPostOfficeBox( const TQString & );
+
+ /**
+ Returns the post office box.
+ */
+ TQString postOfficeBox() const;
+
+ /**
+ Returns the translated label for post office box field.
+ */
+ static TQString postOfficeBoxLabel();
+
+ /**
+ Sets the extended address information.
+ */
+ void setExtended( const TQString & );
+
+ /**
+ Returns the extended address information.
+ */
+ TQString extended() const;
+
+ /**
+ Returns the translated label for extended field.
+ */
+ static TQString extendedLabel();
+
+ /**
+ Sets the street (including number).
+ */
+ void setStreet( const TQString & );
+
+ /**
+ Returns the street.
+ */
+ TQString street() const;
+
+ /**
+ Returns the translated label for street field.
+ */
+ static TQString streetLabel();
+
+ /**
+ Sets the locality, e.g. city.
+ */
+ void setLocality( const TQString & );
+
+ /**
+ Returns the locality.
+ */
+ TQString locality() const;
+
+ /**
+ Returns the translated label for locality field.
+ */
+ static TQString localityLabel();
+
+ /**
+ Sets the region, e.g. state.
+ */
+ void setRegion( const TQString & );
+
+ /**
+ Returns the region.
+ */
+ TQString region() const;
+
+ /**
+ Returns the translated label for region field.
+ */
+ static TQString regionLabel();
+
+ /**
+ Sets the postal code.
+ */
+ void setPostalCode( const TQString & );
+
+ /**
+ Returns the postal code.
+ */
+ TQString postalCode() const;
+
+ /**
+ Returns the translated label for postal code field.
+ */
+ static TQString postalCodeLabel();
+
+ /**
+ Sets the country.
+ */
+ void setCountry( const TQString & );
+
+ /**
+ Returns the country.
+ */
+ TQString country() const;
+
+ /**
+ Returns the translated label for country field.
+ */
+ static TQString countryLabel();
+
+ /**
+ Sets the delivery label. This is the literal text to be used as label.
+ */
+ void setLabel( const TQString & );
+
+ /**
+ Returns the delivery label.
+ */
+ TQString label() const;
+
+ /**
+ Returns the translated label for delivery label field.
+ */
+ static TQString labelLabel();
+
+ /**
+ Returns the list of available types.
+ */
+ static TypeList typeList();
+
+ /**
+ Returns the translated label for a special type.
+ */
+ static TQString typeLabel( int type );
+
+ /**
+ Used for debug output.
+ */
+ void dump() const;
+
+ /**
+ Returns this address formatted according to the country-specific
+ address formatting rules. The formatting rules applied depend on
+ either the addresses {@link #country country} field, or (if the
+ latter is empty) on the system country setting. If companyName is
+ provided, an available business address format will be preferred.
+
+ @param realName the formatted name of the contact
+ @param orgaName the name of the organization or company
+ @return the formatted address (containing newline characters)
+ */
+ TQString formattedAddress( const TQString &realName=TQString::null
+ , const TQString &orgaName=TQString::null ) const;
+
+ /**
+ Returns ISO code for a localized country name. Only localized country
+ names will be understood. This might be replaced by a TDELocale method in
+ the future.
+ @param cname name of the country
+ @return two digit ISO code
+ */
+ static TQString countryToISO( const TQString &cname );
+
+ /**
+ Returns a localized country name for a ISO code.
+ This might be replaced by a TDELocale method in the future.
+ @param ISOname two digit ISO code
+ @return localized name of the country
+ @since 3.2
+ */
+ static TQString ISOtoCountry( const TQString &ISOname );
+
+ private:
+ /**
+ Parses a snippet of an address template
+ @param tsection the template string to be parsed
+ @param result TQString reference in which the result will be stored
+ @return true if at least one tag evaluated positively, else false
+ */
+ bool parseAddressTemplateSection( const TQString &tsection
+ , TQString &result
+ , const TQString &realName
+ , const TQString &orgaName ) const;
+
+ /**
+ Finds the balanced closing bracket starting from the opening bracket at
+ pos in tsection.
+ @return position of closing bracket, -1 for unbalanced brackets
+ */
+ int findBalancedBracket( const TQString &tsection, int pos ) const;
+
+ bool mEmpty;
+
+ TQString mId;
+ int mType;
+
+ TQString mPostOfficeBox;
+ TQString mExtended;
+ TQString mStreet;
+ TQString mLocality;
+ TQString mRegion;
+ TQString mPostalCode;
+ TQString mCountry;
+ TQString mLabel;
+
+ static TQMap<TQString, TQString> *mISOMap;
+};
+
+KABC_EXPORT TQDataStream &operator<<( TQDataStream &, const Address & );
+KABC_EXPORT TQDataStream &operator>>( TQDataStream &, Address & );
+
+}
+
+#endif