UI::Di...Dialog(3pm)

📦

version 1.21 · 3 versions

1.21 · ubuntu jammy, ubuntu noble (latest)
1.21 · ubuntu resolute, ubuntu stonking
1.21 · debian bookworm, debian trixie

✨ UI::Dialog::Backend::KDialog ✨

okay bestie, so this is the UI::Dialog::Backend::KDialog page from the User Contributed Perl Documentation — it's the backend for the KDE dialog variant 💖

🌸 NAME 🌸

UI::Dialog::Backend::KDialog — backend for the KDE dialog variant. that's the whole vibe, fr fr 🫶

🦋 SYNOPSIS 🦋

use UI::Dialog::Backend::KDialog;
my $d = new UI::Dialog::Backend::KDialog ( backtitle => 'Demo',
                                           title => 'Default' );

$d->msgbox( title => 'Welcome!', text => 'Welcome one and all!' );

🎀 ABSTRACT 🎀

UI::Dialog::Backend::KDialog is the UI::Dialog backend for the KDE dialog variant. so like, when you're using this module through UI::Dialog or any other loader module, only the compatible methods are ever accessible — that's the deal, periodt.

but !! when you use this module directly in your application (like in the SYNOPSIS example up there 💅), you get access to all the options and features of the real kdialog(1) application. main character energy, honestly 👑

💜 DESCRIPTION 💜

so this dialog variant doesn't have any progress meters, bestie — that's a real thing, no cap. but what it does have? the benefits of many different file/uri/directory widgets ✨ and honestly, it's a shame that this is the only dialog variant for KDE 😭 like, where's the rest of them??

🍓 EXPORT 🍓

None

literally none. nothing. it exports nothing, and that's on purpose 🙈

🌈 INHERITS 🌈

UI::Dialog::Backend

it inherits from UI::Dialog::Backend, iykyk 💖

👑 CONSTRUCTOR 👑

`new( @options )`

EXAMPLE

my $d = new( title => 'Default Title', backtitle => 'Backtitle',
             width => 65, height => 20, listheight => 5 );

DESCRIPTION

this is the Class Constructor method 💅 it accepts a list of key => value pairs, and then uses them as the defaults whenever you're interacting with the various widgets. slay.

RETURNS

a blessed object reference of the UI::Dialog::Backend::KDialog class ✨ iconic.

OPTIONS

the (...)'s after each option show you the default for that option, bestie. and an * means it's supported by all the widget methods on a per-use policy — defaulting to the values decided during object creation. so set it once at construction and let it ride 🦋

debug = 0,1,2 (0)
literal = 0,1 (0)
backtitle = "backtitle" ('') *
title = "title" ('') *
nocancel = 0,1 (0) *
defaultno = 0,1 (0) *
beepbefore = 0,1 (0) *
beepafter = 0,1 (0) *
extrabutton = 0,1 (0) *
extralabel = "extra label" (0) *
helpbutton = 0,1 (0) *
helplabel = "help label" (0) *
maxinput = \d+ (0) *

`yesno( )` `yesnocancel( )` `warningyesno( )` `warningyesnocancel( )`

EXAMPLE

# if ($d->warningyesnocancel( text => 'A question?') ) {
# if ($d->warningyesno( text => 'A question?') ) {
# if ($d->yesnocancel( text => 'A question?') ) {
if ($d->yesno( text => 'A binary type question?') ) {
    # user pressed yes
} else {
    # user pressed no or cancel
}

DESCRIPTION

you're presenting the end user with a message box that has two buttons: yes and no 🫶 that's it, that's the widget.

RETURNS

TRUE (1) for a response of YES, or FALSE (0) for anything else. periodt 💅

`msgbox( )`

EXAMPLE

$d->msgbox( text => 'A simple message' );

DESCRIPTION

you're presenting the end user with a message box that has an OK button ✨

RETURNS

TRUE (1) for a response of OK, or FALSE (0) for anything else. 💖

`password( )`

EXAMPLE

my $string = $d->password( text => 'Enter some (hidden) text.' );

DESCRIPTION

you're presenting the end user with a text input field that doesn't reveal the input (except to the script, sneaky 👀) plus a message. secretive queen behavior, we love her.

RETURNS

a SCALAR if the response is OK, and FALSE (0) for anything else. 🌸

`inputbox( )`

EXAMPLE

my $string = $d->inputbox( text => 'Enter some text.',
                           entry => 'this is the input field' );

DESCRIPTION

you're presenting the end user with a text input field and a message. simple, clean, effective 🎀

RETURNS

a SCALAR if the response is OK, and FALSE (0) for anything else. ⭐

`textbox( )`

EXAMPLE

$d->textbox( path => '/path/to/a/text/file' );

DESCRIPTION

you're presenting the end user with a simple scrolling box containing the contents of the given text file 🦋

RETURNS

TRUE (1) if the response is OK, and FALSE (0) for anything else. 💜

`menu( )`

EXAMPLE

my $selection1 = $d->menu( text => 'Select one:',
                           list => [ 'tag1', 'item1',
                                     'tag2', 'item2',
                                     'tag3', 'item3' ]
                         );

DESCRIPTION

you're presenting the user with a selectable list 👑

RETURNS

a SCALAR of the chosen tag if the response is OK, and FALSE (0) for anything else. ✨

`checklist( )`

