[Libreoffice-commits] core.git: include/svtools
Florian Reisinger
florei at libreoffice.org
Tue Sep 30 08:38:14 PDT 2014
include/svtools/fmtfield.hxx | 66 ++++++++++++++++++-------------------------
1 file changed, 29 insertions(+), 37 deletions(-)
New commits:
commit d0aba6a01c876a91d1c7ebb3800c7a8428534dec
Author: Florian Reisinger <florei at libreoffice.org>
Date: Tue Sep 30 16:37:53 2014 +0100
German comment translation.
Change-Id: I2a0691724e6cf0248f9b5854b824f0d6d52308ba
diff --git a/include/svtools/fmtfield.hxx b/include/svtools/fmtfield.hxx
index 3c13f0f..8dcc0f7 100644
--- a/include/svtools/fmtfield.hxx
+++ b/include/svtools/fmtfield.hxx
@@ -36,9 +36,7 @@ typedef sal_uInt16 FORMAT_CHANGE_TYPE;
class SVT_DLLPUBLIC FormattedField : public SpinField
{
private:
- // Da ein SvNumberFormatter eine ziemlich teure (sowohl zeit- als auch platz-maessig) Angelegenheit ist,
- // haelt sich nicht jedes Field, an dem kein Formatter gesetzt wurde, eine eigenen Instanz, sondern es gibt nur eine
- // einzige statische.
+ // A SvNumberFormatter is very expensive (regarding time and space), it is a Singleton
class StaticFormatter
{
static SvNumberFormatter* s_cFormatter;
@@ -53,8 +51,8 @@ private:
protected:
OUString m_sLastValidText;
- // hat nichts mit dem current value zu tun, ist der letzte Text, der waehrend einer Eingabe als gueltig erkannt
- // wurde (also durch CheckText geprueft, nicht durch den Formatter gejagt)
+ // Has nothing to do with the current value. It is the last text, which was valid at input (checked by CheckText,
+ // not yet through formatter)
Selection m_aLastSelection;
double m_dMinValue;
@@ -79,16 +77,14 @@ protected:
double m_dSpinFirst;
double m_dSpinLast;
- // es macht einen Unterschied, ob man bei eingestellter Textformatierung beim LostFocus den aktuellen String durch
- // den Formatter jagt und das Ergebnis anzeigt oder erst aus dem String ein double macht, das formatiert und dann
- // ausgibt
+ // There is a difference, when text formatting is enabled, if LostFocus fotmattes the curent String and display it,
+ // or if a double is created from the String and then
bool m_bTreatAsNumber;
- // und mit den folgenden Members koennen wir das Ganze hier auch zur formatierten Text-Ausgabe benutzen ...
+ // And with the following members we can use it for formatted text output as well ...
OUString m_sCurrentTextValue;
OUString m_sDefaultText;
- // die bei der letzten Ausgabe-Operation vom Formatter gelieferte Farbe (nicht dass wir sie beachten wuerden, aber
- // man kann sie von aussen abfragen)
+ // The last color from the Formatter at the last output operation (not we would use it, but you can get it)
Color* m_pLastOutputColor;
bool m_bUseInputStringForFormatting;
@@ -97,7 +93,7 @@ public:
FormattedField(vcl::Window* pParent, WinBits nStyle = 0, SvNumberFormatter* pInitialFormatter = NULL, sal_Int32 nFormatKey = 0);
virtual ~FormattedField();
- // Min-/Max-Verwaltung
+ // Min-/Max-management
bool HasMinValue() const { return m_bHasMin; }
void ClearMinValue() { m_bHasMin = false; }
void SetMinValue(double dMin);
@@ -108,33 +104,32 @@ public:
void SetMaxValue(double dMax);
double GetMaxValue() const { return m_dMaxValue; }
- // aktueller Wert
+ // Current value
virtual void SetValue(double dVal);
virtual double GetValue();
- // die Standard-Implementierung jagt die Eingabe jeweils durch den Formatter, so einer vorhanden ist
+ // The default implementation uses a formatter, if available
void GetColor() const;
void SetTextValue(const OUString& rText);
- // der String wird in ein double umgewandelt (durch den Formatter) und anschliessen in SetValue gesteckt
+ // The String is transformed to a double (with a formatter) and SetValue is called afterwards
bool IsEmptyFieldEnabled() const { return m_bEnableEmptyField; }
void EnableEmptyField(bool bEnable);
- // wenn nicht enabled, wird beim Verlassen des Feldes der Text auf den letzten gueltigen zurueckgesetzt
+ // If disabled, the value will be resetted to the last valid value on leave
void SetDefaultValue(double dDefault) { m_dDefaultValue = dDefault; m_bValueDirty = true; }
- // wenn der aktuelle String ungueltig ist, liefert GetValue() diesen Default-Wert
+ // If the current String is invalid, GetValue() returns this value
double GetDefaultValue() const { return m_dDefaultValue; }
- // Einstellungen fuer das Format
+ // Settings for the format
sal_uLong GetFormatKey() const { return m_nFormatKey; }
void SetFormatKey(sal_uLong nFormatKey);
SvNumberFormatter* GetFormatter() const { return m_pFormatter; }
void SetFormatter(SvNumberFormatter* pFormatter, bool bResetFormat = true);
- // wenn bResetFormat sal_False ist, wird versucht, das alte eingestellte Format mit 'hinueberzuretten' (teuer, wenn es sich nicht
- // um eines der Standard-Formate handelt, die in allen Formattern gleich sind)
- // wenn sal_True, wird als neuer FormatKey 0 gesetzt
+ // If bResetFormat is sal_False, the old format is tried to be kept. (expensive, if it is no default format, available in all formatters)
+ // If sal_True, the new FormatKey is set to zero
bool GetThousandsSep() const;
void SetThousandsSep(bool _bUseSeparator);
@@ -142,28 +137,27 @@ public:
sal_uInt16 GetDecimalDigits() const;
void SetDecimalDigits(sal_uInt16 _nPrecision);
- // the is no check if the current format is numeric, so be cautious when calling these functions
+ // There is no check if the current format is numeric, so be cautious when calling these functions
SvNumberFormatter* StandardFormatter() { return m_aStaticFormatter; }
- // Wenn man keinen eigenen Formatter explizit anlegen will, kann man diesen hier in SetFormatter stecken ...
- // Das hier gelieferte Objekt wird allerdings zwischen allen Instanzen der Klasse geteilt (aus Zeit- und Platzgruenden),
- // also ist etwas Vorsicht angebracht ...
+ // If no new Formatter is created explicitly, this can be used in SetFormatter...
OUString GetFormat(LanguageType& eLang) const;
bool SetFormat(const OUString& rFormatString, LanguageType eLang);
- // sal_False, wenn der FormatString nicht gesetzt werden konnte (also wahrscheinlich ungueltig ist)
+ // sal_False, if the FormatString could not be set (and very probably is invalid)
+ // This Object is shared via all instances, so be careful!
bool IsStrictFormat() const { return m_bStrictFormat; }
void SetStrictFormat(bool bEnable) { m_bStrictFormat = bEnable; }
- // Formatueberpruefung waehrend der Eingabe ?
+ // Check format during input
// Spin-Handling
virtual void Up() SAL_OVERRIDE;
virtual void Down() SAL_OVERRIDE;
- // Standard-Implementierung : hoch- oder runterzaehlen des aktuellen double einfach um die gesetzte SpinSize
+ // Default Implementation: +/- default spin size to the double value
virtual void First() SAL_OVERRIDE;
virtual void Last() SAL_OVERRIDE;
- // Standard-Implementierung : aktuelles double setzen auf eingestellten first respektive last value
+ // Default Implementation: Current double is set to the first or last value
void SetSpinSize(double dStep) { m_dSpinSize = dStep; }
double GetSpinSize() const { return m_dSpinSize; }
@@ -181,19 +175,17 @@ public:
virtual void SetText( const OUString& rStr ) SAL_OVERRIDE;
virtual void SetText( const OUString& rStr, const Selection& rNewSelection ) SAL_OVERRIDE;
- // die folgenden Methoden sind interesant, wenn m_bTreatAsNumber auf sal_False sitzt
- /** nehmen wir mal an, irgendjemand will das ganze schoene double-Handling gar nicht haben, sondern
- einfach den Text formatiert ausgeben ...
- (der Text wird einfach nur durch den Formatter gejagt und dann gesetzt)
- */
+ //The following methods are interesting, if m_bTreatAsNumber is set to sal_False
+ //If someone does not care about all the double handling and just wants to print the text formatted.
+ //(((The text will be formatted, using the Formatter, and then set)
void SetTextFormatted(const OUString& rText);
OUString GetTextValue() const;
void SetDefaultText(const OUString& rDefault) { m_sDefaultText = rDefault; }
OUString GetDefaultText() const { return m_sDefaultText; }
- // die bei der letzten Ausgabe-Operation vom Formatter gelieferte Farbe (Ausgabe-Operationen werden getriggert durch
- // SetValue, SetTextValue, SetTextFormatted, also indirekt eventuell auch durch SetMin-/-MaxValue)
+ // The last colour from the Formatter's last output operation. Output operations get triggered by:
+ // SetValue, SetTextValue, SetTextFormatted, also indirectly via SetMin - / -MaxValue
Color* GetLastOutputColor() const { return m_pLastOutputColor; }
/** reformats the current text. Interesting if the user entered some text in an "input format", and
@@ -238,7 +230,7 @@ protected:
void impl_Modify(bool makeValueDirty = true);
virtual void Modify() SAL_OVERRIDE;
- // CheckText ueberschreiben fuer Ueberpruefung zur Eingabezeit
+ // Override CheckTextfor input-time checks
virtual bool CheckText(const OUString&) const { return true; }
// any aspect of the current format has changed
More information about the Libreoffice-commits
mailing list