~ubuntu-branches/ubuntu/karmic/zenity/karmic

<para>Das vorliegende Dokument kann gemäß den Bedingungen der GNU Free Documentation License (GFDL), Version 1.1 oder jeder späteren, von der Free Software Foundation veröffentlichten Version ohne unveränderbare Abschnitte sowie ohne Texte auf dem vorderen und hinteren Buchdeckel kopiert, verteilt und/oder modifiziert werden. Eine Kopie der GFDL finden Sie unter diesem <ulink type="help" url="ghelp:fdl">Link</ulink> oder in der mit diesem Handbuch gelieferten Datei COPYING-DOCS.</para>

<para>Dieses Handbuch ist Teil einer Sammlung von GNOME-Handbüchern, die unter der GFDL veröffentlicht werden. Wenn Sie dieses Handbuch getrennt von der Sammlung weiterverbreiten möchten, können Sie das tun, indem Sie eine Kopie der Lizenz zum Handbuch hinzufügen, wie es in Abschnitt 6 der Lizenz beschrieben ist.</para>

<para>Viele der Namen, die von Unternehmen verwendet werden, um ihre Produkte und Dienstleistungen von anderen zu unterscheiden, sind eingetragene Warenzeichen. An den Stellen, an denen diese Namen in einer GNOME-Dokumentation erscheinen, werden die Namen in Großbuchstaben oder mit einem großen Anfangsbuchstaben geschrieben, wenn das GNOME-Dokumentationsprojekt auf diese Warenzeichen hingewiesen wird.</para>

<para>DAS DOKUMENT UND VERÄNDERTE FASSUNGEN DES DOKUMENTS WERDEN UNTER DEN BEDINGUNGEN DER GNU FREE DOCUMENTATION LICENSE ZUR VERFÜGUNG GESTELLT MIT DEM WEITERGEHENDEN VERSTÄNDNIS, DASS: <orderedlist>

<para>DIESES DOKUMENT WIRD »WIE VORLIEGEND« GELIEFERT, OHNE GARANTIEN IRGENDEINER ART, SOWOHL AUSDRÜCKLICH GENANNTE ALS AUCH ANGEDEUTETE. DIES BEZIEHT SICH AUCH OHNE EINSCHRÄNKUNG AUF GARANTIEN, DASS DIESES DOKUMENT ODER VERÄNDERTE FASSUNGEN DIESES DOKUMENTS FREI VON HANDELSDEFEKTEN, FÜR EINEN BESTIMMTEN ZWECK GEEIGNET IST ODER DASS ES KEINE RECHTE DRITTER VERLETZT. DAS VOLLE RISIKO WAS QUALITÄT, GENAUIGKEIT UND LEISTUNG DES DOKUMENTS ODER VERÄNDERTE FASSUNGEN DES DOKUMENTS LIEGT BEI IHNEN. SOLLTE EIN DOKUMENT ODER EINE VERÄNDERTE FASSUNG DAVON FEHLER IRGENDEINER ART BEINHALTEN, TRAGEN SIE (NICHT DER URSPRUNGSAUTOR, DER AUTOR ODER EIN MITWIRKENDER) DIE KOSTEN FÜR NOTWENDIGE DIENSTLEISTUNGEN, REPARATUREN ODER FEHLERKORREKTUREN. DIESER HAFTUNGSAUSSCHLUSS IST EIN ESSENZIELLER TEIL DIESER LIZENZ. DIE VERWENDUNG EINES DOKUMENTS ODER EINER VERÄNDERTEN VERSION DES DOKUMENTS IST NICHT GESTATTET AUßER UNTER BEACHTUNG DIESES HAFTUNGSAUSSCHLUSSES UND</para>

</listitem>

<para>UNTER KEINEN UMSTÄNDEN UND AUF BASIS KEINER RECHTSGRUNDLAGE, EGAL OB DURCH UNERLAUBTEN HANDLUNGEN (EINSCHLIEßLICH FAHRLÄSSIGKEIT), VERTRAG ODER ANDERWEITIG KANN DER AUTOR, URSPRUNGSAUTOR, EIN MITWIRKENDER ODER EIN VERTRIEBSPARTNER DIESES DOKUMENTS ODER EINER VERÄNDERTEN FASSUNG DES DOKUMENTS ODER EIN ZULIEFERER EINER DIESER PARTEIEN, HAFTBAR GEMACHT WERDEN FÜR DIREKTE, INDIREKTE, SPEZIELLE, VERSEHENTLICHE ODER FOLGESCHÄDEN JEGLICHER ART, EINSCHLIEßLICH UND OHNE EINSCHRÄNKUNGEN SCHÄDEN DURCH VERLUST VON KULANZ, ARBEITSAUSFALL, COMPUTERVERSAGEN ODER COMPUTERFEHLFUNKTIONEN ODER ALLE ANDEREN SCHÄDEN ODER VERLUSTE, DIE SICH AUS ODER IN VERBINDUNG MIT DER VERWENDUNG DES DOKUMENTS UND VERÄNDERTER FASSUNGEN DES DOKUMENTS ERGEBEN, AUCH WENN DIE OBEN GENANNTEN PARTEIEN ÜBER DIE MÖGLICHKEIT SOLCHER SCHÄDEN INFORMIERT WAREN.</para>

