Quelltext der Seite Text (Qt)

{{Qt-Tour|Datum- und Zeiteingabe|Listen}}

== Übersetzungen ==
Qt bietet eine recht einfache Möglichkeit, Programme durch Übersetzung aller Ausgaben zu internationalisieren<ref group='QtR'>[http://qt-project.org/doc/qt-5/i18n-source-translation.html Writing Source Code for Translation]</ref>.
*Die Verwendung von [[#QString Class|QString]] für alle Ausgaben garantiert [http://www.unicode.org/standard/standard.html Unicode] und damit alle Sprachen.
*{{Iqt|1=static QString QObject::tr(const char * sourceText, const char * disambiguation = 0, int n = -1)}} gibt einen übersetzten Text zurück<ref>Um '''tr''' in einer Methode einer nicht von '''QObject''' abgeleiteten Klasse zu verwenden, muss die Klasse von '''tr''' explicit angegeben werden:
{{Bsyn|lang=cpp-qt|code=class myClass { // Nicht von QOject abgeleitet.
  void myFunc() {
    QMessageBox* msgBox = new QMessageBox(p);
    msgBox->setWindowTitle(QMessageBox::tr("Buchhaltung")); // QMessageBox abgeleitet von QObject.
    .
    .
  }
}
}}. Man könnte auch '''QObject''' direkt verwenden {{Iqt|QObject::tr("Buchhaltung")}}, aber vielleicht liegt noch eine überlagerte Methode zur Optimierung dazwischen, also immer die Klasse, die der Verwendung am nächsten kommt.</ref>. Außerdem markiert '''tr''' den Text für das Übersetzungstool [http://qt-project.org/doc/qt-5/qtlinguist-index.html Qt Linguist].

== [https://qt-project.org/doc/qt-5/qchar.html QChar Class] ==
Ein QChar ist ein 16 Bit [http://www.unicode.org/standard/standard.html Unicode]-Zeichen (UTF-16)

== [https://qt-project.org/doc/qt-5/qstring.html QString Class] ==
Ein QString repräsentiert eine Zeichenkette aus [http://www.unicode.org/standard/standard.html Unicode]-Buchstaben. Jedes Zeichen ist ein QChar mit 16 Bit.
=== QString arg(...) ===
{{Isyn|lang=cpp-qt|code=QString QString::arg(double a, int fieldWidth = 0, char format = 'g', int precision = -1, QChar fillChar = QLatin1Char( ' ' )) const}} bietet eine einfache Möglichkeit, Werte in einen String einzubauen: {{Bsyn|lang=cpp-qt|code=double v1 = 123.456, v2 = 45.67;
qDebug() << tr("Double %2 wird im C-Stil und double %L1 im ortsüblichen Format ausgegeben").arg(v1).arg(v2);
// Double 45.67 wird im C-Stil und double 123,456 im ortsüblichen Format ausgegeben}}
Der Vorteil von '''arg''' liegt in der Übersetzbarkeit, es ist garantiert, dass %1 immer das 1. arg ist usw., auch wenn eine vernünftige Übersetzung eine andere Anordnung im Text erzwingt. %Ln verwendet die lokale Schreibweise (zB. in Deutschland Komma statt Punkt), %n den C-Standart.
{{Achtung}}'''arg''' verwendet die [http://www.cplusplus.com/reference/cstdio/printf/ printf-Syntax], die Vorgabe begrenzt die Ausgabe auf 6 Ziffern, egal wie groß der Wert ist. Für größere Werte muss {{Platz|precision}} angepasst werden. Im Format 'g' oder 'G' bestimmt precision die Anzahl aller Ziffern, in 'e', 'E' und 'f' nur die Anzahl hinter dem Komma.
=== QString toDouble() ===
Die Umkehrung von einer Zeichenkette in eine Fließkommazahl ist leider nicht so einfach: {{Iqt|1=double QString::toDouble(bool * ok = 0) const}} verwendet immer die {{Tooltip|C-Stil: Punkt als Dezimaltrenner|C-Locale}}. {{Tooltip|zB. mit Komma in Deutschland|Lokale Ziffernfolgen}} müssen mit {{Iqt|1=double QLocale::toDouble(const QString & s, bool * ok = 0) const}} umgewandelt werden. Außerdem scheitern beide Methoden, sobald andere Zeichen außer Ziffern, +, - oder Dezimaltrenner auftauchen. Ein Lösungsbeispiel für Geldbeträge:{{Bsyn|lang=cpp-qt|code=double value(123.455555);
QString wert(tr("%L1 %2").arg(value, 0, 'f', 2).arg(QLocale().currencySymbol())); // In Deutschland: 123,46 €
double sameValue(QLocale().toDouble(wert.remove(QLocale().currencySymbol())); // In Deutschland sameValue == 123.46, in USA sameValue == 0 (Umwandlung gescheitert, ok == false)}}
=== QString section(...) ===
Mit einem beliebigen Separator-Zeichen kann ein QString in Sektionen eingeteilt werden. Sektion 0 ist das 1. Feld vor dem 1. Separator. Wenn {{Iqt|1=SectionFlags flags = SectionSkipEmpty}}, dann wird dieses Feld nicht mitgezählt, wenn der String mit dem Separator beginnt.
{{Iqt|1=QString QString::section(QChar sep, int start, int end = -1, SectionFlags flags = SectionDefault) const}} gibt die ausgewählte Sektion zurück.

== [https://qt-project.org/doc/qt-5/QByteArray.html QByteArray Class] ==
QByteArray ist eine Optimierung für [[Literale (C++)#Zeichenliterale|C-Strings]], auch zur Aufnahme von [[Objekte und ihr Speicherplatz (C++)#Basistypen|{{Iqt|char}}]] geeignet.
QByteArray stellt sicher, dass wie bei [[Literale (C++)#Zeichenliterale|C-Strings]] immer eine \0 am Ende steht. {{Iqt|QByteArray::size()}} zählt diese \0 nicht mit. Auch ist ein {{Iqt|QByteArray::at(int i)}} auf diese \0 nicht zulässig, im Debug-Modus wird eine [[ASSERT (Qt)|ASSERT]] ausgegeben und das Programm beendet. {{Iqt|QByteArray::operator[](int i)}} hingegen ist unkritisch, da es das Array vergrößert.
=== [https://qt-project.org/doc/qt-5/qbytearray.html#qChecksum CRC-16 Checksumme] ===
{{Iqt|quint16 qChecksum(const char * data, uint len)}}

== Eine Liste von Strings ==
Ein [https://qt-project.org/doc/qt-5/QListView.html QListView] soll als Anzeigefeld für Strings dienen. QListView ist eine [[Grafik (Qt)#Model-View|'''view''']] des [https://qt-project.org/doc/qt-5/model-view-programming.html Model View Frameworks]. Somit benötigen wir noch ein passendes Modell für die Anzeige, in diesem Fall [https://qt-project.org/doc/qt-5/qstringlistmodel.html QStringListModel]. Beispiel:
<syntaxhighlight lang="cpp-qt">
 QListView *sicht = new QlistView(this); // this als Zeiger auf das Elternelement.
 QStringListModel *model = new QStringListModel;
 QStringList liste;

 sicht->setModel(model);
 liste.append("Text 1"); liste.append("Text 2"); ....
 model->setStringList(liste);
</syntaxhighlight>

== Quellen ==
*aus der Qt-5 Reference Documentation
<references group='QtR' />
== Fußnoten ==
<references />
[[Kategorie:C++]]