EXAMPLE

my @selection = $d->checklist( text => 'Select one:',
                               list => [ 'tag1', [ 'item1', 0 ],
                                         'tag2', [ 'item2', 1 ],
                                         'tag3', [ 'item3', 1 ] ]
                             );

DESCRIPTION

you're presenting the user with a selectable checklist 🎀 multiple picks, we're feeling generous today.

RETURNS

an ARRAY of the chosen tags if the response is OK, and FALSE (0) for anything else. 💖

`radiolist( )`

EXAMPLE

my $selection = $d->radiolist( text => 'Select one:',
                               list => [ 'tag1', [ 'item1', 0 ],
                                         'tag2', [ 'item2', 1 ],
                                         'tag3', [ 'item3', 0 ] ]
                             );

DESCRIPTION

you're presenting the user with a selectable radiolist 🌸

RETURNS

a SCALAR of the chosen tag if the response is OK, and FALSE (0) for anything else. 🌈

`fselect( )` `getopenfilename( )` `getsavefilename( )` `getopenurl( )` `getsaveurl( )`

EXAMPLE

# my $text = $d->getsaveurl( path => '/path/' );
# my $text = $d->getopenurl( path => '/path/' );
# my $text = $d->getsavefilename( path => '/path/' );
# my $text = $d->getopenfilename( path => '/path/' );
my $text = $d->fselect( path => '/path/to/a/file/or/directory' );

DESCRIPTION

you're presenting the user with a file selection widget, preset with the given path 🗂️

RETURNS

a SCALAR if the response is OK, and FALSE (0) for anything else. ⭐

`dselect( )` `getexistingdirectory( )`

EXAMPLE

# my $text = $d->getexistingdirectory( path => '/path/to/a/dir' );
my $text = $d->dselect( path => '/path/to/a/directory' );

DESCRIPTION

you're presenting the user with a file selection widget, preset with the given path. but heads up bestie — unlike fselect() this widget will only return a directory selection 📁 directories only, no files allowed, she's picky and we respect it.

RETURNS

a SCALAR if the response is OK, and FALSE (0) for anything else. 💜

🔥 SEE ALSO 🔥

PERLDOC

UI::Dialog
UI::Dialog::KDE
UI::Dialog::Backend
UI::Dialog::Backend::XOSD

MAN FILES

None. just run kdialog --help from a command line, bestie 💅

💀 BUGS 💀

please email the author with any bug reports 🫶 and include the name of the module in the subject line — that's the assignment, don't skip it.

🌟 AUTHOR 🌟

Kevin C. Krinke, <kevin@krinke.ca>

📜 COPYRIGHT AND LICENSE 📜

Copyright (C) 2004-2016  Kevin C. Krinke <kevin@krinke.ca>

This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA

and that's a wrap, bestie 🎀 this whole thing came to you via perl v5.28.0 on 2018-10-27, which is genuinely giving vintage, and it's the UI::Di...Dialog(3pm) page — so go forth, call some widgets, and slay 💅✨

📦 where this page comes from

ubuntu jammy: libui-dialog-perl 1.21-0.1 · LGPL-2.1-or-later
ubuntu noble: libui-dialog-perl 1.21-0.1 · LGPL-2.1-or-later
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash on 2026-10-14: a language model's rewrite of the original, under its terms

UI::Di...Dialog(3pm)

✨ UI::Dialog::Backend::KDialog ✨

🌸 NAME 🌸

🦋 SYNOPSIS 🦋

🎀 ABSTRACT 🎀

💜 DESCRIPTION 💜

🍓 EXPORT 🍓

🌈 INHERITS 🌈

👑 CONSTRUCTOR 👑

new( @options )

EXAMPLE

DESCRIPTION

RETURNS

OPTIONS

🧚 WIDGET METHODS 🧚

yesno( ) yesnocancel( ) warningyesno( ) warningyesnocancel( )

EXAMPLE

DESCRIPTION

RETURNS

msgbox( )

EXAMPLE

DESCRIPTION

RETURNS

password( )

EXAMPLE

DESCRIPTION

RETURNS

inputbox( )

EXAMPLE

DESCRIPTION

RETURNS

textbox( )

EXAMPLE

DESCRIPTION

RETURNS

menu( )

EXAMPLE

DESCRIPTION

RETURNS

checklist( )

EXAMPLE

DESCRIPTION

RETURNS

radiolist( )

EXAMPLE

DESCRIPTION

RETURNS

fselect( ) getopenfilename( ) getsavefilename( ) getopenurl( ) getsaveurl( )

EXAMPLE

DESCRIPTION

RETURNS

dselect( ) getexistingdirectory( )

EXAMPLE

DESCRIPTION

RETURNS

🔥 SEE ALSO 🔥

PERLDOC

MAN FILES

💀 BUGS 💀

🌟 AUTHOR 🌟

📜 COPYRIGHT AND LICENSE 📜

`new( @options )`

`yesno( )` `yesnocancel( )` `warningyesno( )` `warningyesnocancel( )`

`msgbox( )`

`password( )`

`inputbox( )`

`textbox( )`

`menu( )`

`checklist( )`

`radiolist( )`

`fselect( )` `getopenfilename( )` `getsavefilename( )` `getopenurl( )` `getsaveurl( )`

`dselect( )` `getexistingdirectory( )`