GUILocalisationTable.h

/*
* Copyright (C) TES Electronic Solutions GmbH,
* All Rights Reserved.
* Contact: info@guiliani.de
*
* This file is part of the Guiliani HMI framework
* for the development of graphical user interfaces on embedded systems.
*/
 
#ifndef GUILOCALISATIONTABLE__H_
#define GUILOCALISATIONTABLE__H_
 
#include "GUITextResource.h"
#include "eC_String.h"
#include "eC_TArray.h"
 
class CGUILocalisationTable
{
public:
    CGUILocalisationTable();
 
    ~CGUILocalisationTable();
 
    void LoadLocalisationFile(const eC_String &kLangFileName);
 
    eC_Bool WriteLocalisationFile(const eC_String &kPath) const;
 
    const eC_String* GetText(const TextResource_t &eTextResourcesIdx) const;
 
    void SetText(TextResource_t eID, const eC_String &rkText);
 
    TextResource_t AddDynamicText(const eC_String &kNewText);
 
    void FreeDynamicText(const TextResource_t eID);
 
    void RegisterTextFragments(const TextResource_t& eID, const eC_UInt& uiCount);
 
    void UnregisterTextFragments(const TextResource_t& eID);
 
    void SetTextFragment(
        const TextResource_t& eID,
        const eC_UInt& uiFragmentIndex,
        const eC_String& kText);
 
    eC_Bool SetNOFLocalisationTexts(eC_UInt uiNOFLocalisationTexts);
 
    eC_UInt GetNOFLocalisationTexts() const;
 
    eC_Bool IsValidID(const TextResource_t &eID) const;
 
    const eC_String* GetDummyText() const;
 
    eC_UInt GetNOFReadTextResources() const;
 
private:
    enum LineEndType_t
    {
        LINE_END_NONE,
        LINE_END_CR,
        LINE_END_CRLF
    };
 
private:
    void DeleteLocalisationTable();
 
    LineEndType_t HandleEOL(eC_UByte* const pucBuf) const;
 
    void HandleLineBreak(eC_String *kLineString) const;
 
    eC_UInt ReadLine(
        eC_UByte *pcSourceBuffer,
        eC_UInt uiBufferSize,
        eC_String &kDestinationString);
 
    eC_String* FormatText(const eC_UInt& uiTextIndex) const;
 
    void DeleteTextFragments(const eC_UInt& uiIndex);
 
private:
    eC_TArray<eC_String*> m_apLocalisationText;
 
    eC_TArray<eC_TArray<eC_String*>*> m_apTextFragments;
 
    eC_TArray<eC_String*> m_apLocalCopies;
 
    static eC_String ms_kDummyTextStr;
 
    eC_UInt m_uiNOFReadTexts;
};
 
#endif