</listitem>

</orderedlist></para>

</legalnotice>

<surname>Java-Desktopsystem-Dokumentationsteam</surname>

<affiliation><orgname>Sun Microsystems, Inc.</orgname></affiliation>

</author>

<firstname>Glynn</firstname>

<surname>Foster</surname>

<orgname>GNOME-Dokumentationsprojekt</orgname>

</affiliation>

</author>

<firstname>Nicholas</firstname>

<surname>Curran</surname>

<orgname>GNOME-Dokumentationsprojekt</orgname>

</affiliation>

</editor>

</authorgroup>

<revnumber>Zenity-Desktop-Anwenderhandbuch V2.0</revnumber>

<date>August 2004</date>

<para role="author">Sun Java-Desktopsystem-Dokumentationsteam</para>

<para role="publisher">Sun Microsystems, Inc.</para>

</revdescription>

</revision>

<revnumber>Zenity-Handbuch V1.0</revnumber>

<date>Januar 2003</date>

<para role="author">Glynn Foster</para>

<para role="publisher">GNOME-Dokumentationsprojekt</para>

</revdescription>

</revision>

</revhistory>

<releaseinfo>Dieses Handbuch beschreibt Version 2.6.0 von Zenity.</releaseinfo>

<title>Rückmeldungen</title>

100

<para>Zum Senden von Rückmeldungen folgen Sie den Anweisungen auf der <ulink url="ghelp:gnome-feedback" type="help">GNOME-Seite für Rückmeldungen</ulink>.</para>

101

102

103

</legalnotice>

104

105

<para>Zenity entstand aus »gdialog«, der GNOME-Variante von »dialog«, welches Ihnen erlaubt, Dialogfenster über die Befehlszeile und mittels Shell-Skripten anzuzeigen.</para>

106

</abstract>

107

</articleinfo>

108

109

110

<primary>Zenity-Befehl</primary>

111

</indexterm>

112

113

<primary>Dialog-Erzeuger</primary>

114

</indexterm>

115

116

117

118

119

120

<title>Einführung</title>

121

122

<para><application>Zenity</application> erlaubt Ihnen die Erzeugung der folgenden Typen simpler Dialoge:</para>

123

124

125

<listitem><para>Kalender</para></listitem>

126

<listitem><para>Dateiauswahl</para></listitem>

127

<listitem><para>Liste</para></listitem>

128

<listitem><para>Benachrichtigungssymbol</para></listitem>

129

<listitem><para>Meldung</para>

130

131

<listitem><para>Fehler</para></listitem>

132

<listitem><para>Information</para></listitem>

133

<listitem><para>Frage</para></listitem>

134

<listitem><para>Warnung</para></listitem>

135

</itemizedlist>

136

</listitem>

137

<listitem><para>Fortschritt</para></listitem>

138

<listitem><para>Textfeld</para></listitem>

139

<listitem><para>Textinformation</para></listitem>

140

</itemizedlist>

141

142

</sect1>

143

144

145

146

147

<title>Benutzung</title>

148

149

<para>Wenn Sie Skripte schreiben, können Sie <application>Zenity</application> zur Erzeugung einfacher Dialoge zur Interaktion mit dem Benutzer verwenden, wie folgende:</para>

150

151

152

<para>Sie können einen Dialog erzeugen, der die Eingabe von Informationen durch den Benutzer erfordert. Beispielsweise können Sie den Benutzer anweisen, ein Datum aus einem Kalenderdialog oder eine Datei aus einem Dateiauswahldialog zu wählen.</para>

153

</listitem>

154

155

<para>Sie können einen Dialog erzeugen, um dem Benutzer Informationen zur Verfügung zu stellen. Beispielsweise können Sie einen Fortschrittsanzeige-Dialog erzeugen, um auf den aktuellen Status eines Vorgangs hinzuweisen, oder einen Warndialog, um den Benutzer zu warnen.</para>

156

</listitem>

157

</itemizedlist>

158

<para>Wenn der Benutzer den Dialog schließt, schreibt <application>Zenity</application> den vom Dialog ausgegebenen Text in die Standardausgabe.</para>

159

160

<note>

161

<para>Wenn Sie <application>Zenity</application>-Befehle schreiben, stellen Sie bitte sicher, dass Sie jedes Argument stets in Anführungszeichen einschließen.</para>

162

<para>Benutzen Sie beispielsweise: <screen><userinput><command>zenity --calendar --title="Urlaubsplaner"</command></userinput></screen> Benutzen Sie nicht: <screen><userinput><command>zenity --calendar --title=Urlaubsplaner</command></userinput></screen></para>

163

<para>Wenn Sie keine Anführungszeichen verwenden, könnten Sie unerwartete Ergebnisse erhalten.</para>

164

</note>

165

166

167

<title>Zugriffstasten</title>

168

<para>Eine Zugriffstaste ist eine Taste, die Ihnen die Ausführung einer Aktion mit der Tastatur zur Auswahl eines Befehls aus einem Menü oder einem Dialog erlaubt, anstatt dafür die Maus zu benutzen.</para>

169

<para>Einige <application>Zenity</application>-Dialoge unterstützen die Verwendung von Zugriffstasten. Um das Zeichen für den Tastaturzugriff festzulegen, setzen Sie einen Unterstrich vor das Zeichen im Dialogtext. Das folgende Beispiel zeigt, wie Sie den Buchstaben »W« als Zugriffstaste festlegen.</para>

170

<screen><userinput>"_Wählen Sie einen Namen"</userinput></screen>

171

</sect2>

172

173

174

<title>Rückgabewerte</title>

175

<para><application>Zenity</application> erzeugt die folgenden Rückgabewerte:</para>

176

177

178

179

180

181

<thead>

182

183

184

<para>Rückgabewert</para></entry>

185

186

<para>Beschreibung</para></entry>

187

</row>

188

</thead>

189

<tbody>

190

191

<entry>

192

193

</entry>

194

<entry>

195

<para>Der Benutzer hat entweder auf <guibutton>OK</guibutton> oder auf <guibutton>Schließen</guibutton> gedrückt.</para>

196

</entry>

197

</row>

198

199

<entry>

200

201

</entry>

202

<entry>

203

<para>Der Benutzer hat entweder auf <guibutton>Abbrechen</guibutton> gedrückt oder die Fensterfunktionen zum Schließen des Dialogs benutzt.</para>

204

</entry>

205

</row>

206

207

<entry>

208

209

</entry>

210

<entry>

211

<para>Es ist ein unerwarteter Fehler aufgetreten.</para>

212

</entry>

213

</row>

214

</tbody>

215

</tgroup>

216

</informaltable>

217

218

</sect2>

219

220

221

222

223

224

<title>Allgemeine Einstellungen</title>

225

226

<para>Alle <application>Zenity</application>-Dialoge unterstützen die folgenden allgemeinen Optionen:</para>

227

228

229

230

231

<term><option>--title</option>=<replaceable>Titel</replaceable></term>

232

233

<para>Damit legen Sie den Titel des Dialogs fest.</para>

234

</listitem>

235

</varlistentry>

236

237

238

<term><option>--window-icon</option>=<replaceable>Symbolpfad</replaceable></term>

239

240

<para>Damit legen Sie das Symbol fest, das im Fensterrahmen des Dialogs angezeigt wird. Es gibt 4 Standardsymbole, die auch über die Schlüsselwörter »info«, »warning«, »question« und »error« bereitgestellt werden.</para>

241

</listitem>

242

</varlistentry>

243

244

245

<term><option>--width</option>=<replaceable>Breite</replaceable></term>

246

247

<para>Damit legen Sie die Breite des Dialogs fest.</para>

248

</listitem>

249

</varlistentry>

250

251

252

<term><option>--height</option>=<replaceable>Höhe</replaceable></term>

253

254

<para>Damit legen Sie die Höhe des Dialogs fest.</para>

255

</listitem>

256

</varlistentry>

257

258

</variablelist>

259

260

</sect2>

261

262

263

264

265

<title>Hilfeoptionen</title>

266

267

<para><application>Zenity</application> stellt die folgenden Hilfeoptionen bereit:</para>

268

269

270

271

272

273

274

<para>Damit zeigen Sie einen Hilfetext in Kurzform an.</para>

275

</listitem>

276

</varlistentry>

277

278

279

280

281

<para>Damit zeigen Sie den kompletten Hilfetext für alle Dialoge an.</para>

282

</listitem>

283

</varlistentry>

284

285

286

<term><option>--help-general</option></term>

287

288

<para>Damit zeigen Sie den Hilfetext für allgemeine Dialogoptionen an.</para>

289

</listitem>

290

</varlistentry>

291

292

293

<term><option>--help-calendar</option></term>

294

295

<para>Damit zeigen Sie den Hilfetext für Kalenderdialogoptionen an.</para>

296

</listitem>

297

</varlistentry>

298

299

300

