QRadioButton Class

Detaillierte Beschreibung

Ein QRadioButton ist eine Optionsschaltfläche, die ein- (angekreuzt) oder ausgeschaltet (nicht angekreuzt) werden kann. Radiobuttons bieten dem Benutzer typischerweise eine "eine von vielen" Auswahlmöglichkeiten. In einer Gruppe von Optionsschaltflächen kann jeweils nur eine Optionsschaltfläche aktiviert werden; wählt der Benutzer eine andere Schaltfläche aus, wird die zuvor ausgewählte Schaltfläche deaktiviert.

Optionsfelder sind standardmäßig autoExclusive. Wenn autoExclusive aktiviert ist, verhalten sich Optionsfelder, die zum selben übergeordneten Widget gehören, so, als wären sie Teil derselben exklusiven Schaltflächengruppe. Wenn Sie mehrere exklusive Schaltflächengruppen für Optionsschaltflächen benötigen, die zu demselben übergeordneten Widget gehören, fügen Sie sie in ein QButtonGroup ein.

Jedes Mal, wenn eine Schaltfläche ein- oder ausgeschaltet wird, sendet sie das Signal toggled(). Verbinden Sie sich mit diesem Signal, wenn Sie jedes Mal, wenn die Schaltfläche ihren Zustand ändert, eine Aktion auslösen möchten. Verwenden Sie isChecked(), um zu sehen, ob eine bestimmte Schaltfläche ausgewählt ist.

Genau wie QPushButton zeigt eine Optionsschaltfläche Text und optional ein kleines Symbol an. Das Symbol wird mit setIcon() gesetzt. Der Text kann im Konstruktor oder mit setText() festgelegt werden. Ein Tastenkürzel kann angegeben werden, indem dem gewünschten Zeichen ein kaufmännisches Und im Text vorangestellt wird. Ein Beispiel:

QRadioButton *button = new QRadioButton("Search from the &cursor", this);

In diesem Beispiel ist die Abkürzung Alt+c. Einzelheiten finden Sie in der Dokumentation QShortcut. Um ein echtes kaufmännisches Und darzustellen, verwenden Sie '&&'.

Wichtige vererbte Mitglieder: text(), setText(), text(), setDown(), isDown(), autoRepeat(), group(), setAutoRepeat(), toggle(), pressed(), released(), clicked() und toggled().