natgillin/translations-raw huggingface dataset:
The third case is very interesting indeed. & DCOP; is short for & kde; 's D esktop CO mmunication P rotocol and it is very powerful. Go ahead and run the kdcop program and have a look around. You'll quickly see that any & kde; application that is built to standards has things happening in & DCOP; and the well designed ones have a lot going on. With & DCOP; you can query information of all sorts as well as set widget values and more. There is a section on using & DCOP; in this manual. & kommander; can send & DCOP; to any & kde; program as well as be controlled by & DCOP;. In fact you can send & DCOP; from the command line to any & kde; program. So what's the big deal? The deal is, if you want to do any volume of commands you begin to realized that command line & DCOP; is adequate for short commands, but it can cause delays for instance being called from a loop several hundred times. This is why & kommander; has a @dcop special, because this is roughly 1000 times faster. Because & kommander; can send and receive & DCOP;, & DCOP; can be used to script & kommander;. That is why we also have a local & DCOP; special, @ldcop, that allows you to type a lot less to issue a command.
Третій пункт є насправді дуже цікавим. & DCOP; є скороченням від & kde; D esktop CO mmunication P rotocol (стільничний протокол обміну інформацією). Запустіть програму kdcop і познайомтеся з можливостями цього протоколу. Ви швидко зможете переконатися, що будь- якою програмою & kde;, яку було створено згідно стандартів, можна керувати за допомогою & DCOP;, а належно розробленою програмою можна повністю керувати за допомогою цього протоколу. За допомогою & DCOP; ви можете надсилати програмі запити щодо будь- яких відомостей, встановлювати значення віджетів тощо. У цьому підручнику є окремий розділ, присвячений & DCOP;. & kommander; може надсилати команди & DCOP; будь- якій програмі & kde;, а також сам керуватися за допомогою & DCOP;. Фактично, ви можете надсилати команди & DCOP; з командного рядка будь- якій програмі & kde;. Ну то й що? А те, що, якщо ви спробуєте виконати довільну кількість команд, ви побачите, що & DCOP; командного рядка добре працює лише для коротких команд, і створює затримки, наприклад, якщо виклики надходять з циклу, який виконується декілька сотень разів. Ось чому у & kommander; передбачено спеціальну функцію @ dcop, яка працює приблизно у 1000 разів швидше. Оскільки & kommander; може надсилати і отримувати команди & DCOP;, & DCOP; можна використовувати для написання скриптів & kommander;. Ось чому у програмі передбачено локальну спеціальну функцію & DCOP;, @ ldcop, за допомогою якої можна значно скоротити довжину локальних команд.
Is that all the core concepts in & kommander;? No, but it should help you to make sense of how it works so that what is covered does not look like a foreign language to you. There are a few more. Signals and slots are how & kommander; handles events. An event in a program basically means something happened like a widget was created or had its text changed. These changes emit signals and you can connect those signals to a receiving slot which will then do something when the event happens. One use of this in & kommander; is the sibling of & kommander; Text, Population Text. Population Text will populate a widget when called. Just like & kommander; Text, Population Text can contain text strings or scripts.
Оце і всі загальні концепції & kommander;? Ні, але те, про що ми говорили вище, допоможе вам зрозуміти спосіб, у який працює програма, вам стане зрозумілішим подальший виклад матеріалу цього підручника. Ось іще декілька речей. За допомогою сигналів і слотів & kommander; працює з подіями. Слово « подія » у програмі, зазвичай, означає, що щось сталося, наприклад було створено віджет або було змінено текст віджета. Кожна з таких змін призводить до надсилання сигналу, ви можете з’ єднати ці сигнали зі слотом, який їх отримуватиме, а потім виконуватиме певні дії у разі настання події. Одним з застосувань цієї схеми у & kommander; є близнюк тексту & kommander;, текст заповнення. Текстом заповнення буде заповнено віджет, коли вікно викличе цей текст. Так само, як і у тексті & kommander;, у тексті заповнення можуть міститися текстові рядки або скрипти.
That should give you the base concepts to begin using & kommander;. We try to keep the number of Specials low and we use & DCOP; a lot. The idea is that we want to keep the power of & kommander; as consistent and streamlined as possible. You will find that you can incorporate any scripting language into & kommander; where ever you need to and even multiple scripting languages in a dialog. The rest of the information in this document assumes you are familiar with the concepts and terms presented here. The examples and tutorials are also very useful to understanding what can be done with & kommander;.
Ну ось ви і познайомилися з базовими елементами, тепер можна починати користуватися & kommander;. Автори намагалися не збільшувати без потреби кількість спеціальних функцій і широко використовувати & DCOP;. Ідея полягала у тому, щоб & kommander; залишався потужним і водночас узгодженим і спрямованим на мету. Ви можете вбудовувати до & kommander; будь- яку скриптову мову, якщо це потрібно, навіть можете використовувати декілька скриптових мов у діалоговому вікні. Решту відомостей цього документа викладено у сподіванні, що ви добре ознайомилися з елементами та термінами, описаними у цьому розділі. За допомогою прикладів та інструкцій вам буде легше зрозуміти можливості & kommander;.
The Executor
Виконавець
The executor, called kmdr-executor, runs & kommander; scripts. It loads. kmdr files and dynamically produces a fully functional dialog.
Виконавець, програма з назвою kmdr- executor, виконує скрипти & kommander;. Вона завантажує файли. kmdr і у динамічному режимі створює повноцінне діалогове вікно.
Executor for Programmers
Виконавець для програмістів
C++ developers can easily use the KmdrDialogInstance class in their C++ programs so that the execution functionality is embedded in the their application obsoleting the need for running the external executor program. For standard dialog the dialog creation overhead is minimal but the creation of the & kde; application may delay the dialog for around a second.
Розробники програм, які пишуть мовою C++, можуть з легкістю скористатися класом KmdrDialogInstance у своїх програмах C++, і таким чином вбудувати до програми функціональні можливості виконання скриптів, без запуску зовнішньої програми- виконавця. Виграш часу на створенні стандартного діалогового вікна буде мінімальним, але створення середовища програми & kde; може затримати виконання скрипту приблизно на секунду.
Creating a Dialog
Створення діалогового вікна
The & kommander; Handbook
Підручник з & kommander;
& kommander; Development Team
Команда з розробки & kommander;
& kommander; is a set of tools that allow you to create dynamic & GUI; dialogs that generate, based on their state, a piece of text. The piece of text can be a command line to a program, any piece of code, business documents that contain a lot of repetitious or templated text and so on. The resulting generated text can then be executed as a command line program (hence the name kommander;), written to a file, passed to a script for extended processing, and literally anything else you can think of. The best part of it all? You are n't required to write a single line of code!
& kommander; — це набір інструментів, за допомогою яких ви зможете створювати динамічні діалогові вікна графічного інтерфейсу користувача, які виводитимуть, залежно від стану, певні текстові повідомлення. Ці текстові повідомлення можуть бути рядком команди, частиною коду програми, діловими документами, у яких міститься багато тексту, що повторюється тощо. Отриманий текст може бути виконано у командному рядку (звідси і назва, — kommander;), записано до файла, передано скрипту для подальшої обробки, з ним можна робити буквально все, про що ви могли б подумати. Але найкраще серед усього цього те, що для цього вам не доведеться писати жодного рядка коду!
The & kommander; Development Team
Команда розробників & kommander;
Developer and documentation
Розробка і документація
Project manager and documentation
Керування проектом і документація
& kommander; 2004 & kommander; Development Team.
Авторські права на & kommander; належать 2004 Команді з розробки & kommander;.
& kommander; User Manual 2004 & kommander; Development Team.
Авторські права на інструкцію користувача & kommander; належать 2004 Команді з розробки & kommander;.
& DCOP; Functions
Функції & DCOP;
& DCOP; can be called in several ways in & kommander;. First is the console method
Викликати у & kommander; & DCOP; можна у декілька способів. По- перше, це можна зробити за допомогою консолі
dcop kmdr-executor-@pid KommanderIf changeWidgetText myWidget new text
dcop kmdr- executor - @ pid KommanderIf changeWidgetText myWidget new text
This assumes you are inside a & kommander; file and have access to the special @pid which contains the process ID. In fact it is simpler to replace kmdr-executor-@pid with @dcopid. However, you can use this syntax (obviously without the specials) from the command line or any external script to alter the & kommander; window.
Тут ми припускали, що виконується файл & kommander; і ви маєте доступ до спеціальної функції @ pid, яка визначає ідентифікатор процесу. Фактично, простіше замінити kmdr- executor - @ pid на @ dcopid. Але ви можете користуватися і цим синтаксисом (звичайно ж, без спеціальних функцій) з командного рядка або будь- якого зовнішнього скрипту для того, щоб змінити вікно & kommander;.
Because & kommander; does not have a full parser in it's Alpha stage, if you want to use the much faster internal & DCOP; from another application window (console & DCOP; is very slow) it is more complicated because you must give lots of information, including a prototype of the call. The above call would become:
Оскільки у & kommander; не передбачено повноцінний інструмент обробки на стадії Alpha, якщо вам потрібно скористатися набагато швидшим внутрішнім & DCOP; з вікна іншої програми (DCOP; консолі є дуже повільним), задача стає набагато складнішою, оскільки вам слід буде надати набагато більше відомостей, зокрема прототип виклику. Наведений вище виклик набуде форми:
@dcop(@dcopid, KommanderIf, enableWidget(QString, bool), Widget, true)
@ dcop (@ dcopid, KommanderIf, enableWidget( QString, bool), Widget, true)
At the time of this writing you should be aware that nesting & DCOP; calls inside script language structures (like bash) means that you must use console method calls. If you use internal & DCOP; all & kommander; specials will be executed first and then the script will be executed.
Читаючи попередні приклади, вам слід весь час пам’ ятати, що під час вбудовування викликів & DCOP; у структури скриптової мови (на зразок bash), ви змушені будете використовувати виклики за допомогою консолі. Якщо ви використовуєте внутрішній & DCOP;, спочатку буде виконано всі спеціальні функції & kommander;, а потім вже виконуватиметься сам скрипт.
There is a new simplified way to use & DCOP; inside & kommander; using an object syntax. Let's say you want to change the text in a widget name @LineEdit1. It would look like this.
Існує новий спрощений спосіб використання & DCOP; у & kommander; за допомогою об’ єктного синтаксису. Припустімо, що ви бажаєте змінити текст віджета з назвою @ LineEdit1. Відповідна команда виглядатиме так:.
@LineEdit1. changeWidgetText(New text)
@ LineEdit1. changeWidgetText( Новий текст)
As you can see the new syntax is very easy, as well as consistent visually with function groups. All the & DCOP; reference here will use the new object syntax listed above. Please note that if you are referencing a widget using & DCOP; from another window or another application the first parameter will always be the widget name. All functions are listed here starting with the second parameter.
Як ви можете бачити, новий синтаксис є дуже простим, а також добре узгоджується візуально з групами функцій. Всі посилання на & DCOP; у цьому розділі використовуватимуть новий об’ єктний синтаксис, наведений вище. Будь ласка, зауважте, що, якщо ви викликаєте на віджет за допомогою & DCOP; з іншого вікна або іншої програми, першим параметром завжди буде назва віджета. Записи всіх перелічених у цьому розділі функцій починатимуться з другого параметра.
& DCOP; for Global Variables
& DCOP; для загальних змінних
global(QString variableName)
global( QString variableName)
Returns the value of the specified global variable. When a script is run from within a & kommander; window any (non-global) variables set in that script will cease to exist after the script completes and therfore will not be available to other script processes or in a new instance of the calling process. The global scope means the variable will exist for any process of the window until that window is closed. You may change these variables at any time with a new call to @setGlobal.
Повертає значення вказаної глобальної змінної. Якщо скрипт було запущено з вікна & kommander;, всі (неглобальні) змінні, встановлені цим скриптом, припинять своє існування після завершення виконання скрипту і тому будуть недоступними іншим процесам скриптів або у новому екземплярі процесу виклику. Глобальна область видимості означає, що змінна існуватиме для будь- якого з процесів вікна до закриття самого вікна. Ви можете змінити ці змінні у будь- який момент за допомогою нового виклику @ setGlobal.
setGlobal(QString variableName, QString value)
setGlobal( QString variableName, QString value)
Creates a variable that is global to the window process and assigns the value to it. This value can be retrieved with global(QString variableName) or set again.
Створює змінну, яка є глобальною для процесу вікна і надає значення цій змінній. Це значення можна отримати за допомогою функції global( QString variableName) або перевизначене.
& DCOP; for all Widgets
& DCOP; для всіх віджетів
This should be renamed setWidgetText and this name will probably be deprecated. This removes the text displayed in the widget and replaces it with the text supplied.
Назва цієї функції є іншою назвою функції setWidgetText, цю функцію, ймовірно, буде вилучено з наступних версій програми. Ця функція вилучає текст показаний у віджеті і заміняє його на вказаний як параметр текст.
enableWidget(bool enable)
enableWidget( bool enable)
Enables or disables a widget.
Вмикає або вимикає показ віджета.
Returns the text associated with the specified widget. This is not the same as the displayed text. It would be @widgetText or the text and/ or scripting used to arrive at the displayed value.
Повертає текст, пов’ язаних з вказаним віджетом. Цей текст може не збігатися з показаним текстом. Буде повернуто значення @ widgetText або текст і/ або скрипт, використаний для появи показаного значення.
This sets the & kommander; Text default string. This is typically set to @widgetText to display what is entered into the widget. It is unlikely you will have much need for this, but if you do it is there. Applies to all widgets that can contain data.
Ця команда встановлює типовий рядок тексту & kommander;. Це значення типово передається @ widgetText і відповідає тексту підказки щодо того, що слід ввести до віджета. Навряд чи у вас виникне потреба у цій команді, але, якщо все ж виникне, ви будете знати, що така команда є. Застосовується для всіх віджетів, які містять дані.
& DCOP; for ListBox and ComboBox Widgets
& DCOP; для віджетів ListBox і ComboBox
addListItem(QString item, int index)
addListItem( QString item, int index)
Adds an item to a ListBox widget at the specified index. List index starts at zero. To add to the end of the list use -1.
Додає пункт до віджета ListBox на вказану позицію. Нумерація списку починається з нуля. Щоб додати пункт у кінець списку, скористайтеся параметром - 1.
addListItems(QStringList items, int index)
addListItems( QStringList items, int index)
This adds a list of strings all at once. The list should be delimited by EOL (\ - newlines). This is handy as you can use bash to derive the list rather easily. For instance, using @exec(ls -l ~/ projects _BAR_ grep kmdr) for items will give you a directory listing of & kommander; files in your projects folder. List index starts at zero. Use -1 to add to the end of the list.
Ця команда одразу додає увесь список рядків. Пункти списку слід відокремлювати символом EOL (\ — символами нового рядка). Це зручно, оскільки ви можете скористатися bash для порівняно простого отримання списку. Наприклад, за допомогою функції @ exec( ls - l ~/ projects _BAR_ grep kmdr) пункти списку складатиметься з переліку файлів у теці вашого проекту & kommander;. Нумерація списку починатиметься з нуля. Щоб додати пункт у кінець списку, скористайтеся параметром - 1.
addUniqueItem(QString item)
addUniqueItem( QString item)
addUniqueItem will add an item to the end of the list only if it is unique.
addUniqueItem додасть пункт в кінець списку, лише якщо цей пункт є унікальним.
Removes all items.
Вилучає всі елементи.
Removes the item at the specified index.
Вилучає елемент з вказаним номером index.
Returns the text of the item at the specified index.
Повертає текст елемента з вказаним номером index.
Set the current (or selected) item to the index specified. Applies to ListBox and ComboBox widgets.
Визначає для поточного (або виділеного) елемента вказаний номер index. Застосовується до віджетів ListBox і ComboBox.
& DCOP; for CheckBox and RadioButton Widgets
& DCOP; для віджетів CheckBox і RadioButton
setChecked(QString widgetName, bool checked)
setChecked( QString widgetName, bool checked)
Checks/ unchecks CheckBox or RadioButton widgets.
Позначає або знімає позначення з віджетів CheckBox або RadioButton.
& DCOP; for TabWidget Widgets
& DCOP; для віджетів TabWidget
setCurrentTab(QString widgetName, int index)
setCurrentTab( QString назваВіджета, int index)
Selected the tab by index for TabWidgets. Index starts at 0.
Відкриває вкладку з номером index у TabWidget. Нумерація починається з 0.
The editor is based on & designer;, a tool for designing and implementing user interfaces created by Trolltech. We have modified & designer; in the following ways:
Редактор засновано на програмі & designer;, інструменті для розробки і реалізації інтерфейсів користувача, створеному компанією Trolltech. Автори програми змінили & designer; у такий спосіб:
Its interface is much simpler
Значно спростили його інтерфейс
Built in our own widgets
Вбудували наші власні віджети
Added the ability to setup & kommander; Text
Додали можливість встановлення тексту & kommander;
Various other superficial changes
Внесли інші поверхові зміни
For those of you already familiar with using & designer;, using the & kmdr-editor; will be trivial.
Для тих, хто вже знайомий з користуванням & designer;, користування & kmdr- editor; буде тривіальним.
Toolbars contain a number of buttons to provide quick access to number of functions.
На панелях інструментів розташовано багато кнопок, які спрощують доступ до значної кількості функціональних можливостей.
The File Overview displays all of the files. Use the search field to rapidly switch between files.
У « Оглядачі файлів » буде показано всі файли. Для швидкого перемикання між файлами скористайтеся полем пошуку.
The Object Explorer provides an overview of the relationships between the widgets in a form. It is useful for selecting widgets in a form with a complex layout.
На панелі « Переглядача об’ єктів » буде показано загальну картину взаємозв’ язків між віджетами форми. Ця панель буде корисною для вибору віджетів на формі зі складним компонуванням.
The Property Editor is where the behavior and apperance of a widget is changed.
За допомогою редактора властивостей можна змінювати поведінку і вигляд віджетів.
The Dialog Editor is where dialogs are created and edited.
Редактор діалогових вікон — це місце, де створюються і редагуються діалогові вікна
Creates a new dialog
Створює нове діалогове вікно
Search the file system to open an existing dialog
Відкриває вікно пошуку у файловій системі існуючого файла діалогового вікна
File Close
Файл Закрити
Closes the active dialog
Закриває активне діалогове вікно
Saves the active dialog
Зберігає активне діалогове вікно
Saves the active dialog with another name
Зберігає активне діалогове вікно під новою назвою
Saves all open dialogs
Зберігає всі відкриті діалогові вікна
File Recently Opened Files
Файл Нещодавно відкрити файли
Quick list of the last several files you've opened. This list will change each time you open a file that is not on it with the oldest being bumped off first.
Короткий список декількох останніх відкритих вами файлів. Цей список змінюватиметься кожного разу, коли ви відкриватимете файл, якого там ще не було, — запис цього файла замінюватиме найстаріший з записів файлів у списку.
Quits & kommander;
Завершує роботу & kommander;
Ctrl; Y Edit Redo
Ctrl; Y Правка Повторити
Cut the current item and place it content on the clipboard.
Вирізає поточний елемент і копіює його вміст до буфера обміну інформацією.
Copy the current item to the clipbard.
Копіює поточний елемент до буфера обміну інформацією.
Ctrl; Z Edit Delete
Ctrl; Z Правка Вилучити
Delete the current item.
Вилучає поточний елемент.
Del Edit
Del Правка Вибрати все
Select all of the items in the current dialog.
Вибирає всі елементи поточного діалогового вікна.
Alt; R Edit
Alt; R Правка Перевірити акселератори
Verifies that all the accelerators are used only once.
Виконує перевірку того, чи використовується кожне з клавіатурних скорочень лише раз.
Alt; S Edit
Alt; S Правка Скриптові об’ єкти
Edit Slots
Правка Слоти
Displays window to edit and create slots and functions.
Відкриває вікно, призначене для редагування і створення слотів і функцій.
Edit Connectors
Правка З’ єднання
Displays the view and edit connections dialog.
Відкриває діалогове вікно перегляду і редагування з’ єднань.
Edit Form Setting
Правка Параметри форми...
Displays the form setting dialog.
Відкриває діалогове вікно параметрів форми.
Edit Preferences
Правка Вподобання
Displays the preferences dialog.
Відкриває діалогове вікно параметрів.
F2 Tools Pointer
F2 Інструменти Вказівник
F3 Tools
F3 Інструменти З' єднати сигнал/ слоти
F3 Tools
F3 Інструменти Порядку переходу фокусу
Tools Kommander
Інструменти Kommander
Tools Kommander TextLabel
Інструменти Kommander TextLabel
Tools Kommander PixelmapLabel
Інструменти Kommander PixelmapLabel
Tools Kommander ListView
Інструменти Kommander ListView
Tools Kommander ListBox
Інструменти Kommander ListBox
Tools Kommander SubDialog
Інструменти Kommander SubDialog
Tools Kommander TabWidget
Інструменти Kommander TabWidget
Tools Kommander LineEdit
Інструменти Kommander LineEdit
Tools Kommander ExecButton
Інструменти Kommander ExecButton
Tools Kommander CloseButton
Інструменти Kommander CloseButton
Tools Kommander FileSelector
Інструменти Kommander FileSelector
Tools Kommander TextEdit
Інструменти Kommander TextEdit
Tools Kommander RadioButton
Інструменти Kommander RadioButton
Tools Kommander ButtonGroup
Інструменти Kommander ButtonGroup
Tools Kommander GroupBox
Інструменти Kommander GroupBox
Tools Kommander CheckBox
Інструменти Kommander CheckBox
Tools Kommander ComboBox
Інструменти Kommander ComboBox
Tools Kommander SpinBoxInt
Інструменти Kommander SpinBoxInt
Tools Kommander RichTextEditor
Інструменти Kommander RichTextEditor
Tools Kommander TreeWidget
Інструменти Kommander TreeWidget
Tools Kommander Unknown
Інструменти Kommander Unknown
Tools Kommander Wizard
Інструменти Kommander Wizard
Tools Custom
Інструменти Нетипові
Tools Custom Edit Custom Widgets
Інструменти Нетиповий Редагувати нетипові віджети
The Layout Menu
Меню « Розкладка »
Ctrl; J Layout Adjust Size
Ctrl; J Розкладка Відкоригувати розмір
Ctrl; H Layout Horizontally
Ctrl; H Розкладка Розкласти горизонтально
Ctrl; L Layout Vertically
Ctrl; L Розкладка Розкласти вертикально
Ctrl; G Layout in a Grid
Ctrl; G Розкладка Розкласти у ґратці
Layout Lay Out Horzontially (in Splitter)
Розкладка Розкласти горизонтально (з розділювачем)
Layout Lay Out Vertically (in Splitter)
Розкладка Розкласти вертикально (з розділювачем)
Ctrl; B Layout
Ctrl; B Розкладка Забрати розкладку
Layout Add Spacer
Розкладка Додати розпірку
The Run Menu
Меню « Запуск »
Ctrl; R Run
Ctrl; R Запуск Запустити діалогове вікно
Runs the current dialog.
Запускає виконання у поточному діалоговому вікні.