<term><option>--help-entry</option></term>

301

302

<para>Damit zeigen Sie den Hilfetext für Optionen des Texteingabedialogs an.</para>

303

</listitem>

304

</varlistentry>

305

306

307

<term><option>--help-error</option></term>

308

309

<para>Damit zeigen Sie den Hilfetext für Optionen des Fehlerdialogs an.</para>

310

</listitem>

311

</varlistentry>

312

313

314

315

316

<para>Damit zeigen Sie den Hilfetext für Informationsdialogoptionen an.</para>

317

</listitem>

318

</varlistentry>

319

320

321

<term><option>--help-file-selection</option></term>

322

323

<para>Damit zeigen Sie den Hilfetext für Optionen des Dateiauswahldialogs.</para>

324

</listitem>

325

</varlistentry>

326

327

328

329

330

<para>Damit zeigen Sie den Hilfetext für Optionen des Listendialogs an.</para>

331

</listitem>

332

</varlistentry>

333

334

335

<term><option>--help-notification</option></term>

336

337

<para>Damit zeigen Sie den Hilfetext für Optionen des Benachrichtigungsymbols an.</para>

338

</listitem>

339

</varlistentry>

340

341

342

<term><option>--help-progress</option></term>

343

344

<para>Damit zeigen Sie den Hilfetext für Optionen des Fortschrittsanzeige-Dialogs an.</para>

345

</listitem>

346

</varlistentry>

347

348

349

<term><option>--help-question</option></term>

350

351

<para>Damit zeigen Sie den Hilfetext für Optionen des Fragedialogs an.</para>

352

</listitem>

353

</varlistentry>

354

355

356

<term><option>--help-warning</option></term>

357

358

<para>Damit zeigen Sie den Hilfetext für die Optionen des Warndialogs an.</para>

359

</listitem>

360

</varlistentry>

361

362

363

364

365

<para>Damit zeigen Sie den Hilfetext für Optionen des Informationsdialogs an.</para>

366

</listitem>

367

</varlistentry>

368

369

370

371

372

<para>Damit zeigen Sie den Hilfetext für nicht auf einen bestimmten Dialog bezogene Optionen an.</para>

373

</listitem>

374

</varlistentry>

375

376

377

378

379

<para>Damit zeigen Sie den Hilfetext für die GTK+-Optionen an.</para>

380

</listitem>

381

</varlistentry>

382

383

</variablelist>

384

385

</sect2>

386

387

388

389

390

<title>Verschiedene Optionen</title>

391

392

<para><application>Zenity</application> stellt außerdem die folgenden verschiedenen Optionen zur Verfügung:</para>

393

394

395

396

397

<term><option>--about</option></term>

398

399

<para>Damit zeigen Sie den <guilabel>Info zu Zenity</guilabel>-Dialog an, der Versionsinformationen, Copyright-Informationen und Entwicklerinformationen über <application>Zenity</application> enthält.</para>

400

</listitem>

401

</varlistentry>

402

403

404

<term><option>--version</option></term>

405

406

<para>Damit zeigen Sie die Versionsnummer von <application>Zenity</application> an.</para>

407

</listitem>

408

</varlistentry>

409

410

</variablelist>

411

412

</sect2>

413

414

415

416

417

<title>GTK+-Optionen</title>

418

419

<para><application>Zenity</application> unterstützt die Standardoptionen von GTK+. Um weitere Informationen über die GTK+-Optionen anzuzeigen, führen Sie den Befehl <command>zenity -?</command> aus.</para>

420

421

</sect2>

422

423

</sect1>

424

425

426

427

<title>Kalenderdialog</title>

428

429

<para>Benutzen Sie die Option <option>--calendar</option> zur Erzeugung eines Kalenderdialogs. <application>Zenity</application> gibt das gewählte Datum an die Standardausgabe zurück. Wenn kein Datum auf der Befehlszeile angegeben wird, verwendet der Dialog das aktuelle Datum.</para>

430

<para>Der Kalenderdialog unterstützt die folgenden Optionen:</para>

431

432

433

434

435

436

437

<para>Damit legen Sie den Text fest, der im Kalenderdialog angezeigt wird.</para>

438

</listitem>

439

</varlistentry>

440

441

442

443

444

<para>Damit legen Sie den im Kalenderdialog ausgewählten Tag fest. <replaceable>Tag</replaceable> muss eine Zahl von 1 bis 31 sein.</para>

445

</listitem>

446

</varlistentry>

447

448

449

<term><option>--month</option>=<replaceable>Monat</replaceable></term>

450

451

<para>Damit legen Sie den im Kalenderdialog ausgewählten Monat fest. <replaceable>Monat</replaceable> muss eine Zahl zwischen 1 und 12 sein.</para>

452

</listitem>

453

</varlistentry>

454

455

456

457

458

<para>Damit legen Sie das im Kalenderdialog ausgewählte Jahr fest.</para>

459

</listitem>

460

</varlistentry>

461

462

463

<term><option>--date-format</option>=<replaceable>Format</replaceable></term>

464

465

<para>Damit legen Sie das Format fest, das vom Kalenderdialog nach der Auswahl des Datums zurückgegeben wird. Das Standardformat ist abhängig von Ihren Spracheinstellungen. <replaceable>Format</replaceable> muss ein Format sein, das von der <command>strftime</command>-Funktion unterstützt wird, zum Beispiel <literal>%A %d/%m/%y</literal>.</para>

466

</listitem>

467

</varlistentry>

468

469

</variablelist>

470

471

<para>Das folgende Beispielskript zeigt, wie Sie einen Kalenderdialog erzeugen können: <programlisting>

472

#!/bin/sh

473

474

475

if zenity --calendar \

476

--title="Datum auswählen" \

477

--text="Klicken Sie auf ein Datum, um es auszuwählen." \

478

--day=9 --month=4 --year=2008

479

then echo $?

480

else echo "Kein Datum ausgewählt"

481

482

</programlisting></para>

483

484

485

<title>Beispiel für einen Kalenderdialog</title>

486

487

488

489

490

</imageobject>

491

492

<phrase><application>Zenity</application> Beispiel für einen Kalenderdialog</phrase>

493

</textobject>

494

</mediaobject>

495

</screenshot>

496

</figure>

497

498

</sect1>

499

500

501

502

503

504

<title>Dateiauswahldialog</title>

505

506

<para>Verwenden Sie die Option <option>--file-selection</option> zur Erzeugung eines Dateiauswahldialogs. <application>Zenity</application> gibt die ausgewählten Dateien oder Ordner an die Standardausgabe zurück. Der Standardmodus für den Dateiauswahldialog ist »Öffnen«. </para>

507

<para>Der Dateiauswahldialog unterstützt die folgenden Optionen:</para>

508

509

510

511

512

<term><option>--filename</option>=<replaceable>Dateiname</replaceable></term>

513

514

<para>Legt die Datei oder den Ordner fest, die oder der bei der ersten Anzeige des Dateiauswahldialogs angezeigt wird.</para>

515

</listitem>

516

</varlistentry>

517

518

519

<term><option>--multiple</option></term>

520

521

<para>Erlaubt die Mehrfachauswahl von Dateien im Dateiauswahldialog.</para>

522

</listitem>

523

</varlistentry>

524

525

526

<term><option>--directory</option></term>

527

528

<para>Erlaubt nur die Auswahl von Ordnern im Dateiauswahldialog.</para>

529

</listitem>

530

</varlistentry>

531

532

533

534

535

<para>Setzt den Dateiauswahldialog in den Modus »Speichern«.</para>

536

</listitem>

537

</varlistentry>

538

539

540

<term><option>--separator</option>=<replaceable>Trenner</replaceable></term>

541

542

<para>Legt die Zeichenkette fest, die für die Trennung der zurückgegebenen Liste der Dateinamen verwendet wird.</para>

543

</listitem>

544

</varlistentry>

545

546

</variablelist>

547

548

<para>Das folgende Beispielskript zeigt, wie Sie einen Dateiauswahldialog erzeugen können: <programlisting>

549

#!/bin/sh

550

551

FILE=`zenity --file-selection --title="Wählen Sie eine Datei"`

552

553

case $? in

554

555

echo "\"$FILE\" ausgewählt.";;

556

557

echo "Keine Datei ausgewählt.";;

558

-1)

559

echo "Keine Datei ausgewählt.";;

560

esac

561

</programlisting></para>

562

563

564

<title>Beispiel für einen Dateiauswahldialog</title>

565

566

567

568

569

</imageobject>

570

571

<phrase><application>Zenity</application> Beispiel für einen Dateiauswahldialog</phrase>

572

</textobject>

573

</mediaobject>

574

</screenshot>

575

</figure>

576

577

</sect1>

578

579

580

581

<title>Benachrichtigungssymbol</title>

582

583

<para>

584

</para>

585

586

587

588

589

590

591

<para>Legt den Text fest, der im Benachrichtigungsfeld angezeigt wird.</para>

592

</listitem>

593

</varlistentry>

594

595

</variablelist>

596

597

<para>Das folgende Beispielskript zeigt, wie Sie ein Benachrichtigungssymbol erzeugen: <programlisting>

598

#!/bin/sh

599

600

zenity --notification\

601

--window-icon="info" \

602

--text="Wichtige Systemaktualisierungen sind verfügbar!"

603

</programlisting></para>

604

605

606

<title>Beispiel für ein Benachrichtigungssymbol</title>

607

608

609

610

611

</imageobject>

612

613

<phrase><application>Zenity</application> Beispiel für ein Benachrichtigungssymbol</phrase>

614

</textobject>

615

</mediaobject>

616

</screenshot>

617

</figure>

618

619

</sect1>

620

621

622

623

624

<title>Listendialog</title>

625

626

<para>Verwenden Sie die Option <option>--list</option>, um einen Listendialog zu erzeugen. <application>Zenity</application> gibt die Einträge in der ersten Spalte der ausgewählten Zeile an die Standardausgabe zurück.</para>

627

628

<para>Die Daten für den Dialog müssen Spalte für Spalte und Zeile für Zeile angegeben werden. Die Daten können dem Dialog durch die Standardeingabe zur Verfügung gestellt werden. Die einzelnen Einträge müssen durch ein Newline-Zeichen voneinander getrennt werden.</para>

629

630

<para>Wenn Sie die Optionen <option>--checklist</option> oder <option>--radiolist</option> verwenden, muss jede Zeile entweder mit 'TRUE' oder mit 'FALSE' beginnen.</para>

631

632

<para>Der Listendialog unterstützt die folgenden Optionen:</para>

633

634

635

636

637

<term><option>--column</option>=<replaceable>Spalte</replaceable></term>

638

639

<para>Legt die Spaltenüberschriften fest, die im Listendialog angezeigt werden sollen. Sie müssen eine <option>--column</option>-Option für jede Spalte angeben, die Sie im Listendialog anzeigen wollen.</para>

640

</listitem>

641

</varlistentry>

642

643

644

<term><option>--checklist</option></term>

645

646

<para>Legt fest, dass die erste Spalte im Listendialog Ankreuzfelder enthält.</para>

647

</listitem>

648

</varlistentry>

649

650

651

<term><option>--radiolist</option></term>

652

653

<para>Legt fest, dass die erste Spalte im Listendialog Radioknöpfe enthalten soll.</para>

654

</listitem>

655

</varlistentry>

656

657

658

<term><option>--editable</option></term>

659

660

<para>Erlaubt die Bearbeitung der angezeigten Objekte.</para>

661

</listitem>

662

</varlistentry>

663

664

665

<term><option>--separator</option>=<replaceable>Trenner</replaceable></term>

666

667

<para>Legt fest, welche Zeichenkette verwendet wird, wenn der Listendialog die ausgewählten Einträge zurück gibt.</para>

668

</listitem>

669

</varlistentry>

670

671

672

<term><option>--print-column</option>=<replaceable>Spalte</replaceable></term>

673

674

<para>Dies legt fest, welche Spalte Ihrer Auswahl ausgegeben werden soll. Die Vorgabe ist »1«. Sie können »ALL« verwenden, um alle Spalten der Liste ausgeben zu lassen.</para>

675

</listitem>

676

</varlistentry>

677

678

</variablelist>

679

680

<para>Das folgende Beispielskript zeigt, wie Sie einen Listendialog erzeugen: <programlisting>

681

#!/bin/sh

682

683

zenity --list \

684

--title="Fehlerberichte auswählen" \

685

--column="Kennung" --column="Wichtigkeit" --column="Beschreibung" \

686

992383 Normal "GtkTreeView crashes on multiple selections" \

687

293823 High "GNOME Dictionary does not handle proxy" \

688

393823 Critical "Menu editing does not work in GNOME 2.0"

689

</programlisting></para>

690

691

692

<title>Beispiel für einen Listendialog</title>

693

694

695

696

697

</imageobject>

698

699

<phrase><application>Zenity</application> Beispiel für einen Listendialog</phrase>

700

</textobject>

701

</mediaobject>

702

</screenshot>

703

</figure>

704

705

</sect1>

706

707

708

709

710

<title>Meldungsdialoge</title>

711

712

<para><application>Zenity</application> kann vier verschiedene Typen von Meldungsdialogen erzeugen:</para>

713

714

715

<para>Fehler</para>

716

</listitem>

717

718

<para>Information</para>

719

</listitem>

720

721

<para>Frage</para>

722

</listitem>

723

724

<para>Warnung</para>

725

</listitem>

726

</itemizedlist>

727

728

<para>Für jeden dieser Typen geben Sie mit der Option <option>--text</option> an, welcher Text im Dialog angezeigt werden soll.</para>

729

730

731

<title>Fehlerdialog</title>

732

733

<para>Verwenden Sie die Option <option>--error</option>, um einen Fehlerdialog zu erzeugen.</para>

734

735

<para>Das folgende Beispielskript zeigt, wie Sie einen Fehlerdialog erzeugen: <programlisting>

736

#!/bin/bash

737

738

zenity --error \

739

--text="/var/log/syslog wurde nicht gefunden."

740

</programlisting></para>

741

742

743

<title>Beispiel für einen Fehlerdialog</title>

744

745

746

747

748

</imageobject>

749

750

<phrase><application>Zenity</application> Beispiel für einen Fehlerdialog</phrase>

751

</textobject>

752

</mediaobject>

753

</screenshot>

754

</figure>

755

</sect2>

756

757

758

<title>Informationsdialog</title>

759

760

<para>Verwenden Sie die Option <option>--info</option>, um einen Informationsdialog zu erzeugen.</para>

761

762

<para>Das folgende Beispielskript zeigt, wie Sie einen Informationsdialog erzeugen: <programlisting>

763

#!/bin/bash

764

765

zenity --info \

766

--text="Die Aktualisierung wurde ausgeführt.\n3 von 10 Dateien wurden aktualisiert."

767

</programlisting></para>

768

769

770

<title>Beispiel für einen Informationsdialog</title>

771

772

773

774

775

</imageobject>

776

777

<phrase><application>Zenity</application> Beispiel für einen Informationsdialog</phrase>

778

</textobject>

779

</mediaobject>

780

</screenshot>

781

</figure>

782

</sect2>

783

784

785

<title>Fragedialog</title>

786

787

<para>Verwenden Sie die Option <option>--question</option>, um einen Fragedialog zu erzeugen.</para>

788

789

<para>Das folgende Beispielskript zeigt, wie Sie einen Fragedialog erzeugen: <programlisting>

790

#!/bin/bash

791

792

zenity --question \

793

--text="Wollen Sie wirklich fortsetzen?"

794

</programlisting></para>

795

796

797

<title>Beispiel für einen Fragedialog</title>

798

799

800

801

802

</imageobject>

803

804

<phrase><application>Zenity</application> Beispiel für einen Fragedialog</phrase>

805

</textobject>

806

</mediaobject>

807

</screenshot>

808

</figure>

809

</sect2>

810

811

812

<title>Warndialog</title>

813

814

<para>Verwenden Sie die Option <option>--warning</option>, um einen Warndialog zu erzeugen.</para>

815

816

<para>Das folgende Beispielskript zeigt, wie Sie einen Warndialog erzeugen: <programlisting>

817

#!/bin/bash

818

819

zenity --warning \

820

--text="Ziehen Sie den Netzstecker, um einen elektrischen Schlag zu vermeiden."

821

</programlisting></para>

822

823

824

<title>Beispiel für einen Warndialog</title>

825

826

827

828

829

</imageobject>

830

831

<phrase><application>Zenity</application> Beispiel für einen Warndialog</phrase>

832

</textobject>

833

</mediaobject>

834

</screenshot>

835

</figure>

836

</sect2>

837

838

</sect1>

839

840

841

842

843

<title>Fortschrittsanzeige-Dialog</title>

844

845

<para>Verwenden Sie die Option <option>--progress</option>, um einen Fortschrittsanzeige-Dialog zu erzeugen.</para>

846

847

<para><application>Zenity</application> liest die Daten aus der Standardeingabe zeilenweise. Wenn einer Zeile ein Raute-Zeichen (#) vorangestellt ist, wird der angezeigte Text durch den Text in dieser Zeile aktualisiert, bei einem angezeigten Prozentsatz durch die angegebene Zahl.</para>

848

849

<para>Der Fortschrittsanzeige-Dialog unterstützt die folgenden Optionen:</para>

850

851

852

853

854

855

856

<para>Legt den Text fest, der im Fortschrittsanzeige-Dialog angezeigt wird.</para>

857

</listitem>

858

</varlistentry>

859

860

861

<term><option>--percentage</option>=<replaceable>Prozentsatz</replaceable></term>

862

863

<para>Legt den anfänglich im Fortschrittsanzeige-Dialog angezeigten Prozentsatz fest.</para>

864

</listitem>

865

</varlistentry>

866

867

868

<term><option>--auto-close</option></term>

869

870

<para>Schließt den Fortschrittsanzeige-Dialog, wenn 100% erreicht sind.</para>

871

</listitem>

872

</varlistentry>

873

874

875

<term><option>--pulsate</option></term>

876

877

<para>Legt fest, dass die Fortschrittsleiste pulsiert, bis ein EOF-Zeichen von der Standardeingabe gelesen wird.</para>

878

</listitem>

879

</varlistentry>

880

881

</variablelist>

882

883

<para>Das folgende Beispielskript zeigt, wie Sie einen Fortschrittsanzeige-Dialog erzeugen: <programlisting>

884

#!/bin/sh

885

(

886

echo "10" ; sleep 1

887

echo "# Mail-Logdateien werden aktualisiert" ; sleep 1

888

echo "20" ; sleep 1

889

echo "# Cronjobs werden zurückgesetzt" ; sleep 1

890

echo "50" ; sleep 1

891

echo "Diese Zeile wird ignoriert" ; sleep 1

892

echo "75" ; sleep 1

893

echo "# Neustart des Systems" ; sleep 1

894

echo "100" ; sleep 1

895

) |

896

zenity --progress \

897

--title="Logdateien aktualisieren" \

898

--text="Mail-Logdateien werden untersucht …" \

899

--percentage=0

900

901

if [ "$?" = -1 ] ; then

902

zenity --error \

903

--text="Aktualisierung wurde abgebrochen."

904

905

906

</programlisting></para>

907

908

909

<title>Beispiel für einen Fortschrittsanzeige-Dialog</title>

910

911

912

913

914

</imageobject>

915

916

<phrase><application>Zenity</application> Beispiel für einen Fortschrittsanzeige-Dialog</phrase>

917

</textobject>

918

</mediaobject>

919

</screenshot>

920

</figure>

921

922

</sect1>

923

924

925

926

927

<title>Texteingabe-Dialog</title>

928

929

<para>Verwenden Sie die Option <option>--entry</option>, um einen Texteingabedialog zu erzeugen. <application>Zenity</application> gibt den Inhalt des Texts an die Standardausgabe zurück.</para>

930

<para>Der Texteingabedialog unterstützt die folgenden Optionen:</para>

931

932

933

934

935

936

937

<para>Legt den Text fest, der im Texteingabedialog angezeigt wird.</para>

938

</listitem>

939

</varlistentry>

940

941

942

<term><option>--entry-text</option>=<replaceable>Text</replaceable></term>

943

944

<para>Legt den Text fest, der im Eingabefeld des Texteingabedialogs angezeigt wird.</para>

945

</listitem>

946

</varlistentry>

947

948

949

950

951

<para>Dadurch wird der Text im Eingabefeld des Textreingabedialogs verborgen.</para>

952

</listitem>

953

</varlistentry>

954

955

</variablelist>

956

957

<para>Das folgende Beispielskript zeigt, wie Sie einen Texteingabedialog erzeugen: <programlisting>

958

#!/bin/sh

959

960

if zenity --entry \

961

--title="Eintrag hinzufügen" \

962

--text="Geben Sie Ihr _Passwort ein:" \

963

--entry-text "Passwort" \

964

--hide-text

965

then echo $?

966

else echo "Es wurde kein Passwort eingegeben"

967

968

</programlisting></para>

969

970

971

<title>Beispiel für einen Texteingabe-Dialog</title>

972

973

974

975

976

</imageobject>

977

978

<phrase><application>Zenity</application> Beispiel für einen Texteingabedialog</phrase>

979

</textobject>

980

</mediaobject>

981

</screenshot>

982

</figure>

983

</sect1>

984

985

986

987

988

<title>Text-Informationsdialog</title>

989

990

<para>Verwenden Sie die Option <option>--text-info</option>, um einen Textinformationsdialog zu erzeugen.</para>

991

992

<para>Der Textinformationsdialog unterstützt die folgenden Optionen:</para>

993

994

995

996

997

<term><option>--filename</option>=<replaceable>Dateiname</replaceable></term>

998

999

<para>Legt eine Datei fest, die im Textinformationsdialog geladen wird.</para>

1000

</listitem>

1001

</varlistentry>

1002

1003

1004

<term><option>--editable</option></term>

1005

1006

<para>Ermöglicht die Bearbeitung des angezeigten Texts. Der bearbeitete Text wird an die Standardausgabe zurückgegeben, wenn der Dialog geschlossen wird.</para>

1007

</listitem>

1008

</varlistentry>

1009

1010

</variablelist>

1011

1012

<para>Das folgende Beispielskript zeigt, wie Sie einen Textinformationsdialog erzeugen: <programlisting>

1013

#!/bin/sh

1014

1015

FILE=`zenity --file-selection \

1016

--title="Wählen Sie eine Datei"`

1017

1018

case $? in

1019

1020

zenity --text-info \

1021

--title=$FILE \

1022

--filename=$FILE \

1023

--editable 2>/tmp/tmp.txt;;

1024

1025

echo "Keine Datei ausgewählt.";;

1026

-1)

1027

echo "Keine Datei ausgewählt.";;

1028

esac

1029

</programlisting></para>

1030

1031

1032

<title>Beispiel für einen Text-Informationsdialog</title>

1033

1034

1035

1036

1037

</imageobject>

1038

1039

<phrase><application>Zenity</application> Beispiel für einen Textinformationsdialog</phrase>

1040

</textobject>

1041

</mediaobject>

1042

</screenshot>

1043

</figure>

1044

1045

</sect1>

1046

1047

</article>

Older »