PilotAddress Class Reference
A wrapper class around the Address struct provided by pi-address.h. More...
#include <pilotAddress.h>
Public Types | |
enum | EPhoneType { eWork = 0, eHome, eFax, eOther, eEmail, eMain, ePager, eMobile } |
Public Member Functions | |
PilotAddress (struct AddressAppInfo &appInfo) | |
PilotAddress (struct AddressAppInfo &appInfo, PilotRecord *rec) | |
PilotAddress (const PilotAddress ©From) | |
PilotAddress & | operator= (const PilotAddress &r) |
bool | operator== (const PilotAddress &r) |
void | reset () |
Zeros the internal address info structure, in effect clearing out all prior set values. | |
void | setField (int field, const QString &text) |
QString | getField (int field) const |
QString | getCategoryLabel () const |
bool | setCategory (const QString &label) |
If the label already exists, uses the id; if not, adds the label to the category list. | |
QString | getPhoneField (EPhoneType type, bool checkCustom4=true) const |
void | setPhoneField (EPhoneType type, const QString &field, bool overflowCustom=true) |
int | getShownPhone () const |
Returns the (adjusted) index of the phone number selected by the user to be shown in the overview of addresses. | |
void | setShownPhone (EPhoneType phoneType) |
int | getPhoneLabelIndex (int index) |
PilotRecord * | pack () |
void * | pack (void *, int *) |
void | unpack (const void *, int=0) |
Static Public Attributes | |
const int | APP_BUFFER_SIZE = 0xffff |
Protected Member Functions | |
const char * | getFieldP (int field) const |
Detailed Description
A wrapper class around the Address struct provided by pi-address.h.This class allows the user to set and get address field values. For everything but phone fields, the user can simply pass the the pi-address enum for the index for setField() and getField() such as entryLastname.
Phone fields are a bit trickier. The structure allows for 8 possible phone fields with 5 possible slots. That means there could be three fields that don't have available storage. The setPhoneField() method will attempt to store the extra fields in a custom field if there is an overflow.
There are eight possible fields for 5 view slots: fields: Work, Home, Fax, Other, Pager, Mobile, E-mail, Main slots: entryPhone1, entryPhone2, entryPhone3, entryPhone4, entryPhone5
Internally in the pilot-link library, the AddressAppInfo phone array stores the strings for the eight possible phone values. Their English string values are : phone[0] = Work phone[1] = Home phone[2] = Fax phone[3] = Other phone[4] = E-mail phone[5] = Main phone[6] = Pager phone[7] = Mobile
Apparently, this order is kept for all languages, just with localized strings. The implementation of the internal methods will assume this order is kept. In other languages, main can replaced with Corporation.
Definition at line 81 of file pilotAddress.h.
Member Function Documentation
|
Zeros the internal address info structure, in effect clearing out all prior set values.
Definition at line 100 of file pilotAddress.h. |
|
Definition at line 308 of file pilotAddress.cc. References QString::isEmpty(), and QString::length(). Referenced by setPhoneField(). |
|
If the label already exists, uses the id; if not, adds the label to the category list.
Definition at line 140 of file pilotAddress.cc. References QString::isEmpty(). |
|
Definition at line 238 of file pilotAddress.cc. References QString::find(), QString::length(), QString::mid(), and QString::simplifyWhiteSpace(). |
|
Definition at line 190 of file pilotAddress.cc. References QString::isEmpty(), and setField(). |
|
Returns the (adjusted) index of the phone number selected by the user to be shown in the overview of addresses. Adjusted here means that it's actually an index into 3..8, the fields that store phone numbers, so 0 means field 3 is selected.
Definition at line 143 of file pilotAddress.h. |
The documentation for this class was generated from the following files: