gtkmm-documentation master - en to sr translation catalogue (1897 entries)

note: (itstool) path: info/title
en: Programming with <application>gtkmm</application> 4
sr: Програмирање уз <application>gtkmm</application> 4

note: (itstool) path: authorgroup/author
en: <personname><firstname>Murray</firstname><surname>Cumming</surname></personname>
sr: <personname><firstname>Мари</firstname><surname>Каминг</surname></personname>

note: (itstool) path: authorgroup/author
en: <personname><firstname>Bernhard</firstname><surname>Rieder</surname></personname> <contrib>Chapter on "Timeouts".</contrib>
sr: <personname><firstname>Бернхард</firstname><surname>Ридер</surname></personname> <contrib>Поглавље о „Временским роковима“.</contrib>

note: (itstool) path: authorgroup/author
en: <personname><firstname>Jonathon</firstname><surname>Jongsma</surname></personname> <contrib>Chapter on "Drawing with Cairo".</contrib> <contrib>Chapter on "Working with gtkmm's Source Code".</contrib> <contrib>Chapter on "Recent Files".</contrib>
sr: <personname><firstname>Џонатон</firstname><surname>Јонгсма</surname></personname> <contrib>Поглавље о „Цртању уз Каиро“.</contrib> <contrib>Поглавље о „Раду са изворним кодом за gtkmm“.</contrib> <contrib>Поглавље о „Недавним датотекама“.</contrib>

note: (itstool) path: authorgroup/author
en: <personname><firstname>Ole</firstname><surname>Laursen</surname></personname> <contrib>Parts of chapter on "Internationalization".</contrib>
sr: <personname><firstname>Оле</firstname><surname>Лаурсен</surname></personname> <contrib>Делови поглавља о „Интернационализацији“.</contrib>

note: (itstool) path: authorgroup/author
en: <personname><firstname>Marko</firstname><surname>Anastasov</surname></personname> <contrib>Chapter on "Printing".</contrib> <contrib>Parts of chapter on "Internationalization".</contrib>
sr: <personname><firstname>Марко</firstname><surname>Анастасов</surname></personname> <contrib>Поглавље о „Штампању“.</contrib> <contrib>Делови поглавља о „Интернационализацији“.</contrib>

note: (itstool) path: authorgroup/author
en: <personname><firstname>Daniel</firstname><surname>Elstner</surname></personname> <contrib>Section "Build Structure" of chapter on "Wrapping C Libraries with gmmproc".</contrib>
sr: <personname><firstname>Данијел</firstname><surname>Елстнер</surname></personname> <contrib>Одељак „Структура изградње“ у поглављу о „Омотавању Ц библиотека помоћу gmmproc-а“.</contrib>

note: (itstool) path: authorgroup/author
en: <personname><firstname>Chris</firstname><surname>Vine</surname></personname> <contrib>Chapter on "Multi-threaded programs".</contrib>
sr: <personname><firstname>Крис</firstname><surname>Вајн</surname></personname> <contrib>Поглавље о „Вишенативним програмима“.</contrib>

note: (itstool) path: authorgroup/author
en: <personname><firstname>David</firstname><surname>King</surname></personname> <contrib>Section on Gtk::Grid.</contrib>
sr: <personname><firstname>Дејвид</firstname><surname>Кинг</surname></personname> <contrib>Одељак о Gtk::Grid-у.</contrib>

note: (itstool) path: authorgroup/author
en: <personname><firstname>Pedro</firstname><surname>Ferreira</surname></personname> <contrib>Chapter on "Keyboard Events".</contrib>
sr: <personname><firstname>Педро</firstname><surname>Фереира</surname></personname> <contrib>Поглавље о „Догађајима тастатуре“.</contrib>

note: (itstool) path: authorgroup/author
en: <personname><firstname>Kjell</firstname><surname>Ahlstedt</surname></personname> <contrib>Update from gtkmm 3 to gtkmm 4.</contrib> <contrib>Chapter on "Building applications".</contrib> <contrib>Chapter on "The DropDown Widget".</contrib> <contrib>Chapter on "ListView, GridView, ColumnView".</contrib>
sr: <personname><firstname>Кјел</firstname><surname>Алстет</surname></personname> <contrib>Ажурирање са gtkmm 3 на gtkmm 4.</contrib> <contrib>Поглавље о „Изградњи програма“.</contrib> <contrib>Поглавље о „Елементу падајућег списка“.</contrib> <contrib>Поглавље о „ListView, GridView, ColumnView“.</contrib>

note: (itstool) path: authorgroup/author
en: <personname><firstname>Daniel</firstname><surname>Boles</surname></personname> <contrib>Notes on need to remove widgets in non-managed wrappers from parents to dispose, other tweaks.</contrib>
sr: <personname><firstname>Данијел</firstname><surname>Боулс</surname></personname> <contrib>Напомене о потреби за уклањањем елемената у неуправљаним омотачима из родитеља ради ослобађања, и друга лицкања.</contrib>

note: (itstool) path: abstract/para
en: This book explains key concepts of the <application>gtkmm</application> <phrase role="nowrap">C++</phrase> API for creating user interfaces. It also introduces the main user interface elements ("widgets").
sr: Ова књига објашњава кључна начела <application>gtkmm</application> <phrase role="nowrap">C++</phrase> API-ја за стварање корисничких прочеља. Такође представља главне елементе корисничког прочеља („елементе“).

note: (itstool) path: info/copyright
en: <year>2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010</year> <holder>Murray Cumming</holder>
sr: <year>2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010</year> <holder>Мари Каминг</holder>

note: (itstool) path: legalnotice/para
en: Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled <link linkend="chapter-gfdl">"GNU Free Documentation License"</link>.
sr: Дозвољено је умножавање, дељење и/или мењање овог документа под условима ГНУ-ове Слободне документационе лиценце, верзије 1.2 или било које новије верзије коју објави Задужбина слободног софтвера; без непроменљивих одељака, без текста на предњој страни и без текста на задњој страни. Примерак лиценце је укључен у одељку под насловом <link linkend="chapter-gfdl">„GNU Free Documentation License“</link>.

note: (itstool) path: chapter/title
en: Introduction
sr: Увод

note: (itstool) path: section/title
en: This book
sr: Ова књига

note: (itstool) path: section/para
en: This book explains key concepts of the <application>gtkmm</application> <phrase role="nowrap">C++</phrase> API for creating user interfaces. It also introduces the main user interface elements ("widgets"). Although it mentions classes, constructors, and methods, it does not go into great detail. Therefore, for full API information you should follow the links into the reference documentation.
sr: Ова књига објашњава кључна начела <application>gtkmm</application> <phrase role="nowrap">C++</phrase> API-ја за стварање корисничких прочеља. Такође представља главне елементе корисничког прочеља („елементе“). Иако помиње класе, конструкторе и методе, не улази у велике детаље. Због тога, за потпуне податке о API-ју треба да пратите везе у референтној документацији.

note: (itstool) path: section/para
en: This book assumes a good understanding of <phrase role="nowrap">C++</phrase>, and how to create <phrase role="nowrap">C++</phrase> programs.
sr: Ова књига претпоставља добро разумевање језика <phrase role="nowrap">C++</phrase> и начина прављења <phrase role="nowrap">C++</phrase> програма.

note: (itstool) path: section/para
en: We would very much like to hear of any problems you have learning <application>gtkmm</application> with this document, and would appreciate input regarding improvements. Please see the <link linkend="chapter-contributing">Contributing</link> section for further information.
sr: Веома бисмо волели да чујемо за било какве проблеме које имате приликом учења <application>gtkmm</application>-а уз овај документ, и ценили бисмо доприносе у погледу побољшања. Погледајте одељак <link linkend="chapter-contributing">Допринос</link> за даље податке.

note: (itstool) path: section/para
en: <application>gtkmm</application> is a <phrase role="nowrap">C++</phrase> wrapper for <link xlink:href="http://www.gtk.org/">GTK</link>, a library used to create graphical user interfaces. It is licensed using the LGPL license, so you can develop open software, free software, or even commercial non-free software using <application>gtkmm</application> without purchasing licenses.
sr: <application>gtkmm</application> је <phrase role="nowrap">Ц++</phrase> омотач за <link xlink:href="http://www.gtk.org/">ГТК</link>, библиотеку која се користи за прављење графичких корисничких прочеља. Лиценциран је под ЛГПЛ лиценцом, тако да можете развијати отворени софтвер, слободни софтвер или чак комерцијални несофтвер користећи <application>gtkmm</application> без куповине лиценци.

note: (itstool) path: section/para
en: <application>gtkmm</application> was originally named gtk-- because GTK was originally named GTK+ and had a + in the name. However, as -- is not easily indexed by search engines, the package generally went by the name <application>gtkmm</application>, and that's what we stuck with.
sr: <application>gtkmm</application> се првобитно звао gtk-- јер се ГТК првобитно звао ГТК+ и имао је + у називу. Међутим, пошто претраживачи не могу лако да индексирају --, пакет је углавном познат под именом <application>gtkmm</application>, и то је оно што смо задржали.

note: (itstool) path: section/title
en: Why use <application>gtkmm</application> instead of GTK?
sr: Зашто користити <application>gtkmm</application> уместо ГТК-а?

note: (itstool) path: section/para
en: <application>gtkmm</application> allows you to write code using normal <phrase role="nowrap">C++</phrase> techniques such as encapsulation, derivation, and polymorphism. As a <phrase role="nowrap">C++</phrase> programmer you probably already realize that this leads to clearer and better organized code.
sr: <application>gtkmm</application> вам омогућава да пишете код користећи уобичајене <phrase role="nowrap">Ц++</phrase> технике као што су енкапсулација, извођење и полиморфизам. Као <phrase role="nowrap">Ц++</phrase> програмер вероватно већ схватате да ово води ка јаснијем и боље организованом коду.

note: (itstool) path: section/para
en: <application>gtkmm</application> is more type-safe, so the compiler can detect errors that would only be detected at run time when using C. This use of specific types also makes the API clearer because you can see what types should be used just by looking at a method's declaration.
sr: <application>gtkmm</application> је безбеднији у погледу типова, тако да преводилац може да открије грешке које би се откриле тек у време извршавања када се користи Ц. Ова употреба одређених типова такође чини АПИ јаснијим јер можете видети који типови треба да се користе само гледањем у декларацију метода.

note: (itstool) path: section/para
en: Inheritance can be used to derive new widgets. The derivation of new widgets in GTK C code is so complicated and error prone that almost no C coders do it. As a <phrase role="nowrap">C++</phrase> developer you know that derivation is an essential Object Orientated technique.
sr: Наслеђивање се може користити за извођење нових виџета. Извођење нових виџета у ГТК Ц коду је толико компликовано и подложно грешкама да то скоро ниједан Ц програмер не ради. Као <phrase role="nowrap">Ц++</phrase> програмер знате да је извођење суштинска објектно оријентисана техника.

note: (itstool) path: section/para
en: Member instances can be used, simplifying memory management. All GTK C widgets are dealt with by use of pointers. As a <phrase role="nowrap">C++</phrase> coder you know that pointers should be avoided where possible.
sr: Могу се користити примерци чланова, што поједностављује управљање меморијом. Сви ГТК Ц виџети се обрађују коришћењем показивача. Као <phrase role="nowrap">Ц++</phrase> програмер знате да показиваче треба избегавати где год је то могуће.

note: (itstool) path: section/para
en: <application>gtkmm</application> involves less code compared to GTK, which uses prefixed function names and lots of cast macros.
sr: <application>gtkmm</application> укључује мање кода у поређењу са ГТК-ом, који користи префиксна имена функција и много макроа за претварање типова.

note: (itstool) path: section/title
en: <application>gtkmm</application> compared to Qt
sr: <application>gtkmm</application> у поређењу са Qt-ом

note: (itstool) path: section/para
en: Trolltech's Qt is the closest competition to <application>gtkmm</application>, so it deserves discussion.
sr: Trolltech-ов Qt је најближа конкуренција <application>gtkmm</application>-у, па заслужује расправу.

note: (itstool) path: section/para
en: <application>gtkmm</application> developers tend to prefer <application>gtkmm</application> to Qt because <application>gtkmm</application> does things in a more <phrase role="nowrap">C++</phrase> way. Qt originates from a time when <phrase role="nowrap">C++</phrase> and the standard library were not standardized or well supported by compilers. It therefore duplicates a lot of stuff that is now in the standard library, such as containers and type information. Most significantly, Trolltech modified the <phrase role="nowrap">C++</phrase> language to provide signals, so that Qt classes cannot be used easily with non-Qt classes. <application>gtkmm</application> was able to use standard <phrase role="nowrap">C++</phrase> to provide signals without changing the <phrase role="nowrap">C++</phrase> language. See the <link xlink:href="https://gtkmm.gnome.org/en/faq.html">FAQ</link> for more detailed differences.
sr: Програмери <application>gtkmm</application>-а обично више воле <application>gtkmm</application> од Qt-а јер <application>gtkmm</application> ради ствари на више <phrase role="nowrap">Ц++</phrase> начин. Qt потиче из времена када <phrase role="nowrap">Ц++</phrase> и стандардна библиотека нису били стандардизовани или добро подржани од стране преводилаца. Стога он дуплира много ствари које су сада у стандардној библиотеци, као што су контејнери и подаци о типовима. Најзначајније је то што је Trolltech изменио језик <phrase role="nowrap">Ц++</phrase> да би обезбедио сигнале, тако да се Qt класе не могу лако користити са класама које нису из Qt-а. <application>gtkmm</application> је могао да користи стандардни <phrase role="nowrap">Ц++</phrase> да обезбеди сигнале без промене језика <phrase role="nowrap">Ц++</phrase>. Погледајте <link xlink:href="https://gtkmm.gnome.org/en/faq.html">ЧПП</link> за детаљније разлике.

note: (itstool) path: section/title
en: <application>gtkmm</application> is a wrapper
sr: <application>gtkmm</application> је омотач

note: (itstool) path: section/para
en: <application>gtkmm</application> is not a native <phrase role="nowrap">C++</phrase> toolkit, but a <phrase role="nowrap">C++</phrase> wrapper of a C toolkit. This separation of interface and implementation has advantages. The <application>gtkmm</application> developers spend most of their time talking about how <application>gtkmm</application> can present the clearest API, without awkward compromises due to obscure technical details. We contribute a little to the underlying GTK code base, but so do the C coders, and the Perl coders and the Python coders, etc. Therefore GTK benefits from a broader user base than language-specific toolkits - there are more implementers, more developers, more testers, and more users.
sr: <application>gtkmm</application> није изворни <phrase role="nowrap">Ц++</phrase> скуп алата, већ <phrase role="nowrap">Ц++</phrase> омотач Ц скупа алата. Ово раздвајање прочеља и изведбе има предности. Програмери <application>gtkmm</application>-а проводе већину свог времена разговарајући о томе како <application>gtkmm</application> може да представи најјаснији АПИ, без незгодних компромиса због нејасних техничких детаља. Ми мало доприносимо основној ГТК бази кода, али то раде и Ц програмери, и Перл програмери и Пајтон програмери, итд. Стога ГТК има користи од шире базе корисника него скупови алата специфични за језик — има више реализатора, више програмера, више тестера и више корисника.

note: (itstool) path: section/title
en: C++ Resources
sr: Ц++ ресурси

note: (itstool) path: section/para
en: Useful links:
sr: Корисне везе:

note: (itstool) path: listitem/para
en: <link xlink:href="https://en.wikipedia.org/wiki/C%2B%2B">Wikipedia C++</link>: An introduction to <phrase role="nowrap">C++</phrase>, and many links.
sr: <link xlink:href="https://en.wikipedia.org/wiki/C%2B%2B">Википедија Ц++</link>: Увод у <phrase role="nowrap">Ц++</phrase> и многе везе.

note: (itstool) path: listitem/para
en: <link xlink:href="https://en.cppreference.com/w/">C++ reference</link>: A convenient version of the C and <phrase role="nowrap">C++</phrase> standards.
sr: <link xlink:href="https://en.cppreference.com/w/">Ц++ референца</link>: Погодна верзија Ц и <phrase role="nowrap">Ц++</phrase> стандарда.

note: (itstool) path: listitem/para
en: <link xlink:href="https://cplusplus.com/">The C++ Resources Network</link>
sr: <link xlink:href="https://cplusplus.com/">Мрежа Ц++ ресурса</link>

note: (itstool) path: listitem/para
en: <link xlink:href="https://www.stroustrup.com/">Bjarne Stroustrup's homepage</link>
sr: <link xlink:href="https://www.stroustrup.com/">Почетна страница Бјарнеа Струструпа</link>

note: (itstool) path: chapter/title
en: Installation
sr: Инсталација

note: (itstool) path: section/title
en: Dependencies
sr: Зависности

note: (itstool) path: section/para
en: Before attempting to install <application>gtkmm</application><application>-4.0</application>, you might first need to install these other packages.
sr: Пре него што покушате да инсталирате <application>gtkmm</application><application>-4.0</application>, можда ћете прво морати да инсталирате ове друге пакете.

note: (itstool) path: section/para
en: These dependencies have their own dependencies, including the following applications and libraries:
sr: Ове зависности имају своје сопствене зависности, укључујући следеће програме и библиотеке:

note: (itstool) path: section/title
en: Unix and Linux
sr: Јуникс и Линукс

note: (itstool) path: section/title
en: Prebuilt Packages
sr: Претходно изграђени пакети

note: (itstool) path: section/para
en: Recent versions of <application>gtkmm</application> are packaged by nearly every major Linux distribution these days. So, if you use Linux, you can probably get started with <application>gtkmm</application> by installing the package from the official repository for your distribution. Distributions that include <application>gtkmm</application> in their repositories include Debian, Ubuntu, Red Hat, Fedora, Mandriva, Suse, and many others.
sr: Новија издања <application>gtkmm</application>-а су упакована у скоро свакој већој Линукс дистрибуцији данас. Дакле, ако користите Линукс, вероватно можете почети са <application>gtkmm</application>-ом тако што ћете инсталирати пакет из званичне ризнице за вашу дистрибуцију. Дистрибуције које укључују <application>gtkmm</application> у своје ризнице укључују Дебијан, Убунту, Ред Хет, Федору, Мандриву, Сузе и многе друге.

note: (itstool) path: section/para
en: The names of the <application>gtkmm</application> packages vary from distribution to distribution (e.g. <application>libgtkmm-4.0-dev</application> on Debian and Ubuntu or <application>gtkmm4.0-devel</application> on Red Hat and Fedora), so check with your distribution's package management program for the correct package name and install it like you would any other package.
sr: Називи <application>gtkmm</application> пакета се разликују од дистрибуције до дистрибуције (нпр. <application>libgtkmm-4.0-dev</application> на Дебијану и Убунту или <application>gtkmm4.0-devel</application> на Ред Хету и Федори), па проверите са програмом за управљање пакетима ваше дистрибуције тачан назив пакета и инсталирајте га као што бисте инсталирали било који други пакет.

note: (itstool) path: note/para
en: The package names will not change when new API/ABI-compatible versions of <application>gtkmm</application> are released. Otherwise they would not be API/ABI-compatible. So don't be surprised, for instance, to find <application>gtkmm</application> 4.8 supplied by Debian's <application>libgtkmm-4.0-dev</application> package.
sr: Називи пакета се неће мењати када буду објављена нова АПИ/АБИ-сагласна издања <application>gtkmm</application>-а. У супротном не би била АПИ/АБИ-сагласна. Зато се немојте изненадити, на пример, ако нађете <application>gtkmm</application> 4.8 који обезбеђује Дебијанов пакет <application>libgtkmm-4.0-dev</application>.

note: (itstool) path: section/title
en: Installing From Source
sr: Инсталирање из изворног кода

note: (itstool) path: section/para
en: If your distribution does not provide a pre-built <application>gtkmm</application> package, or if you want to install a different version than the one provided by your distribution, you can also install <application>gtkmm</application> from source. The source code for <application>gtkmm</application> can be downloaded from <link xlink:href="https://download.gnome.org/sources/gtkmm/"/>.
sr: Ако ваша дистрибуција не обезбеђује претходно изграђен <application>gtkmm</application> пакет, или ако желите да инсталирате другачије издање од оног које обезбеђује ваша дистрибуција, можете такође инсталирати <application>gtkmm</application> из изворног кода. Изворни код за <application>gtkmm</application> се може преузети са <link xlink:href="https://download.gnome.org/sources/gtkmm/"/>.

note: (itstool) path: section/para
en: After you've installed all of the dependencies, download the <application>gtkmm</application> source code, unpack it, and change to the newly created directory. <application>gtkmm</application> can be built with Meson. See the <filename>README</filename> file in the <application>gtkmm</application> version you've downloaded.
sr: Након што инсталирате све зависности, преузмите изворни код за <application>gtkmm</application>, распакујте га и пређите у новостворени директоријум. <application>gtkmm</application> се може изградити помоћу Мезона. Погледајте датотеку <filename>README</filename> у издању <application>gtkmm</application>-а које сте преузели.

note: (itstool) path: note/para
en: Remember that on a Unix or Linux operating system, you will probably need to be <literal>root</literal> to install software. The <command>su</command> or <command>sudo</command> command will allow you to enter the <literal>root</literal> password and have <literal>root</literal> status temporarily.
sr: Запамтите да ће вам на Јуникс или Линукс оперативном систему вероватно бити потребна <literal>root</literal> овлашћења за инсталирање софтвера. Наредба <command>su</command> или <command>sudo</command> ће вам омогућити да унесете <literal>root</literal> лозинку и привремено стекнете <literal>root</literal> статус.

note: (itstool) path: section/para
en: The <filename>configure</filename> script or <command>meson</command> will check to make sure all of the required dependencies are already installed. If you are missing any dependencies, it will exit and display an error.
sr: Скрипта <filename>configure</filename> или <command>meson</command> ће проверити да ли су све неопходне зависности већ инсталиране. Ако вам недостаје било која зависност, изаћи ће и приказати грешку.

note: (itstool) path: section/para
en: By default, <application>gtkmm</application> if built with Meson or Autotools, will be installed under the <filename>/usr/local</filename> directory. On some systems you may need to install to a different location. For instance, on Red Hat Linux systems you might use the <literal>--prefix</literal> option with configure, like one of: <_:screen-1/>
sr: Подразумевано, ако се гради помоћу Мезона или Аутотулса, <application>gtkmm</application> ће бити инсталиран у директоријум <filename>/usr/local</filename>. На неким системима ћете можда морати да га инсталирате на другу локацију. На пример, на Red Hat Linux системима можете користити опцију <literal>--prefix</literal> уз configure, као што је: <_:screen-1/>

note: (itstool) path: warning/para
en: You should be very careful when installing to standard system prefixes such as <filename>/usr</filename>. Linux distributions install software packages to <filename>/usr</filename>, so installing a source package to this prefix could corrupt or conflict with software installed using your distribution's package-management system. Ideally, you should use a separate prefix for all software you install from source.
sr: Требало би да будете веома опрезни када инсталирате у стандардне системске префиксе као што је <filename>/usr</filename>. Линукс дистрибуције инсталирају софтверске пакете у <filename>/usr</filename>, па би инсталирање пакета из изворног кода у овај префикс могло да оштети или доведе до сукоба са софтвером који је инсталиран помоћу система за управљање пакетима ваше дистрибуције. Идеално би било да користите посебан префикс за сав софтвер који инсталирате из изворног кода.

note: (itstool) path: section/para
en: If you want to help develop <application>gtkmm</application> or experiment with new features, you can also install <application>gtkmm</application> from git. Most users will never need to do this, but if you're interested in helping with <application>gtkmm</application> development, see the <link linkend="chapter-working-with-source">Working with gtkmm's Source Code</link> appendix.
sr: Ако желите да помогнете у развоју <application>gtkmm</application>-а или да експериментишете са новим функцијама, можете такође инсталирати <application>gtkmm</application> из гита. Већини корисника ово никада неће бити потребно, али ако сте заинтересовани да помогнете у развоју <application>gtkmm</application>-а, погледајте додатак <link linkend="chapter-working-with-source">Рад са изворним кодом gtkmm-а</link>.

note: (itstool) path: section/para
en: GTK and <application>gtkmm</application> were designed to work well with Microsoft Windows, and the developers encourage its use on the win32 platform. However, Windows has no standard installation system for development libraries. Please see the <link xlink:href="https://wiki.gnome.org/Projects/gtkmm/MSWindows">Windows Installation</link> page (somewhat outdated) or the <link linkend="sec-windows-installation"><application>gtkmm</application> and Win32</link> appendix for Windows-specific installation instructions and notes.
sr: GTK и <application>gtkmm</application> су дизајнирани да добро раде са Microsoft Windows-ом, а програмери подстичу његово коришћење на win32 платформи. Међутим, Windows нема стандардни систем инсталације за развојне библиотеке. Погледајте страницу <link xlink:href="https://wiki.gnome.org/Projects/gtkmm/MSWindows">Windows инсталација</link> (донекле застарела) или додатак <link linkend="sec-windows-installation"><application>gtkmm</application> и Win32</link> за упутства и напомене о инсталацији специфичне за Windows.

note: (itstool) path: chapter/title
en: Basics
sr: Основно

note: (itstool) path: chapter/para
en: This chapter will introduce some of the most important aspects of <application>gtkmm</application> coding. These will be demonstrated with simple working example code. However, this is just a taster, so you need to look at the other chapters for more substantial information.
sr: Ово поглавље ће представити неке од најважнијих аспеката програмирања помоћу <application>gtkmm</application>-а. Они ће бити демонстрирани једноставним примером кода који ради. Међутим, ово је само увод, па треба да погледате остала поглавља за опширније информације.

note: (itstool) path: chapter/para
en: Your existing knowledge of <phrase role="nowrap">C++</phrase> will help you with <application>gtkmm</application> as it would with any library. Unless we state otherwise, you can expect <application>gtkmm</application> classes to behave like any other <phrase role="nowrap">C++</phrase> class, and you can expect to use your existing <phrase role="nowrap">C++</phrase> techniques with <application>gtkmm</application> classes.
sr: Ваше постојеће знање језика <phrase role="nowrap">C++</phrase> ће вам помоћи код <application>gtkmm</application>-а као и код било које друге библиотеке. Осим ако не наведемо другачије, можете очекивати да се класе <application>gtkmm</application>-а понашају као и било која друга <phrase role="nowrap">C++</phrase> класа, и можете очекивати да користите своје постојеће <phrase role="nowrap">C++</phrase> технике са класама <application>gtkmm</application>-а.

note: (itstool) path: section/title
en: Simple Example
sr: Једноставан пример

note: (itstool) path: section/para
en: To begin our introduction to <application>gtkmm</application>, we'll start with the simplest program possible. This program will create an empty 200 x 200 pixel window.
sr: Да бисмо започели наш увод у <application>gtkmm</application>, почећемо са најједноставнијим могућим програмом. Овај програм ће направити празан прозор величине 200 x 200 пиксела.

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/base">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/base">Изворни код</link>

note: (itstool) path: section/para
en: We will now explain each part of the example
sr: Сада ћемо објаснити сваки део примера

note: (itstool) path: section/para
en: All <application>gtkmm</application> programs must include certain <application>gtkmm</application> headers; <filename>gtkmm.h</filename> includes the entire <application>gtkmm</application> kit. This is usually not a good idea, because it includes a megabyte or so of headers, but for simple programs, it suffices.
sr: Сви <application>gtkmm</application> програми морају да укључе одређена <application>gtkmm</application> заглавља; <filename>gtkmm.h</filename> укључује цео <application>gtkmm</application> комплет. Ово обично није добра идеја, јер укључује око мегабајт заглавља, али за једноставне програме је довољно.

note: (itstool) path: section/para
en: The next part of the program:
sr: Следећи део програма:

note: (itstool) path: section/para
en: defines the <classname>MyWindow</classname> class. Its default constructor sets the window's title and default (initial) size.
sr: дефинише класу <classname>MyWindow</classname>. Њен подразумевани конструктор поставља наслов прозора и подразумевану (почетну) величину.

note: (itstool) path: section/para
en: The <function>main()</function> function's first statement:
sr: Прва наредба функције <function>main()</function>:

note: (itstool) path: section/para
en: creates a <classname>Gtk::Application</classname> object, stored in a <classname>Glib::RefPtr</classname> smartpointer. This is needed in all <application>gtkmm</application> applications. The <methodname>create()</methodname> method for this object initializes <application>gtkmm</application>.
sr: ствара објекат <classname>Gtk::Application</classname>, смештен у паметном показивачу <classname>Glib::RefPtr</classname>. Ово је потребно у свим <application>gtkmm</application> програмима. Метод <methodname>create()</methodname> за овај објекат покреће <application>gtkmm</application>.

note: (itstool) path: section/para
en: The last line creates and shows a window and enters the <application>gtkmm</application> main processing loop, which will finish when the window is closed. Your <function>main()</function> function will then return with an appropriate success or error code. The <parameter>argc</parameter> and <parameter>argv</parameter> arguments, passed to your application on the command line, can be checked when <methodname>make_window_and_run()</methodname> is called, but this simple application does not use those arguments.
sr: Последњи ред ствара и приказује прозор и улази у <application>gtkmm</application> главну петљу обраде, која ће се завршити када се прозор затвори. Ваша функција <function>main()</function> ће се тада вратити са одговарајућим кодом успеха или грешке. Аргументи <parameter>argc</parameter> и <parameter>argv</parameter>, који се прослеђују вашем програму из линије наредби, могу се проверити када се позове <methodname>make_window_and_run()</methodname>, али овај једноставан програм не користи те аргументе.

note: (itstool) path: section/para
en: After putting the source code in <filename>base.cc</filename> you can compile the above program with <application>gcc</application> using:
sr: Након стављања изворног кода у <filename>base.cc</filename>, можете компајлирати горњи програм помоћу <application>gcc</application>-а користећи:

note: (itstool) path: section/para
en: Note that you must surround the <application>pkg-config</application> invocation with backquotes. Backquotes cause the shell to execute the command inside them, and to use the command's output as part of the command line. Note also that <filename>base.cc</filename> must come before the <application>pkg-config</application> invocation on the command line. <literal><phrase role="nowrap">-std=c++17</phrase></literal> is necessary only if your compiler is not <phrase role="nowrap">C++17</phrase> compliant by default.
sr: Имајте на уму да морате окружити позив <application>pkg-config</application>-а обрнутим апострофима. Обрнути апострофи узрокују да шкољка изврши наредбу унутар њих и да користи излаз наредбе као део линије наредби. Такође имајте на уму да <filename>base.cc</filename> мора доћи пре позива <application>pkg-config</application>-а у линији наредби. <literal><phrase role="nowrap">-std=c++17</phrase></literal> је неопходно само ако ваш преводилац није подразумевано усклађен са <phrase role="nowrap">C++17</phrase> стандардом.

note: (itstool) path: section/title
en: Headers and Linking
sr: Заглавља и повезивање

note: (itstool) path: section/para
en: Although we have shown the compilation command for the simple example, you really should use the <link xlink:href="https://mesonbuild.com/">Meson build system</link>. The examples used in this book are included in the <application>gtkmm-documentation</application> package, with appropriate build files, so we won't show the build commands in future. The <filename>README</filename> file in <application>gtkmm-documentation</application> describes how to build the examples.
sr: Иако смо приказали наредбу за компајлирање за једноставан пример, заиста би требало да користите <link xlink:href="https://mesonbuild.com/">Мезон систем за изградњу</link>. Примери коришћени у овој књизи су укључени у пакет <application>gtkmm-documentation</application>, са одговарајућим датотекама за изградњу, тако да убудуће нећемо приказивати наредбе за изградњу. Датотека <filename>README</filename> у <application>gtkmm-documentation</application> описује како се граде примери.

note: (itstool) path: section/para
en: To simplify compilation, we use <literal>pkg-config</literal>, which is present in all (properly installed) <application>gtkmm</application> installations. This program 'knows' what compiler switches are needed to compile programs that use <application>gtkmm</application>. The <literal>--cflags</literal> option causes <literal>pkg-config</literal> to output a list of include directories for the compiler to look in; the <literal>--libs</literal> option requests the list of libraries for the compiler to link with and the directories to find them in. Try running it from your shell-prompt to see the results on your system.
sr: Да бисмо поједноставили компајлирање, користимо <literal>pkg-config</literal>, који је присутан у свим (правилно инсталираним) <application>gtkmm</application> инсталацијама. Овај програм „зна“ који су прекидачи преводиоца потребни за компајлирање програма који користе <application>gtkmm</application>. Опција <literal>--cflags</literal> узрокује да <literal>pkg-config</literal> испише списак директоријума за укључивање које преводилац треба да претражи; опција <literal>--libs</literal> захтева списак библиотека са којима преводилац треба да се повеже и директоријуме у којима се оне налазе. Пробајте да га покренете из вашег упита шкољке да бисте видели резултате на вашем системе.

note: (itstool) path: section/para
en: However, this is even simpler when using the <function>dependency()</function> function in a <filename>meson.build</filename> file with Meson. For instance:
sr: Међутим, ово је још једноставније када се користи функција <function>dependency()</function> у <filename>meson.build</filename> датотеци са Мезоном. На пример:

note: (itstool) path: section/para
en: This checks for the presence of gtkmm and defines <literal>gtkmm_dep</literal> for use in your <filename>meson.build</filename> files. For instance:
sr: Ово проверава присуство gtkmm-а и дефинише <literal>gtkmm_dep</literal> за употребу у вашим <filename>meson.build</filename> датотекама. На пример:

note: (itstool) path: section/para
en: gtkmm-4.0 is the name of the current stable API. There are older APIs called gtkmm-2.4 and gtkmm-3.0 which install in parallel when they are available. There are several versions of gtkmm-2.4, such as gtkmm 2.10 and there are several versions of the gtkmm-3.0 API. Note that the API name does not change for every version because that would be an incompatible API and ABI break. There might be a future gtkmm-5.0 API which would install in parallel with gtkmm-4.0 without affecting existing applications.
sr: gtkmm-4.0 је назив тренутног стабилног АПИ-ја. Постоје старији АПИ-ји под називом gtkmm-2.4 и gtkmm-3.0 који се инсталирају паралелно када су доступни. Постоји неколико верзија gtkmm-2.4, као што је gtkmm 2.10, а постоји и неколико верзија gtkmm-3.0 АПИ-ја. Имајте на уму да се назив АПИ-ја не мења за сваку верзију јер би то био некомпатибилан прекид АПИ-ја и АБИ-ја. Можда ће постојати будући gtkmm-5.0 АПИ који би се инсталирао паралелно са gtkmm-4.0 без утицаја на постојеће програме.

note: (itstool) path: section/para
en: If you start by experimenting with a small application that you plan to use just for yourself, it's easier to start with a <filename>meson.build</filename> similar to the <filename>meson.build</filename> files in the <link linkend="chapter-building-applications">Building applications</link> chapter.
sr: Ако почнете експериментисањем са малим програмом који планирате да користите само за себе, лакше је почети са <filename>meson.build</filename> датотеком сличном <filename>meson.build</filename> датотекама у поглављу <link linkend="chapter-building-applications">Изградња програма</link>.

note: (itstool) path: section/para
en: If you use the older Autotools build system, see also the GNU site. It has more information about <link xlink:href="https://www.gnu.org/software/autoconf/">autoconf</link> and <link xlink:href="https://www.gnu.org/software/automake/">automake</link>. There are also some books describing Autotools: "GNU Autoconf, Automake, and Libtool" by Gary Vaughan et al. and "Autotools, A Practitioner's Guide to GNU Autoconf, Automake, and Libtool" by John Calcote.
sr: Ако користите старији Autotools систем за изградњу, погледајте и ГНУ веб сајт. Тамо има више информација о <link xlink:href="https://www.gnu.org/software/autoconf/">autoconf</link>-у и <link xlink:href="https://www.gnu.org/software/automake/">automake</link>-у. Постоје и неке књиге које описују Autotools: „GNU Autoconf, Automake, and Libtool“ аутора Gary Vaughan-а и осталих и „Autotools, A Practitioner's Guide to GNU Autoconf, Automake, and Libtool“ аутора John Calcote-а.

note: (itstool) path: section/title
en: Widgets
sr: Елементи

note: (itstool) path: section/para
en: <application>gtkmm</application> applications consist of windows containing widgets, such as buttons and text boxes. In some other systems, widgets are called "controls". For each widget in your application's windows, there is a <phrase role="nowrap">C++</phrase> object in your application's code. So you just need to call a method of the widget's class to affect the visible widget.
sr: <application>gtkmm</application> програми се састоје од прозора који садрже елементе, као што су дугмад и поља за текст. У неким другим системима, елементи се називају „контроле“. За сваки елемент у прозорима вашег програма, постоји <phrase role="nowrap">C++</phrase> објекат у коду вашег програма. Дакле, само треба да позовете метод класе елемента да бисте утицали на видљиви елемент.

note: (itstool) path: section/para
en: Widgets are arranged inside container widgets such as frames and notebooks, in a hierarchy of widgets within widgets. Some of these container widgets, such as <classname>Gtk::Grid</classname>, are not visible - they exist only to arrange other widgets. Here is some example code that adds 2 <classname>Gtk::Button</classname> widgets to a <classname>Gtk::Box</classname> container widget:
sr: Елементи су распоређени унутар елемената контејнера као што су оквири и бележнице, у хијерархији елемената унутар елемената. Неки од ових елемената контејнера, као што је <classname>Gtk::Grid</classname>, нису видљиви — они постоје само да би распоредили друге елементе. Ево неког примера кода који додаје 2 <classname>Gtk::Button</classname> елемента у <classname>Gtk::Box</classname> елемент контејнера:

note: (itstool) path: section/para
en: and here is how to add the <classname>Gtk::Box</classname>, containing those buttons, to a <classname>Gtk::Frame</classname>, which has a visible frame and title:
sr: а ево како да додате <classname>Gtk::Box</classname>, који садржи ту дугмад, у <classname>Gtk::Frame</classname>, који има видљив оквир и наслов:

note: (itstool) path: section/para
en: Most of the chapters in this book deal with specific widgets. See the <link linkend="chapter-container-widgets">Container Widgets</link> section for more details about adding widgets to container widgets.
sr: Већина поглавља у овој књизи се бави одређеним елементима. Погледајте одељак <link linkend="chapter-container-widgets">Елементи садржаоца</link> за више детаља о додавању елемената у елементе садржаоце.

note: (itstool) path: section/para
en: Although you can specify the layout and appearance of windows and widgets with <phrase role="nowrap">C++</phrase> code, you will probably find it more convenient to design your user interfaces with <filename class="extension">.ui</filename> XML files and load them at runtime with <classname>Gtk::Builder</classname>. See the <link linkend="chapter-builder">Gtk::Builder</link> chapter.
sr: Иако можете одредити распоред и изглед прозора и елемената помоћу <phrase role="nowrap">C++</phrase> кода, вероватно ће вам бити згодније да дизајнирате своја корисничка прочеља помоћу <filename class="extension">.ui</filename> XML датотека и да их учитате у време извршавања помоћу <classname>Gtk::Builder</classname>-а. Погледајте поглавље <link linkend="chapter-builder">Gtk::Builder</link>.

note: (itstool) path: section/para
en: Although <application>gtkmm</application> widget instances have lifetimes and scopes just like those of other <phrase role="nowrap">C++</phrase> classes, <application>gtkmm</application> has an optional time-saving feature that you will see in some of the examples. The <function>Gtk::make_managed()</function> allows you to create a new widget and state that it will become owned by the container into which you place it. This allows you to create the widget, add it to the container and not be concerned about deleting it, since that will occur when the parent container (which may itself be managed) is deleted. You can learn more about <application>gtkmm</application> memory management techniques in the <link linkend="chapter-memory">Memory Management chapter</link>.
sr: Иако примерци <application>gtkmm</application> елемената имају животни век и опсеге баш као и они код других <phrase role="nowrap">C++</phrase> класа, <application>gtkmm</application> има необавезну функцију за уштеду времена коју ћете видети у неким од примера. <function>Gtk::make_managed()</function> вам омогућава да направите нови елемент и наведете да ће постати власништво садржаоца у који га поставите. Ово вам омогућава да направите елемент, додате га у садржаоца и да не бринете о његовом брисању, јер ће се то догодити када се матични садржалац (који и сам може бити управљан) обрише. Можете сазнати више о <application>gtkmm</application> техникама управљања меморијом у <link linkend="chapter-memory">поглављу о управљању меморијом</link>.

note: (itstool) path: section/title (itstool) path: appendix/title
en: Signals
sr: Сигнали

note: (itstool) path: section/para
en: <application>gtkmm</application>, like most GUI toolkits, is <emphasis>event-driven</emphasis>. When an event occurs, such as the press of a mouse button, the appropriate signal will be <emphasis>emitted</emphasis> by the Widget that was pressed. Each Widget has a different set of signals that it can emit. To make a button click result in an action, we set up a <emphasis>signal handler</emphasis> to catch the button's "clicked" signal.
sr: <application>gtkmm</application>, као и већина ГКС алата, заснован је на <emphasis>догађајима</emphasis>. Када се догоди неки догађај, као што је притисак на дугме миша, одговарајући сигнал ће бити <emphasis>емитован</emphasis> од стране елемента који је притиснут. Сваки елемент има различит скуп сигнала које може емитовати. Да би клик на дугме резултирао радњом, постављамо <emphasis>руковаоца сигналом</emphasis> да ухвати сигнал „clicked“ (кликнуто) дугмета.

note: (itstool) path: section/para
en: <application>gtkmm</application> uses the libsigc++ library to implement signals. Here is an example line of code that connects a Gtk::Button's "clicked" signal with a signal handler called "on_button_clicked":
sr: <application>gtkmm</application> користи библиотеку libsigc++ за имплементацију сигнала. Ево примера линије кода која повезује сигнал „clicked“ (кликнуто) Gtk::Button-а са руковаоцем сигнала који се зове „on_button_clicked“:

note: (itstool) path: section/para
en: For more detailed information about signals, see the <link linkend="chapter-signals">appendix</link>.
sr: За детаљније информације о сигналима, погледајте <link linkend="chapter-signals">додатак</link>.

note: (itstool) path: section/para
en: For information about implementing your own signals rather than just connecting to the existing <application>gtkmm</application> signals, see the <link linkend="chapter-custom-signals">appendix</link>.
sr: За информације о имплементацији сопствених сигнала уместо самог повезивања на постојеће <application>gtkmm</application> сигнале, погледајте <link linkend="chapter-custom-signals">додатак</link>.

note: (itstool) path: section/para
en: You might be surprised to learn that <application>gtkmm</application> doesn't use <classname>std::string</classname> in its interfaces. Instead it uses <classname>Glib::ustring</classname>, which is so similar and unobtrusive that you could actually pretend that each <classname>Glib::ustring</classname> is a <classname>std::string</classname> and ignore the rest of this section. But read on if you want to use languages other than English in your application.
sr: Можда ћете се изненадити када сазнате да <application>gtkmm</application> не користи <classname>std::string</classname> у својим прочељима. Уместо тога користи <classname>Glib::ustring</classname>, који је толико сличан и ненаметљив да бисте заправо могли да се претварате да је сваки <classname>Glib::ustring</classname> заправо <classname>std::string</classname> и да занемарите остатак овог одељка. Али наставите са читањем ако желите да користите језике који нису енглески у свом програму.

note: (itstool) path: section/para
en: std::string uses 8 bits per character, but 8 bits aren't enough to encode languages such as Arabic, Chinese, and Japanese. Although the encodings for these languages have been specified by the <link xlink:href="http://www.unicode.org/">Unicode Consortium</link>, the C and <phrase role="nowrap">C++</phrase> languages do not yet provide any standardized Unicode support for UTF-8 encoding. GTK and GNOME chose to implement Unicode using UTF-8, and that's what is wrapped by Glib::ustring. It provides almost exactly the same interface as std::string, along with automatic conversions to and from std::string.
sr: std::string користи 8 битова по знаку, али 8 битова није довољно за кодирање језика као што су арапски, кинески и јапански. Иако је кодирања за ове језике одредио <link xlink:href="http://www.unicode.org/">Unicode конзорцијум</link>, језици C и <phrase role="nowrap">C++</phrase> још увек не пружају никакву стандардизовану подршку за Уникод за UTF-8 кодирање. ГТК и Гном су изабрали да имплементирају Уникод користећи UTF-8, и то је оно што је омотано помоћу Glib::ustring. Он пружа скоро потпуно исто прочеље као std::string, заједно са аутоматским претварањем у и из std::string.

note: (itstool) path: section/para
en: One of the benefits of UTF-8 is that you don't need to use it unless you want to, so you don't need to retrofit all of your code at once. <classname>std::string</classname> will still work for 7-bit ASCII strings. But when you try to localize your application for languages like Chinese, for instance, you will start to see strange errors, and possible crashes. Then all you need to do is start using <classname>Glib::ustring</classname> instead.
sr: Једна од предности UTF-8 је та што не морате да га користите осим ако то не желите, тако да не морате одједном да преправљате сав свој код. <classname>std::string</classname> ће и даље радити за 7-битне ASCII ниске. Али када покушате да локализујете свој програм за језике као што је кинески, на пример, почећете да виђате чудне грешке и могућа рушења. Тада је све што треба да урадите да почнете да користите <classname>Glib::ustring</classname> уместо њега.

note: (itstool) path: section/para
en: Note that UTF-8 isn't compatible with 8-bit encodings like ISO-8859-1. For instance, German umlauts are not in the ASCII range and need more than 1 byte in the UTF-8 encoding. If your code contains 8-bit string literals, you have to convert them to UTF-8 (e.g. the Bavarian greeting "Grüß Gott" would be "Gr\xC3\xBC\xC3\x9F Gott").
sr: Имајте на уму да UTF-8 није сагласан са 8-битним кодирањима као што је ISO-8859-1. На пример, немачки умлаути нису у ASCII опсегу и захтевају више од 1 бајта у UTF-8 кодирању. Ако ваш код садржи 8-битне литерале ниски, морате их претворити у UTF-8 (нпр. баварски поздрав „Grüß Gott“ би био „Gr\xC3\xBC\xC3\x9F Gott“).

note: (itstool) path: section/para
en: You should avoid C-style pointer arithmetic, and functions such as strlen(). In UTF-8, each character might need anywhere from 1 to 6 bytes, so it's not possible to assume that the next byte is another character. <classname>Glib::ustring</classname> worries about the details of this for you so you can use methods such as Glib::ustring::substr() while still thinking in terms of characters instead of bytes.
sr: Требало би да избегавате аритметику показивача у C-стилу и функције као што је strlen(). У UTF-8, сваки знак може захтевати од 1 до 6 бајтова, тако да није могуће претпоставити да је следећи бајт други знак. <classname>Glib::ustring</classname> брине о детаљима овога уместо вас, тако да можете користити методе као што је Glib::ustring::substr() док и даље размишљате у смислу знакова уместо бајтова.

note: (itstool) path: section/para
en: Unlike the Windows UCS-2 Unicode solution, this does not require any special compiler options to process string literals, and it does not result in Unicode executables and libraries which are incompatible with ASCII ones.
sr: За разлику од Windows UCS-2 Уникод решења, ово не захтева никакве посебне опције преводиоца за обраду литерала ниски, и не резултира Уникод извршним датотекама и библиотекама које су несагласне са ASCII датотекама.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/glibmm/classGlib_1_1ustring.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/glibmm/classGlib_1_1ustring.html">Референца</link>

note: (itstool) path: section/para
en: See the <link linkend="chapter-internationalization">Internationalization</link> section for information about providing the UTF-8 string literals.
sr: Погледајте одељак <link linkend="chapter-internationalization">Интернационализација</link> за информације о обезбеђивању UTF-8 литерала ниски.

note: (itstool) path: section/title
en: Mixing C and C++ APIs
sr: Мешање Ц и Ц++ API-ја

note: (itstool) path: section/para
en: You can use C APIs which do not yet have convenient <phrase role="nowrap">C++</phrase> interfaces. It is generally not a problem to use C APIs from <phrase role="nowrap">C++</phrase>, and <application>gtkmm</application> helps by providing access to the underlying C object, and providing an easy way to create a <phrase role="nowrap">C++</phrase> wrapper object from a C object, provided that the C API is also based on the <classname>GObject</classname> system.
sr: Можете користити Ц API-је који још увек немају згодна <phrase role="nowrap">Ц++</phrase> прочеља. Обично није проблем користити Ц API-је из <phrase role="nowrap">Ц++</phrase>-а, а <application>gtkmm</application> помаже пружањем приступа основном Ц објекту и пружањем лаког начина за стварање <phrase role="nowrap">Ц++</phrase> објекта омотача из Ц објекта, под условом да је Ц API такође заснован на систему <classname>GObject</classname>.

note: (itstool) path: section/para
en: To use a <application>gtkmm</application> instance with a C function that requires a C <classname>GObject</classname> instance, use the <phrase role="nowrap">C++</phrase> instance’s <function>gobj()</function> function to obtain a pointer to the underlying C instance. For example:
sr: Да бисте користили <application>gtkmm</application> инстанцу са Ц функцијом која захтева Ц <classname>GObject</classname> инстанцу, користите функцију <function>gobj()</function> Ц++ инстанце да бисте добили показивач на основну Ц инстанцу. На пример:

note: (itstool) path: section/para
en: To obtain a <application>gtkmm</application> instance from a C <classname>GObject</classname> instance, use one of the many overloaded <function>Glib::wrap()</function> functions. The C instance’s reference count is not incremented, unless you set the optional <parameter>take_copy</parameter> argument to <literal>true</literal>. For example:
sr: Да бисте добили <application>gtkmm</application> инстанцу из Ц <classname>GObject</classname> инстанце, користите једну од многих преоптерећених <function>Glib::wrap()</function> функција. Број референци Ц инстанце се не увећава, осим ако не поставите опциони аргумент <parameter>take_copy</parameter> на <literal>true</literal>. На пример:

note: (itstool) path: listitem/para
en: it's a widget or other class that inherits from <classname>Gtk::Object</classname>, and
sr: то је елемент или друга класа која наслеђује из <classname>Gtk::Object</classname>, и

note: (itstool) path: listitem/para
en: the C instance has a floating reference when the wrapper is created, and
sr: Ц инстанца има плутајућу референцу када се омотач створи, и

note: (itstool) path: listitem/para
en: <function>Gtk::manage()</function> has not been called on it (which includes if it was created with <function>Gtk::make_managed()</function>), or
sr: <function>Gtk::manage()</function> није позвано над њом (што укључује и ако је створена помоћу <function>Gtk::make_managed()</function>), или

note: (itstool) path: listitem/para
en: <function>Gtk::manage()</function> was called on it, but it was never added to a parent.
sr: <function>Gtk::manage()</function> је позвано над њом, али никада није додато родитељу.

note: (itstool) path: section/para
en: The <phrase role="nowrap">C++</phrase> wrapper shall be explicitly deleted if <_:itemizedlist-1/> <function>Glib::wrap()</function> binds the C and <phrase role="nowrap">C++</phrase> instances to each other. Don't delete the <phrase role="nowrap">C++</phrase> instance before you want the C instance to die.
sr: <phrase role="nowrap">Ц++</phrase> омотач ће бити експлицитно обрисан ако <_:itemizedlist-1/> <function>Glib::wrap()</function> везује Ц и <phrase role="nowrap">Ц++</phrase> инстанце једну за другу. Немојте брисати <phrase role="nowrap">Ц++</phrase> инстанцу пре него што желите да Ц инстанца нестане.

note: (itstool) path: section/para
en: In all other cases the <phrase role="nowrap">C++</phrase> instance is automatically deleted when the last reference to the C instance is dropped. This includes all <function>Glib::wrap()</function> overloads that return a <classname>Glib::RefPtr</classname>.
sr: У свим осталим случајевима <phrase role="nowrap">Ц++</phrase> инстанца се аутоматски брише када се одбаци последња референца на Ц инстанцу. Ово укључује сва преоптерећења <function>Glib::wrap()</function> која враћају <classname>Glib::RefPtr</classname>.

note: (itstool) path: section/title
en: Hello World in <application>gtkmm</application>
sr: „Здраво свете“ у <application>gtkmm</application>-у

note: (itstool) path: section/para
en: We've now learned enough to look at a real example. In accordance with an ancient tradition of computer science, we now introduce Hello World, a la <application>gtkmm</application>:
sr: Сада смо научили довољно да погледамо прави пример. У складу са древном традицијом рачунарства, сада представљамо „Здраво свете“, на <application>gtkmm</application> начин:

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/helloworld">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/helloworld">Изворни ко̂д</link>

note: (itstool) path: section/para
en: Try to compile and run it before going on. You should see something like this:
sr: Пробајте да га компајлирате и покренете пре него што наставите. Требало би да видите нешто овако:

note: (itstool) path: figure/title
en: Hello World
sr: Здраво свете

[ctx: _]
note: (itstool) path: imageobject/imagedata This is a reference to an external file such as an image or video. When the file changes, the md5 hash will change to let you know you need to update your localized copy. The msgstr is not used at all. Set it to whatever you like once you have updated your copy 
en: external ref='figures/helloworld.png' md5='d599f2ce71f0ba20cad9cb48453f74f5'
sr: _:external ref='figures/helloworld.png' md5='d599f2ce71f0ba20cad9cb48453f74f5'

note: (itstool) path: section/para
en: Pretty thrilling, eh? Let's examine the code. First, the <classname>HelloWorld</classname> class:
sr: Прилично узбудљиво, зар не? Хајде да испитамо ко̂д. Прво, класа <classname>HelloWorld</classname>:

note: (itstool) path: section/para
en: This class implements the "Hello World" window. It's derived from <classname>Gtk::Window</classname>, and has a single <classname>Gtk::Button</classname> as a member. We've chosen to use the constructor to do all of the initialization work for the window, including setting up the signals. Here it is, with the comments omitted:
sr: Овај разред имплементира прозор „Здраво свете“. Изведен је из <classname>Gtk::Window</classname> и има једно <classname>Gtk::Button</classname> као члан. Одабрали смо да користимо конструктор за обављање свих послова иницијализације прозора, укључујући подешавање сигнала. Ево га, са изостављеним коментарима:

note: (itstool) path: section/para
en: Notice that we've used an initializer statement to give the <literal>m_button</literal> object the label "Hello World".
sr: Приметите да смо користили наредбу за иницијализацију да бисмо објекту <literal>m_button</literal> дали натпис „Hello World“.

note: (itstool) path: section/para
en: Next we call the Button's <methodname>set_margin()</methodname> method. This sets the amount of space around the button.
sr: Затим позивамо метод дугмета <methodname>set_margin()</methodname>. Ово поставља количину простора око дугмета.

note: (itstool) path: section/para
en: We then hook up a signal handler to <literal>m_button</literal>'s <literal>clicked</literal> signal. This prints our friendly greeting to <literal>stdout</literal>.
sr: Потом повезујемо руковалац сигнала са сигналом <literal>clicked</literal> објекта <literal>m_button</literal>. Ово исписује наш пријатељски поздрав на <literal>stdout</literal>.

note: (itstool) path: section/para
en: Next, we use the Window's <methodname>set_child()</methodname> method to put <literal>m_button</literal> in the Window. The <methodname>set_child()</methodname> method places the Widget in the Window.
sr: Затим користимо метод прозора <methodname>set_child()</methodname> да поставимо <literal>m_button</literal> у прозор. Метод <methodname>set_child()</methodname> смешта елемент у прозор.

note: (itstool) path: section/para
en: Now let's look at our program's <function>main()</function> function. Here it is, without comments:
sr: Сада погледајмо функцију <function>main()</function> нашег програма. Ево је, без коментарима:

note: (itstool) path: section/para
en: First we instantiate an object stored in a <classname>Glib::RefPtr</classname> smartpointer called <literal>app</literal>. This is of type <classname>Gtk::Application</classname>. Every <application>gtkmm</application> program must have one of these.
sr: Прво стварамо примерак објекта сачуваног у паметном показивачу <classname>Glib::RefPtr</classname> под називом <literal>app</literal>. Он је типа <classname>Gtk::Application</classname>. Сваки <application>gtkmm</application> програм мора имати један овакав.

note: (itstool) path: section/para
en: Next we call <methodname>make_window_and_run()</methodname> which creates an object of our <classname>HelloWorld</classname> class, shows that Window and starts the <application>gtkmm</application> <emphasis>event loop</emphasis>. During the event loop <application>gtkmm</application> idles, waiting for actions from the user, and responding appropriately. When the user closes the Window, <methodname>make_window_and_run()</methodname> will return, causing our <function>main()</function> function to return. The application will then finish.
sr: Затим позивамо <methodname>make_window_and_run()</methodname> који ствара објекат нашег разреда <classname>HelloWorld</classname>, приказује тај прозор и покреће <application>gtkmm</application> <emphasis>петљу догађаја</emphasis>. Током петље догађаја <application>gtkmm</application> мирује, чекајући акције корисника и одговарајући на одговарајући начин. Када корисник затвори прозор, <methodname>make_window_and_run()</methodname> ће се вратити, узрокујући да се наша функција <function>main()</function> заврши. Програм ће се тада завршити.

note: (itstool) path: section/para
en: Like the simple example we showed earlier, this Hello World program does not use the command-line parameters.
sr: Попут једноставног примера који смо раније показали, овај програм „Здраво свете“ не користи параметре командне линије.

note: (itstool) path: chapter/title
en: Changes in <application>gtkmm</application> 3
sr: Промене у <application>gtkmm</application> 3

note: (itstool) path: chapter/para
en: <application>gtkmm</application>-3.0 is an old version of the <application>gtkmm</application> API that installs in parallel with the still older <application>gtkmm</application>-2.4 API and the new <application>gtkmm</application>-4.0 API. The last version of the <application>gtkmm</application>-2.4 API was <application>gtkmm</application> 2.24. <application>gtkmm</application> 3 has no major fundamental differences to <application>gtkmm</application> 2 but does make several small changes that were not possible while maintaining binary compatibility. If you never used the <application>gtkmm</application>-2.4 API then you can safely ignore this chapter.
sr: <application>gtkmm</application>-3.0 је стара верзија <application>gtkmm</application> АПИ-ја која се инсталира паралелно са још старијим <application>gtkmm</application>-2.4 АПИ-јем и новим <application>gtkmm</application>-4.0 АПИ-јем. Последња верзија <application>gtkmm</application>-2.4 АПИ-ја била је <application>gtkmm</application> 2.24. <application>gtkmm</application> 3 нема великих суштинских разлика у односу на <application>gtkmm</application> 2, али ипак доноси неколико малих измена које нису биле могуће уз одржавање бинарне компатибилности. Ако никада нисте користили <application>gtkmm</application>-2.4 АПИ, можете слободно занемарити ово поглавље.

note: (itstool) path: chapter/para
en: <application>gtkmm</application> 3's library is called <literal>libgtkmm-3.0</literal> rather than <literal>libgtkmm-2.4</literal> and installs its headers in a similarly-versioned directory, so your pkg-config check should ask for <literal>gtkmm-3.0</literal> rather than <literal>gtkmm-2.4</literal>.
sr: Библиотека <application>gtkmm</application> 3 се зове <literal>libgtkmm-3.0</literal> уместо <literal>libgtkmm-2.4</literal> и инсталира своја заглавља у директоријум са сличном верзијом, тако да ваша pkg-config провера треба да тражи <literal>gtkmm-3.0</literal> уместо <literal>gtkmm-2.4</literal>.

note: (itstool) path: chapter/para
en: <application>gtkmm</application> 3 added some new classes:
sr: <application>gtkmm</application> 3 је додао неке нове разреде:

note: (itstool) path: listitem/simpara
en: <classname>Gtk::AppChooser</classname>, <classname>Gtk::AppChooserButton</classname>, <classname>Gtk::AppChooserDialog</classname> allow the user to select an installed application to open a particular type of content.
sr: <classname>Gtk::AppChooser</classname>, <classname>Gtk::AppChooserButton</classname>, <classname>Gtk::AppChooserDialog</classname> омогућавају кориснику да изабере инсталирани програм за отварање одређене врсте садржаја.

note: (itstool) path: listitem/simpara
en: <classname>Gtk::Grid</classname> is a new container widget that will eventually replace <classname>Gtk::Box</classname> and <classname>Gtk::Table</classname>. It arranges its children according to properties of those children rather than its own layout details.
sr: <classname>Gtk::Grid</classname> је нови елемент контејнера који ће на крају заменити <classname>Gtk::Box</classname> и <classname>Gtk::Table</classname>. Он распоређује своје садржане елементе према особинама тих елемената, а не према сопственим детаљима распореда.

note: (itstool) path: listitem/simpara
en: <classname>Gtk::Switch</classname> displays On/Off states more explicitly than <classname>Gtk::CheckButton</classname>. It may be useful, for instance, when allowing users to activate hardware.
sr: <classname>Gtk::Switch</classname> приказује стања Укључено/Искључено јасније од <classname>Gtk::CheckButton</classname>. Може бити користан, на пример, када се корисницима омогућава активирање хардвера.

note: (itstool) path: chapter/para
en: <application>gtkmm</application> 3 also made several small changes to the API, which you will probably encounter when porting code that used <application>gtkmm</application>-2.4. Here is a short list:
sr: <application>gtkmm</application> 3 је такође направио неколико малих измена у АПИ-ју, на које ћете вероватно наићи приликом преношења кода који је користио <application>gtkmm</application>-2.4. Ево кратког списка:

note: (itstool) path: listitem/simpara
en: <classname>Gtk::CellLayout</classname>, used by <classname>Gtk::IconView</classname>, <classname>Gtk::TreeView::Column</classname> and <classname>Gtk::ComboBox</classname>, now has a <classname>Gtk::CellArea</classname> which can be used to specify more details of how the <classname>CellRenderer</classname>s are arranged and aligned.
sr: <classname>Gtk::CellLayout</classname>, који користе <classname>Gtk::IconView</classname>, <classname>Gtk::TreeView::Column</classname> и <classname>Gtk::ComboBox</classname>, сада има <classname>Gtk::CellArea</classname> који се може користити за навођење више детаља о томе како су <classname>CellRenderer</classname>-и распоређени и поравнати.

note: (itstool) path: listitem/simpara
en: Gtk::ComboBox now derives from CellLayout, allowing easier layout and alignment of its <classname>Gtk::CellRenderer</classname>s.
sr: Gtk::ComboBox сада изводи из CellLayout-а, омогућавајући лакши распоред и поравнање његових <classname>Gtk::CellRenderer</classname>-а.

note: (itstool) path: listitem/simpara
en: <classname>Gtk::Adjustment</classname> and <classname>IconSet</classname> and <classname>Gdk::Cursor</classname> are now used via <classname>Glib::RefPtr</classname>.
sr: <classname>Gtk::Adjustment</classname>, <classname>IconSet</classname> и <classname>Gdk::Cursor</classname> се сада користе путем <classname>Glib::RefPtr</classname>-а.

note: (itstool) path: listitem/simpara
en: <classname>Gtk::Box</classname>, <classname>Gtk::ButtonBox</classname>, <classname>Gtk::IconView</classname>, <classname>Gtk::Paned</classname>, <classname>Gtk::ProgressBar</classname>, <classname>Gtk::ScaleButton</classname>, <classname>Gtk::Scrollbar</classname> and <classname>Gtk::Separator</classname> now derive from <classname>Gtk::Orientable</classname>, allowing their orientation (vertical or horizontal) to be specified without requiring the use of a derived class such as <classname>Gtk::HBox</classname>.
sr: <classname>Gtk::Box</classname>, <classname>Gtk::ButtonBox</classname>, <classname>Gtk::IconView</classname>, <classname>Gtk::Paned</classname>, <classname>Gtk::ProgressBar</classname>, <classname>Gtk::ScaleButton</classname>, <classname>Gtk::Scrollbar</classname> и <classname>Gtk::Separator</classname> сада изводе из <classname>Gtk::Orientable</classname>-а, омогућавајући да се њихово усмерење (усправно или водоравно) наведе без захтевања коришћења изведене класе као што је <classname>Gtk::HBox</classname>.

note: (itstool) path: listitem/simpara
en: <classname>Gtk::IconView</classname>, <classname>Gtk::TextView</classname>, <classname>Gtk::TreeView</classname> and other widgets derive from Scrollable instead of having their own methods such as <methodname>get_vadjustment()</methodname> and instead of having their own set_scroll_adjustments signal.
sr: <classname>Gtk::IconView</classname>, <classname>Gtk::TextView</classname>, <classname>Gtk::TreeView</classname> и други елементи изводе из Scrollable-а уместо да имају сопствене методе као што је <methodname>get_vadjustment()</methodname> и уместо да имају сопствени сигнал set_scroll_adjustments.

note: (itstool) path: listitem/simpara
en: <classname>Gtk::Style</classname> and <classname>Gtk::Rc</classname> were removed, replaced by <classname>Gtk::StyleContext</classname>, and <classname>Gtk::StyleProvider</classname>s, such as <classname>Gtk::CssProvider</classname>.
sr: <classname>Gtk::Style</classname> и <classname>Gtk::Rc</classname> су уклоњени, замењени са <classname>Gtk::StyleContext</classname> и <classname>Gtk::StyleProvider</classname>-има, као што је <classname>Gtk::CssProvider</classname>.

note: (itstool) path: listitem/simpara
en: Widget::on_expose_event() was replaced by Widget::on_draw(), which assumes that cairomm is used for drawing, via the provided <classname>Cairo::Context</classname> and does not require you to call <methodname>Cairo::Context::clip()</methodname>.
sr: Widget::on_expose_event() је замењен са Widget::on_draw(), који подразумева да се cairomm користи за цртање, путем достављеног <classname>Cairo::Context</classname>-а и не захтева од вас да позовете <methodname>Cairo::Context::clip()</methodname>.

note: (itstool) path: listitem/simpara
en: <classname>Gdk::RGBA</classname> replaces <classname>Color</classname>, adding an alpha component for opacity. <classname>Colormap</classname> was removed, along with its awkward use to allocate colors.
sr: <classname>Gdk::RGBA</classname> замењује <classname>Color</classname>, додајући алфа компоненту за непрозирност. <classname>Colormap</classname> је уклоњен, заједно са његовим незгодним коришћењем за додељивање боја.

note: (itstool) path: listitem/simpara
en: <classname>Gdk::Pixmap</classname> and <classname>Gdk::Bitmap</classname> were removed in favor of <classname>Gdk::Pixbuf</classname>.
sr: <classname>Gdk::Pixmap</classname> и <classname>Gdk::Bitmap</classname> су уклоњени у корист <classname>Gdk::Pixbuf</classname>-а.

note: (itstool) path: listitem/simpara
en: <classname>Gdk::Drawable</classname> was removed, with its methods moving into <classname>Gdk::Window</classname>.
sr: <classname>Gdk::Drawable</classname> је уклоњен, а његове методе су премештене у <classname>Gdk::Window</classname>.

note: (itstool) path: listitem/simpara
en: We now use std::vector in several methods instead of the intermediate *Handle types to make the API clearer.
sr: Сада користимо std::vector у неколико метода уместо посредних *Handle типова како бисмо API учинили јаснијим.

note: (itstool) path: chapter/para
en: All deprecated API was removed in <application>gtkmm</application> 3.0, though there have been new deprecations in later <application>gtkmm</application> 3.x versions.
sr: Сав застарели API је уклоњен у <application>gtkmm</application>-у 3.0, иако је било нових застарелости у каснијим <application>gtkmm</application> 3.x издањима.

note: (itstool) path: chapter/para
en: As a first step to porting your source code to <application>gtkmm</application>-3.0 you should probably ensure that your application builds with the deprecated <application>gtkmm</application>-2.4 API disabled, by defining macro such as GTKMM_DISABLE_DEPRECATED. There are some autotools macros that can help with this by defining them optionally at build time. See the <link xlink:href="https://wiki.gnome.org/Projects/gtkmm/PortingToGtkmm3">gtkmm 3 porting wiki page</link> for more details.
sr: Као први корак ка пребацивању вашег изворног кода на <application>gtkmm</application>-3.0 вероватно би требало да се уверите да се ваш програм изграђује са онемогућеним застарелим <application>gtkmm</application>-2.4 API-јем, дефинисањем макроа као што је GTKMM_DISABLE_DEPRECATED. Постоје неки autotools макрои који могу помоћи у томе њиховим опционим дефинисањем у време изградње. Погледајте <link xlink:href="https://wiki.gnome.org/Projects/gtkmm/PortingToGtkmm3">вики страницу о пребацивању на gtkmm 3</link> за више детаља.

note: (itstool) path: chapter/title
en: Changes in <application>gtkmm</application>-4.0 and <application>glibmm-2.68</application>
sr: Измене у <application>gtkmm</application>-у 4.0 и <application>glibmm-2.68</application>-у

note: (itstool) path: chapter/para
en: <application>gtkmm</application>-4.0 is a new version of the <application>gtkmm</application> API that installs in parallel with the older <application>gtkmm</application>-2.4 and <application>gtkmm</application>-3.0 APIs. The last version of the <application>gtkmm</application>-3.0 API is <application>gtkmm</application> 3.24. <application>gtkmm</application> 4 has no major fundamental differences to <application>gtkmm</application> 3 but does make several changes (both small and large ones) that were not possible while maintaining binary compatibility. If you never used the <application>gtkmm</application>-3.0 API then you can safely ignore this chapter.
sr: <application>gtkmm</application>-4.0 је ново издање <application>gtkmm</application> API-ја које се инсталира паралелно са старијим <application>gtkmm</application>-2.4 и <application>gtkmm</application>-3.0 API-јима. Последње издање <application>gtkmm</application>-3.0 API-ја је <application>gtkmm</application> 3.24. <application>gtkmm</application> 4 нема великих суштинских разлика у односу на <application>gtkmm</application> 3, али ипак доноси неколико измена (малих и великих) које нису биле могуће уз одржавање бинарне усклађености. Ако никада нисте користили <application>gtkmm</application>-3.0 API, онда можете безбедно занемарити ово поглавље.

note: (itstool) path: chapter/para
en: <application>gtkmm</application> 4's library is called <literal>libgtkmm-4.0</literal> rather than <literal>libgtkmm-3.0</literal> and installs its headers in a similarly-versioned directory, so your <application>pkg-config</application> check should ask for <literal>gtkmm-4.0</literal> rather than <literal>gtkmm-3.0</literal>.
sr: Библиотека <application>gtkmm</application>-а 4 се зове <literal>libgtkmm-4.0</literal> уместо <literal>libgtkmm-3.0</literal> и инсталира своја заглавља у директоријум са сличном верзијом, тако да би ваша <application>pkg-config</application> провера требало да тражи <literal>gtkmm-4.0</literal> уместо <literal>gtkmm-3.0</literal>.

note: (itstool) path: chapter/para
en: <application>gtkmm</application>-4.0 is used in combination with <application>glibmm-2.68</application>, which sets the global locale for your program. The older <application>glibmm-2.4</application> does not do that, and <application>gtkmm</application>-3.0 does it only to some extent. What this means is briefly that if your <application>gtkmm</application>-3.0 program contains a call to <function>std::locale::global(std::locale(""))</function>, you can probably remove it. If you don't want <application>glibmm</application> or <application>gtkmm</application> to set the global locale for you, you should add a call to <function>Glib::set_init_to_users_preferred_locale(false)</function> before any call to <function>Glib::init()</function> or <methodname>Gtk::Application::create()</methodname>. See the <application>glibmm</application> <link xlink:href="https://gnome.pages.gitlab.gnome.org/glibmm/namespaceGlib.html"> reference</link>.
sr: <application>gtkmm</application>-4.0 се користи у комбинацији са <application>glibmm-2.68</application>-ом, који поставља општу локализацију за ваш програм. Старији <application>glibmm-2.4</application> то не ради, а <application>gtkmm</application>-3.0 то ради само у одређеној мери. Ово укратко значи да ако ваш <application>gtkmm</application>-3.0 програм садржи позив <function>std::locale::global(std::locale(""))</function>, вероватно га можете уклонити. Ако не желите да <application>glibmm</application> или <application>gtkmm</application> постављају општу локализацију уместо вас, требало би да додате позив <function>Glib::set_init_to_users_preferred_locale(false)</function> пре било ког позива <function>Glib::init()</function> или <methodname>Gtk::Application::create()</methodname>. Погледајте <application>glibmm</application> <link xlink:href="https://gnome.pages.gitlab.gnome.org/glibmm/namespaceGlib.html">референцу</link>.

note: (itstool) path: chapter/para
en: There are lots and lots of differences between <application>gtkmm</application>-3.0 and <application>gtkmm</application>-4.0. The following lists are not complete.
sr: Постоји веома много разлика између <application>gtkmm</application>-а 3.0 и <application>gtkmm</application>-а 4.0. Следећи спискови нису потпуни.

note: (itstool) path: chapter/para
en: There are some important behavioural changes, to which you must adapt when migrating:
sr: Постоје неке важне промене у понашању, којима се морате прилагодити приликом преласка:

note: (itstool) path: listitem/simpara
en: Whereas in <application>gtkmm</application>-3.0, destruction of a non-managed <phrase role="nowrap">C++</phrase> widget wrapper caused the wrapped GtkWidget to be destroyed, changes in GTK4 mean that in <application>gtkmm</application>-4.0 this canʼt always be the case. GTK4 has no uniform way to remove a widget from a parent, as GTK3 did with <methodname>Gtk::Container::remove()</methodname>, so <application>gtkmm</application>-4.0 canʼt do the removal for you as <application>gtkmm</application>-3.0 did. Hence, if a non-managed <phrase role="nowrap">C++</phrase> widget instance is destructed while the widget is a child of another, <application>gtkmm</application>-4.0 wonʼt remove it from the parent, the parent retains a ref that stops the child being disposed, and the GtkWidget stays alive. The end result is that to destroy a non-managed widget with its <phrase role="nowrap">C++</phrase> wrapper you must first remove it from its parent (however that parent allows) so the <phrase role="nowrap">C++</phrase> wrapperʼs dtor can drop the final reference.
sr: Док је у <application>gtkmm</application>-у 3.0 уништавање неуправљаног <phrase role="nowrap">C++</phrase> омотача елемента узроковало уништавање обавијеног GtkWidget-а, измене у GTK4 значе да у <application>gtkmm</application>-у 4.0 то не може увек бити случај. GTK4 нема једнообразан начин за уклањање елемента из родитеља, као што је GTK3 радио са <methodname>Gtk::Container::remove()</methodname>, тако да <application>gtkmm</application>-4.0 не може да изврши уклањање уместо вас као што је то радио <application>gtkmm</application>-3.0. Стога, ако се примерак неуправљаног <phrase role="nowrap">C++</phrase> елемента уништи док је елемент дете другог елемента, <application>gtkmm</application>-4.0 га неће уклонити из родитеља, родитељ задржава референцу која спречава одбацивање детета, а GtkWidget остаје жив. Крајњи резултат је да бисте уништили неуправљани елемент са његовим <phrase role="nowrap">C++</phrase> омотачем, морате га прво уклонити из његовог родитеља (како год тај родитељ дозвољава) како би деструктор <phrase role="nowrap">C++</phrase> омотача могао да отпусти последњу референцу.

note: (itstool) path: chapter/para
en: Some new classes were added in <application>gtkmm</application> 4 and <application>glibmm</application> 2.68:
sr: Неке нове класе су додате у <application>gtkmm</application> 4 и <application>glibmm</application> 2.68:

note: (itstool) path: listitem/simpara
en: <classname>Glib::ExtraClassInit</classname> and <classname>Gtk::Snapshot</classname>: These classes are needed only for writing custom widgets. See the <link linkend="sec-custom-widgets">Custom Widgets</link> section.
sr: <classname>Glib::ExtraClassInit</classname> и <classname>Gtk::Snapshot</classname>: Ове класе су потребне само за писање прилагођених виџета. Погледајте одељак <link linkend="sec-custom-widgets">Прилагођени виџети</link>.

note: (itstool) path: listitem/simpara
en: <classname>Gtk::EventControllerKey</classname>, <classname>Gtk::EventControllerMotion</classname>, <classname>Gtk::EventControllerScroll</classname> and <classname>Gtk::GestureStylus</classname>
sr: <classname>Gtk::EventControllerKey</classname>, <classname>Gtk::EventControllerMotion</classname>, <classname>Gtk::EventControllerScroll</classname> и <classname>Gtk::GestureStylus</classname>

note: (itstool) path: listitem/simpara
en: <classname>Gdk::Paintable</classname>, <classname>Gdk::Texture</classname>, <classname>Gtk::Picture</classname> and <classname>Gtk::WidgetPaintable</classname>
sr: <classname>Gdk::Paintable</classname>, <classname>Gdk::Texture</classname>, <classname>Gtk::Picture</classname> и <classname>Gtk::WidgetPaintable</classname>

note: (itstool) path: listitem/simpara
en: <classname>Gdk::Window</classname> has been renamed to <classname>Gdk::Surface</classname>. (<classname>Gtk::Window</classname> keeps its name.)
sr: <classname>Gdk::Window</classname> је преименован у <classname>Gdk::Surface</classname>. (<classname>Gtk::Window</classname> задржава своје име.)

note: (itstool) path: listitem/simpara
en: <classname>Gdk::DrawContext</classname> and <classname>Gdk::CairoContext</classname> are new. <classname>Gdk::DrawingContext</classname> has been removed.
sr: <classname>Gdk::DrawContext</classname> и <classname>Gdk::CairoContext</classname> су нови. <classname>Gdk::DrawingContext</classname> је уклоњен.

note: (itstool) path: listitem/simpara
en: <classname>Gtk::Clipboard</classname> has been replaced by the new <classname>Gdk::Clipboard</classname>.
sr: <classname>Gtk::Clipboard</classname> је замењен новим <classname>Gdk::Clipboard</classname>.

note: (itstool) path: listitem/simpara
en: <classname>Gdk::DragContext</classname> has been split into <classname>Gdk::Drag</classname> and <classname>Gdk::Drop</classname>.
sr: <classname>Gdk::DragContext</classname> је подељен на <classname>Gdk::Drag</classname> и <classname>Gdk::Drop</classname>.

note: (itstool) path: chapter/para
en: There have also been several changes to the API, which you will probably encounter when porting code that used <application>gtkmm</application>-3.0 and <application>glibmm</application>-2.4. Here is a short list:
sr: Такође је дошло до неколико измена у API-ју, на које ћете вероватно наићи приликом преношења кода који је користио <application>gtkmm</application>-3.0 и <application>glibmm</application>-2.4. Ево кратког списка:

note: (itstool) path: listitem/simpara
en: A C++17 compiler is required.
sr: Потребан је C++17 компајлер.

note: (itstool) path: listitem/simpara
en: <classname>Gtk::Button</classname>, <classname>Gtk::ToolButton</classname>, <classname>Gtk::MenuItem</classname> and <classname>Gtk::Switch</classname> implement the <classname>Gtk::Actionable</classname> interface instead of the removed <classname>Gtk::Activatable</classname> interface.
sr: <classname>Gtk::Button</classname>, <classname>Gtk::ToolButton</classname>, <classname>Gtk::MenuItem</classname> и <classname>Gtk::Switch</classname> имплементирају интерфејс <classname>Gtk::Actionable</classname> уместо уклоњеног интерфејса <classname>Gtk::Activatable</classname>.

note: (itstool) path: listitem/simpara
en: <classname>Gtk::FontButton</classname> implements the <classname>Gtk::FontChooser</classname> interface.
sr: <classname>Gtk::FontButton</classname> имплементира интерфејс <classname>Gtk::FontChooser</classname>.

note: (itstool) path: listitem/simpara
en: <classname>Gtk::Widget</classname>: The <methodname>get_preferred_*_vfunc()</methodname>s have been replaced by <methodname>measure_vfunc()</methodname>. This change only affects custom widgets.
sr: <classname>Gtk::Widget</classname>: <methodname>get_preferred_*_vfunc()</methodname> су замењени са <methodname>measure_vfunc()</methodname>. Ова измена утиче само на прилагођене виџете.

note: (itstool) path: listitem/simpara
en: <classname>sigc::slot</classname>s use the <classname>sigc::slot&lt;R(Args...)&gt;</classname> syntax. Example: <classname>sigc::slot&lt;void(int, int)&gt;</classname> instead of <classname>sigc::slot&lt;void, int, int&gt;</classname>.
sr: <classname>sigc::slot</classname> користи синтаксу <classname>sigc::slot&lt;R(Args...)&gt;</classname>. Пример: <classname>sigc::slot&lt;void(int, int)&gt;</classname> уместо <classname>sigc::slot&lt;void, int, int&gt;</classname>.

note: (itstool) path: listitem/simpara
en: <classname>Gtk::DrawingArea</classname> uses a draw function instead of the draw signal.
sr: <classname>Gtk::DrawingArea</classname> користи функцију цртања уместо сигнала цртања.

note: (itstool) path: listitem/simpara
en: <classname>Glib::ArrayHandle</classname>, <classname>Glib::StringArrayHandle</classname>, <classname>Glib::ListHandle</classname> and <classname>Glib::SListHandle</classname> have been removed. They were used in <application>glibmm</application>-2.4, but not used in <application>gtkmm</application>-3.0. If you've ever used these classes, replace them with a standard <phrase role="nowrap">C++</phrase> container, such as <classname>std::vector</classname>.
sr: <classname>Glib::ArrayHandle</classname>, <classname>Glib::StringArrayHandle</classname>, <classname>Glib::ListHandle</classname> и <classname>Glib::SListHandle</classname> су уклоњени. Коришћени су у <application>glibmm</application>-2.4, али не и у <application>gtkmm</application>-3.0. Ако сте икада користили ове класе, замените их стандардним <phrase role="nowrap">C++</phrase> контејнером, као што је <classname>std::vector</classname>.

note: (itstool) path: listitem/simpara
en: <classname>Gtk::Container</classname> has been removed.
sr: <classname>Gtk::Container</classname> је уклоњен.

note: (itstool) path: listitem/simpara
en: <methodname>Gtk::Widget::show_all()</methodname> has been removed. The default value of <methodname>Gtk::Widget::property_visible()</methodname> has been changed from <literal>false</literal> to <literal>true</literal>.
sr: <methodname>Gtk::Widget::show_all()</methodname> је уклоњен. Подразумевана вредност <methodname>Gtk::Widget::property_visible()</methodname> је промењена из <literal>false</literal> у <literal>true</literal>.

note: (itstool) path: listitem/simpara
en: All event signals have been removed from <classname>Gtk::Widget</classname>. In most cases you can use one of the subclasses of <classname>Gtk::EventController</classname> as a replacement. For instance, use <classname>Gtk::GestureMultiPress</classname> instead of <methodname>signal_button_press_event()</methodname> and <methodname>signal_button_release_event()</methodname>, and <classname>Gtk::EventControllerKey</classname> instead of <methodname>signal_key_press_event()</methodname> and <methodname>signal_key_release_event()</methodname>.
sr: Сви сигнали догађаја су уклоњени из <classname>Gtk::Widget</classname>. У већини случајева можете користити једну од подкласа <classname>Gtk::EventController</classname> као замену. На пример, користите <classname>Gtk::GestureMultiPress</classname> уместо <methodname>signal_button_press_event()</methodname> и <methodname>signal_button_release_event()</methodname>, и <classname>Gtk::EventControllerKey</classname> уместо <methodname>signal_key_press_event()</methodname> и <methodname>signal_key_release_event()</methodname>.

note: (itstool) path: listitem/simpara
en: <classname>Glib::RefPtr</classname> is an alias for <classname>std::shared_ptr</classname>. If you make your own <classname>Glib::ObjectBase</classname>-derived classes with <methodname>create()</methodname> methods that return a <classname>Glib::RefPtr</classname>, you must use <methodname>Glib::make_refptr_for_instance()</methodname> in your <methodname>create()</methodname> methods.
sr: <classname>Glib::RefPtr</classname> је алијас за <classname>std::shared_ptr</classname>. Ако правите сопствене класе изведене из <classname>Glib::ObjectBase</classname> са <methodname>create()</methodname> методама које враћају <classname>Glib::RefPtr</classname>, морате користити <methodname>Glib::make_refptr_for_instance()</methodname> у својим <methodname>create()</methodname> методама.

note: (itstool) path: listitem/simpara
en: <methodname>Gtk::Box::pack_start()</methodname> and <methodname>Gtk::Box::pack_end()</methodname> have been removed. Use the new <classname>Gtk::Box</classname> methods <methodname>append()</methodname>, <methodname>prepend()</methodname>, <methodname>insert_child_after()</methodname> and <methodname>insert_child_at_start()</methodname>.
sr: <methodname>Gtk::Box::pack_start()</methodname> и <methodname>Gtk::Box::pack_end()</methodname> су уклоњени. Користите нове <classname>Gtk::Box</classname> методе <methodname>append()</methodname>, <methodname>prepend()</methodname>, <methodname>insert_child_after()</methodname> и <methodname>insert_child_at_start()</methodname>.

note: (itstool) path: listitem/simpara
en: <classname>Gtk::ButtonBox</classname> has been removed.
sr: <classname>Gtk::ButtonBox</classname> је уклоњен.

note: (itstool) path: listitem/simpara
en: <classname>Gtk::RadioButton</classname> and <classname>Gtk::RadioButtonGroup</classname> have been removed. Use <classname>Gtk::CheckButton</classname> or <classname>Gtk::ToggleButton</classname> with <methodname>set_group()</methodname>.
sr: <classname>Gtk::RadioButton</classname> и <classname>Gtk::RadioButtonGroup</classname> су уклоњени. Користите <classname>Gtk::CheckButton</classname> или <classname>Gtk::ToggleButton</classname> са <methodname>set_group()</methodname>.

note: (itstool) path: chapter/para
en: All deprecated API was removed in <application>gtkmm</application> 4.0 and <application>glibmm</application> 2.68, though there will be new deprecations in future versions.
sr: Сав застарели АПИ је уклоњен у <application>gtkmm</application> 4.0 и <application>glibmm</application> 2.68, иако ће бити нових застарелости у будућим верзијама.

note: (itstool) path: chapter/para
en: As a first step to porting your source code to <application>gtkmm</application>-4.0 you should probably ensure that your application builds with the deprecated <application>gtkmm</application>-3.0 and <application>glibmm-2.4</application> API disabled, by defining the macros GTKMM_DISABLE_DEPRECATED, GDKMM_DISABLE_DEPRECATED, GLIBMM_DISABLE_DEPRECATED and GIOMM_DISABLE_DEPRECATED. There are some autotools macros that can help with this by defining them optionally at build time. See the <link xlink:href="https://wiki.gnome.org/Projects/gtkmm/PortingToGtkmm3">Porting from gtkmm-2.4 to gtkmm-3.0</link> wiki page for more details.
sr: Као први корак у пребацивању вашег изворног кода на <application>gtkmm</application>-4.0 вероватно би требало да се уверите да се ваша апликација изграђује са онемогућеним застарелим <application>gtkmm</application>-3.0 и <application>glibmm-2.4</application> АПИ-јем, дефинисањем макроа GTKMM_DISABLE_DEPRECATED, GDKMM_DISABLE_DEPRECATED, GLIBMM_DISABLE_DEPRECATED и GIOMM_DISABLE_DEPRECATED. Постоје неки autotools макрои који могу помоћи у томе њиховим опционалним дефинисањем у време изградње. Погледајте вики страницу <link xlink:href="https://wiki.gnome.org/Projects/gtkmm/PortingToGtkmm3">Porting from gtkmm-2.4 to gtkmm-3.0</link> за више детаља.

note: (itstool) path: chapter/para
en: See also <link xlink:href="https://docs.gtk.org/gtk4/migrating-3to4.html"> Migrating from GTK 3.x to GTK 4</link>.
sr: Погледајте такође <link xlink:href="https://docs.gtk.org/gtk4/migrating-3to4.html"> Migrating from GTK 3.x to GTK 4</link>.

note: (itstool) path: section/title
en: Deprecations in <application>gtkmm</application> 4.10
sr: Застарелости у <application>gtkmm</application> 4.10

note: (itstool) path: section/para
en: Many classes are deprecated since <application>gtkmm</application> 4.10. They can still be used in <application>gtkmm</application>4 applications, provided GTKMM_DISABLE_DEPRECATED and GDKMM_DISABLE_DEPRECATED are not defined. There are also many new classes in <application>gtkmm</application> 4.10, which replace some of the deprecated classes. Some example programs in this tutorial use classes deprecated since <application>gtkmm</application> 4.10. Some other programs use classes available since <application>gtkmm</application> 4.10.
sr: Многе класе су застареле од верзије <application>gtkmm</application> 4.10. Оне се и даље могу користити у <application>gtkmm</application>4 апликацијама, под условом да GTKMM_DISABLE_DEPRECATED и GDKMM_DISABLE_DEPRECATED нису дефинисани. Такође постоје многе нове класе у <application>gtkmm</application> 4.10, које замењују неке од застарелих класа. Неки примери програма у овом водичу користе класе застареле од верзије <application>gtkmm</application> 4.10. Неки други програми користе класе доступне од верзије <application>gtkmm</application> 4.10.

note: (itstool) path: section/para
en: Deprecated classes: AppChooser, AppChooserButton, AppChooserDialog, AppChooserWidget, CellArea, CellAreaBox, CellAreaContext, CellLayout, CellRenderer, CellRendererAccel, CellRendererCombo, CellRendererPixbuf, CellRendererProgress, CellRendererSpin, CellRendererSpinner, CellRendererText, CellRendererToggle, CellView, ComboBox, ComboBoxText, EntryCompletion, IconView, ListStore, ListViewText, StyleContext, TreeDragDest, TreeDragSource, TreeIter and other classes in treeiter.h, TreeModel, TreeModelFilter, TreeModelSort, TreePath, TreeRowReference, TreeSelection, TreeSortable, TreeStore, TreeView, TreeViewColumn, namespace CellRenderer_Generation, namespace TreeView_Private, ColorButton, ColorChooser, ColorChooserDialog, FileChooser, FileChooserDialog, FileChooserNative, FileChooserWidget, FontButton, FontChooser, FontChooserDialog, FontChooserWidget, MessageDialog, TreeModelColumn, TreeModelColumnRecord, InfoBar, Assistant, AssistantPage, LockButton, Statusbar, VolumeButton.
sr: Застареле класе: AppChooser, AppChooserButton, AppChooserDialog, AppChooserWidget, CellArea, CellAreaBox, CellAreaContext, CellLayout, CellRenderer, CellRendererAccel, CellRendererCombo, CellRendererPixbuf, CellRendererProgress, CellRendererSpin, CellRendererSpinner, CellRendererText, CellRendererToggle, CellView, ComboBox, ComboBoxText, EntryCompletion, IconView, ListStore, ListViewText, StyleContext, TreeDragDest, TreeDragSource, TreeIter и друге класе у treeiter.h, TreeModel, TreeModelFilter, TreeModelSort, TreePath, TreeRowReference, TreeSelection, TreeSortable, TreeStore, TreeView, TreeViewColumn, именски простор CellRenderer_Generation, именски простор TreeView_Private, ColorButton, ColorChooser, ColorChooserDialog, FileChooser, FileChooserDialog, FileChooserNative, FileChooserWidget, FontButton, FontChooser, FontChooserDialog, FontChooserWidget, MessageDialog, TreeModelColumn, TreeModelColumnRecord, InfoBar, Assistant, AssistantPage, LockButton, Statusbar, VolumeButton.

note: (itstool) path: section/para
en: New classes and enums: AlertDialog, ColorDialog, ColorDialogButton, ColumnViewSorter, FileDialog, FontDialog, FontDialogButton, FileLauncher, UriLauncher, ATContext, enums DialogError, FontLevel, Collation.
sr: Нове класе и набрајања: AlertDialog, ColorDialog, ColorDialogButton, ColumnViewSorter, FileDialog, FontDialog, FontDialogButton, FileLauncher, UriLauncher, ATContext, набрајања DialogError, FontLevel, Collation.

note: (itstool) path: section/para
en: In most cases there are replacements for the deprecated classes. See the reference documentation.
sr: У већини случајева постоје замене за застареле класе. Погледајте референтну документацију.

note: (itstool) path: chapter/title
en: Buttons
sr: Дугмад

note: (itstool) path: chapter/para
en: <application>gtkmm</application> provides four basic types of buttons:
sr: <application>gtkmm</application> обезбеђује четири основне врсте дугмади:

note: (itstool) path: varlistentry/term
en: Push buttons
sr: Обична дугмад

note: (itstool) path: listitem/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1Button.html"><classname>Gtk::Button</classname></link>. Standard buttons, usually marked with a label or picture. Pushing one triggers an action. See the <link linkend="sec-pushbuttons">Button</link> section.
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1Button.html"><classname>Gtk::Button</classname></link>. Стандардна дугмад, обично означена натписом или сликом. Притисак на једно покреће радњу. Погледајте одељак <link linkend="sec-pushbuttons">Дугме</link>.

note: (itstool) path: varlistentry/term
en: Toggle buttons
sr: Прекидачка дугмад

note: (itstool) path: listitem/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1ToggleButton.html"><classname>Gtk::ToggleButton</classname></link>. Unlike a normal Button, which springs back up, a ToggleButton stays down until you press it again. It might be useful as an on/off switch. See the <link linkend="sec-toggle-buttons">ToggleButton</link> section.
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1ToggleButton.html"><classname>Gtk::ToggleButton</classname></link>. За разлику од обичног дугмета, које се враћа назад, прекидачко дугме остаје притиснуто док га поново не притиснете. Може бити корисно као прекидач за укључивање/искључивање. Погледајте одељак <link linkend="sec-toggle-buttons">Прекидачко дугме</link>.

note: (itstool) path: varlistentry/term
en: Check buttons
sr: Дугмад за потврду

note: (itstool) path: listitem/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1CheckButton.html"><classname>Gtk::CheckButton</classname></link>. These act like ToggleButtons, but show their state in small squares, with their label at the side. They should be used in most situations which require an on/off setting. See the <link linkend="sec-checkbuttons">CheckButton</link> section.
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1CheckButton.html"><classname>Gtk::CheckButton</classname></link>. Она се понашају као прекидачка дугмад, али приказују своје стање у малим квадратима, са натписом са стране. Требало би их користити у већини ситуација које захтевају поставку укључено/искључено. Погледајте одељак <link linkend="sec-checkbuttons">Дугме за потврду</link>.

note: (itstool) path: varlistentry/term
en: Radio buttons
sr: Радио дугмад

note: (itstool) path: listitem/para
en: Named after the station selectors on old car radios, these buttons are used in groups for options which are mutually exclusive. Pressing one causes all the others in its group to turn off. They are similar to ToggleButtons or CheckButtons (a small widget with a label at the side), but usually look different. There is no separate radio button class. Check buttons and toggle buttons can act as radio buttons. See the <link linkend="sec-radio-buttons">Radio Button</link> section.
sr: Названа по бирачима станица на старим ауто-радио апаратима, ова дугмад се користе у групама за опције које се међусобно искључују. Притисак на једно доводи до тога да се сва остала у његовој групи искључе. Слична су прекидачким дугмадима или дугмадима за потврду (мали елемент са натписом са стране), али обично изгледају другачије. Не постоји посебна класа радио дугмета. Дугмад за потврду и прекидачка дугмад могу деловати као радио дугмад. Погледајте одељак <link linkend="sec-radio-buttons">Радио дугме</link>.

note: (itstool) path: chapter/para
en: Note that, due to GTK's theming system, the appearance of these widgets will vary. In the case of check buttons and radio buttons, they may vary considerably.
sr: Имајте на уму да ће, због ГТК-овог система тема, изглед ових елемената варирати. У случају дугмади за потврду и радио дугмади, они могу значајно варирати.

note: (itstool) path: section/title
en: Button
sr: Дугме

note: (itstool) path: section/para
en: There are two ways to create a Button. You can specify a label string in the <classname>Gtk::Button</classname> constructor, or set it later with <methodname>set_label()</methodname>.
sr: Постоје два начина за прављење дугмета. Можете навести ниску натписа у <classname>Gtk::Button</classname> конструктору, или је поставити касније помоћу <methodname>set_label()</methodname>.

note: (itstool) path: section/para
en: To define an accelerator key for keyboard navigation, place an underscore before one of the label's characters and specify <literal>true</literal> for the optional <literal>mnemonic</literal> parameter. For instance:
sr: Да бисте дефинисали тастер пречице за навигацију тастатуром, поставите доњу црту испред једног од знакова натписа и наведите <literal>true</literal> за опциони <literal>mnemonic</literal> параметар. На пример:

note: (itstool) path: section/para
en: <classname>Gtk::Button</classname> is also a container so you could put any other widget, such as a <classname>Gtk::Image</classname> into it.
sr: <classname>Gtk::Button</classname> је такође и контејнер, тако да у њега можете ставити било који други елемент, као што је <classname>Gtk::Image</classname>.

note: (itstool) path: section/para
en: The <classname>Gtk::Button</classname> widget has the <literal>clicked</literal> signal which is emitted when the button is pressed and released.
sr: Елемент <classname>Gtk::Button</classname> има сигнал <literal>clicked</literal> који се емитује када се дугме притисне и отпусти.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1Button.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1Button.html">Референца</link>

note: (itstool) path: section/title
en: Example
sr: Пример

note: (itstool) path: section/para
en: This example creates a button with a picture and a label.
sr: Овај пример прави дугме са сликом и натписом.

note: (itstool) path: figure/title
en: buttons example
sr: пример дугмића

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/buttons/button">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/buttons/button">Изворни код</link>

note: (itstool) path: section/title
en: ToggleButton
sr: Дугме за пребацивање

note: (itstool) path: section/para
en: <classname>ToggleButton</classname>s are like normal <classname>Button</classname>s, but when clicked they remain activated, or pressed, until clicked again.
sr: <classname>ToggleButton</classname> дугмад су као обична <classname>Button</classname> дугмад, али када се кликне на њих, она остају активирана, или притиснута, док се поново не кликне.

note: (itstool) path: section/para
en: To retrieve the state of the <classname>ToggleButton</classname>, you can use the <methodname>get_active()</methodname> method. This returns <literal>true</literal> if the button is "down". You can also set the toggle button's state, with <methodname>set_active()</methodname>. Note that, if you do this, and the state actually changes, it causes the "clicked" signal to be emitted. This is usually what you want.
sr: Да бисте добили стање <classname>ToggleButton</classname> дугмета, можете користити метод <methodname>get_active()</methodname>. Он враћа <literal>true</literal> ако је дугме „доле“. Такође можете поставити стање дугмета за пребацивање помоћу <methodname>set_active()</methodname>. Имајте на уму да, ако то урадите и стање се заиста промени, то узрокује емитовање сигнала „clicked“. Ово је обично оно што желите.

note: (itstool) path: section/para
en: You can use the <methodname>toggled()</methodname> method to toggle the button, rather than forcing it to be up or down: This switches the button's state, and causes the <literal>toggled</literal> signal to be emitted.
sr: Можете користити метод <methodname>toggled()</methodname> да пребаците стање дугмета, уместо да га присиљавате да буде горе или доле: ово мења стање дугмета и узрокује емитовање сигнала <literal>toggled</literal>.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1ToggleButton.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1ToggleButton.html">Референца</link>

note: (itstool) path: section/title (itstool) path: figure/title
en: CheckButton
sr: Дугме за штиклирање

note: (itstool) path: section/para
en: <classname>Gtk::CheckButton</classname> inherits directly from <classname>Gtk::Widget</classname>. It is similar to <classname>Gtk::ToggleButton</classname>. The only real difference between the two is <classname>Gtk::CheckButton</classname>'s appearance. You can check and set a check button using the same member methods as for <classname>Gtk::ToggleButton</classname>.
sr: <classname>Gtk::CheckButton</classname> наслеђује директно из <classname>Gtk::Widget</classname>. Слично је <classname>Gtk::ToggleButton</classname> дугмету. Једина стварна разлика између њих је изглед <classname>Gtk::CheckButton</classname> дугмета. Можете штиклирати и поставити дугме за штиклирање користећи исте методе чланове као и за <classname>Gtk::ToggleButton</classname>.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1CheckButton.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1CheckButton.html">Референца</link>

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/buttons/checkbutton">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/buttons/checkbutton">Изворни код</link>

note: (itstool) path: section/title
en: Radio Button
sr: Радио дугме

note: (itstool) path: section/para
en: There is no separate class for radio buttons. Check buttons and toggle buttons act as radio buttons when they form a group. Only one button in a group can be selected at any one time.
sr: Не постоји посебна класа за радио дугмад. Дугмад за штиклирање и дугмад за пребацивање се понашају као радио дугмад када формирају групу. Само једно дугме у групи може бити изабрано у било ком тренутку.

note: (itstool) path: section/title
en: Groups
sr: Групе

note: (itstool) path: section/para
en: You create the buttons, and set up their group afterwards. In the following example, we put 3 radio buttons in a group:
sr: Прво направите дугмад, а затим подесите њихову групу. У следећем примеру, ставићемо 3 радио дугмета у групу:

note: (itstool) path: section/para
en: We told <application>gtkmm</application> to put all three <classname>CheckButton</classname>s in the same group by using <methodname>set_group()</methodname> to tell the other <classname>CheckButton</classname>s to share group with the first <classname>CheckButton</classname>.
sr: Рекли смо <application>gtkmm</application>-у да стави сва три <classname>CheckButton</classname>-а у исту групу коришћењем методе <methodname>set_group()</methodname> како бисмо рекли осталим <classname>CheckButton</classname>-има да деле групу са првим <classname>CheckButton</classname>-ом.

note: (itstool) path: section/title
en: Methods
sr: Методе

note: (itstool) path: section/para
en: <classname>CheckButton</classname>s and <classname>ToggleButton</classname>s are "off" when created; this means that when you first make a group of them, they will all be off. Don't forget to turn one of them on using <methodname>set_active()</methodname>.
sr: <classname>CheckButton</classname> и <classname>ToggleButton</classname> дугмад су „искључена“ када се направе; то значи да ће сви бити искључени када први пут направите групу од њих. Не заборавите да укључите једно од њих користећи методу <methodname>set_active()</methodname>.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1RadioButton.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1RadioButton.html">Референца</link>

note: (itstool) path: section/para
en: The following example demonstrates the use of grouped <classname>CheckButton</classname>s:
sr: Следећи пример демонстрира употребу груписаних <classname>CheckButton</classname> дугмади:

note: (itstool) path: figure/title
en: RadioButton
sr: Радио дугме

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/buttons/radiobutton">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/buttons/radiobutton">Изворни ко̂д</link>

note: (itstool) path: chapter/title (itstool) path: figure/title
en: Range Widgets
sr: Елементи опсега

note: (itstool) path: chapter/para
en: <classname>Gtk::Scale</classname> inherits from <classname>Gtk::Range</classname>. <classname>Gtk::Scrollbar</classname> does not inherit from <classname>Gtk::Range</classname>, but it shares much functionality with <classname>Gtk::Scale</classname>. They both contain a "trough" and a "slider" (sometimes called a "thumbwheel" in other GUI environments). Dragging the slider with the pointer moves it within the trough, while clicking in the trough advances the slider towards the location of the click, either completely, or by a designated amount, depending on which mouse button is used. This should be familiar scrollbar behavior.
sr: <classname>Gtk::Scale</classname> наслеђује из <classname>Gtk::Range</classname>. <classname>Gtk::Scrollbar</classname> не наслеђује из <classname>Gtk::Range</classname>, али дели многе функционалности са <classname>Gtk::Scale</classname>. Оба садрже „удубљење“ и „клизач“ (који се понекад назива „точкић“ у другим ГУИ окружењима). Превлачење клизача показивачем помера га унутар удубљења, док кликање у удубљењу помера клизач према месту клика, било потпуно или за одређени износ, у зависности од тога који тастер миша се користи. Ово би требало да буде познато понашање траке клизача.

note: (itstool) path: chapter/para
en: As will be explained in the <link linkend="chapter-adjustment">Adjustments</link> section, all range widgets are associated with an <classname>Adjustment</classname> object. To change the lower, upper, and current values used by the widget you need to use the methods of its <classname>Adjustment</classname>, which you can get with the <methodname>get_adjustment()</methodname> method. The range widgets' default constructors create an <classname>Adjustment</classname> automatically, or you can specify an existing <classname>Adjustment</classname>, maybe to share it with another widget. See the <link linkend="chapter-adjustment">Adjustments</link> section for further details.
sr: Као што ће бити објашњено у одељку <link linkend="chapter-adjustment">Поправке</link>, сви елементи опсега су повезани са објектом <classname>Adjustment</classname>. Да бисте променили доњу, горњу и тренутну вредност коју користи елемент, морате користити методе његовог <classname>Adjustment</classname>-а, који можете добити методом <methodname>get_adjustment()</methodname>. Подразумевани конструктори елемената опсега аутоматски праве <classname>Adjustment</classname>, или можете навести постојећи <classname>Adjustment</classname>, можда да бисте га поделили са другим елементом. Погледајте одељку <link linkend="chapter-adjustment">Поправке</link> за више детаља.

note: (itstool) path: chapter/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1Range.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1Range.html">Референца</link>

note: (itstool) path: section/title
en: Scrollbar Widgets
sr: Елементи траке клизача

note: (itstool) path: section/para
en: These are standard scrollbars. They should be used only to scroll another widget, such as a <classname>Gtk::Entry</classname> or a <classname>Gtk::Viewport</classname>, though it's usually easier to use the <classname>Gtk::ScrolledWindow</classname> widget in most cases.
sr: Ово су стандардне траке клизача. Требало би их користити само за померање другог елемента, као што су <classname>Gtk::Entry</classname> или <classname>Gtk::Viewport</classname>, иако је обично лакше користити елемент <classname>Gtk::ScrolledWindow</classname> у већини случајева.

note: (itstool) path: section/para
en: The orientation of a <classname>Gtk::Scrollbar</classname> can be either horizontal or vertical.
sr: Усмерење <classname>Gtk::Scrollbar</classname>-а може бити или водоравно или усправно.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1Scrollbar.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1Scrollbar.html">Референца</link>

note: (itstool) path: section/title
en: Scale Widgets
sr: Елементи скале

note: (itstool) path: section/para
en: <classname>Gtk::Scale</classname> widgets (or "sliders") allow the user to visually select and manipulate a value within a specific range. You might use one, for instance, to adjust the magnification level on a zoomed preview of a picture, or to control the brightness of a colour, or to specify the number of minutes of inactivity before a screensaver takes over the screen.
sr: <classname>Gtk::Scale</classname> елементи (или „клизачи“) омогућавају кориснику да визуелно изабере и обради вредност унутар одређеног опсега. Можете користити један, на време, за подешавање нивоа увећања на умањеном прегледу слике, или за контролу осветљености боје, или за навођење броја минута неактивности пре него што чувар екрана преузме екран.

note: (itstool) path: section/para
en: As with <classname>Scrollbar</classname>s, the orientation can be either horizontal or vertical. The default constructor creates an <classname>Adjustment</classname> with all of its values set to <literal>0.0</literal>. This isn't useful so you will need to set some <classname>Adjustment</classname> details to get meaningful behavior.
sr: Као и код <classname>Scrollbar</classname>-а, усмерење може бити или водоравно или усправно. Подразумевани конструктор прави <classname>Adjustment</classname> са свим његовим вредностима постављеним на <literal>0.0</literal>. Ово није корисно, па ћете морати да подесите неке детаље <classname>Adjustment</classname>-а да бисте добили смислено понашање.

note: (itstool) path: section/title
en: Useful methods
sr: Корисне методе

note: (itstool) path: section/para
en: <classname>Scale</classname> widgets can display their current value as a number next to the trough. By default they show the value, but you can change this with the <methodname>set_draw_value()</methodname> method.
sr: Елементи <classname>Scale</classname> могу приказати своју тренутну вредност као број поред увале. Подразумевано приказују вредност, али то можете променити методом <methodname>set_draw_value()</methodname>.

note: (itstool) path: section/para
en: The value displayed by a scale widget is rounded to one decimal point by default, as is the <literal>value</literal> field in its <classname>Gtk::Adjustment</classname>. You can change this with the <methodname>set_digits()</methodname> method.
sr: Вредност коју приказује елемент размере је подразумевано заокружена на једну децималу, као и поље <literal>value</literal> у његовом <classname>Gtk::Adjustment</classname>-у. Ово можете променити методом <methodname>set_digits()</methodname>.

note: (itstool) path: section/para
en: Also, the value can be drawn in different positions relative to the trough, specified by the <methodname>set_value_pos()</methodname> method.
sr: Такође, вредност може бити исцртана на различитим положајима у односу на увалу, што се наводи методом <methodname>set_value_pos()</methodname>.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1Scale.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1Scale.html">Референце</link>

note: (itstool) path: section/para
en: This example displays a window with three range widgets all connected to the same adjustment, along with a couple of controls for adjusting some of the parameters mentioned above and in the section on adjustments, so you can see how they affect the way these widgets work for the user.
sr: Овај пример приказује прозор са три елемента опсега који су сви повезани на исту поправку, заједно са пар контрола за подешавање неких од горе поменутих параметара и у одељку о поправкама, тако да можете видети како они утичу на начин на који ови елементи раде за корисника.

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/range_widgets">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/range_widgets">Изворни код</link>

note: (itstool) path: chapter/title
en: Miscellaneous Widgets
sr: Разни елементи

note: (itstool) path: section/title (itstool) path: figure/title
en: Label
sr: Ознака

note: (itstool) path: section/para
en: Labels are the main method of placing non-editable text in windows, for instance to place a title next to an <classname>Entry</classname> widget. You can specify the text in the constructor, or later with the <methodname>set_text()</methodname> or <methodname>set_markup()</methodname> methods.
sr: Натписи су главни начин постављања неизмењивог текста у прозоре, на пример за постављање наслова поред елемента <classname>Entry</classname>. Текст можете навести у конструктору, или касније методама <methodname>set_text()</methodname> или <methodname>set_markup()</methodname>.

note: (itstool) path: section/para
en: The width of the label will be adjusted automatically. You can produce multi-line labels by putting line breaks ("\n") in the label string.
sr: Ширина натписа ће бити аутоматски прилагођена. Вишелинијске натписе можете направити стављањем прелома линија („\
    “) у ниску натписа.

note: (itstool) path: section/para
en: The label text can be justified using the <methodname>set_justify()</methodname> method. The widget is also capable of word-wrapping, which can be activated with <methodname>set_wrap()</methodname>.
sr: Текст натписа се може поравнати методом <methodname>set_justify()</methodname>. Елемент је такође способан за преламање речи, што се може активирати са <methodname>set_wrap()</methodname>.

note: (itstool) path: section/para
en: Gtk::Label supports some simple formatting, for instance allowing you to make some text bold, colored, or larger. You can do this by providing a string to <methodname>set_markup()</methodname>, using the <link xlink:href="https://docs.gtk.org/Pango/pango_markup.html">Pango Markup syntax</link>. For instance, <code> &lt;b&gt;bold text&lt;/b&gt; and &lt;s&gt;strikethrough text&lt;/s&gt; </code> .
sr: Gtk::Label подржава неко једноставно форматирање, на пример омогућавајући вам да неки текст учините подебљаним, обојеним или већим. То можете урадити достављањем ниске за <methodname>set_markup()</methodname>, користећи <link xlink:href="https://docs.gtk.org/Pango/pango_markup.html">синтаксу Панго означавања</link>. На пример, <code> &lt;b&gt;подебљан текст&lt;/b&gt; и &lt;s&gt;прецртан текст&lt;/s&gt; </code> .

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1Label.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1Label.html">Референце</link>

note: (itstool) path: section/para
en: Below is a short example to illustrate these functions. This example makes use of the Frame widget to better demonstrate the label styles. (The Frame widget is explained in the <link linkend="sec-frame">Frame</link> section.) It is possible that the first character in <literal>m_Label_Normal</literal> is shown underlined only when you press the <keycap>Alt</keycap> key.
sr: Испод је кратак пример који илуструје ове функције. Овај пример користи елемент Frame како би боље демонстрирао стилове натписа. (Елемент Frame је објашњен у одељку <link linkend="sec-frame">Frame</link>.) Могуће је да је први знак у <literal>m_Label_Normal</literal> приказан подвучено само када притиснете тастер <keycap>Alt</keycap>.

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/label">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/label">Изворни код</link>

note: (itstool) path: section/title (itstool) path: figure/title
en: Entry
sr: Унос

note: (itstool) path: section/title
en: Simple Use
sr: Једноставна употреба

note: (itstool) path: section/para
en: Entry widgets allow the user to enter text. You can change the contents with the <methodname>set_text()</methodname> method, and read the current contents with the <methodname>get_text()</methodname> method.
sr: Елементи уноса (Entry) омогућавају кориснику да унесе текст. Садржај можете променити методом <methodname>set_text()</methodname>, а прочитати тренутни садржај методом <methodname>get_text()</methodname>.

note: (itstool) path: section/para
en: Occasionally you might want to make an <classname>Entry</classname> widget read-only. This can be done by passing <literal>false</literal> to the <methodname>set_editable()</methodname> method.
sr: Повремено ћете можда желети да елемент <classname>Entry</classname> учините само за читање. Ово се може постићи прослеђивањем вредности <literal>false</literal> методу <methodname>set_editable()</methodname>.

note: (itstool) path: section/para
en: For the input of passwords, passphrases and other information you don't want echoed on the screen, calling <methodname>set_visibility()</methodname> with <literal>false</literal> will cause the text to be hidden.
sr: За унос лозинки, фраза и других података које не желите да буду приказани на екрану, позивање метода <methodname>set_visibility()</methodname> са вредношћу <literal>false</literal> ће довести до скривања текста.

note: (itstool) path: section/para
en: You might want to be notified whenever the user types in a text entry widget. <classname>Gtk::Entry</classname> provides two signals, <literal>activate</literal> (since <application>gtkmm</application> 4.8) and <literal>changed</literal>, for this purpose. <literal>activate</literal> is emitted when the user presses the <keycap>Enter</keycap> key in a text-entry widget; <literal>changed</literal> is emitted when the text in the widget changes. You can use these, for instance, to validate or filter the text the user types. Moving the keyboard focus to another widget may also signal that the user has finished entering text. The <literal>leave</literal> signal in a <classname>Gtk::EventControllerFocus</classname> can notify you when that happens. The <link linkend="sec-comboboxentry">ComboBox with an Entry</link> section contains example programs that use these signals.
sr: Можда ћете желети да будете обавештени кад год корисник куца у елементу за унос текста. <classname>Gtk::Entry</classname> пружа два сигнала, <literal>activate</literal> (од верзије <application>gtkmm</application> 4.8) и <literal>changed</literal>, за ову сврху. <literal>activate</literal> се емитује када корисник притисне тастер <keycap>Enter</keycap> у елементу за унос текста; <literal>changed</literal> се емитује када се текст у елементу промени. Ово можете користити, на пример, за проверу или филтрирање текста који корисник уноси. Померање фокуса тастатуре на други елемент такође може сигнализирати да је корисник завршио унос текста. Сигнал <literal>leave</literal> у <classname>Gtk::EventControllerFocus</classname> вас може обавестити када се то догоди. Одељак <link linkend="sec-comboboxentry">ComboBox са Entry-јем</link> садржи примере програма који користе ове сигнале.

note: (itstool) path: section/para
en: If you pass <literal>true</literal> to the <methodname>set_activates_default()</methodname> method, pressing <keycap>Enter</keycap> in the <classname>Gtk::Entry</classname> will activate the default widget for the window containing the <classname>Gtk::Entry</classname>. This is especially useful in dialog boxes. The default widget is usually one of the dialog buttons, which e.g. will close the dialog box. To set a widget as the default widget, use <methodname>Gtk::Window::set_default_widget()</methodname>.
sr: Ако проследите <literal>true</literal> методу <methodname>set_activates_default()</methodname>, притисак на <keycap>Enter</keycap> у <classname>Gtk::Entry</classname> ће активирати подразумевани елемент прозора који садржи <classname>Gtk::Entry</classname>. Ово је посебно корисно у прозорчићима. Подразумевани елемент је обично једно од дугмади прозорчића, које ће нпр. затворити прозорчић. Да бисте поставили елемент као подразумевани, користите <methodname>Gtk::Window::set_default_widget()</methodname>.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1Entry.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1Entry.html">Референце</link>

note: (itstool) path: section/title
en: Simple Entry Example
sr: Пример једноставног уноса

note: (itstool) path: section/para
en: This example uses <classname>Gtk::Entry</classname>. It also has two <classname>CheckButton</classname>s, with which you can toggle the editable and visible flags.
sr: Овај пример користи <classname>Gtk::Entry</classname>. Такође има два <classname>CheckButton</classname>-а, помоћу којих можете мењати заставице за измењивост и видљивост.

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/entry/simple">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/entry/simple">Изворни код</link>

note: (itstool) path: section/title (itstool) path: figure/title
en: Entry Completion
sr: Довршавање уноса

note: (itstool) path: note/para
en: <classname>Gtk::EntryCompletion</classname> is deprecated since <application>gtkmm</application> 4.10. There is no replacement in <application>gtkmm</application>.
sr: <classname>Gtk::EntryCompletion</classname> је превазиђен од верзије <application>gtkmm</application> 4.10. Нема замене у <application>gtkmm</application>.

note: (itstool) path: section/para
en: An <classname>Entry</classname> widget can offer a drop-down list of pre-existing choices based on the first few characters typed by the user. For instance, a search dialog could suggest text from previous searches.
sr: Елемент <classname>Entry</classname> може понудити падајућу листу постојећих избора на основу првих неколико знакова које је корисник укуцао. На пример, прозорче за претрагу би могло да предложи текст из претходних претрага.

note: (itstool) path: section/para
en: To enable this functionality, you must create an <classname>EntryCompletion</classname> object, and provide it to the <classname>Entry</classname> widget via the <methodname>set_completion()</methodname> method.
sr: Да бисте омогућили ову функционалност, морате креирати објекат <classname>EntryCompletion</classname> и обезбедити га елементу <classname>Entry</classname> путем метода <methodname>set_completion()</methodname>.

note: (itstool) path: section/para
en: The <classname>EntryCompletion</classname> may use a <classname>TreeModel</classname> containing possible entries, specified with <methodname>set_model()</methodname>. You should then call <methodname>set_text_column()</methodname> to specify which of your model columns should be used to match possible text entries.
sr: <classname>EntryCompletion</classname> може користити <classname>TreeModel</classname> који садржи могуће уносе, одређене помоћу <methodname>set_model()</methodname>. Затим треба да позовете <methodname>set_text_column()</methodname> да бисте навели која од колона вашег модела треба да се користи за подударање могућих текстуалних уноса.

note: (itstool) path: section/para
en: Alternatively, if a complete list of possible entries would be too large or too inconvenient to generate, a callback slot may instead be specified with <methodname>set_match_func()</methodname>. This is also useful if you wish to match on a part of the string other than the start.
sr: Алтернативно, ако би потпуна листа могућих уноса била превелика или незгодна за генерисање, уместо тога се може навести слот повратног позива помоћу <methodname>set_match_func()</methodname>. Ово је такође корисно ако желите да извршите подударање на делу ниске који није почетак.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1EntryCompletion.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1EntryCompletion.html">Референце</link>

note: (itstool) path: section/title
en: Entry Completion Example
sr: Пример довршавања уноса

note: (itstool) path: section/para
en: This example creates a <classname>Gtk::EntryCompletion</classname> and associates it with a <classname>Gtk::Entry</classname> widget. The completion uses a <classname>Gtk::TreeModel</classname> of possible entries, and some additional actions.
sr: Овај пример прави <classname>Gtk::EntryCompletion</classname> и придружује га елементу <classname>Gtk::Entry</classname>. Довршавање користи <classname>Gtk::TreeModel</classname> могућих уноса, и неке додатне радње.

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/entry/completion">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/entry/completion">Изворни ко̂д</link>

note: (itstool) path: section/title
en: Entry Icons
sr: Иконице уноса

note: (itstool) path: section/para
en: An <classname>Entry</classname> widget can show an icon at the start or end of the text area. The icon can be specified by methods such as <methodname>set_icon_from_paintable()</methodname> or <methodname>set_icon_from_icon_name()</methodname>. An application can respond to the user pressing the icon by handling the <methodname>signal_icon_press</methodname> signal.
sr: Елемент <classname>Entry</classname> може приказати иконицу на почетку или на крају текстуалне области. Иконица се може навести методама као што су <methodname>set_icon_from_paintable()</methodname> или <methodname>set_icon_from_icon_name()</methodname>. Програм може одговорити на корисниково притискање иконице руковањем сигналом <methodname>signal_icon_press</methodname>.

note: (itstool) path: section/title
en: Entry Icon Example
sr: Пример иконице уноса

note: (itstool) path: section/para
en: This example shows a <classname>Gtk::Entry</classname> widget with a named search icon, and prints text to the terminal when the icon is pressed.
sr: Овај пример приказује елемент <classname>Gtk::Entry</classname> са именованом иконицом претраге, и исписује текст у терминалу када се притисне иконица.

note: (itstool) path: figure/title
en: Entry with Icon
sr: Унос са иконицом

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/entry/icon">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/entry/icon">Изворни ко̂д</link>

note: (itstool) path: section/title
en: Entry Progress
sr: Напредак уноса

note: (itstool) path: section/para
en: An <classname>Entry</classname> widget can show a progress bar inside the text area, under the entered text. The progress bar will be shown if the <methodname>set_progress_fraction()</methodname> or <methodname>set_progress_pulse_step()</methodname> methods are called.
sr: Елемент <classname>Entry</classname> може приказати траку напретка унутар текстуалне области, испод унетог текста. Трака напретка ће бити приказана ако се позову методе <methodname>set_progress_fraction()</methodname> или <methodname>set_progress_pulse_step()</methodname>.

note: (itstool) path: section/title
en: Entry Progress Example
sr: Пример напретка уноса

note: (itstool) path: section/para
en: This example shows a <classname>Gtk::Entry</classname> widget with a progress bar.
sr: Овај пример приказује елемент <classname>Gtk::Entry</classname> са траком напретка.

note: (itstool) path: figure/title
en: Entry with Progress Bar
sr: Унос са траком напретка

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/entry/progress">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/entry/progress">Изворни ко̂д</link>

note: (itstool) path: section/title (itstool) path: figure/title
en: SpinButton
sr: Вртеће дугме

note: (itstool) path: section/para
en: A <classname>SpinButton</classname> allows the user to select a value from a range of numeric values. It has an <classname>Entry</classname> widget with increment and decrement buttons at the side. Clicking the buttons causes the value to 'spin' up and down across the range of possible values. The <classname>Entry</classname> widget may also be used to enter a value directly.
sr: <classname>SpinButton</classname> омогућава кориснику да изабере вредност из опсега бројчаних вредности. Садржи елемент <classname>Entry</classname> са дугмићима за повећање и смањење са стране. Кликање на дугмиће доводи до тога да вредност „вррти“ горе-доле кроз опсег могућих вредности. Елемент <classname>Entry</classname> се такође може користити за директан унос вредности.

note: (itstool) path: section/para
en: The value can have an adjustable number of decimal places, and the step size is configurable. <classname>SpinButton</classname>s have an 'auto-repeat' feature as well: holding down the increment or decrement button can optionally cause the value to change more quickly the longer the button is held down.
sr: Вредност може имати подесив број децималних места, а величина корака се може подесити. <classname>SpinButton</classname> дугмићи имају и функцију „самопонављања“: држање притиснутог дугмета за повећање или смањење може опционално довести до тога да се вредност мења брже што се дугме дуже држи.

note: (itstool) path: listitem/para
en: <literal>value</literal>: value for the Spin Button
sr: <literal>value</literal>: вредност за вртеће дугме

note: (itstool) path: listitem/para
en: <literal>lower</literal>: lower range value
sr: <literal>lower</literal>: доња вредност опсега

note: (itstool) path: listitem/para
en: <literal>upper</literal>: upper range value
sr: <literal>upper</literal>: горња вредност опсега

note: (itstool) path: listitem/para
en: <literal>step_increment</literal>: value to increment/decrement when pressing mouse button 1
sr: <literal>step_increment</literal>: вредност за повећање/смањење при притиску на 1. тастер миша

note: (itstool) path: listitem/para
en: <literal>page_increment</literal>: value to increment/decrement when pressing mouse button 2
sr: <literal>page_increment</literal>: вредност за повећање/смањење при притиску на 2. тастер миша

note: (itstool) path: listitem/para
en: <literal>page_size</literal>: unused
sr: <literal>page_size</literal>: некоришћено

note: (itstool) path: section/para
en: <classname>SpinButton</classname>s use an <link linkend="chapter-adjustment">Adjustment</link> object to hold information about the range of values. These Adjustment attributes are used by the Spin Button like so: <_:itemizedlist-1/>
sr: <classname>SpinButton</classname> дугмад користе објекат <link linkend="chapter-adjustment">Adjustment</link> за чување података о опсегу вредности. Ове особине подешавања користи вртеће дугме на следећи начин: <_:itemizedlist-1/>

note: (itstool) path: section/para
en: Additionally, mouse button 3 can be used to jump directly to the <literal>upper</literal> or <literal>lower</literal> values.
sr: Додатно, 3. тастер миша се може користити за директан скок на <literal>upper</literal> или <literal>lower</literal> вредности.

note: (itstool) path: section/para
en: The <classname>SpinButton</classname> can create a default <classname>Adjustment</classname>, which you can access via the <methodname>get_adjustment()</methodname> method, or you can specify an existing <classname>Adjustment</classname> in the constructor.
sr: <classname>SpinButton</classname> може да направи подразумевани <classname>Adjustment</classname>, коме можете приступити путем методе <methodname>get_adjustment()</methodname>, или можете навести постојећи <classname>Adjustment</classname> у конструктору.

note: (itstool) path: section/para
en: The number of decimal places can be altered using the <methodname>set_digits()</methodname> method.
sr: Број децималних места се може изменити коришћењем методе <methodname>set_digits()</methodname>.

note: (itstool) path: section/para
en: You can set the spinbutton's value using the <methodname>set_value()</methodname> method, and retrieve it with <methodname>get_value()</methodname>.
sr: Можете поставити вредност вртећег дугмета коришћењем методе <methodname>set_value()</methodname>, и добавити је помоћу <methodname>get_value()</methodname>.

note: (itstool) path: section/para
en: The <methodname>spin()</methodname> method 'spins' the <classname>SpinButton</classname>, as if its increment or decrement button had been clicked. You need to specify a <classname>Gtk::SpinType</classname> to specify the direction or new position.
sr: Метода <methodname>spin()</methodname> „врти“ <classname>SpinButton</classname>, као да је кликнуто на његово дугме за повећање или смањење. Треба да наведете <classname>Gtk::SpinType</classname> да бисте одредили смер или нови положај.

note: (itstool) path: section/para
en: To prevent the user from typing non-numeric characters into the entry box, pass <literal>true</literal> to the <methodname>set_numeric()</methodname> method.
sr: Да бисте спречили корисника да уноси небројевне знакове у поље за унос, проследите <literal>true</literal> методи <methodname>set_numeric()</methodname>.

note: (itstool) path: section/para
en: To make the <classname>SpinButton</classname> 'wrap' between its upper and lower bounds, use the <methodname>set_wrap()</methodname> method.
sr: Да би се <classname>SpinButton</classname> „премотавао“ између својих горњих и доњих граница, користите методу <methodname>set_wrap()</methodname>.

note: (itstool) path: section/para
en: To force it to snap to the nearest <literal>step_increment</literal>, use <methodname>set_snap_to_ticks()</methodname>.
sr: Да бисте га приморали да се прилепи на најближи <literal>step_increment</literal>, користите <methodname>set_snap_to_ticks()</methodname>.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1SpinButton.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1SpinButton.html">Референце</link>

note: (itstool) path: section/para
en: Here's an example of a <classname>SpinButton</classname> in action:
sr: Ево примера <classname>SpinButton</classname> дугмета на делу:

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/spinbutton">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/spinbutton">Изворни код</link>

note: (itstool) path: section/title (itstool) path: figure/title
en: ProgressBar
sr: Трака напретка

note: (itstool) path: section/para
en: Progress bars are used to show the status of an ongoing operation. For instance, a <classname>ProgressBar</classname> can show how much of a task has been completed.
sr: Траке напретка се користе за приказ стања текуће радње. На пример, <classname>ProgressBar</classname> може показати колики део задатка је завршен.

note: (itstool) path: section/para
en: To change the value shown, use the <methodname>set_fraction()</methodname> method, passing a <type>double</type> between 0.0 and 1.0 to provide the new fraction.
sr: Да бисте променили приказану вредност, користите метод <methodname>set_fraction()</methodname>, прослеђујући <type>double</type> између 0.0 и 1.0 да бисте поставили нови део.

note: (itstool) path: section/para
en: A <classname>ProgressBar</classname> is horizontal and left-to-right by default, but you can change it to a vertical progress bar by using the <methodname>set_orientation()</methodname> method.
sr: <classname>ProgressBar</classname> је водораван и слева надесно по подразумеваним поставкама, али га можете променити у усправну траку напретка коришћењем метода <methodname>set_orientation()</methodname>.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1ProgressBar.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1ProgressBar.html">Референца</link>

note: (itstool) path: section/title
en: Activity Mode
sr: Режим активности

note: (itstool) path: section/para
en: Besides indicating the amount of progress that has occurred, the progress bar can also be used to indicate that there is some activity; this is done by placing the progress bar in <emphasis>activity mode</emphasis>. In this mode, the progress bar displays a small rectangle which moves back and forth. Activity mode is useful in situations where the progress of an operation cannot be calculated as a value range (e.g., receiving a file of unknown length).
sr: Осим што указује на количину напретка који се догодио, трака напретка се такође може користити да укаже на то да постоји нека активност; то се ради постављањем траке напретка у <emphasis>режим активности</emphasis>. У овом режиму, трака напретка приказује мали правоугаоник који се креће напред-назад. Режим активности је користан у ситуацијама када се напредак радње не може израчунати као опсег вредности (нпр. примање датотеке непознате дужине).

note: (itstool) path: section/para
en: To do this, you need to call the <methodname>pulse()</methodname> method at regular intervals. You can also choose the step size, with the <methodname>set_pulse_step()</methodname> method.
sr: Да бисте то урадили, потребно је да позовете метод <methodname>pulse()</methodname> у редовним интервалима. Такође можете изабрати величину корака помоћу метода <methodname>set_pulse_step()</methodname>.

note: (itstool) path: section/para
en: The progress bar can also display a configurable text string next to the bar, using the <methodname>set_text()</methodname> method.
sr: Трака напретка такође може приказати подесиву ниску текста поред траке, коришћењем метода <methodname>set_text()</methodname>.

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/progressbar">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/progressbar">Изворни код</link>

note: (itstool) path: section/title (itstool) path: figure/title
en: InfoBar
sr: Трака обавештења

note: (itstool) path: section/para
en: An <classname>InfoBar</classname> may show small items of information or ask brief questions. Unlike a <classname>Dialog</classname>, it appears at the top of the current window instead of opening a new window. Its API is very similar to the <link linkend="chapter-dialogs">Gtk::Dialog</link> API.
sr: <classname>InfoBar</classname> може приказати мале ставке информација или поставити кратка питања. За разлику од <classname>Dialog</classname>-а, појављује се на врху тренутног прозора уместо да отвара нови прозор. Његов АПИ је врло сличан <link linkend="chapter-dialogs">Gtk::Dialog</link> АПИ-ју.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1InfoBar.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1InfoBar.html">Референца</link>

note: (itstool) path: section/para
en: The <classname>InfoBar</classname> widget is deprecated since <application>gtkmm</application> 4.10. The example shows an info bar consisting of a <classname>Box</classname> with a <classname>Label</classname> and a <classname>Button</classname>.
sr: Елемент <classname>InfoBar</classname> је превазиђен почев од <application>gtkmm</application> 4.10. Пример приказује траку обавештења која се састоји од <classname>Box</classname>-а са <classname>Label</classname>-ом и <classname>Button</classname>-ом.

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/infobar">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/infobar">Изворни код</link>

note: (itstool) path: section/title
en: Tooltips
sr: Облачићи

note: (itstool) path: section/para
en: Tooltips are the little information windows that pop up when you leave your pointer over a widget for a few seconds. Use <methodname>set_tooltip_text()</methodname> to set a text string as a tooltip on any <classname>Widget</classname>. <classname>Gtk::Tooltip</classname> is used for more advanced tooltip usage, such as showing an image as well as text.
sr: Облачићи су мали прозори са информацијама који искачу када оставите показивач изнад елемента на неколико секунди. Користите <methodname>set_tooltip_text()</methodname> да поставите ниску текста као облачић на било ком <classname>Widget</classname>-у. <classname>Gtk::Tooltip</classname> се користи за напредније коришћење облачића, као што је приказивање слике поред текста.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1Widget.html">Widget Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1Widget.html">Референца елемента</link>

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1Tooltip.html">Tooltip Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1Tooltip.html">Референца облачића</link>

note: (itstool) path: figure/title
en: Tooltip
sr: Облачић

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/tooltips">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/tooltips">Изворни код</link>

note: (itstool) path: chapter/title
en: Container Widgets
sr: Елементи контејнери

note: (itstool) path: chapter/para
en: Container widgets, like other widgets, derive from <classname>Gtk::Widget</classname>. Some container widgets, such as <classname>Gtk::Grid</classname> can hold many child widgets, so these typically have more complex interfaces. Others, such as <classname>Gtk::Frame</classname> contain only one child widget.
sr: Елементи контејнери, као и други елементи, потичу из <classname>Gtk::Widget</classname>-а. Неки елементи контејнери, као што је <classname>Gtk::Grid</classname>, могу да садрже много садржаних елемената, па они обично имају сложенија прочеља. Други, као што је <classname>Gtk::Frame</classname>, садрже само један садржани елемент.

note: (itstool) path: section/title
en: Single-item Containers
sr: Контејнери са једном ставком

note: (itstool) path: section/para
en: Most single-item container widgets have <methodname>set_child()</methodname> and <methodname>unset_child()</methodname> methods for the child widget. <classname>Gtk::Button</classname> and <classname>Gtk::Window</classname> are technically single-item containers, but we have discussed them already elsewhere.
sr: Већина елемената контејнера са једном ставком имају методе <methodname>set_child()</methodname> и <methodname>unset_child()</methodname> за садржани елемент. <classname>Gtk::Button</classname> и <classname>Gtk::Window</classname> су технички контејнери са једном ставком, али смо о њима већ расправљали на другим местима.

note: (itstool) path: section/para
en: We also discuss the <classname>Gtk::Paned</classname> widget, which allows you to divide a window into two separate "panes". This widget actually contains two child widgets, but the number is fixed so it seems appropriate.
sr: Такође ћемо расправљати о елементу <classname>Gtk::Paned</classname>, који вам омогућава да поделите прозор на две засебне „површи“. Овај елемент заправо садржи два садржана елемента, али је број фиксан па се чини прикладним.

note: (itstool) path: section/title (itstool) path: figure/title
en: Frame
sr: Оквир

note: (itstool) path: section/para
en: Frames can enclose one or a group of widgets within a box, optionally with a title. For instance, you might place a group of <classname>ToggleButton</classname>s or <classname>CheckButton</classname>s in a <classname>Frame</classname>.
sr: Оквири могу да окруже један или групу елемената унутар кутије, опционално са насловом. На пример, можете поставити групу <classname>ToggleButton</classname>-а или <classname>CheckButton</classname>-а у <classname>Frame</classname>.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1Frame.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1Frame.html">Референца</link>

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/frame">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/frame">Изворни код</link>

note: (itstool) path: section/title (itstool) path: figure/title
en: Paned
sr: Површи

note: (itstool) path: section/para
en: Panes divide a widget into two halves, separated by a moveable divider. The two halves (panes) can be oriented either horizontally (side by side) or vertically (one above the other).
sr: Површи деле елемент на две половине, раздвојене покретним разделником. Две половине (површи) могу бити усмерене или водоравно (једна поред друге) или усправно (једна изнад друге).

note: (itstool) path: section/para
en: Unlike the other widgets in this section, pane widgets contain not one but two child widgets, one in each pane. Therefore, you should use <methodname>set_start_child()</methodname> and <methodname>set_end_child()</methodname> instead of a <methodname>set_child()</methodname> method.
sr: За разлику од других елемената у овом одељку, елементи са површима не садрже један већ два садржана елемента, по један у свакој површи. Због тога треба да користите <methodname>set_start_child()</methodname> и <methodname>set_end_child()</methodname> уместо методе <methodname>set_child()</methodname>.

note: (itstool) path: section/para
en: You can adjust the position of the divider using the <methodname>set_position()</methodname> method, and you will probably need to do so.
sr: Можете подесити положај разделника користећи методу <methodname>set_position()</methodname>, и вероватно ће вам то бити потребно.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1Paned.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1Paned.html">Референца</link>

[ctx: _]
note: (itstool) path: imageobject/imagedata This is a reference to an external file such as an image or video. When the file changes, the md5 hash will change to let you know you need to update your localized copy. The msgstr is not used at all. Set it to whatever you like once you have updated your copy 
en: external ref='figures/paned.png' md5='874e9d11227d6d10d2ab7cb0b04de32d'
sr: _:external ref='figures/paned.png' md5='874e9d11227d6d10d2ab7cb0b04de32d'

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/paned">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/paned">Изворни код</link>

note: (itstool) path: section/title (itstool) path: figure/title
en: ScrolledWindow
sr: Прозор са клизачима

note: (itstool) path: section/para
en: <classname>ScrolledWindow</classname> widgets create a scrollable area. You can insert any type of widget into a <classname>ScrolledWindow</classname>, and it will be accessible regardless of its size by using the scrollbars. Note that <classname>ScrolledWindow</classname> is not a <classname>Gtk::Window</classname> despite the slightly misleading name.
sr: <classname>ScrolledWindow</classname> елементи стварају област са клизачима. Можете уметнути било коју врсту елемента у <classname>ScrolledWindow</classname>, и он ће бити приступачан без обзира на његову величину коришћењем трака клизача. Имајте на уму да <classname>ScrolledWindow</classname> није <classname>Gtk::Window</classname> упркос мало обмањујућем називу.

note: (itstool) path: section/para
en: Scrolled windows have <emphasis>scrollbar policies</emphasis> which determine whether the <classname>Scrollbar</classname>s will be displayed. The policies can be set with the <methodname>set_policy()</methodname> method. The policy may be for instance <literal>Gtk::PolicyType::AUTOMATIC</literal> or <literal>Gtk::PolicyType::ALWAYS</literal>. <literal>Gtk::PolicyType::AUTOMATIC</literal> will cause the scrolled window to display the scrollbar only if the contained widget is larger than the visible area. <literal>Gtk::PolicyType::ALWAYS</literal> will cause the scrollbar to be displayed always.
sr: Прозори са клизачима имају <emphasis>смернице траке клизача</emphasis> које одређују да ли ће <classname>Scrollbar</classname> траке бити приказане. Смернице се могу поставити методом <methodname>set_policy()</methodname>. Смерница може бити на пример <literal>Gtk::PolicyType::AUTOMATIC</literal> или <literal>Gtk::PolicyType::ALWAYS</literal>. <literal>Gtk::PolicyType::AUTOMATIC</literal> ће довести до тога да прозор са клизачима прикаже траку клизача само ако је садржани елемент већи од видљиве области. <literal>Gtk::PolicyType::ALWAYS</literal> ће довести до тога да трака клизача увек буде приказана.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1ScrolledWindow.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1ScrolledWindow.html">Референца</link>

note: (itstool) path: section/para
en: Here is a simple example that packs 100 toggle buttons into a ScrolledWindow. Try resizing the window to see the scrollbars react.
sr: Ево једноставног примера који пакује 100 прекидачких дугмади у ScrolledWindow. Пробајте да промените величину прозора да видите како траке клизача реагују.

[ctx: _]
note: (itstool) path: imageobject/imagedata This is a reference to an external file such as an image or video. When the file changes, the md5 hash will change to let you know you need to update your localized copy. The msgstr is not used at all. Set it to whatever you like once you have updated your copy 
en: external ref='figures/scrolledwindow.png' md5='b99f195d17b39197af733087e0e69def'
sr: _:external ref='figures/scrolledwindow.png' md5='b99f195d17b39197af733087e0e69def'

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/scrolledwindow">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/scrolledwindow">Изворни код</link>

note: (itstool) path: section/title (itstool) path: figure/title
en: AspectFrame
sr: Оквир размере

note: (itstool) path: section/para
en: The <classname>AspectFrame</classname> widget looks like a <classname>Frame</classname> widget, but it also enforces the <emphasis>aspect ratio</emphasis> (the ratio of the width to the height) of the child widget, adding extra space if necessary. For instance, this would allow you to display a photograph without allowing the user to distort it horizontally or vertically while resizing.
sr: Елемент <classname>AspectFrame</classname> изгледа као <classname>Frame</classname> елемент, али такође намеће <emphasis>однос размере</emphasis> (однос ширине и висине) садржаног елемента, додајући додатни простор ако је потребно. На пример, ово би вам омогућило да прикажете фотографију без дозвољавања кориснику да је изобличи водоравно или усправно приликом промене величине.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1AspectFrame.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1AspectFrame.html">Референца</link>

note: (itstool) path: section/para
en: The following program uses a <classname>Gtk::AspectFrame</classname> to present a drawing area whose aspect ratio will always be 2:1, no matter how the user resizes the top-level window.
sr: Следећи програм користи <classname>Gtk::AspectFrame</classname> да представи област за цртање чији ће однос размере увек бити 2:1, без обзира на то како корисник мења величину прозора највишег нивоа.

[ctx: _]
note: (itstool) path: imageobject/imagedata This is a reference to an external file such as an image or video. When the file changes, the md5 hash will change to let you know you need to update your localized copy. The msgstr is not used at all. Set it to whatever you like once you have updated your copy 
en: external ref='figures/aspectframe.png' md5='9d8aac9521789ed27036a97a22fedece'
sr: _:external ref='figures/aspectframe.png' md5='9d8aac9521789ed27036a97a22fedece'

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/aspectframe">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/aspectframe">Изворни код</link>

note: (itstool) path: section/title
en: Other Single-item Containers
sr: Остали контејнери са једном ставком

note: (itstool) path: section/para
en: There are other single-item containers. See the reference documentation for a complete list. Here are links to some example programs that show containers, which are not mentioned elsewhere in this tutorial.
sr: Постоје и други контејнери са једном ставком. Погледајте референтну документацију за потпуни списак. Ево веза до неких примера програма који приказују контејнере који нису поменути на другим местима у овом упутству.

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/expander">Source Code, Expander</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/expander">Изворни код, разграник</link>

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/popover">Source Code, Popover</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/popover">Изворни код, искок</link>

note: (itstool) path: section/title
en: Multiple-item Containers
sr: Контејнери са више ставки

note: (itstool) path: section/para
en: Multiple-item container widgets have other methods than <methodname>set_child()</methodname> and <methodname>unset_child()</methodname>. Different containers can have different methods for adding and removing child widgets. For instance, <classname>Gtk::Box</classname> has <methodname>append()</methodname> and <methodname>remove()</methodname> as well as other methods. The <methodname>remove()</methodname> method for multiple-item containers takes an argument, specifying which widget to remove.
sr: Вишеструки контејнерски елементи имају и друге методе осим <methodname>set_child()</methodname> и <methodname>unset_child()</methodname>. Различити контејнери могу имати различите методе за додавање и уклањање садржаних елемената. На пример, <classname>Gtk::Box</classname> има <methodname>append()</methodname> и <methodname>remove()</methodname> као и друге методе. Метода <methodname>remove()</methodname> за вишеструке контејнере прима аргумент који одређује који елемент треба уклонити.

note: (itstool) path: section/title
en: Packing
sr: Паковање

note: (itstool) path: section/para
en: You've probably noticed that <application>gtkmm</application> windows seem "elastic" - they can usually be stretched in many different ways. This is due to the <emphasis>widget packing</emphasis> system.
sr: Вероватно сте приметили да <application>gtkmm</application> прозори изгледају „еластично“ – обично се могу развући на много различитих начина. То је захваљујући систему за <emphasis>паковање елемената</emphasis>.

note: (itstool) path: section/para
en: Many GUI toolkits require you to precisely place widgets in a window, using absolute positioning, often using a visual editor. This leads to several problems:
sr: Многи ГУИ скупови алата захтевају да прецизно поставите елементе у прозор користећи апсолутно позиционирање, често уз помоћ визуелног уређивача. То доводи до неколико проблема:

note: (itstool) path: listitem/para
en: The widgets don't rearrange themselves when the window is resized. Some widgets are hidden when the window is made smaller, and lots of useless space appears when the window is made larger.
sr: Елементи се не преуређују сами када се промени величина прозора. Неки елементи остају скривени када се прозор смањи, а појављује се много бескорисног простора када се прозор повећа.

note: (itstool) path: listitem/para
en: It's impossible to predict the amount of space necessary for text after it has been translated to other languages, or displayed in a different font. On Unix it is also impossible to anticipate the effects of every theme and window manager.
sr: Немогуће је предвидети количину простора неопходну за текст након што се преведе на друге језике или прикаже другачијим фонтом. На Јуниксу је такође немогуће предвидети ефекте сваке теме и управника прозора.

note: (itstool) path: listitem/para
en: Changing the layout of a window "on the fly", to make some extra widgets appear, for instance, is complex. It requires tedious recalculation of every widget's position.
sr: Промена распореда прозора „у ходу“, како би се на пример приказали неки додатни елементи, сложена је. Захтева заморно поновно израчунавање положаја сваког елемента.

note: (itstool) path: section/para
en: <application>gtkmm</application> uses the packing system to solve these problems. Rather than specifying the position and size of each widget in the window, you can arrange your widgets in rows, columns, and/or grids. <application>gtkmm</application> can size your window automatically, based on the sizes of the widgets it contains. And the sizes of the widgets are, in turn, determined by the amount of text they contain, or the minimum and maximum sizes that you specify, and/or how you have requested that the available space should be shared between sets of widgets. You can perfect your layout by specifying margins and centering values for each of your widgets. <application>gtkmm</application> then uses all this information to resize and reposition everything sensibly and smoothly when the user manipulates the window.
sr: <application>gtkmm</application> користи систем паковања како би решио ове проблеме. Уместо одређивања положаја и величине сваког елемента у прозору, своје елементе можете поређати у редове, колоне и/или мреже. <application>gtkmm</application> може аутоматски одредити величину вашег прозора на основу величина елемената које садржи. А величине елемената су, заузврат, одређене количином текста који садрже, или минималним и максималним величинама које одредите, и/или тиме како сте захтевали да се доступни простор подели између скупова елемената. Свој распоред можете усавршити одређивањем маргина и вредности центрирања за сваки од ваших елемената. <application>gtkmm</application> затим користи све ове информације како би разумно и глатко променио величину и положај свега када корисник манипулише прозором.

note: (itstool) path: section/para
en: <application>gtkmm</application> arranges widgets hierarchically, using <emphasis>containers</emphasis>. A container widget contains other widgets. Most <application>gtkmm</application> widgets are containers. Windows, Notebook tabs, and Buttons are all container widgets. There are two flavors of containers: single-child containers and multiple-child containers. Most container widgets in <application>gtkmm</application> are single-child containers, including <classname>Gtk::Window</classname>.
sr: <application>gtkmm</application> распоређује елементе хијерархијски, користећи <emphasis>контејнере</emphasis>. Контејнерски елемент садржи друге елементе. Већина <application>gtkmm</application> елемената су контејнери. Прозори, језичци бележнице и дугмад су сви контејнерски елементи. Постоје две врсте контејнера: контејнери са једним садржаним елементом и контејнери са више садржаних елемената. Већина контејнерских елемената у <application>gtkmm</application>-у су контејнери са једним садржаним елементом, укључујући <classname>Gtk::Window</classname>.

note: (itstool) path: section/para
en: Yes, that's correct: a Window can contain at most one widget. How, then, can we use a window for anything useful? By placing a multiple-child container in the window. The most useful container widgets are <classname>Gtk::Grid</classname> and <classname>Gtk::Box</classname>.
sr: Да, то је тачно: прозор може да садржи највише један елемент. Како онда можемо користити прозор за било шта корисно? Постављањем контејнера са више садржаних елемената у прозор. Најкориснији контејнерски елементи су <classname>Gtk::Grid</classname> и <classname>Gtk::Box</classname>.

note: (itstool) path: listitem/para
en: <classname>Gtk::Grid</classname> arranges its child widgets in rows and columns. Use <methodname>attach()</methodname> and <methodname>attach_next_to()</methodname> to insert child widgets.
sr: <classname>Gtk::Grid</classname> распоређује своје садржане елементе у редове и колоне. Користите <methodname>attach()</methodname> и <methodname>attach_next_to()</methodname> за уметање садржаних елемената.

note: (itstool) path: listitem/para
en: <classname>Gtk::Box</classname> arranges its child widgets vertically or horizontally. Use <methodname>append()</methodname> to insert child widgets.
sr: <classname>Gtk::Box</classname> распоређује своје садржане елементе усправно или водоравно. Користите <methodname>append()</methodname> за уметање садржаних елемената.

note: (itstool) path: section/para
en: There are several other containers, which we will also discuss.
sr: Постоји још неколико контејнера о којима ћемо такође расправљати.

note: (itstool) path: section/para
en: If you've never used a packing toolkit before, it can take some getting used to. You'll probably find, however, that you don't need to rely on visual form editors quite as much as you might with other toolkits.
sr: Ако никада раније нисте користили скуп алата са паковањем, може бити потребно неко време да се навикнете. Вероватно ћете ипак открити да не морате толико да се ослањате на визуелне уређиваче образаца као што бисте то чинили са другим скуповима алата.

note: (itstool) path: section/title
en: An improved Hello World
sr: Побољшани „Здраво свете“

note: (itstool) path: section/para
en: Let's take a look at a slightly improved <literal>helloworld</literal>, showing what we've learnt.
sr: Погледајмо мало побољшани <literal>helloworld</literal>, који показује шта смо научили.

note: (itstool) path: figure/title
en: Hello World 2
sr: Здраво свете 2

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/helloworld2">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/helloworld2">Изворни ко̂д</link>

note: (itstool) path: section/para
en: After building and running this program, try resizing the window to see the behavior. Also, try playing with <methodname>set_expand()</methodname>, <methodname>set_hexpand()</methodname>, <methodname>set_vexpand()</methodname>, <methodname>set_halign()</methodname> and <methodname>set_valign()</methodname> while reading the <link linkend="sec-boxes">Boxes</link> section.
sr: Након изградње и покретања овог програма, покушајте да промените величину прозора како бисте видели понашање. Такође, покушајте да се играте са <methodname>set_expand()</methodname>, <methodname>set_hexpand()</methodname>, <methodname>set_vexpand()</methodname>, <methodname>set_halign()</methodname> и <methodname>set_valign()</methodname> док читате одељак <link linkend="sec-boxes">Кутије</link>.

note: (itstool) path: section/title
en: Boxes
sr: Кутије

note: (itstool) path: section/para
en: Most packing uses boxes as in the above example. These are invisible containers into which we can pack our widgets. When packing widgets into a horizontal box, the objects are inserted horizontally from left to right. In a vertical box, widgets are packed from top to bottom. You may use any combination of boxes inside or beside other boxes to create the desired effect.
sr: Већина паковања користи кутије као у горњем примеру. То су невидљиви контејнери у које можемо паковати наше елементе. Приликом паковања елемената у водоравну кутију, објекти се умећу водоравно слева надесно. У усправној кутији, елементи се пакују одозго надоле. Можете користити било коју комбинацију кутија унутар или поред других кутија како бисте постигли жељени ефекат.

note: (itstool) path: section/title
en: Adding widgets
sr: Додавање елемената

note: (itstool) path: section/title
en: Per-child packing options
sr: Опције паковања по елементу

note: (itstool) path: section/para
en: The <methodname>append()</methodname> method places widgets inside these containers. It will start at the top and work its way down in a <classname>Box</classname> with vertical orientation, or pack left to right in a <classname>Box</classname> with horizontal orientation. If it's inconvenient to add widgets in this order, use <methodname>insert_child_after()</methodname> or <methodname>insert_child_at_start()</methodname>. We will use <methodname>append()</methodname> in our examples.
sr: Метод <methodname>append()</methodname> смешта елементе унутар ових контејнера. Почеће од врха и ићи надоле у <classname>Box</classname> објекту са усправним усмерењем, или паковати слева надесно у <classname>Box</classname> објекту са водоравним усмерењем. Ако је незгодно додавати елементе овим редом, користите <methodname>insert_child_after()</methodname> или <methodname>insert_child_at_start()</methodname>. Ми ћемо користити <methodname>append()</methodname> у нашим примерима.

note: (itstool) path: section/para
en: There are several options governing how widgets are to be packed, and this can be confusing at first. You can modify the packing by using <methodname>set_expand()</methodname>, <methodname>set_hexpand()</methodname>, <methodname>set_vexpand()</methodname>, <methodname>set_halign()</methodname>, <methodname>set_valign()</methodname> and/or <methodname>set_margin()</methodname> on the child widgets. If you have difficulties, then it is sometimes a good idea to play with the <application>Cambalache</application> GUI designer to see what is possible. You can then use the <classname>Gtk::Builder</classname> API to load your GUI at runtime.
sr: Постоји неколико опција које одређују како ће елементи бити спаковани, што у почетку може бити збуњујуће. Можете изменити паковање користећи <methodname>set_expand()</methodname>, <methodname>set_hexpand()</methodname>, <methodname>set_vexpand()</methodname>, <methodname>set_halign()</methodname>, <methodname>set_valign()</methodname> и/или <methodname>set_margin()</methodname> на садржаним елементима. Ако имате потешкоћа, понекад је добра идеја поиграти се са <application>Cambalache</application> дизајнером графичког прочеља како бисте видели шта је све могуће. Потом можете користити <classname>Gtk::Builder</classname> АПИ за учитавање вашег графичког прочеља у време извршавања.

note: (itstool) path: section/para
en: There are basically five different styles, as shown in this picture:
sr: У основи постоји пет различитих стилова, као што је приказано на овој слици:

note: (itstool) path: figure/title
en: Box Packing 1
sr: Паковање кутија 1

note: (itstool) path: section/para
en: Each line contains one horizontal <classname>Box</classname> with several buttons. Each of the buttons on a line is packed into the <classname>Box</classname> with the same arguments to the <methodname>set_hexpand()</methodname>, <methodname>set_halign()</methodname>, <methodname>set_margin_start()</methodname> and <methodname>set_margin_end()</methodname> methods.
sr: Сваки ред садржи једну водоравну <classname>Box</classname> кутију са неколико дугмића. Свако дугме у реду је спаковано у <classname>Box</classname> кутију са истим аргументима за методе <methodname>set_hexpand()</methodname>, <methodname>set_halign()</methodname>, <methodname>set_margin_start()</methodname> и <methodname>set_margin_end()</methodname>.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1Box.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1Box.html">Референца</link>

note: (itstool) path: section/title
en: Per-container packing options
sr: Опције паковања по контејнеру

note: (itstool) path: section/para
en: Here's the constructor for the <classname>Box</classname> widget, and methods that set per-container packing options:
sr: Ево конструктора за <classname>Box</classname> елемент, као и метода за постављање опција паковања по контејнеру:

note: (itstool) path: section/para
en: Passing <literal>true</literal> to <methodname>set_homogeneous()</methodname> will cause all of the contained widgets to be the same size. <parameter>spacing</parameter> is a (minimum) number of pixels to leave between each widget.
sr: Прослеђивање вредности <literal>true</literal> методу <methodname>set_homogeneous()</methodname> ће проузроковати да сви садржани елементи буду исте величине. <parameter>spacing</parameter> је (најмањи) број пиксела који се оставља између сваког елемента.

note: (itstool) path: section/para
en: What's the difference between spacing (set when the box is created) and margins (set separately for each child widget)? Spacing is added between objects, and margins are added on one or more sides of a widget. The following figure should make it clearer. The shown margins are the left and right margins of each button in the row.
sr: Која је разлика између размака (поставља се при стварању кутије) и маргина (постављају се посебно за сваки садржани елемент)? Размак се додаје између објеката, а маргине се додају на једну или више страна елемента. Следећа фигура би то требала разјаснити. Приказане маргине су лева и десна маргина сваког дугмета у реду.

note: (itstool) path: figure/title
en: Box Packing 2
sr: Паковање кутија 2

note: (itstool) path: section/title
en: Gtk::Application and command-line options
sr: Gtk::Application и опције командне линије

note: (itstool) path: section/para
en: The following example program requires a command-line option. The source code shows two ways of handling command-line options in combination with <classname>Gtk::Application</classname>.
sr: Следећи пример програма захтева опцију командне линије. Изворни ко̂д приказује два начина руковања опцијама командне линије у комбинацији са <classname>Gtk::Application</classname>.

note: (itstool) path: listitem/para
en: Handle the options in <function>main()</function> and hide them from <classname>Gtk::Application</classname> by setting <literal>argc = 1</literal> in the call to <methodname>Gtk::Application::run()</methodname>.
sr: Обрадите опције у <function>main()</function> и сакријте их од <classname>Gtk::Application</classname> постављањем <literal>argc = 1</literal> у позиву <methodname>Gtk::Application::run()</methodname>.

note: (itstool) path: listitem/para
en: Give all command-line options to <methodname>Gtk::Application::run()</methodname> and add the flag <literal>Gio::Application::Flags::HANDLES_COMMAND_LINE</literal> to <methodname>Gtk::Application::create()</methodname>. Connect a signal handler to the <literal>command_line</literal> signal, and handle the command-line options in the signal handler.
sr: Проследите све опције командне линије методу <methodname>Gtk::Application::run()</methodname> и додајте заставицу <literal>Gio::Application::Flags::HANDLES_COMMAND_LINE</literal> у <methodname>Gtk::Application::create()</methodname>. Повежите руковалац сигнала на сигнал <literal>command_line</literal> и обрадите опције командне линије у руковаоцу сигнала.

note: (itstool) path: listitem/para
en: You must set the optional parameter <literal>after = false</literal> in the call to <literal>signal_command_line().connect()</literal>, because your signal handler must be called before the default signal handler. You must also call <methodname>Gio::Application::activate()</methodname> in the signal handler, unless you want your application to exit without showing its main window. (<classname>Gio::Application</classname> is a base class of <classname>Gtk::Application</classname>.)
sr: Морате поставити опциони параметар <literal>after = false</literal> у позиву <literal>signal_command_line().connect()</literal>, јер ваш руковалац сигнала мора бити позван пре подразумеваног руковаоца сигнала. Такође морате позвати <methodname>Gio::Application::activate()</methodname> у руковаоцу сигнала, осим ако не желите да ваша апликација изађе без приказивања свог главног прозора. (<classname>Gio::Application</classname> је базни разред за <classname>Gtk::Application</classname>.)

note: (itstool) path: section/para
en: Here is the source code for the example that produced the screenshots above. When you run this example, provide a number between 1 and 3 as a command-line option, to see different packing options in use.
sr: Ево изворног кода за пример који је произвео снимке екрана изнад. Када покренете овај пример, проследите број између 1 и 3 као опцију командне линије, да бисте видели различите опције паковања у употреби.

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/box">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/box">Изворни код</link>

note: (itstool) path: section/title (itstool) path: figure/title
en: Grid
sr: Мрежа

note: (itstool) path: section/para
en: A <classname>Grid</classname> dynamically lays out child widgets in rows and columns. The dimensions of the grid do not need to be specified in the constructor.
sr: <classname>Grid</classname> динамички распоређује садржане елементе у редове и колоне. Димензије мреже не морају бити наведене у конструктору.

note: (itstool) path: section/para
en: Child widgets can span multiple rows or columns, using <methodname>attach()</methodname>, or added next to an existing widget inside the grid with <methodname>attach_next_to()</methodname>. Individual rows and columns of the grid can be set to have uniform height or width with <methodname>set_row_homogeneous()</methodname> and <methodname>set_column_homogeneous()</methodname>.
sr: Садржани елементи се могу простирати кроз више редова или колона, коришћењем <methodname>attach()</methodname>, или се могу додати поред постојећег елемента унутар мреже помоћу <methodname>attach_next_to()</methodname>. Појединачни редови и колоне мреже се могу поставити да имају уједначену висину или ширину помоћу <methodname>set_row_homogeneous()</methodname> и <methodname>set_column_homogeneous()</methodname>.

note: (itstool) path: section/para
en: You can set the <emphasis>margin</emphasis> and <emphasis>expand</emphasis> properties of the child <classname>Widget</classname>s to control their spacing and their behavior when the Grid is resized.
sr: Можете поставити својства <emphasis>margin</emphasis> и <emphasis>expand</emphasis> садржаних <classname>Widget</classname> елемената да бисте контролисали њихов размак и понашање приликом промене величине мреже.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1Grid.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1Grid.html">Референце</link>

note: (itstool) path: section/para
en: This example creates a window with three buttons in a grid. The first two buttons are in the upper row, from left to right. A third button is attached underneath the first button, in a new lower row, spanning two columns.
sr: Овај пример прави прозор са три дугмета у мрежи. Прва два дугмета су у горњем реду, слева надесно. Треће дугме је прикачено испод првог дугмета, у новом доњем реду, простирући се кроз две колоне.

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/grid">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/grid">Изворни код</link>

note: (itstool) path: section/title (itstool) path: figure/title
en: Notebook
sr: Бележница

note: (itstool) path: section/para
en: A <classname>Notebook</classname> has a set of stacked <literal>pages</literal>, each of which contains widgets. Labelled <literal>tabs</literal> allow the user to select the pages. <classname>Notebook</classname>s allow several sets of widgets to be placed in a small space, by only showing one page at a time. For instance, they are often used in preferences dialogs.
sr: <classname>Notebook</classname> има скуп наслаганих <literal>страница</literal>, од којих свака садржи елементе. Означени <literal>језичци</literal> омогућавају кориснику да изабере странице. <classname>Notebook</classname> елементи омогућавају да се неколико скупова елемената постави у мали простор, приказујући само једну страницу у исто време. На пример, често се користе у прозорчићима са поставкама.

note: (itstool) path: section/para
en: Use the <methodname>append_page()</methodname>, <methodname>prepend_page()</methodname> and <methodname>insert_page()</methodname> methods to add tabbed pages to the <literal>Notebook</literal>, supplying the child widget and the name for the tab.
sr: Користите методе <methodname>append_page()</methodname>, <methodname>prepend_page()</methodname> и <methodname>insert_page()</methodname> за додавање страница са језичцима у <literal>Notebook</literal>, прослеђујући садржани елемент и назив за језичак.

note: (itstool) path: section/para
en: To discover the currently visible page, use the <methodname>get_current_page()</methodname> method. This returns the page number, and then calling <methodname>get_nth_page()</methodname> with that number will give you a pointer to the actual child widget.
sr: Да бисте открили тренутно видљиву страницу, користите метод <methodname>get_current_page()</methodname>. Ово враћа број странице, а затим ће вам позивање <methodname>get_nth_page()</methodname> са тим бројем дати показивач на стварни садржани елемент.

note: (itstool) path: section/para
en: To programmatically change the selected page, use the <methodname>set_current_page()</methodname> method.
sr: Да бисте програмски променили изабрану страницу, користите метод <methodname>set_current_page()</methodname>.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1Notebook.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1Notebook.html">Референце</link>

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/notebook/">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/notebook/">Изворни код</link>

note: (itstool) path: section/title (itstool) path: figure/title
en: Assistant
sr: Помоћник

note: (itstool) path: note/para
en: <classname>Gtk::Assistant</classname> is deprecated since <application>gtkmm</application> 4.10. There is no replacement in <application>gtkmm</application>. libadwaita (a C library) has replacement parts (like AdwCarousel). In some cases, a <classname>Gtk::Notebook</classname> might be an acceptable replacement.
sr: <classname>Gtk::Assistant</classname> је застарео од <application>gtkmm</application> 4.10. Не постоји замена у <application>gtkmm</application>-у. libadwaita (C библиотека) има заменске делове (као што је AdwCarousel). У неким случајевима, <classname>Gtk::Notebook</classname> може бити прихватљива замена.

note: (itstool) path: section/para
en: An <classname>Assistant</classname> splits a complex operation into steps. Each step is a page, containing a header, a child widget and an action area. The Assistant's action area has navigation buttons which update automatically depending on the type of the page, set with <methodname>set_page_type()</methodname>.
sr: <classname>Помоћник</classname> дели сложену операцију на кораке. Сваки корак је страница која садржи заглавље, садржани елемент и област радње. Област радње помоћника има навигациону дугмад која се аутоматски ажурирају у зависности од врсте странице, постављене помоћу <methodname>set_page_type()</methodname>.

note: (itstool) path: section/para
en: Use the <methodname>append_page()</methodname>, <methodname>prepend_page</methodname> and <methodname>insert_page()</methodname> methods to add pages to the <classname>Assistant</classname>, supplying the child widget for each page.
sr: Користите методе <methodname>append_page()</methodname>, <methodname>prepend_page</methodname> и <methodname>insert_page()</methodname> за додавање страница у <classname>Помоћника</classname>, достављајући садржани елемент за сваку страницу.

note: (itstool) path: section/para
en: To determine the currently-visible page, use the <methodname>get_current_page()</methodname> method, and pass the result to <methodname>get_nth_page()</methodname>, which returns a pointer to the actual widget. To programmatically change the current page, use the <methodname>set_current_page()</methodname> method.
sr: Да бисте одредили тренутно видљиву страницу, користите метод <methodname>get_current_page()</methodname> и проследите резултат у <methodname>get_nth_page()</methodname>, који враћа показивач на стварни елемент. Да бисте програмски променили тренутну страницу, користите метод <methodname>set_current_page()</methodname>.

note: (itstool) path: section/para
en: To set the title of a page, use the <methodname>set_page_title()</methodname> method.
sr: Да бисте поставили наслов странице, користите метод <methodname>set_page_title()</methodname>.

note: (itstool) path: section/para
en: To add widgets to the action area, use the <methodname>add_action_widget()</methodname> method. They will be packed alongside the default buttons. Use the <methodname>remove_action_widget()</methodname> method to remove widgets.
sr: Да бисте додали елементе у област радње, користите метод <methodname>add_action_widget()</methodname>. Они ће бити упаковани заједно са подразумеваном дугмадима. Користите метод <methodname>remove_action_widget()</methodname> за уклањање елемената.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1Assistant.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1Assistant.html">Референца</link>

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/assistant/">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/assistant/">Изворни код</link>

note: (itstool) path: section/title
en: Other Multi-item Containers
sr: Остали контејнери са више ставки

note: (itstool) path: section/para
en: There are other multi-item containers. See the reference documentation for a complete list. Here are links to some example programs that show containers, which are not mentioned elsewhere in this tutorial.
sr: Постоје и други контејнери са више ставки. Погледајте референтну документацију за потпуни списак. Овде су везе до неких примерних програма који приказују контејнере, а који нису поменути на другим местима у овом упутству.

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/actionbar">Source Code, ActionBar</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/actionbar">Изворни код, ActionBar</link>

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/listbox_flowbox/flowbox">Source Code, FlowBox</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/listbox_flowbox/flowbox">Изворни код, FlowBox</link>

note: (itstool) path: chapter/para
en: Lists are intended to be used whenever developers want to display many objects in roughly the same way. They are perfectly fine to be used for very short lists of only 2 or 3 items, but generally scale fine to thousands of items.
sr: Спискови су намењени за коришћење кад год програмери желе да прикажу много објеката на приближно исти начин. Сасвим су прикладни за веома кратке спискове од само 2 или 3 ставке, али се углавном добро прилагођавају и хиљадама ставки.

note: (itstool) path: chapter/para
en: Lists are meant to be used with changing data, both with the items themselves changing as well as the list adding and removing items. Of course, they work just as well with static data.
sr: Спискови су намењени за коришћење са променљивим подацима, како са самим ставкама које се мењају, тако и са списком који додаје и уклања ставке. Наравно, они раде подједнако добро и са статичким подацима.

note: (itstool) path: chapter/para
en: The <link xlink:href="https://docs.gtk.org/gtk4/section-list-widget.html">List Widget Overview</link> chapter in the GTK documentation contains more information about list widgets.
sr: Поглавље <link xlink:href="https://docs.gtk.org/gtk4/section-list-widget.html">Преглед елемента списка</link> у ГТК документацији садржи више информација о елементима списка.

note: (itstool) path: chapter/para
en: Some examples are shown in this chapter. There are more examples in the <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/listmodelviews/">listmodelviews directory</link> in <application>gtkmm-documentation</application>'s examples.
sr: Неки примери су приказани у овом поглављу. Постоји још примера у <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/listmodelviews/">директоријуму listmodelviews</link> међу примерима <application>gtkmm-documentation</application>-а.

note: (itstool) path: section/title
en: The Data Model
sr: Модел података

note: (itstool) path: section/para
en: The data model is a class that implements the <classname>Gio::ListModel</classname> interface. Examples of such classes are <classname>Gio::ListStore</classname> (not to be confused with the deprecated <classname>Gtk::ListStore</classname>), <classname>Gtk:StringList</classname>, <classname>Gtk:DirectoryList</classname> and <classname>Pango::FontMap</classname>.
sr: Модел података је класа која примењује прочеље <classname>Gio::ListModel</classname>. Примери таквих класа су <classname>Gio::ListStore</classname> (не треба га мешати са застарелим <classname>Gtk::ListStore</classname>), <classname>Gtk:StringList</classname>, <classname>Gtk:DirectoryList</classname> и <classname>Pango::FontMap</classname>.

note: (itstool) path: section/para
en: The elements in a model are called <emphasis>items</emphasis>. All items are instances of a subclass of <classname>Glib::Object</classname>. For instance, you might have a <classname>ColumnView</classname> with one integer and one text column, like so:
sr: Елементи у моделу се називају <emphasis>ставке</emphasis>. Све ставке су примерци подкласе <classname>Glib::Object</classname>. На пример, можете имати <classname>ColumnView</classname> са једном колоном целог броја и једном текстуалном колоном, овако:

note: (itstool) path: section/para
en: Every item in a model has a position which is the unsigned integer that describes where in the model the item is located. The first item in a model is at position 0. The position of an item can of course change as other items are added to or removed from the model.
sr: Свака ставка у моделу има положај који је неозначени цео број који описује где се у моделу ставка налази. Прва ставка у моделу је на положају 0. Положај ставке се наравно може променити како се друге ставке додају у модел или уклањају из њега.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/glibmm/classGio_1_1ListStore.html">Gio::ListStore Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/glibmm/classGio_1_1ListStore.html">Gio::ListStore референца</link>

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1StringList.html">StringList Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1StringList.html">StringList референца</link>

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1DirectoryList.html">DirectoryList Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1DirectoryList.html">DirectoryList референца</link>

note: (itstool) path: section/title
en: The Selection Model
sr: Модел избора

note: (itstool) path: section/para
en: The selection model is a class that implements the <classname>Gtk::SelectionModel</classname> interface. You can choose between <classname>NoSelection</classname>, <classname>SingleSelection</classname> and <classname>MultiSelection</classname>.
sr: Модел избора је класа која примењује прочеље <classname>Gtk::SelectionModel</classname>. Можете бирати између <classname>NoSelection</classname>, <classname>SingleSelection</classname> и <classname>MultiSelection</classname>.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1NoSelection.html">NoSelection Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1NoSelection.html">NoSelection референца</link>

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1SingleSelection.html">SingleSelection Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1SingleSelection.html">SingleSelection референца</link>

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1MultiSelection.html">MultiSelection Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1MultiSelection.html">MultiSelection референца</link>

note: (itstool) path: section/title
en: The Factory
sr: Фабрика

note: (itstool) path: section/para
en: Data from the data model is added to the view by a factory, which is a subclass of <classname>ListItemFactory</classname>. There is only one such subclass in <application>gtkmm</application>, <classname>SignalListItemFactory</classname>. Data from the model is added to the view with signal handlers connected to a <classname>SignalListItemFactory</classname>.
sr: Подаци из модела података се додају у преглед помоћу фабрике, која је подкласа <classname>ListItemFactory</classname>. Постоји само једна таква подкласа у <application>gtkmm</application>-у, <classname>SignalListItemFactory</classname>. Подаци из модела се додају у преглед помоћу руковалаца сигналима који су повезани на <classname>SignalListItemFactory</classname>.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1SignalListItemFactory.html">SignalListItemFactory Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1SignalListItemFactory.html">SignalListItemFactory референца</link>

note: (itstool) path: section/title
en: The View
sr: Преглед

note: (itstool) path: section/para
en: The View is the widget that displays the model data and allows the user to interact with it. The View can show all of the model's columns, or just some, and it can show them in various ways.
sr: Преглед је елемент који приказује податке модела и омогућава кориснику да комуницира са њим. Преглед може приказати све колоне модела, или само неке, и може их приказати на различите начине.

note: (itstool) path: section/para
en: An important requirement for views (especially views of long lists) is that they need to know which items are not visible so they can be recycled. Views achieve that by implementing the <classname>Scrollable</classname> interface and expecting to be placed directly into a <classname>ScrolledWindow</classname>.
sr: Важан захтев за прегледе (нарочито прегледе дугих спискова) је да морају знати које ставке нису видљиве како би се могле поново искористити. Прегледи то постижу применом прочеља <classname>Scrollable</classname> и очекивањем да буду постављени директно у <classname>ScrolledWindow</classname>.

note: (itstool) path: section/para
en: There are different view widgets to choose from.
sr: Постоје различити елементи прегледа које можете изабрати.

note: (itstool) path: section/para
en: The <classname>ListView</classname> shows a 1-dimensional list with one column.
sr: <classname>ListView</classname> приказује једнодимензиони списак са једном колоном.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1ListView.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1ListView.html">Референце</link>

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/listmodelviews/list_listview">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/listmodelviews/list_listview">Изворни ко̂д</link>

note: (itstool) path: section/para
en: The <classname>GridView</classname> shows a 2-dimensional grid.
sr: <classname>GridView</classname> приказује дводимензиону мрежу.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1GridView.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1GridView.html">Референце</link>

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/listmodelviews/gridview">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/listmodelviews/gridview">Изворни ко̂д</link>

note: (itstool) path: section/para
en: The <classname>ColumnView</classname> shows a 1-dimensional list with one or more columns.
sr: <classname>ColumnView</classname> приказује једнодимензиони списак са једном или више колона.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1ColumnView.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1ColumnView.html">Референце</link>

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/listmodelviews/list_columnview">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/listmodelviews/list_columnview">Изворни ко̂д</link>

note: (itstool) path: section/title
en: Sorting
sr: Ређање

note: (itstool) path: section/para
en: The list can be sorted by wrapping it in a <classname>SortListModel</classname>. There are two ways to do this.
sr: Списак се може поређати његовим обавијањем у <classname>SortListModel</classname>. Постоје два начина да се ово уради.

note: (itstool) path: listitem/para
en: In a <classname>ColumnView</classname>, get the <classname>ColumnViewSorter</classname> from the <classname>ColumnView</classname> and set it to the <classname>SortListModel</classname>. Set a <classname>Sorter</classname> to each <classname>ColumnViewColumn</classname>. Then the user of your app can sort the items by clicking on a column heading.
sr: У <classname>ColumnView</classname>-у, добавите <classname>ColumnViewSorter</classname> из <classname>ColumnView</classname>-а и поставите га у <classname>SortListModel</classname>. Поставите <classname>Sorter</classname> за сваку <classname>ColumnViewColumn</classname>. Тада корисник ваше апликације може поређати ставке кликањем на заглавље колоне.

note: (itstool) path: listitem/para
en: In any view, set a <classname>Sorter</classname> such as a <classname>StringSorter</classname> or a <classname>NumericSorter</classname> to the <classname>SortListModel</classname>.
sr: У било ком прегледу, поставите <classname>Sorter</classname> као што је <classname>StringSorter</classname> или <classname>NumericSorter</classname> у <classname>SortListModel</classname>.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1SortListModel.html">SortListModel Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1SortListModel.html">SortListModel референце</link>

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1StringSorter.html">StringSorter Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1StringSorter.html">StringSorter референце</link>

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1NumericSorter.html">NumericSorter Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1NumericSorter.html">NumericSorter референце</link>

note: (itstool) path: figure/title
en: SortListModel
sr: Сортирани модел списка

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/listmodelviews/sort">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/listmodelviews/sort">Изворни ко̂д</link>

note: (itstool) path: section/title
en: Filtering
sr: Филтрирање

note: (itstool) path: section/para
en: The list can be filtered by wrapping it in a <classname>FilterListModel</classname>. Set a <classname>Filter</classname> such as a <classname>StringFilter</classname> or a <classname>BoolFilter</classname> to the <classname>FilterListModel</classname>.
sr: Списак се може филтрирати његовим обавијањем у <classname>FilterListModel</classname>. Поставите <classname>Filter</classname> као што је <classname>StringFilter</classname> или <classname>BoolFilter</classname> на <classname>FilterListModel</classname>.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1FilterListModel.html">FilterListModel Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1FilterListModel.html">Референце за FilterListModel</link>

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1StringFilter.html">StringFilter Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1StringFilter.html">Референце за StringFilter</link>

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1BoolFilter.html">BoolFilter Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1BoolFilter.html">Референце за BoolFilter</link>

note: (itstool) path: figure/title
en: FilterListModel
sr: Филтрирани модел списка

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/listmodelviews/filter">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/listmodelviews/filter">Изворни ко̂д</link>

note: (itstool) path: section/title
en: Displaying Trees
sr: Приказивање стабала

note: (itstool) path: section/para
en: While the deprecated <classname>TreeView</classname> provided built-in support for trees, the list widgets, and in particular <classname>Gio::ListModel</classname>, do not. However, <application>gtkmm</application> provides functionality to make trees look and behave like lists for the people who still want to display lists. This is achieved by using the <classname>TreeListModel</classname> to flatten a tree into a list. The <classname>TreeExpander</classname> widget can then be used inside a listitem to allow users to expand and collapse rows.
sr: Док је застарели <classname>TreeView</classname> пружао уграђену подршку за стабла, виџети списка, а посебно <classname>Gio::ListModel</classname>, то не чине. Међутим, <application>gtkmm</application> пружа функционалност како би стабла изгледала и понашала се као спискови за људе који и даље желе да приказују спискове. Ово се постиже коришћењем <classname>TreeListModel</classname>-а за изравнавање стабла у списак. Виџет <classname>TreeExpander</classname> се затим може користити унутар ставке списка како би се корисницима омогућило да рашире и скупе редове.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1TreeListModel.html">TreeListModel Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1TreeListModel.html">Референце за TreeListModel</link>

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1TreeExpander.html">TreeExpander Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1TreeExpander.html">Референце за TreeExpander</link>

note: (itstool) path: figure/title
en: TreeListModel
sr: Модел списка стабла

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/listmodelviews/tree_columnview">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/listmodelviews/tree_columnview">Изворни ко̂д</link>

note: (itstool) path: chapter/title
en: The TreeView widget
sr: Виџет TreeView

note: (itstool) path: note/para
en: <classname>Gtk::TreeView</classname> is deprecated since <application>gtkmm</application> 4.10. In new code, use <classname>Gtk::ListView</classname> for lists and <classname>Gtk::ColumnView</classname> for tabular lists.
sr: <classname>Gtk::TreeView</classname> је застарео од верзије <application>gtkmm</application> 4.10. У новом коду, користите <classname>Gtk::ListView</classname> за спискове и <classname>Gtk::ColumnView</classname> за табеларне спискове.

note: (itstool) path: chapter/para
en: The <classname>Gtk::TreeView</classname> widget can contain lists or trees of data, in columns.
sr: Виџет <classname>Gtk::TreeView</classname> може да садржи спискове или стабла података, у колонама.

note: (itstool) path: section/title
en: The Model
sr: Модел

note: (itstool) path: section/para
en: Each <classname>Gtk::TreeView</classname> has an associated <classname>Gtk::TreeModel</classname>, which contains the data displayed by the <classname>TreeView</classname>. Each <classname>Gtk::TreeModel</classname> can be used by more than one <classname>Gtk::TreeView</classname>. For instance, this allows the same underlying data to be displayed and edited in 2 different ways at the same time. Or the 2 Views might display different columns from the same Model data, in the same way that 2 SQL queries (or "views") might show different fields from the same database table.
sr: Сваки <classname>Gtk::TreeView</classname> има придружени <classname>Gtk::TreeModel</classname>, који садржи податке приказане у <classname>TreeView</classname>-у. Сваки <classname>Gtk::TreeModel</classname> може користити више од једног <classname>Gtk::TreeView</classname>-а. На пример, ово омогућава да се исти основни подаци приказују и уређују на 2 различита начина у исто време. Или 2 приказа могу приказивати различите колоне из истих података модела, на исти начин на који 2 SQL упита (или „приказа“) могу приказивати различита поља из исте табеле базе података.

note: (itstool) path: section/para
en: Although you can theoretically implement your own Model, you will normally use either the <classname>ListStore</classname> or <classname>TreeStore</classname> model classes.
sr: Иако теоретски можете имплементирати сопствени модел, обично ћете користити класе модела <classname>ListStore</classname> или <classname>TreeStore</classname>.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1TreeModel.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1TreeModel.html">Референца</link>

note: (itstool) path: section/title
en: ListStore, for rows
sr: ListStore, за редове

note: (itstool) path: section/para
en: The <classname>ListStore</classname> contains simple rows of data, and each row has no children.
sr: <classname>ListStore</classname> садржи једноставне редове података, а сваки ред нема подређених ставки.

note: (itstool) path: figure/title
en: TreeView - ListStore
sr: TreeView — ListStore

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1ListStore.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1ListStore.html">Референца</link>

note: (itstool) path: section/title
en: TreeStore, for a hierarchy
sr: TreeStore, за хијерархију

note: (itstool) path: section/para
en: The <classname>TreeStore</classname> contains rows of data, and each row may have child rows.
sr: <classname>TreeStore</classname> садржи редове података, а сваки ред може имати подређене редове.

note: (itstool) path: figure/title
en: TreeView - TreeStore
sr: TreeView — TreeStore

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1TreeStore.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1TreeStore.html">Упута</link>

note: (itstool) path: section/title
en: Model Columns
sr: Колоне модела

note: (itstool) path: section/para
en: The <classname>TreeModelColumnRecord</classname> class is used to keep track of the columns and their data types. You add <classname>TreeModelColumn</classname> instances to the <classname>ColumnRecord</classname> and then use those <classname>TreeModelColumn</classname>s when getting and setting the data in model rows. You will probably find it convenient to derive a new <classname>TreeModelColumnRecord</classname> which has your <classname>TreeModelColumn</classname> instances as member data.
sr: Разред <classname>TreeModelColumnRecord</classname> се користи за праћење колона и њихових врста података. Додајете примерке <classname>TreeModelColumn</classname> у <classname>ColumnRecord</classname> а затим користите те <classname>TreeModelColumn</classname>-е приликом добављања и подешавања података у редовима модела. Вероватно ће вам бити згодно да изведете нови <classname>TreeModelColumnRecord</classname> који има ваше примерке <classname>TreeModelColumn</classname> као податке чланове.

note: (itstool) path: section/para
en: You specify the <classname>ColumnRecord</classname> when creating the Model, like so:
sr: Наводите <classname>ColumnRecord</classname> приликом стварања модела, овако:

note: (itstool) path: section/para
en: As a <classname>TreeModelColumnRecord</classname> describes structure, not data, it can be shared among multiple models, and this is preferable for efficiency. However, the instance (such as <varname>m_Columns</varname> here) should usually not be static, because it often needs to be instantiated after <application>glibmm</application> has been initialized. The best solution is to make it a lazily instantiated singleton, so that it will be constructed on-demand, whenever the first model accesses it.
sr: Како <classname>TreeModelColumnRecord</classname> описује структуру, а не податке, може се делити међу више модела, што је пожељно због ефикасности. Међутим, примерак (као што је овде <varname>m_Columns</varname>) обично не би требало да буде статички, јер га често треба покренути након што је <application>glibmm</application> покренут. Најбоље решење је да га учините лењо покренутим јединцем, тако да ће бити изграђен на захтев, кад год му први модел приступи.

note: (itstool) path: section/title
en: Adding Rows
sr: Додавање редова

note: (itstool) path: section/para
en: Add rows to the model with the <methodname>append()</methodname>, <methodname>prepend()</methodname>, or <methodname>insert()</methodname> methods.
sr: Додајте редове у модел помоћу метода <methodname>append()</methodname>, <methodname>prepend()</methodname> или <methodname>insert()</methodname>.

note: (itstool) path: section/para
en: You can dereference the iterator to get the Row:
sr: Можете разрешити итератор да бисте добили ред:

note: (itstool) path: section/title
en: Adding child rows
sr: Додавање садржаних редова

note: (itstool) path: section/para
en: <classname>Gtk::TreeStore</classname> models can have child items. Add them with the <methodname>append()</methodname>, <methodname>prepend()</methodname>, or <methodname>insert()</methodname> methods, like so:
sr: Модели <classname>Gtk::TreeStore</classname> могу имати садржане ставке. Додајте их помоћу метода <methodname>append()</methodname>, <methodname>prepend()</methodname> или <methodname>insert()</methodname>, овако:

note: (itstool) path: section/title
en: Setting values
sr: Подешавање вредности

note: (itstool) path: section/para
en: You can use the <methodname>operator[]</methodname> overload to set the data for a particular column in the row, specifying the <classname>TreeModelColumn</classname> used to create the model.
sr: Можете користити преоптерећење <methodname>operator[]</methodname> да подесите податке за одређену колону у реду, наводећи <classname>TreeModelColumn</classname> који је коришћен за стварање модела.

note: (itstool) path: section/title
en: Getting values
sr: Добављање вредности

note: (itstool) path: section/para
en: You can use the <methodname>operator[]</methodname> overload to get the data in a particular column in a row, specifying the <classname>TreeModelColumn</classname> used to create the model.
sr: Можете користити преоптерећење <methodname>operator[]</methodname> да добавите податке у одређеној колони у реду, наводећи <classname>TreeModelColumn</classname> који је коришћен за стварање модела.

note: (itstool) path: section/para
en: The compiler will complain if you use an inappropriate type. For instance, this would generate a compiler error:
sr: Преводилац ће се побунити ако користите неприкладну врсту. На пример, ово би створило грешку преводиоца:

note: (itstool) path: section/programlisting
en: <code>//compiler error - no conversion from ustring to int.
    int number = row[m_Columns.m_col_text];</code>
sr: <code>//грешка преводиоца — нема претварања из ustring у int.
    int number = row[m_Columns.m_col_text];</code>

note: (itstool) path: section/title
en: "Hidden" Columns
sr: „Скривене“ колоне

note: (itstool) path: section/para
en: You might want to associate extra data with each row. If so, just add it as a Model column, but don't add it to the View.
sr: Можда ћете желети да придружите додатне податке сваком реду. Ако је тако, само их додајте као колону модела, али их немојте додавати у приказ.

note: (itstool) path: section/para
en: The View is the actual widget (<classname>Gtk::TreeView</classname>) that displays the model (<classname>Gtk::TreeModel</classname>) data and allows the user to interact with it. The View can show all of the model's columns, or just some, and it can show them in various ways.
sr: Приказ је стварни елемент (<classname>Gtk::TreeView</classname>) који приказује податке модела (<classname>Gtk::TreeModel</classname>) и омогућава кориснику да узајамно делује са њим. Приказ може да покаже све колоне модела, или само неке, и може да их прикаже на различите начине.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1TreeView.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1TreeView.html">Референце</link>

note: (itstool) path: section/title
en: Using a Model
sr: Коришћење модела

note: (itstool) path: section/para
en: You can specify a <classname>Gtk::TreeModel</classname> when constructing the <classname>Gtk::TreeView</classname>, or you can use the <methodname>set_model()</methodname> method, like so:
sr: Можете навести <classname>Gtk::TreeModel</classname> приликом изградње <classname>Gtk::TreeView</classname>, или можете користити метод <methodname>set_model()</methodname>, овако:

note: (itstool) path: section/title
en: Adding View Columns
sr: Додавање колона приказа

note: (itstool) path: section/para
en: You can use the <methodname>append_column()</methodname> method to tell the View that it should display certain Model columns, in a certain order, with a certain column title.
sr: Можете користити метод <methodname>append_column()</methodname> да кажете приказу да треба да прикаже одређене колоне модела, одређеним редоследом, са одређеним насловом колоне.

note: (itstool) path: section/programlisting
en: <code>m_TreeView.append_column("Messages", m_Columns.m_col_text);</code>
sr: <code>m_TreeView.append_column("Поруке", m_Columns.m_col_text);</code>

note: (itstool) path: section/para
en: When using this simple <methodname>append_column()</methodname> overload, the <classname>TreeView</classname> will display the model data with an appropriate <classname>CellRenderer</classname>. For instance, strings and numbers are shown in a simple <classname>Gtk::Entry</classname> widget, and booleans are shown in a <classname>Gtk::CheckButton</classname>. This is usually what you need. For other column types you must either connect a callback that converts your type into a string representation, with <methodname>TreeViewColumn::set_cell_data_func()</methodname>, or derive a custom <classname>CellRenderer</classname>. Note that (unsigned) short is not supported by default - You could use (unsigned) int or (unsigned) long as the column type instead.
sr: Када користите ово једноставно преоптерећење <methodname>append_column()</methodname>, <classname>TreeView</classname> ће приказати податке модела са одговарајућим <classname>CellRenderer</classname>-ом. На пример, ниске и бројеви се приказују у једноставном елементу <classname>Gtk::Entry</classname>, а логичке вредности у <classname>Gtk::CheckButton</classname>. Ово је обично оно што вам треба. За друге врсте колона морате или да повежете повратни позив који претвара вашу врсту у текстуалну представу, помоћу <methodname>TreeViewColumn::set_cell_data_func()</methodname>, или да изведете произвољни <classname>CellRenderer</classname>. Имајте на уму да (unsigned) short није подржан по подразумеваним вредностима — уместо тога можете користити (unsigned) int или (unsigned) long као врсту колоне.

note: (itstool) path: section/title
en: More than one Model Column per View Column
sr: Више од једне колоне модела по колони приказа

note: (itstool) path: section/para
en: To render more than one model column in a view column, you need to create the <classname>TreeView::Column</classname> widget manually, and use <methodname>pack_start()</methodname> to add the model columns to it.
sr: Да бисте исцртали више од једне колоне модела у колони приказа, морате ручно да направите елемент <classname>TreeView::Column</classname> и користите <methodname>pack_start()</methodname> да му додате колоне модела.

note: (itstool) path: section/para
en: Then use <methodname>append_column()</methodname> to add the view Column to the View. Notice that <methodname>Gtk::TreeView::append_column()</methodname> is overloaded to accept either a prebuilt <classname>Gtk::TreeView::Column</classname> widget, or just the <classname>TreeModelColumn</classname> from which it generates an appropriate <classname>Gtk::TreeView::Column</classname> widget.
sr: Затим користите <methodname>append_column()</methodname> да додате колону приказа у приказ. Приметите да је <methodname>Gtk::TreeView::append_column()</methodname> преоптерећен тако да прихвата или већ изграђен елемент <classname>Gtk::TreeView::Column</classname>, или само <classname>TreeModelColumn</classname> из којег ствара одговарајући елемент <classname>Gtk::TreeView::Column</classname>.

note: (itstool) path: section/para
en: Here is some example code, which has a pixbuf icon and a text name in the same column:
sr: Ево неког примера кода који има иконицу сличице и текстуални назив у истој колони:

note: (itstool) path: section/programlisting
en: <code>auto pColumn = Gtk::make_managed&lt;Gtk::TreeView::Column&gt;("Icon Name");
    
    // m_columns.icon and m_columns.iconname are columns in the model.
    // pColumn is the column in the TreeView:
    pColumn-&gt;pack_start(m_columns.icon, /* expand= */ false);
    pColumn-&gt;pack_start(m_columns.iconname);
    
    m_TreeView.append_column(*pColumn);</code>
sr: <code>auto pColumn = Gtk::make_managed&lt;Gtk::TreeView::Column&gt;("Назив иконице");
    
    // m_columns.icon и m_columns.iconname су колоне у моделу.
    // pColumn је колона у TreeView-у:
    pColumn-&gt;pack_start(m_columns.icon, /* expand= */ false);
    pColumn-&gt;pack_start(m_columns.iconname);
    
    m_TreeView.append_column(*pColumn);</code>

note: (itstool) path: section/title
en: Specifying CellRenderer details
sr: Навођење детаља CellRenderer-а

note: (itstool) path: section/para
en: The default <classname>CellRenderer</classname>s and their default behavior will normally suffice, but you might occasionally need finer control. For instance, this example code from <filename>gtkmm/demos/gtk-demo/example_treeview_treestore.cc</filename>, appends a <classname>Gtk::CellRenderer</classname> widget and instructs it to render the data from various model columns through various aspects of its appearance.
sr: Подразумевани <classname>CellRenderer</classname>-и и њихово подразумевано понашање ће обично бити довољни, али повремено вам може затребати прецизнија контрола. На пример, овај пример кода из <filename>gtkmm/demos/gtk-demo/example_treeview_treestore.cc</filename>, додаје <classname>Gtk::CellRenderer</classname> виџет и налаже му да исцрта податке из различитих колона модела кроз различите аспекте његовог изгледа.

note: (itstool) path: section/para
en: You can also connect to <classname>CellRenderer</classname> signals to detect user actions. For instance:
sr: Такође се можете повезати на сигнале <classname>CellRenderer</classname>-а како бисте открили корисничке радње. На пример:

note: (itstool) path: section/title
en: Editable Cells
sr: Измењиве ћелије

note: (itstool) path: section/title
en: Automatically-stored editable cells.
sr: Аутоматски сачуване измењиве ћелије.

note: (itstool) path: section/para
en: Cells in a <classname>TreeView</classname> can be edited in-place by the user. To allow this, use the <classname>Gtk::TreeView</classname> <methodname>insert_column_editable()</methodname> and <methodname>append_column_editable()</methodname> methods instead of <methodname>insert_column()</methodname> and <methodname>append_column()</methodname>. When these cells are edited the new values will be stored immediately in the Model. Note that these methods are templates which can only be instantiated for simple column types such as <classname>Glib::ustring</classname>, int, and long.
sr: Ћелије у <classname>TreeView</classname>-у корисник може мењати на лицу места. Да бисте ово омогућили, користите методе <classname>Gtk::TreeView</classname> <methodname>insert_column_editable()</methodname> и <methodname>append_column_editable()</methodname> уместо <methodname>insert_column()</methodname> и <methodname>append_column()</methodname>. Када се ове ћелије уреде, нове вредности ће одмах бити сачуване у моделу. Имајте на уму да су ове методе шаблони који се могу инстанцирати само за једноставне типове колона као што су <classname>Glib::ustring</classname>, int и long.

note: (itstool) path: section/title
en: Implementing custom logic for editable cells.
sr: Имплементација прилагођене логике за измењиве ћелије.

note: (itstool) path: section/para
en: However, you might not want the new values to be stored immediately. For instance, maybe you want to restrict the input to certain characters or ranges of values.
sr: Међутим, можда нећете желети да се нове вредности одмах сачувају. На пример, можда желите да ограничите унос на одређене знакове или опсеге вредности.

note: (itstool) path: section/para
en: To achieve this, you should use the normal <classname>Gtk::TreeView</classname> <methodname>insert_column()</methodname> and <methodname>append_column()</methodname> methods, then use <methodname>get_column_cell_renderer()</methodname> to get the <classname>Gtk::CellRenderer</classname> used by that column.
sr: Да бисте то постигли, требало би да користите обичне методе <classname>Gtk::TreeView</classname> <methodname>insert_column()</methodname> и <methodname>append_column()</methodname>, а затим користите <methodname>get_column_cell_renderer()</methodname> да бисте добили <classname>Gtk::CellRenderer</classname> који користи та колона.

note: (itstool) path: section/para
en: You should then cast that <classname>Gtk::CellRenderer*</classname> to the specific <classname>CellRenderer</classname> that you expect, so you can use specific API.
sr: Затим би требало да кастујете тај <classname>Gtk::CellRenderer*</classname> у специфични <classname>CellRenderer</classname> који очекујете, како бисте могли да користите специфичан АПИ.

note: (itstool) path: section/para
en: For instance, for a CellRendererText, you would set the cell's <emphasis>editable</emphasis> property to true, like so:
sr: На пример, за CellRendererText, поставили бисте својство ћелије <emphasis>editable</emphasis> на тачно, овако:

note: (itstool) path: section/para
en: For a CellRendererToggle, you would set the <emphasis>activatable</emphasis> property instead.
sr: За CellRendererToggle, уместо тога бисте поставили својство <emphasis>activatable</emphasis>.

note: (itstool) path: section/para
en: You can then connect to the appropriate "edited" signal. For instance, connect to <methodname>Gtk::CellRendererText::signal_edited()</methodname>, or <methodname>Gtk::CellRendererToggle::signal_toggled()</methodname>. If the column contains more than one <classname>CellRenderer</classname> then you will need to use <methodname>Gtk::TreeView::get_column()</methodname> and then call <methodname>get_cells()</methodname> on that view Column.
sr: Затим се можете повезати на одговарајући сигнал „edited“. На пример, повежите се на <methodname>Gtk::CellRendererText::signal_edited()</methodname> или <methodname>Gtk::CellRendererToggle::signal_toggled()</methodname>. Ако колона садржи више од једног <classname>CellRenderer</classname>-а, мораћете да користите <methodname>Gtk::TreeView::get_column()</methodname>, а затим да позовете <methodname>get_cells()</methodname> на тој колони приказа.

note: (itstool) path: section/para
en: In your signal handler, you should examine the new value and then store it in the Model if that is appropriate for your application.
sr: У свом руковаоцу сигналом, требало би да испитате нову вредност и затим је сачувате у моделу ако је то прикладно за вашу апликацију.

note: (itstool) path: section/title
en: Iterating over Model Rows
sr: Итерирање кроз редове модела

note: (itstool) path: section/para
en: <classname>Gtk::TreeModel</classname> provides a <phrase role="nowrap">C++</phrase> Standard Library-style container of its children, via the <methodname>children()</methodname> method. You can use the familiar <methodname>begin()</methodname> and <methodname>end()</methodname> methods iterator incrementing, like so:
sr: <classname>Gtk::TreeModel</classname> обезбеђује контејнер својих садржалаца у стилу <phrase role="nowrap">C++</phrase> стандардне библиотеке, преко методе <methodname>children()</methodname>. Можете користити познате методе <methodname>begin()</methodname> и <methodname>end()</methodname> за увећавање итератора, овако:

note: (itstool) path: section/para
en: If you always want to iterate across the entire range, much more succinct syntax is possible using <phrase role="nowrap">C++</phrase>'s range-based <literal>for</literal> loop:
sr: Ако увек желите да итерирате кроз цео опсег, могућа је много сажетија синтакса коришћењем <phrase role="nowrap">C++</phrase> <literal>for</literal> петље засноване на опсегу:

note: (itstool) path: section/programlisting
en: <code>for (auto row: refModel-&gt;children())
    {
      //Do something with the row - see above for set/get.
    }</code>
sr: <code>for (auto row: refModel-&gt;children())
    {
      //Урадите нешто са редом — погледајте изнад за постављање/добављање.
    }</code>

note: (itstool) path: section/title
en: Row children
sr: Садржаоци реда

note: (itstool) path: section/para
en: When using a <classname>Gtk::TreeStore</classname>, the rows can have child rows, which can have their own children in turn. Use <methodname>Gtk::TreeModel::Row::children()</methodname> to get the container of child <classname>Row</classname>s:
sr: Када користите <classname>Gtk::TreeStore</classname>, редови могу имати садржане редове, који заузврат могу имати сопствене садржаоце. Користите <methodname>Gtk::TreeModel::Row::children()</methodname> да бисте добили контејнер садржаних <classname>Row</classname> (редова):

note: (itstool) path: section/title
en: The Selection
sr: Избор

note: (itstool) path: section/para
en: To find out what rows the user has selected, get the <classname>Gtk::TreeView::Selection</classname> object from the <classname>TreeView</classname>, like so:
sr: Да бисте сазнали које редове је корисник изабрао, добавите објекат <classname>Gtk::TreeView::Selection</classname> из <classname>TreeView</classname>-а, на овај начин:

note: (itstool) path: section/title
en: Single or multiple selection
sr: Једноструки или вишеструки избор

note: (itstool) path: section/para
en: By default, only single rows can be selected, but you can allow multiple selection by setting the mode, like so:
sr: По подразумеваним подешавањима, могу се изабрати само појединачни редови, али можете дозволити вишеструки избор постављањем режима, овако:

note: (itstool) path: section/title
en: The selected rows
sr: Изабрани редови

note: (itstool) path: section/para
en: For single-selection, you can just call <methodname>get_selected()</methodname>, like so:
sr: За једноструки избор, можете једноставно позвати <methodname>get_selected()</methodname>, овако:

note: (itstool) path: section/programlisting
en: <code>auto iter = refTreeSelection-&gt;get_selected();
    if(iter) //If anything is selected
    {
      auto row = *iter;
      //Do something with the row.
    }</code>
sr: <code>auto iter = refTreeSelection-&gt;get_selected();
    if(iter) //Ако је било шта изабрано
    {
      auto row = *iter;
      //Урадите нешто са редом.
    }</code>

note: (itstool) path: section/para
en: For multiple-selection, you need to call <methodname>get_selected_rows()</methodname> or define a callback, and give it to <methodname>selected_foreach()</methodname>, <methodname>selected_foreach_path()</methodname>, or <methodname>selected_foreach_iter()</methodname>, like so:
sr: За вишеструки избор, потребно је да позовете <methodname>get_selected_rows()</methodname> или да дефинишете повратни позив и проследите га функцији <methodname>selected_foreach()</methodname>, <methodname>selected_foreach_path()</methodname> или <methodname>selected_foreach_iter()</methodname>, овако:

note: (itstool) path: section/programlisting
en: <code>refTreeSelection-&gt;selected_foreach_iter(
        sigc::mem_fun(*this, &amp;TheClass::selected_row_callback) );
    
    void TheClass::selected_row_callback(
        const Gtk::TreeModel::const_iterator&amp; iter)
    {
      auto row = *iter;
      //Do something with the row.
    }</code>
sr: <code>refTreeSelection-&gt;selected_foreach_iter(
        sigc::mem_fun(*this, &amp;TheClass::selected_row_callback) );
    
    void TheClass::selected_row_callback(
        const Gtk::TreeModel::const_iterator&amp; iter)
    {
      auto row = *iter;
      //Урадите нешто са редом.
    }</code>

note: (itstool) path: section/title
en: The "changed" signal
sr: Сигнал „changed“ (измењено)

note: (itstool) path: section/para
en: To respond to the user clicking on a row or range of rows, connect to the signal like so:
sr: Да бисте одговорили на корисниково кликање на ред или опсег редова, повежите се са сигналом овако:

note: (itstool) path: section/title
en: Preventing row selection
sr: Спречавање избора реда

note: (itstool) path: section/para
en: Maybe the user should not be able to select every item in your list or tree. For instance, in the gtk-demo, you can select a demo to see the source code, but it doesn't make any sense to select a demo category.
sr: Можда корисник не би требало да буде у могућности да изабере сваку ставку у вашој листи или стаблу. На пример, у gtk-demo-у, можете изабрати демо да бисте видели изворни код, али нема никаквог смисла изабрати категорију демоа.

note: (itstool) path: section/para
en: To control which rows can be selected, use the <methodname>set_select_function()</methodname> method, providing a <classname>sigc::slot</classname> callback. For instance:
sr: Да бисте управљали тиме који редови могу бити изабрани, користите метод <methodname>set_select_function()</methodname>, обезбеђујући <classname>sigc::slot</classname> повратни позив. На пример:

note: (itstool) path: section/para
en: and then
sr: а затим

note: (itstool) path: section/programlisting
en: <code>bool DemoWindow::select_function(
        const Glib::RefPtr&lt;Gtk::TreeModel&gt;&amp; model,
        const Gtk::TreeModel::Path&amp; path, bool)
    {
      const auto iter = model-&gt;get_iter(path);
      return iter-&gt;children().empty(); // only allow leaf nodes to be selected
    }</code>
sr: <code>bool DemoWindow::select_function(
        const Glib::RefPtr&lt;Gtk::TreeModel&gt;&amp; model,
        const Gtk::TreeModel::Path&amp; path, bool)
    {
      const auto iter = model-&gt;get_iter(path);
      return iter-&gt;children().empty(); // дозволи само избор чворова листова
    }</code>

note: (itstool) path: section/title
en: Changing the selection
sr: Мењање избора

note: (itstool) path: section/para
en: To change the selection, specify a <classname>Gtk::TreeModel::iterator</classname> or <classname>Gtk::TreeModel::Row</classname>, like so:
sr: Да бисте променили избор, наведите <classname>Gtk::TreeModel::iterator</classname> или <classname>Gtk::TreeModel::Row</classname>, овако:

note: (itstool) path: section/programlisting
en: <code>auto row = m_refModel-&gt;children()[5]; //The sixth row.
    if(row)
      refTreeSelection-&gt;select(row.get_iter());</code>
sr: <code>auto row = m_refModel-&gt;children()[5]; //Шести ред.
    if(row)
      refTreeSelection-&gt;select(row.get_iter());</code>

note: (itstool) path: section/para
en: or
sr: или

note: (itstool) path: section/para
en: The standard tree models (<classname>TreeStore</classname> and <classname>ListStore</classname>) derive from <classname>TreeSortable</classname>, so they offer sorting functionality. For instance, call <methodname>set_sort_column()</methodname>, to sort the model by the specified column. Or supply a callback function to <methodname>set_sort_func()</methodname> to implement a more complicated sorting algorithm.
sr: Стандардни модели стабла (<classname>TreeStore</classname> и <classname>ListStore</classname>) потичу из <classname>TreeSortable</classname>, па нуде функционалност ређања. На пример, позовите <methodname>set_sort_column()</methodname> да бисте поређали модел према наведеној колони. Или доставите функцију повратног позива у <methodname>set_sort_func()</methodname> да бисте применили сложенији алгоритам ређања.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1TreeSortable.html">TreeSortable Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1TreeSortable.html">TreeSortable референца</link>

note: (itstool) path: section/title
en: Sorting by clicking on columns
sr: Ређање кликом на колоне

note: (itstool) path: section/para
en: So that a user can click on a <classname>TreeView</classname>'s column header to sort the <classname>TreeView</classname>'s contents, call <methodname>Gtk::TreeView::Column::set_sort_column()</methodname>, supplying the model column on which model should be sorted when the header is clicked. For instance:
sr: Да би корисник могао да кликне на заглавље колоне <classname>TreeView</classname>-а ради ређања садржаја <classname>TreeView</classname>-а, позовите <methodname>Gtk::TreeView::Column::set_sort_column()</methodname>, достављајући колону модела према којој модел треба да буде поређан када се кликне на заглавље. На пример:

note: (itstool) path: section/title
en: Independently sorted views of the same model
sr: Независно поређани прегледи истог модела

note: (itstool) path: section/para
en: The <classname>TreeView</classname> already allows you to show the same <classname>TreeModel</classname> in two <classname>TreeView</classname> widgets. If you need one of these TreeViews to sort the model differently than the other then you should use a <classname>TreeModelSort</classname> instead of just, for instance, <methodname>Gtk::TreeViewColumn::set_sort_column()</methodname>. <classname>TreeModelSort</classname> is a model that contains another model, presenting a sorted version of that model. For instance, you might add a sorted version of a model to a <classname>TreeView</classname> like so:
sr: <classname>TreeView</classname> већ омогућава да прикажете исти <classname>TreeModel</classname> у два <classname>TreeView</classname> елемента. Ако вам је потребно да један од ових прегледа стабла ређа модел другачије од другог, онда треба да користите <classname>TreeModelSort</classname> уместо само, на пример, <methodname>Gtk::TreeViewColumn::set_sort_column()</methodname>. <classname>TreeModelSort</classname> је модел који садржи други модел, представљајући поређану верзију тог модела. На пример, можете додати поређану верзију модела у <classname>TreeView</classname> овако:

note: (itstool) path: section/para
en: Note, however, that the TreeView will provide iterators to the sorted model. You must convert them to iterators to the underlying child model in order to perform actions on that model. For instance:
sr: Имајте на уму, међутим, да ће TreeView пружити итераторе за поређани модел. Морате их претворити у итераторе за основни подређени модел да бисте извршили радње над тим моделом. На пример:

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1TreeModelSort.html">TreeModelSort Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1TreeModelSort.html">TreeModelSort референца</link>

note: (itstool) path: section/title (itstool) path: chapter/title (itstool) path: figure/title
en: Drag and Drop
sr: Превуци и пусти

note: (itstool) path: section/para
en: <classname>Gtk::TreeView</classname> already implements simple drag-and-drop when used with the <classname>Gtk::ListStore</classname> or <classname>Gtk::TreeStore</classname> models (since gtk 4.8). If necessary, it also allows you to implement more complex behavior when items are dragged and dropped, using the normal <link linkend="chapter-draganddrop">Drag and Drop</link> API.
sr: <classname>Gtk::TreeView</classname> већ примењује једноставно превлачење и спуштање када се користи са моделима <classname>Gtk::ListStore</classname> или <classname>Gtk::TreeStore</classname> (од гтк-а 4.8). Ако је потребно, такође вам омогућава да примените сложеније понашање када се ставке превлаче и спуштају, користећи обичан <link linkend="chapter-draganddrop">Превлачење и спуштање</link> API.

note: (itstool) path: section/title
en: Reorderable rows
sr: Редови са променљивим редоследом

note: (itstool) path: section/para
en: If you call <methodname>Gtk::TreeView::set_reorderable()</methodname> then your TreeView's items can be moved within the treeview itself. This is demonstrated in the <classname>TreeStore</classname> example.
sr: Ако позовете <methodname>Gtk::TreeView::set_reorderable()</methodname> тада се ставке вашег TreeView-а могу премештати унутар самог прегледа стабла. Ово је приказано у примеру <classname>TreeStore</classname>.

note: (itstool) path: section/para
en: However, this does not allow you any control of which items can be dragged, and where they can be dropped. If you need that extra control then you might create a derived <literal>Gtk::TreeModel</literal> from <literal>Gtk::TreeStore</literal> or <literal>Gtk::ListStore</literal> and override the <literal>Gtk::TreeDragSource::row_draggable_vfunc()</literal> and <literal>Gtk::TreeDragDest::row_drop_possible_vfunc()</literal> virtual methods. You can examine the <literal>Gtk::TreeModel::Path</literal>s provided and allow or disallow dragging or dropping by returning <literal>true</literal> or <literal>false</literal>.
sr: Међутим, ово вам не омогућава никакву контролу над тим које ставке се могу превлачити и где се могу спустити. Ако вам је потребна та додатна контрола, тада можете направити изведени <literal>Gtk::TreeModel</literal> из <literal>Gtk::TreeStore</literal> или <literal>Gtk::ListStore</literal> и преклопити виртуелне методе <literal>Gtk::TreeDragSource::row_draggable_vfunc()</literal> и <literal>Gtk::TreeDragDest::row_drop_possible_vfunc()</literal>. Можете испитати достављене <literal>Gtk::TreeModel::Path</literal> путање и дозволити или онемогућити превлачење или спуштање враћањем <literal>true</literal> или <literal>false</literal>.

note: (itstool) path: section/para
en: This is demonstrated in the drag_and_drop example.
sr: Ово је приказано у примеру drag_and_drop.

note: (itstool) path: section/title
en: Popup Context Menu
sr: Искачући контекстни мени

note: (itstool) path: section/para
en: Lots of people need to implement right-click context menus for <classname>TreeView</classname>s so we will explain how to do that here to save you some time. It's much the same as a normal context menu, as described in the <link linkend="sec-menus-popup">menus chapter</link>. You use a <classname>Gtk::GestureClick</classname> to detect the mouse click.
sr: Многим људима је потребно да примене контекстне меније на десни клик за <classname>TreeView</classname> прегледе, па ћемо овде објаснити како то да урадите да бисмо вам уштедели мало времена. То је углавном исто као и обичан контекстни мени, као што је описано у <link linkend="sec-menus-popup">поглављу о менијима</link>. Користите <classname>Gtk::GestureClick</classname> за откривање клика мишем.

note: (itstool) path: section/para
en: This is demonstrated in the Popup Context Menu example. In that example a derived <classname>TreeView</classname> is used, but that's not necessary.
sr: Ово је приказано у примеру искачућег контекстног менија. У том примеру се користи изведени <classname>TreeView</classname>, али то није неопходно.

note: (itstool) path: section/title
en: Examples
sr: Примери

note: (itstool) path: section/para
en: Some <classname>TreeView</classname> examples are shown here. There are more examples in the <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/treeview/">treeview directory</link> in <application>gtkmm-documentation</application>'s examples.
sr: Неки <classname>TreeView</classname> примери су приказани овде. Има још примера у <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/treeview/">директоријуму прегледа стабла</link> међу примерима <application>gtkmm-documentation</application> документације.

note: (itstool) path: section/para
en: If neither <classname>ListStore</classname> nor <classname>TreeStore</classname> is suitable for your application, look at the <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/treeview/custom_treemodel">custom TreeModel</link> example. It shows how you can make your own implementation of the <classname>TreeModel</classname> interface.
sr: Ако ни <classname>ListStore</classname> ни <classname>TreeStore</classname> нису прикладни за ваш програм, погледајте пример <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/treeview/custom_treemodel">произвољног TreeModel-а</link>. Он показује како можете направити сопствену изведбу <classname>TreeModel</classname> прочеља.

note: (itstool) path: section/para
en: This example has a <classname>Gtk::TreeView</classname> widget, with a <classname>Gtk::ListStore</classname> model.
sr: Овај пример има <classname>Gtk::TreeView</classname> елемент, са <classname>Gtk::ListStore</classname> моделом.

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/treeview/list/">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/treeview/list/">Изворни ко̂д</link>

note: (itstool) path: section/para
en: This example is very similar to the <classname>ListStore</classname> example, but uses a <classname>Gtk::TreeStore</classname> model instead, and adds children to the rows.
sr: Овај пример је врло сличан примеру за <classname>ListStore</classname>, али уместо њега користи модел <classname>Gtk::TreeStore</classname> и додаје садржаоце у редове.

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/treeview/tree/">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/treeview/tree/">Изворни ко̂д</link>

note: (itstool) path: section/para
en: This example is identical to the <classname>ListStore</classname> example, but it uses <methodname>TreeView::append_column_editable()</methodname> instead of <methodname>TreeView::append_column()</methodname>.
sr: Овај пример је истоветан примеру за <classname>ListStore</classname>, али користи <methodname>TreeView::append_column_editable()</methodname> уместо <methodname>TreeView::append_column()</methodname>.

note: (itstool) path: figure/title
en: TreeView - Editable Cells
sr: Преглед стабла — измењива поља

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/treeview/editable_cells/">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/treeview/editable_cells/">Изворни ко̂д</link>

note: (itstool) path: section/para
en: This example is much like the <classname>TreeStore</classname> example, but has 2 extra columns to indicate whether the row can be dragged, and whether it can receive drag-and-dropped rows. It uses a derived <classname>Gtk::TreeStore</classname> which overrides the virtual functions as described in the <link linkend="sec-treeview-draganddrop">TreeView Drag and Drop</link> section.
sr: Овај пример је веома сличан примеру за <classname>TreeStore</classname>, али има 2 додатне колоне које указују на то да ли се ред може превлачити и да ли може да прими превучене редове. Користи изведени <classname>Gtk::TreeStore</classname> који преписује виртуелне функције као што је описано у одељку <link linkend="sec-treeview-draganddrop">Превлачење и спуштање у прегледу стабла</link>.

note: (itstool) path: figure/title
en: TreeView - Drag And Drop
sr: Преглед стабла — Превлачење и спуштање

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/treeview/drag_and_drop/">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/treeview/drag_and_drop/">Изворни ко̂д</link>

note: (itstool) path: section/para
en: This example is much like the <classname>ListStore</classname> example, but derives a custom <classname>TreeView</classname> to encapsulate the tree model code and popup menu code in our derived class. See the <link linkend="sec-treeview-contextmenu">TreeView Popup Context Menu</link> section.
sr: Овај пример је веома сличан примеру за <classname>ListStore</classname>, али изводи прилагођени <classname>TreeView</classname> како би инкапсулирао ко̂д модела стабла и ко̂д искачућег менија у нашој изведеној класи. Погледајте одељак <link linkend="sec-treeview-contextmenu">Искачући контекстни мени прегледа стабла</link>.

note: (itstool) path: figure/title
en: TreeView - Popup Context Menu
sr: Преглед стабла — Искачући контекстни мени

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/treeview/popup/">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/treeview/popup/">Изворни ко̂д</link>

note: (itstool) path: chapter/title
en: The DropDown Widget
sr: Елемент падајућег менија

note: (itstool) path: chapter/para
en: The <classname>DropDown</classname> widget is an alternative to the deprecated <classname>ComboBox</classname>. It uses list models instead of tree models, and the content is displayed using widgets instead of cell renderers.
sr: Елемент <classname>DropDown</classname> је алтернатива за застарели <classname>ComboBox</classname>. Користи моделе списка уместо модела стабла, а садржај се приказује помоћу елемената уместо исцртавача ћелија.

note: (itstool) path: chapter/para
en: The <classname>DropDown</classname> widget offers a list of choices in a dropdown menu. If appropriate, it can show extra information about each item, such as text, a picture, or a check button. The <classname>DropDown</classname> widget can optionally have an <classname>Entry</classname> in the dropdown menu, allowing the user to search in a long list.
sr: Елемент <classname>DropDown</classname> нуди списак избора у падајућем менију. Ако је прикладно, може приказати додатне податке о свакој ставци, као што су текст, слика или дугме за потврду. Елемент <classname>DropDown</classname> опционално може имати <classname>Entry</classname> у падајућем менију, омогућавајући кориснику да претражује дугачак списак.

note: (itstool) path: chapter/para
en: The list is provided via a <classname>Gio::ListModel</classname>, and data from this model is added to the <classname>DropDown</classname>'s view with signal handlers connected to a <classname>SignalListItemFactory</classname>. This provides flexibility, but the <classname>StringList</classname> class provides a simpler text-based specialization in case that flexibility is not required.
sr: Списак се доставља преко <classname>Gio::ListModel</classname>, а подаци из овог модела се додају у преглед елемента <classname>DropDown</classname> помоћу руковалаца сигналима повезаних са <classname>SignalListItemFactory</classname>. Ово пружа флексибилност, али класа <classname>StringList</classname> пружа једноставнију текстуалну специјализацију у случају да та флексибилност није потребна.

note: (itstool) path: chapter/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1DropDown.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1DropDown.html">Референца</link>

note: (itstool) path: section/title
en: The model
sr: Модел

note: (itstool) path: section/para
en: The model for a <classname>DropDown</classname> can be defined and filled exactly as for a <classname>ListView</classname> or a <classname>ColumnView</classname>. It must be a subclass of <classname>Glib::Object</classname>. For instance, you might have a <classname>DropDown</classname> with one integer and one text column, like so:
sr: Модел за <classname>DropDown</classname> се може дефинисати и попунити потпуно исто као за <classname>ListView</classname> или <classname>ColumnView</classname>. Мора бити подкласа <classname>Glib::Object</classname>. На пример, можете имати <classname>DropDown</classname> са једном колоном за целе бројеве и једном за текст, овако:

note: (itstool) path: section/para
en: After appending rows to this model, you should provide the model to the <classname>DropDown</classname> with the <methodname>set_model()</methodname> method. Unless you use the <classname>StringList</classname> model, you also need to set a <classname>ListItemFactory</classname> with <methodname>set_factory()</methodname>. If you want the items in the dropdown menu to look different from the item in the <classname>DropDown</classname> widget, you also need to set a separate <classname>ListItemFactory</classname> with <methodname>set_list_factory()</methodname>.
sr: Након додавања редова у овај модел, требало би да доставите модел елементу <classname>DropDown</classname> помоћу методе <methodname>set_model()</methodname>. Осим ако не користите модел <classname>StringList</classname>, такође морате да поставите <classname>ListItemFactory</classname> помоћу <methodname>set_factory()</methodname>. Ако желите да ставке у падајућем менију изгледају другачије од ставке у елементу <classname>DropDown</classname>, такође морате да поставите посебан <classname>ListItemFactory</classname> помоћу <methodname>set_list_factory()</methodname>.

note: (itstool) path: section/title
en: The selected item
sr: Изабрана ставка

note: (itstool) path: section/para
en: To discover what item, if any, the user has selected from the <classname>DropDown</classname>, call <methodname>DropDown::get_selected()</methodname>. This returns an <type>unsigned int</type> that you can use to get the selected data from the model. For instance, you might read an integer ID value from the model, even though you have chosen only to show the human-readable description in the <classname>DropDown</classname>. For instance:
sr: Да бисте сазнали коју је ставку, ако је има, корисник изабрао из елемента <classname>DropDown</classname>, позовите <methodname>DropDown::get_selected()</methodname>. Ово враћа <type>unsigned int</type> који можете користити да добијете изабране податке из модела. На пример, можете прочитати целобројну вредност ИД-а из модела, иако сте изабрали да у елементу <classname>DropDown</classname> прикажете само опис читљив људима. На пример:

note: (itstool) path: section/title
en: Responding to changes
sr: Одговор на измене

note: (itstool) path: section/para
en: You might need to react to every change of selection in the <classname>DropDown</classname>, for instance to update other widgets. To do so, you should connect to <methodname>property_selected().signal_changed()</methodname>. For instance:
sr: Можда ћете морати да реагујете на сваку промену избора у <classname>DropDown</classname> елементу, на пример да бисте ажурирали друге виџете. Да бисте то урадили, требало би да се повежете на <methodname>property_selected().signal_changed()</methodname>. На пример:

note: (itstool) path: section/title
en: Simple String Example
sr: Пример једноставне ниске

note: (itstool) path: figure/title
en: Simple DropDown
sr: Једноставан падајући мени

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/dropdown/string">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/dropdown/string">Изворни код</link>

note: (itstool) path: section/title
en: Examples with a Search Entry
sr: Примери са пољем за претрагу

note: (itstool) path: section/para
en: The dropdown menu may contain an <classname>Entry</classname> that allows to search for items in the list. Call <methodname>set_enable_search()</methodname> and <methodname>set_expression()</methodname>. For instance:
sr: Падајући мени може да садржи <classname>Entry</classname> који омогућава претрагу ставки на списку. Позовите <methodname>set_enable_search()</methodname> и <methodname>set_expression()</methodname>. На пример:

note: (itstool) path: section/title
en: String Example
sr: Пример са ниском

note: (itstool) path: figure/title
en: Search String
sr: Ниска за претрагу

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/dropdown/search_string">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/dropdown/search_string">Изворни код</link>

note: (itstool) path: section/title
en: Font Example
sr: Пример са фонтом

note: (itstool) path: section/para
en: This example uses a <classname>Pango::FontMap</classname> as its model. This is possible because <classname>Pango::FontMap</classname> implements the <classname>Gio::ListModel</classname> interface. Of course you can use a <classname>FontDialogButton</classname> instead.
sr: Овај пример користи <classname>Pango::FontMap</classname> као свој модел. Ово је могуће јер <classname>Pango::FontMap</classname> примењује <classname>Gio::ListModel</classname> интерфејс. Наравно, уместо тога можете користити <classname>FontDialogButton</classname>.

note: (itstool) path: figure/title
en: Search Font
sr: Претрага фонта

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/dropdown/search_font">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/dropdown/search_font">Изворни код</link>

note: (itstool) path: section/title
en: Complex Example
sr: Сложени пример

note: (itstool) path: section/para
en: This is a more complex example with two <classname>SignalListItemFactory</classname> objects and their signal handlers. This example would be simpler without the checkmark in the dropdown menu.
sr: Ово је сложенији пример са два <classname>SignalListItemFactory</classname> објекта и њиховим обрађивачима сигнала. Овај пример би био једноставнији без поља за потврду у падајућем менију.

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/dropdown/complex">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/dropdown/complex">Изворни ко̂д</link>

note: (itstool) path: chapter/title
en: Combo Boxes
sr: Прозорчићи за избор

note: (itstool) path: note/para
en: <classname>Gtk::ComboBox</classname> and <classname>Gtk::ComboBoxText</classname> are deprecated since <application>gtkmm</application> 4.10. Use <classname>Gtk::DropDown</classname> in new code.
sr: <classname>Gtk::ComboBox</classname> и <classname>Gtk::ComboBoxText</classname> су застарели почев од <application>gtkmm</application> 4.10. Користите <classname>Gtk::DropDown</classname> у новом ко̂ду.

note: (itstool) path: chapter/para
en: The <classname>ComboBox</classname> widget offers a list (or tree) of choices in a dropdown menu. If appropriate, it can show extra information about each item, such as text, a picture, a check button, or a progress bar. The <classname>ComboBox</classname> widget usually restricts the user to the available choices, but it can optionally have an <classname>Entry</classname>, allowing the user to enter arbitrary text if none of the available choices are suitable.
sr: Елемент <classname>ComboBox</classname> нуди списак (или дрво) избора у падајућем менију. Ако је прикладно, може приказати додатне податке о свакој ставци, као што су текст, слика, дугме са кућицом за означавање или трака напретка. Елемент <classname>ComboBox</classname> обично ограничава корисника на доступне изборе, али опционално може имати <classname>Entry</classname>, омогућавајући кориснику да унесе произвољан текст ако ниједан од доступних избора није одговарајући.

note: (itstool) path: chapter/para
en: The list is provided via a <classname>TreeModel</classname>, and columns from this model are added to the ComboBox's view with the <methodname>ComboBox::pack_start()</methodname> method. This provides flexibility and compile-time type-safety, but the <classname>ComboBoxText</classname> class provides a simpler text-based specialization in case that flexibility is not required.
sr: Списак се доставља преко <classname>TreeModel</classname>-а, а колоне из овог модела се додају у преглед ComboBox-а помоћу методе <methodname>ComboBox::pack_start()</methodname>. Ово пружа флексибилност и безбедност врста приликом превођења, али класа <classname>ComboBoxText</classname> обезбеђује једноставнију специјализацију засновану на тексту у случају да та флексибилност није потребна.

note: (itstool) path: chapter/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1ComboBox.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1ComboBox.html">Референца</link>

note: (itstool) path: section/para
en: The model for a ComboBox can be defined and filled exactly as for a <classname>TreeView</classname>. For instance, you might derive a ComboBox class with one integer and one text column, like so:
sr: Модел за ComboBox се може дефинисати и попунити исто као и за <classname>TreeView</classname>. На пример, можете извести ComboBox класу са једном колоном целог броја и једном текстуалном колоном, овако:

note: (itstool) path: section/para
en: After appending rows to this model, you should provide the model to the <classname>ComboBox</classname> with the <methodname>set_model()</methodname> method. Then use the <methodname>pack_start()</methodname> or <methodname>pack_end()</methodname> methods to specify what columns will be displayed in the ComboBox. As with the TreeView you may either use the default cell renderer by passing the <classname>TreeModelColumn</classname> to the pack methods, or you may instantiate a specific <classname>CellRenderer</classname> and specify a particular mapping with either <methodname>add_attribute()</methodname> or <methodname>set_cell_data_func()</methodname>. Note that these methods are in the <classname>CellLayout</classname> base class.
sr: Након додавања редова у овај модел, требало би да доставите модел <classname>ComboBox</classname>-у помоћу методе <methodname>set_model()</methodname>. Затим користите методе <methodname>pack_start()</methodname> или <methodname>pack_end()</methodname> да одредите које ће колоне бити приказане у ComboBox-у. Као и код TreeView-а, можете користити или подразумевани исцртавач ћелија прослеђивањем <classname>TreeModelColumn</classname>-а методама паковања, или можете инстанцирати одређени <classname>CellRenderer</classname> и одредити одређено мапирање помоћу <methodname>add_attribute()</methodname> или <methodname>set_cell_data_func()</methodname>. Имајте на уму да се ове методе налазе у базној класи <classname>CellLayout</classname>.

note: (itstool) path: section/title
en: The chosen item
sr: Изабрана ставка

note: (itstool) path: section/para
en: To discover what item, if any, the user has chosen from the ComboBox, call <methodname>ComboBox::get_active()</methodname>. This returns a <classname>TreeModel::iterator</classname> that you can dereference to a <classname>Row</classname> in order to read the values in your columns. For instance, you might read an integer ID value from the model, even though you have chosen only to show the human-readable description in the ComboBox. For instance:
sr: Да бисте сазнали коју је ставку, ако је има, корисник изабрао из ComboBox-а, позовите <methodname>ComboBox::get_active()</methodname>. Ово враћа <classname>TreeModel::iterator</classname> који можете дереференцирати у <classname>Row</classname> како бисте прочитали вредности у вашим колонама. На пример, можете прочитати вредност целог броја ID-а из модела, иако сте изабрали да у ComboBox-у прикажете само опис читљив људима. На пример:

note: (itstool) path: section/programlisting
en: <code>Gtk::TreeModel::iterator iter = m_Combo.get_active();
    if(iter)
    {
      auto row = *iter;
    
      //Get the data for the selected row, using our knowledge
      //of the tree model:
      auto id = row[m_Columns.m_col_id];
      set_something_id_chosen(id); //Your own function.
    }
    else
      set_nothing_chosen(); //Your own function.</code>
sr: <code>Gtk::TreeModel::iterator iter = m_Combo.get_active();
    if(iter)
    {
      auto row = *iter;
    
      //Добавите податке за изабрани ред, користећи наше знање
      //о моделу стабла:
      auto id = row[m_Columns.m_col_id];
      set_something_id_chosen(id); //Ваша сопствена функција.
    }
    else
      set_nothing_chosen(); //Ваша сопствена функција.</code>

note: (itstool) path: section/para
en: You might need to react to every change of selection in the ComboBox, for instance to update other widgets. To do so, you should handle the <literal>changed</literal> signal. For instance:
sr: Можда ћете морати да реагујете на сваку промену избора у ComboBox-у, на пример да бисте ажурирали друге елементе. Да бисте то урадили, требало би да обрадите сигнал <literal>changed</literal>. На пример:

note: (itstool) path: section/title
en: Full Example
sr: Потпуни пример

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/combobox/complex">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/combobox/complex">Изворни ко̂д</link>

note: (itstool) path: section/title
en: Simple Text Example
sr: Једноставан текстуални пример

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/combobox/text">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/combobox/text">Изворни ко̂д</link>

note: (itstool) path: section/title
en: ComboBox with an Entry
sr: ComboBox са уносом

note: (itstool) path: section/para
en: A <classname>ComboBox</classname> may contain an <classname>Entry</classname> widget for entering of arbitrary text, by specifying <literal>true</literal> for the constructor's <literal>has_entry</literal> parameter.
sr: <classname>ComboBox</classname> може да садржи елемент <classname>Entry</classname> за унос произвољног текста, навођењем <literal>true</literal> за параметар конструктора <literal>has_entry</literal>.

note: (itstool) path: section/title
en: The text column
sr: Текстуална колона

note: (itstool) path: section/para
en: So that the <classname>Entry</classname> can interact with the drop-down list of choices, you must specify which of your model columns is the text column, with <methodname>set_entry_text_column()</methodname>. For instance:
sr: Да би <classname>Entry</classname> могао да међудејствује са падајућим списком избора, морате навести која је од колона вашег модела текстуална колона, помоћу <methodname>set_entry_text_column()</methodname>. На пример:

note: (itstool) path: section/para
en: When you select a choice from the drop-down menu, the value from this column will be placed in the <classname>Entry</classname>.
sr: Када изаберете ставку из падајућег менија, вредност из ове колоне ће бити постављена у <classname>Entry</classname>.

note: (itstool) path: section/title
en: The entry
sr: Унос

note: (itstool) path: section/para
en: Because the user may enter arbitrary text, an active model row isn't enough to tell us what text the user has entered. Therefore, you should retrieve the <classname>Entry</classname> widget with the <methodname>ComboBox::get_entry()</methodname> method and call <methodname>get_text()</methodname> on that.
sr: Будући да корисник може да унесе произвољан текст, активни ред модела није довољан да нам каже који је текст корисник унео. Стога, треба да добавите елемент <classname>Entry</classname> методом <methodname>ComboBox::get_entry()</methodname> и позовете <methodname>get_text()</methodname> над њим.

note: (itstool) path: section/para
en: When the user enters arbitrary text, it may not be enough to connect to the <literal>changed</literal> signal, which is emitted for every typed character. It is not emitted when the user presses the <keycap>Enter</keycap> key. Pressing the <keycap>Enter</keycap> key or moving the keyboard focus to another widget may signal that the user has finished entering text. To be notified of these events, connect to the <classname>Entry</classname>'s <literal>activate</literal> signal (available since <application>gtkmm</application> 4.8), and add a <classname>Gtk::EventControllerFocus</classname> and connect to its <literal>leave</literal> signal, like so
sr: Када корисник унесе произвољан текст, можда неће бити довољно повезати се на сигнал <literal>changed</literal>, који се емитује за сваки откуцани знак. Он се не емитује када корисник притисне тастер <keycap>Enter</keycap>. Притисак на тастер <keycap>Enter</keycap> или померање фокуса тастатуре на други елемент може сигнализирати да је корисник завршио са уносом текста. Да бисте били обавештени о овим догађајима, повежите се на сигнал <literal>activate</literal> елемента <classname>Entry</classname> (доступан од <application>gtkmm</application> 4.8), и додајте <classname>Gtk::EventControllerFocus</classname> и повежите се на његов сигнал <literal>leave</literal>, овако

note: (itstool) path: section/programlisting
en: <code>auto entry = m_Combo.get_entry();
    if (entry)
    {
      // Alternatively you can connect to m_Combo.signal_changed().
      entry-&gt;signal_changed().connect(sigc::mem_fun(*this,
        &amp;ExampleWindow::on_entry_changed));
      entry-&gt;signal_activate().connect(sigc::mem_fun(*this,
        &amp;ExampleWindow::on_entry_activate));
      // The Entry shall receive focus-leave events.
      auto controller = Gtk::EventControllerFocus::create();
      m_ConnectionFocusLeave = controller-&gt;signal_leave().connect(
        sigc::mem_fun(*this, &amp;ExampleWindow::on_entry_focus_leave));
      entry-&gt;add_controller(controller);
    }</code>
sr: <code>auto entry = m_Combo.get_entry();
    if (entry)
    {
      // Алтернативно се можете повезати на m_Combo.signal_changed().
      entry-&gt;signal_changed().connect(sigc::mem_fun(*this,
        &amp;ExampleWindow::on_entry_changed));
      entry-&gt;signal_activate().connect(sigc::mem_fun(*this,
        &amp;ExampleWindow::on_entry_activate));
      // Entry ће примати догађаје напуштања фокуса.
      auto controller = Gtk::EventControllerFocus::create();
      m_ConnectionFocusLeave = controller-&gt;signal_leave().connect(
        sigc::mem_fun(*this, &amp;ExampleWindow::on_entry_focus_leave));
      entry-&gt;add_controller(controller);
    }</code>

note: (itstool) path: section/para
en: The <literal>changed</literal> signals of <classname>ComboBox</classname> and <classname>Entry</classname> are both emitted for every change. It doesn't matter which one you connect to. But the <classname>EventControllerFocus</classname> must be added to the <classname>Entry</classname>.
sr: Сигнали <literal>changed</literal> елемената <classname>ComboBox</classname> и <classname>Entry</classname> се оба емитују за сваку промену. Није битно на који ћете се повезати. Али <classname>EventControllerFocus</classname> мора бити додат у <classname>Entry</classname>.

note: (itstool) path: figure/title
en: ComboBox with Entry
sr: ComboBox са уносом

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/combobox/entry_complex">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/combobox/entry_complex">Изворни ко̂д</link>

note: (itstool) path: figure/title
en: ComboBoxText with Entry
sr: ComboBoxText са уносом

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/combobox/entry_text">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/combobox/entry_text">Изворни ко̂д</link>

note: (itstool) path: chapter/para
en: The <classname>TextView</classname> widget can be used to display and edit large amounts of formatted text. Like the <classname>TreeView</classname>, it has a model/view design. In this case the <classname>TextBuffer</classname> is the model.
sr: Виџет <classname>TextView</classname> се може користити за приказ и уређивање великих количина форматираног текста. Попут <classname>TreeView</classname>-а, има дизајн модел/преглед. У овом случају <classname>TextBuffer</classname> је модел.

note: (itstool) path: section/title
en: The Buffer
sr: Међумеморија

note: (itstool) path: section/para
en: <classname>Gtk::TextBuffer</classname> is a model containing the data for the <classname>Gtk::TextView</classname>, like the <classname>Gtk::TreeModel</classname> used by <classname>Gtk::TreeView</classname>. This allows two or more <classname>Gtk::TextView</classname>s to share the same <classname>TextBuffer</classname>, and allows those TextBuffers to be displayed slightly differently. Or you could maintain several <classname>Gtk::TextBuffer</classname>s and choose to display each one at different times in the same <classname>Gtk::TextView</classname> widget.
sr: <classname>Gtk::TextBuffer</classname> је модел који садржи податке за <classname>Gtk::TextView</classname>, попут <classname>Gtk::TreeModel</classname>-а који користи <classname>Gtk::TreeView</classname>. Ово омогућава да два или више <classname>Gtk::TextView</classname>-а деле исту <classname>TextBuffer</classname> међумеморију, и омогућава да те међумеморије буду приказане мало другачије. Или бисте могли да одржавате неколико <classname>Gtk::TextBuffer</classname> међумеморија и изаберете да прикажете сваку у различито време у истом <classname>Gtk::TextView</classname> виџету.

note: (itstool) path: section/para
en: The <classname>TextView</classname> creates its own default <classname>TextBuffer</classname>, which you can access via the <methodname>get_buffer()</methodname> method.
sr: <classname>TextView</classname> ствара сопствену подразумевану <classname>TextBuffer</classname> међумеморију, којој можете приступити путем методе <methodname>get_buffer()</methodname>.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1TextBuffer.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1TextBuffer.html">Референце</link>

note: (itstool) path: section/title
en: Iterators
sr: Итератори

note: (itstool) path: section/para
en: A <classname>Gtk::TextBuffer::iterator</classname> and a <classname>Gtk::TextBuffer::const_iterator</classname> represent a position between two characters in the text buffer. Whenever the buffer is modified in a way that affects the number of characters in the buffer, all outstanding iterators become invalid. Because of this, iterators can't be used to preserve positions across buffer modifications. To preserve a position, use <classname>Gtk::TextBuffer::Mark</classname>.
sr: <classname>Gtk::TextBuffer::iterator</classname> и <classname>Gtk::TextBuffer::const_iterator</classname> представљају положај између два знака у међумеморији текста. Кад год се међумеморија измени на начин који утиче на број знакова у њој, сви преостали итератори постају неважећи. Због тога се итератори не могу користити за очување положаја током измена међумеморије. Да бисте очували положај, користите <classname>Gtk::TextBuffer::Mark</classname>.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1TextIter.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1TextIter.html">Референце</link>

note: (itstool) path: section/title
en: Tags and Formatting
sr: Ознаке и форматирање

note: (itstool) path: section/title
en: Tags
sr: Ознаке

note: (itstool) path: section/para
en: To specify that some text in the buffer should have specific formatting, you must define a tag to hold that formatting information, and then apply that tag to the region of text. For instance, to define the tag and its properties:
sr: Да бисте навели да неки текст у међумеморији треба да има специфично форматирање, морате дефинисати ознаку која ће чувати те информације о форматирању, а затим применити ту ознаку на област текста. На пример, да бисте дефинисали ознаку и њена својства:

note: (itstool) path: section/para
en: You can specify a name for the <classname>Tag</classname> when using the <methodname>create()</methodname> method, but it is not necessary.
sr: Можете навести име за <classname>Tag</classname> када користите методу <methodname>create()</methodname>, али то није неопходно.

note: (itstool) path: section/para
en: The <classname>Tag</classname> class has many other properties.
sr: Класа <classname>Tag</classname> има многа друга својства.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1TextTag.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1TextTag.html">Референце</link>

note: (itstool) path: section/title
en: TagTable
sr: Табела ознака

note: (itstool) path: section/para
en: Each <classname>Gtk::TextBuffer</classname> uses a <classname>Gtk::TextBuffer::TagTable</classname>, which contains the <classname>Tag</classname>s for that buffer. 2 or more <classname>TextBuffer</classname>s may share the same <classname>TagTable</classname>. When you create <classname>Tag</classname>s you should add them to the <classname>TagTable</classname>. For instance:
sr: Сваки <classname>Gtk::TextBuffer</classname> користи <classname>Gtk::TextBuffer::TagTable</classname>, који садржи <classname>Tag</classname>-ове за ту међумеморију. 2 или више <classname>TextBuffer</classname>-а могу делити исту <classname>TagTable</classname>. Када правите <classname>Tag</classname>-ове, требало би да их додате у <classname>TagTable</classname>. На пример:

note: (itstool) path: section/programlisting
en: <code>auto refTagTable = Gtk::TextBuffer::TagTable::create();
    refTagTable-&gt;add(refTagMatch);
    //Hopefully a future version of gtkmm will have a set_tag_table() method,
    //for use after creation of the buffer.
    auto refBuffer = Gtk::TextBuffer::create(refTagTable);</code>
sr: <code>auto refTagTable = Gtk::TextBuffer::TagTable::create();
    refTagTable-&gt;add(refTagMatch);
    //Надајмо се да ће будуће издање gtkmm-а имати метод set_tag_table(),
    //за коришћење након стварања међумеморије.
    auto refBuffer = Gtk::TextBuffer::create(refTagTable);</code>

note: (itstool) path: section/para
en: You can also use <methodname>get_tag_table()</methodname> to get, and maybe modify, the <classname>TextBuffer</classname>'s default <classname>TagTable</classname> instead of creating one explicitly.
sr: Такође можете користити <methodname>get_tag_table()</methodname> да добијете, и можда измените, подразумевану <classname>TagTable</classname> <classname>TextBuffer</classname>-а уместо да је правите експлицитно.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1TextTagTable.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1TextTagTable.html">Референце</link>

note: (itstool) path: section/title
en: Applying Tags
sr: Примена ознака

note: (itstool) path: section/para
en: If you have created a <classname>Tag</classname> and added it to the <classname>TagTable</classname>, you may apply that tag to part of the <classname>TextBuffer</classname> so that some of the text is displayed with that formatting. You define the start and end of the range of text by specifying <classname>Gtk::TextBuffer::iterator</classname>s. For instance:
sr: Ако сте направили <classname>Tag</classname> и додали га у <classname>TagTable</classname>, можете применити ту ознаку на део <classname>TextBuffer</classname>-а тако да се део текста приказује са тим форматирањем. Почетак и крај опсега текста одређујете навођењем <classname>Gtk::TextBuffer::iterator</classname>-а. На пример:

note: (itstool) path: section/para
en: Or you could specify the tag when first inserting the text:
sr: Или можете навести ознаку при првом уметању текста:

note: (itstool) path: section/programlisting
en: <code>refBuffer-&gt;insert_with_tag(iter, "Some text", refTagMatch);</code>
sr: <code>refBuffer-&gt;insert_with_tag(iter, "Неки текст", refTagMatch);</code>

note: (itstool) path: section/para
en: You can apply more than one <classname>Tag</classname> to the same text, by using <methodname>apply_tag()</methodname> more than once, or by using <methodname>insert_with_tags()</methodname>. The <classname>Tag</classname>s might specify different values for the same properties, but you can resolve these conflicts by using <methodname>Tag::set_priority()</methodname>.
sr: Можете применити више од једног <classname>Tag</classname>-а на исти текст, коришћењем <methodname>apply_tag()</methodname> више пута, или коришћењем <methodname>insert_with_tags()</methodname>. <classname>Tag</classname>-ови могу навести различите вредности за иста својства, али те сукобе можете решити коришћењем <methodname>Tag::set_priority()</methodname>.

note: (itstool) path: section/title
en: Marks
sr: Ознаке

note: (itstool) path: section/para
en: <classname>TextBuffer</classname> iterators are generally invalidated when the text changes, but you can use a <classname>Gtk::TextBuffer::Mark</classname> to remember a position in these situations. For instance,
sr: Итератори <classname>TextBuffer</classname>-а обично постају неважећи када се текст промени, али можете користити <classname>Gtk::TextBuffer::Mark</classname> да запамтите положај у таквим ситуацијама. На пример,

note: (itstool) path: section/para
en: You can then use the <methodname>get_iter()</methodname> method later to create an iterator for the <classname>Mark</classname>'s new position.
sr: Затим можете касније користити метод <methodname>get_iter()</methodname> да направите итератор за нови положај <classname>Mark</classname>-а.

note: (itstool) path: section/para
en: There are two built-in <classname>Mark</classname>s - <literal>insert</literal> and <literal>selection_bound</literal>, which you can access with <classname>TextBuffer</classname>'s <methodname>get_insert()</methodname> and <methodname>get_selection_bound()</methodname> methods.
sr: Постоје два уграђена <classname>Mark</classname>-а — <literal>insert</literal> и <literal>selection_bound</literal>, којима можете приступити помоћу метода <classname>TextBuffer</classname>-а <methodname>get_insert()</methodname> и <methodname>get_selection_bound()</methodname>.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1TextMark.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1TextMark.html">Референце</link>

note: (itstool) path: section/para
en: As mentioned above, each <classname>TextView</classname> has a <classname>TextBuffer</classname>, and one or more <classname>TextView</classname>s can share the same <classname>TextBuffer</classname>.
sr: Као што је већ поменуто, сваки <classname>TextView</classname> има <classname>TextBuffer</classname>, а један или више <classname>TextView</classname>-а могу делити исти <classname>TextBuffer</classname>.

note: (itstool) path: section/para
en: Like the <classname>TreeView</classname>, you should probably put your <classname>TextView</classname> inside a <classname>ScrolledWindow</classname> to allow the user to see and move around the whole text area with scrollbars.
sr: Попут <classname>TreeView</classname>-а, вероватно би требало да поставите свој <classname>TextView</classname> унутар <classname>ScrolledWindow</classname>-а како бисте омогућили кориснику да види и креће се кроз целу текстуалну област помоћу трака за помицање.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1TextView.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1TextView.html">Референце</link>

note: (itstool) path: section/title
en: Default formatting
sr: Подразумевано форматирање

note: (itstool) path: section/para
en: <classname>TextView</classname> has various methods which allow you to change the presentation of the buffer for this particular view. Some of these may be overridden by the <classname>Gtk::TextTag</classname>s in the buffer, if they specify the same things. For instance, <methodname>set_left_margin()</methodname>, <methodname>set_right_margin()</methodname>, <methodname>set_indent()</methodname>, etc.
sr: <classname>TextView</classname> има различите методе које вам омогућавају да промените приказ међумеморије за овај конкретан преглед. Неке од њих могу бити преклопљене <classname>Gtk::TextTag</classname>-овима у међумеморији, ако наводе исте ствари. На пример, <methodname>set_left_margin()</methodname>, <methodname>set_right_margin()</methodname>, <methodname>set_indent()</methodname>, итд.

note: (itstool) path: section/title
en: Scrolling
sr: Клизање

note: (itstool) path: section/para
en: <classname>Gtk::TextView</classname> has various <methodname>scroll_to()</methodname> methods. These allow you to ensure that a particular part of the text buffer is visible. For instance, your application's Find feature might use <methodname>Gtk::TextView::scroll_to()</methodname> to show the found text.
sr: <classname>Gtk::TextView</classname> има различите <methodname>scroll_to()</methodname> методе. Оне вам омогућавају да осигурате да је одређени део међумеморије текста видљив. На пример, функција „Пронађи“ ваше апликације може користити <methodname>Gtk::TextView::scroll_to()</methodname> за приказ пронађеног текста.

note: (itstool) path: section/title
en: Widgets and ChildAnchors
sr: Елементи и ChildAnchors

note: (itstool) path: section/para
en: You can embed widgets, such as <classname>Gtk::Button</classname>s, in the text. Each such child widget needs a <classname>ChildAnchor</classname>. ChildAnchors are associated with <classname>iterator</classname>s. For instance, to create a child anchor at a particular position, use <methodname>Gtk::TextBuffer::create_child_anchor()</methodname>:
sr: Можете уградити елементе, као што су <classname>Gtk::Button</classname> дугмад, у текст. Сваком таквом садржаном елементу је потребан <classname>ChildAnchor</classname>. ChildAnchor-и су повезани са <classname>iterator</classname>-има. На пример, да бисте направили ослонац садржаног елемента на одређеном положају, користите <methodname>Gtk::TextBuffer::create_child_anchor()</methodname>:

note: (itstool) path: section/para
en: Then, to add a widget at that position, use <methodname>Gtk::TextView::add_child_at_anchor()</methodname>:
sr: Затим, да бисте додали елемент на тај положај, користите <methodname>Gtk::TextView::add_child_at_anchor()</methodname>:

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1TextChildAnchor.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1TextChildAnchor.html">Референца</link>

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/textview/">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/textview/">Изворни код</link>

note: (itstool) path: section/title
en: Other Examples
sr: Други примери

note: (itstool) path: section/para
en: The example in the <link linkend="sec-i18n-example"> Internationalization and Localization</link> chapter uses <classname>TextView</classname>.
sr: Пример у поглављу <link linkend="sec-i18n-example">Интернационализација и локализација</link> користи <classname>TextView</classname>.

note: (itstool) path: section/para
en: There is a more complicated example among <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm/tree/master/demos/gtk-demo/example_textview.cc"><application>gtkmm</application>'s demo programs</link>.
sr: Постоји сложенији пример међу <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm/tree/master/demos/gtk-demo/example_textview.cc">демо програмима <application>gtkmm</application>-а</link>.

note: (itstool) path: chapter/title
en: Menus and Toolbars
sr: Изборници и траке алата

note: (itstool) path: chapter/para
en: There are specific APIs for menus and toolbars, but you should usually deal with them together, creating <classname>Gio::SimpleAction</classname>s that you can refer to in both menus and toolbars. In this way you can handle activation of the action instead of responding to the menu and toolbar items separately. And you can enable or disable both the menu and toolbar item via the action. <classname>Gtk::Builder</classname> can create menus and toolbars.
sr: Постоје посебни АПИ-ји за изборнике и траке алата, али би обично требало да радите са њима заједно, стварајући <classname>Gio::SimpleAction</classname> радње на које се можете позивати и у изборницима и у тракама алата. На овај начин можете управљати активирањем радње уместо да одговарате на ставке изборника и траке алата засебно. Такође можете омогућити или онемогућити и ставку изборника и ставку траке алата путем радње. <classname>Gtk::Builder</classname> може да направи изборнике и траке алата.

note: (itstool) path: chapter/para
en: This involves the use of the <classname>Gio::SimpleActionGroup</classname>, <classname>Gio::SimpleAction</classname> and <classname>Gtk::Builder</classname> classes, all of which should be instantiated via their <methodname>create()</methodname> methods, which return <classname>RefPtr</classname>s.
sr: Ово укључује коришћење класа <classname>Gio::SimpleActionGroup</classname>, <classname>Gio::SimpleAction</classname> и <classname>Gtk::Builder</classname>, од којих би све требало да буду инстанциране путем својих <methodname>create()</methodname> метода, које враћају <classname>RefPtr</classname>-ове.

note: (itstool) path: section/title
en: Actions
sr: Радње

note: (itstool) path: section/para
en: First create the <classname>Gio::SimpleAction</classname>s and add them to a <classname>Gio::SimpleActionGroup</classname>, with <methodname>Gio::ActionMap::add_action()</methodname>. (<classname>Gio::ActionMap</classname> is a base class of <classname>Gio::SimpleActionGroup</classname>.) Then add the action group to your window with <methodname>Gtk::Widget::insert_action_group()</methodname>.
sr: Прво направите <classname>Gio::SimpleAction</classname> радње и додајте их у <classname>Gio::SimpleActionGroup</classname>, помоћу <methodname>Gio::ActionMap::add_action()</methodname>. (<classname>Gio::ActionMap</classname> је основна класа за <classname>Gio::SimpleActionGroup</classname>.) Затим додајте групу радњи у ваш прозор помоћу <methodname>Gtk::Widget::insert_action_group()</methodname>.

note: (itstool) path: section/para
en: The arguments to <methodname>add_action()</methodname> specify the action's name, which is used in the menu items and toolbar buttons. You can also specify a signal handler when calling <methodname>add_action()</methodname>. This signal handler will be called when the action is activated via either a menu item or a toolbar button.
sr: Аргументи за <methodname>add_action()</methodname> наводе назив радње, који се користи у ставкама изборника и дугмадима траке алата. Такође можете навести руковаоца сигналом када позивате <methodname>add_action()</methodname>. Овај руковалац сигналом ће бити позван када се радња активира било преко ставке изборника или дугмета траке алата.

note: (itstool) path: section/para
en: For instance:
sr: На пример:

note: (itstool) path: section/para
en: If you use an <classname>Gtk::ApplicationWindow</classname>, you don't have to create your own action group. <classname>Gio::ActionGroup</classname> and <classname>Gio::ActionMap</classname> are base classes of <classname>Gtk::ApplicationWindow</classname>.
sr: Ако користите <classname>Gtk::ApplicationWindow</classname>, не морате да правите сопствену групу радњи. <classname>Gio::ActionGroup</classname> и <classname>Gio::ActionMap</classname> су основни разреди за <classname>Gtk::ApplicationWindow</classname>.

note: (itstool) path: section/title
en: Menubar and Toolbar
sr: Трака изборника и трака са алаткама

note: (itstool) path: section/para
en: Next you should create a <classname>Gtk::Builder</classname>. At this point is also a good idea to tell the application to respond to keyboard shortcuts, by using <methodname>Gtk::Application::set_accel_for_action()</methodname>.
sr: Затим треба да направите <classname>Gtk::Builder</classname>. У овом тренутку је такође добра идеја да кажете апликацији да одговара на пречице тастатуре, коришћењем <methodname>Gtk::Application::set_accel_for_action()</methodname>.

note: (itstool) path: section/para
en: For instance,
sr: На пример,

note: (itstool) path: section/para
en: Then, you can define the actual visible layout of the menus and toolbars, and add the UI layout to the <classname>Builder</classname>. This "ui string" uses an XML format, in which you should mention the names of the actions that you have already created. For instance:
sr: Потом можете одредити стварни видљиви распоред изборника и трака са алаткама, и додати распоред корисничког прочеља у <classname>Builder</classname>. Ова „ниска корисничког прочеља“ користи ИксМЛ формат, у којем треба да наведете називе радњи које сте већ направили. На пример:

note: (itstool) path: section/para
en: This is where we specify the names of the menu items as they will be seen by users in the menu. Therefore, this is where you should make strings translatable, by adding <literal>translatable='yes'</literal>.
sr: Ово је место где наводимо називе ставки изборника онако како ће их корисници видети у изборнику. Због тога је ово место где треба да учините ниске преводивим, додавањем <literal>translatable='yes'</literal>.

note: (itstool) path: section/para
en: To instantiate a <classname>Gtk::PopoverMenuBar</classname> and toolbar (a horizontal <classname>Gtk::Box</classname>) which you can actually show, you should use the <methodname>Builder::get_object()</methodname> and <methodname>Builder::get_widget()</methodname> methods, and then add the widgets to a container. For instance:
sr: Да бисте покренули <classname>Gtk::PopoverMenuBar</classname> и траку са алаткама (водоравну <classname>Gtk::Box</classname>) коју заправо можете приказати, треба да користите методе <methodname>Builder::get_object()</methodname> и <methodname>Builder::get_widget()</methodname>, а затим да додате елементе у контејнер. На пример:

note: (itstool) path: section/title
en: Popup Menus
sr: Искачући изборници

note: (itstool) path: section/para
en: <classname>Menu</classname>s are normally just added to a window, but they can also be displayed temporarily as the result of a mouse button click. For instance, a context menu might be displayed when the user clicks their right mouse button.
sr: <classname>Menu</classname> изборници се обично само додају у прозор, али се такође могу привремено приказати као резултат клика дугметом миша. На пример, контекстни изборник може бити приказан када корисник кликне десним дугметом миша.

note: (itstool) path: section/para
en: To show the popup menu, use a <classname>Gtk::GestureClick</classname> and connect to its <literal>pressed</literal> signal. In the signal handler, use <classname>Gtk::PopoverMenu</classname>'s <methodname>popup()</methodname> method. For instance:
sr: Да бисте приказали искачући изборник, користите <classname>Gtk::GestureClick</classname> и повежите се на његов сигнал <literal>pressed</literal>. У руковаоцу сигналом, користите метод <methodname>popup()</methodname> разреда <classname>Gtk::PopoverMenu</classname>. На пример:

note: (itstool) path: section/title
en: Gio::Resource and glib-compile-resources
sr: Gio::Resource и glib-compile-resources

note: (itstool) path: section/para
en: Applications and libraries often contain binary or textual data that is really part of the application, rather than user data. For instance <classname>Gtk::Builder</classname> <filename class="extension">.ui</filename> files, splashscreen images, <classname>Gio::Menu</classname> markup xml, CSS files, icons, etc. These are often shipped as files in <filename class="directory">$datadir/appname</filename>, or manually included as literal strings in the code.
sr: Програми и библиотеке често садрже бинарне или текстуалне податке који су заправо део програма, пре него кориснички подаци. На пример <classname>Gtk::Builder</classname> <filename class="extension">.ui</filename> датотеке, слике почетног екрана, <classname>Gio::Menu</classname> ИксМЛ означавање, ЦСС датотеке, иконице, итд. Они се често испоручују као датотеке у <filename class="directory">$datadir/appname</filename>, или се ручно укључују као дословне ниске у коду.

note: (itstool) path: section/para
en: The <classname>Gio::Resource</classname> API and the <application>glib-compile-resources</application> program provide a convenient and efficient alternative to this, which has some nice properties. You maintain the files as normal files, so it's easy to edit them, but during the build the files are combined into a binary bundle that is linked into the executable. This means that loading the resource files is efficient (as they are already in memory, shared with other instances) and simple (no need to check for things like I/O errors or locate the files in the filesystem). It also makes it easier to create relocatable applications.
sr: <classname>Gio::Resource</classname> АПИ и програм <application>glib-compile-resources</application> пружају погодну и ефикасну алтернативу овоме, која има неке лепе особине. Датотеке одржавате као обичне датотеке, тако да их је лако уређивати, али се током изградње датотеке комбинују у бинарни комплет који је повезан у извршну датотеку. То значи да је учитавање датотека ресурса ефикасно (јер су већ у меморији, дељене са другим примерцима) и једноставно (нема потребе за провером ствари као што су У/И грешке или проналажење датотека у систему датотека). То такође олакшава прављење премостивих програма.

note: (itstool) path: section/para
en: Resource bundles are created by the <application>glib-compile-resources</application> program which takes an xml file that describes the bundle, and a set of files that the xml references. These are combined into a binary resource bundle.
sr: Комплете ресурса прави програм <application>glib-compile-resources</application> који узима ИксМЛ датотеку која описује комплет, и скуп датотека на које се ИксМЛ позива. Они се комбинују у бинарни комплет ресурса.

note: (itstool) path: section/para
en: An example:
sr: Пример:

note: (itstool) path: section/para
en: This will create a resource bundle with the files <_:itemizedlist-1/>
sr: Ово ће направити пакет ресурса са датотекама <_:itemizedlist-1/>

note: (itstool) path: section/para
en: You can then use <application>glib-compile-resources</application> to compile the xml to a binary bundle that you can load with <methodname>Gio::Resource::create_from_file()</methodname>. However, it's more common to use the <parameter class="command">--generate-source</parameter> argument to create a C source file to link directly into your application. E.g. <_:screen-1/>
sr: Затим можете користити <application>glib-compile-resources</application> да компајлирате xml у бинарни пакет који можете учитати помоћу <methodname>Gio::Resource::create_from_file()</methodname>. Међутим, чешће се користи аргумент <parameter class="command">--generate-source</parameter> за прављење C изворне датотеке која се директно повезује са вашом апликацијом. Нпр. <_:screen-1/>

note: (itstool) path: section/para
en: Once a <classname>Gio::Resource</classname> has been created and registered all the data in it can be accessed globally in the process by using API calls like <methodname>Gio::Resource::open_stream_from_global_resources()</methodname> to stream the data or <methodname>Gio::Resource::lookup_data_in_global_resources()</methodname> to get a direct pointer to the data. You can also use URIs like <uri>resource:///toolbar/rain.png</uri> with <classname>Gio::File</classname> to access the resource data.
sr: Након што је <classname>Gio::Resource</classname> направљен и регистрован, свим подацима у њему се може приступити глобално у процесу коришћењем АПИ позива као што су <methodname>Gio::Resource::open_stream_from_global_resources()</methodname> за проток података или <methodname>Gio::Resource::lookup_data_in_global_resources()</methodname> за добијање директног показивача на податке. Такође можете користити УРИ-је као што је <uri>resource:///toolbar/rain.png</uri> са <classname>Gio::File</classname> за приступ подацима ресурса.

note: (itstool) path: section/para
en: Often you don't need a <classname>Gio::Resource</classname> instance, because resource data can be loaded with methods such as <methodname>Gdk::Pixbuf::create_from_resource()</methodname>, <methodname>Gtk::Builder::add_from_resource()</methodname> and <methodname>Gtk::Image::set_from_resource()</methodname>.
sr: Често вам није потребан примерак <classname>Gio::Resource</classname>, јер се подаци ресурса могу учитати методама као што су <methodname>Gdk::Pixbuf::create_from_resource()</methodname>, <methodname>Gtk::Builder::add_from_resource()</methodname> и <methodname>Gtk::Image::set_from_resource()</methodname>.

note: (itstool) path: section/title
en: Application Menu and Main Menu example
sr: Пример менија апликације и главног менија

note: (itstool) path: section/para
en: This program contains an application menu, a menubar and a toolbar. Classes are derived from <classname>Gtk::Application</classname> and <classname>Gtk::ApplicationWindow</classname>.
sr: Овај програм садржи мени апликације, траку менија и траку алата. Класе су изведене из <classname>Gtk::Application</classname> и <classname>Gtk::ApplicationWindow</classname>.

note: (itstool) path: figure/title
en: App and Main Menu
sr: Програм и главни мени

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/menus/main_menu/">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/menus/main_menu/">Изворни ко̂д</link>

note: (itstool) path: section/title
en: Main Menu example
sr: Пример главног менија

note: (itstool) path: section/para
en: This program contains a menubar and a toolbar. A class is derived from <classname>Gtk::Window</classname>.
sr: Овај програм садржи траку менија и траку алата. Класа је изведена из <classname>Gtk::Window</classname>.

note: (itstool) path: figure/title
en: Main Menu
sr: Главни мени

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/menus_and_toolbars">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/menus_and_toolbars">Изворни ко̂д</link>

note: (itstool) path: section/title
en: Popup Menu example
sr: Пример искачућег менија

note: (itstool) path: figure/title
en: Popup Menu
sr: Искачући мени

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/menus/popup/">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/menus/popup/">Изворни код</link>

note: (itstool) path: chapter/title
en: Adjustments
sr: Поравнања

note: (itstool) path: chapter/para
en: <application>gtkmm</application> has various widgets that can be visually adjusted using the mouse or the keyboard, such as the <classname>Range</classname> widgets (described in the <link linkend="chapter-range-widgets">Range Widgets</link> section). There are also a few widgets that display some adjustable part of a larger area, such as the <classname>Viewport</classname> widget. These widgets have <classname>Gtk::Adjustment</classname> objects that express this common part of their API.
sr: <application>gtkmm</application> има различите елементе који се могу визуелно подешавати мишем или тастатуром, као што су елементи <classname>Range</classname> (описани у одељку <link linkend="chapter-range-widgets">Елементи опсега</link>). Постоји и неколико елемената који приказују неки подесиви део веће области, као што је елемент <classname>Viewport</classname>. Ови елементи имају објекте <classname>Gtk::Adjustment</classname> који изражавају овај заједнички део њиховог АПИ-ја.

note: (itstool) path: chapter/para
en: So that applications can react to changes, for instance when a user moves a scrollbar, <classname>Gtk::Adjustment</classname> has a <literal>value_changed</literal> signal. You can then use the <methodname>get_value()</methodname> method to discover the new value.
sr: Како би програми могли да реагују на измене, на пример када корисник помери траку клизача, <classname>Gtk::Adjustment</classname> има сигнал <literal>value_changed</literal>. Затим можете користити метод <methodname>get_value()</methodname> да бисте сазнали нову вредност.

note: (itstool) path: section/title
en: Creating an Adjustment
sr: Стварање поравнања

note: (itstool) path: section/para
en: The <classname>Gtk::Adjustment</classname> is created by its <methodname>create()</methodname> method which is as follows:
sr: <classname>Gtk::Adjustment</classname> се ствара својим методом <methodname>create()</methodname> који изгледа овако:

note: (itstool) path: section/para
en: The <parameter>value</parameter> argument is the initial value of the adjustment, usually corresponding to the topmost or leftmost position of an adjustable widget. The <parameter>lower</parameter> and <parameter>upper</parameter> arguments specify the possible range of values which the adjustment can hold. The <parameter>step_increment</parameter> argument specifies the smaller of the two increments by which the user can change the value, while the <parameter>page_increment</parameter> is the larger one. The <parameter>page_size</parameter> argument usually corresponds somehow to the visible area of a panning widget. The <parameter>upper</parameter> argument is used to represent the bottommost or rightmost coordinate in a panning widget's child.
sr: Аргумент <parameter>value</parameter> је почетна вредност поравнања, која обично одговара највишем или најлевљем положају подесивог елемента. Аргументи <parameter>lower</parameter> и <parameter>upper</parameter> одређују могући опсег вредности које поравнање може да садржи. Аргумент <parameter>step_increment</parameter> одређује мањи од два корака за који корисник може да промени вредност, док је <parameter>page_increment</parameter> већи. Аргумент <parameter>page_size</parameter> обично на неки начин одговара видљивој области елемента за померање. Аргумент <parameter>upper</parameter> се користи за представљање најниже или најдесније координате унутар садржаја елемента за померање.

note: (itstool) path: section/title
en: Using Adjustments the Easy Way
sr: Коришћење поравнања на лак начин

note: (itstool) path: section/para
en: The adjustable widgets can be roughly divided into those which use and require specific units for these values, and those which treat them as arbitrary numbers.
sr: Подесиви елементи се грубо могу поделити на оне који користе и захтевају специфичне јединице за ове вредности, и на оне који их третирају као произвољне бројеве.

note: (itstool) path: section/para
en: The group which treats the values as arbitrary numbers includes the <classname>Range</classname> widgets (<classname>Scrollbar</classname> and <classname>Scale</classname>), the <classname>ScaleButton</classname> widget, and the <classname>SpinButton</classname> widget. These widgets are typically "adjusted" directly by the user with the mouse or keyboard. They will treat the <parameter>lower</parameter> and <parameter>upper</parameter> values of an adjustment as a range within which the user can manipulate the adjustment's <parameter>value</parameter>. By default, they will only modify the <parameter>value</parameter> of an adjustment.
sr: Група која третира вредности као произвољне бројеве укључује елементе <classname>Range</classname> (<classname>Scrollbar</classname> и <classname>Scale</classname>), елемент <classname>ScaleButton</classname> и елемент <classname>SpinButton</classname>. Ове елементе обично „подешава“ директно корисник помоћу миша или тастатуре. Они ће третирати вредности <parameter>lower</parameter> и <parameter>upper</parameter> поравнања као опсег унутар којег корисник може да мења <parameter>value</parameter> поравнања. Подразумевано, они ће мењати само <parameter>value</parameter> поравнања.

note: (itstool) path: section/para
en: The other group includes the <classname>Viewport</classname> widget and the <classname>ScrolledWindow</classname> widget. All of these widgets use pixel values for their adjustments. These are also typically adjusted indirectly using scrollbars. While all widgets which use adjustments can either create their own adjustments or use ones you supply, you'll generally want to let this particular category of widgets create its own adjustments.
sr: Друга група укључује елемент <classname>Viewport</classname> и елемент <classname>ScrolledWindow</classname>. Сви ови елементи користе вредности у пикселима за своја поравнања. Они се такође обично подешавају индиректно помоћу трака клизача. Иако сви елементи који користе поравнања могу или да направе сопствена поравнања или да користе она која ви доставите, углавном ћете желети да допустите овој специфичној категорији елемената да сама направи своја поравнања.

note: (itstool) path: section/para
en: If you share an adjustment object between a Scrollbar and a TextView widget, manipulating the scrollbar will automagically adjust the TextView widget. You can set it up like this:
sr: Ако делите објекат поравнања између елемената Scrollbar и TextView, померање траке клизача ће аутоматски прилагодити елемент TextView. То можете подесити овако:

note: (itstool) path: section/programlisting
en: <code>// creates its own adjustments
    Gtk::TextView textview;
    // uses the newly-created adjustment for the scrollbar as well
    Gtk::Scrollbar vscrollbar(textview.get_vadjustment(), Gtk::Orientation::VERTICAL);</code>
sr: <code>// прави сопствена поравнања
    Gtk::TextView textview;
    // користи новостворено поравнање и за траку клизача
    Gtk::Scrollbar vscrollbar(textview.get_vadjustment(), Gtk::Orientation::VERTICAL);</code>

note: (itstool) path: section/title
en: Adjustment Internals
sr: Унутрашњост поравнања

note: (itstool) path: section/para
en: OK, you say, that's nice, but what if I want to create my own handlers to respond when the user adjusts a <classname>Range</classname> widget or a <classname>SpinButton</classname>. To access the value of a <classname>Gtk::Adjustment</classname>, you can use the <methodname>get_value()</methodname> and <methodname>set_value()</methodname> methods:
sr: У реду, рећи ћете, то је лепо, али шта ако желим да направим сопствене руковаоце који ће реаговати када корисник подеси елемент <classname>Range</classname> или <classname>SpinButton</classname>. Да бисте приступили вредности <classname>Gtk::Adjustment</classname>, можете користити методе <methodname>get_value()</methodname> и <methodname>set_value()</methodname>:

note: (itstool) path: section/para
en: As mentioned earlier, <classname>Gtk::Adjustment</classname> can emit signals. This is, of course, how updates happen automatically when you share an <classname>Adjustment</classname> object between a <classname>Scrollbar</classname> and another adjustable widget; all adjustable widgets connect signal handlers to their adjustment's <literal>value_changed</literal> signal, as can your program.
sr: Као што је раније поменуто, <classname>Gtk::Adjustment</classname> може да емитује сигнале. Ово је, наравно, начин на који се ажурирања дешавају аутоматски када делите објекат <classname>Adjustment</classname> између елемента <classname>Scrollbar</classname> и другог подесивог елемента; сви подесиви елементи повезују руковаоце сигналима на сигнал <literal>value_changed</literal> свог поравнања, што може да уради и ваш програм.

note: (itstool) path: section/para
en: So, for example, if you have a <classname>Scale</classname> widget, and you want to change the rotation of a picture whenever its value changes, you would create a signal handler like this:
sr: Тако, на пример, ако имате елемент <classname>Scale</classname> и желите да промените ротацију слике кад год се њена вредност промени, направили бисте руковалац сигналом овако:

note: (itstool) path: section/para
en: and connect it to the scale widget's adjustment like this:
sr: и повежите га на подешавање елемента размере овако:

note: (itstool) path: section/para
en: What if a widget reconfigures the <parameter>upper</parameter> or <parameter>lower</parameter> fields of its <classname>Adjustment</classname>, such as when a user adds more text to a text widget? In this case, it emits the <literal>changed</literal> signal.
sr: Шта ако елемент поново конфигурише поља <parameter>upper</parameter> или <parameter>lower</parameter> свог <classname>Adjustment</classname>-а, као када корисник дода више текста у елемент текста? У овом случају, он емитује сигнал <literal>changed</literal>.

note: (itstool) path: section/para
en: <classname>Range</classname> widgets typically connect a handler to this signal, which changes their appearance to reflect the change - for example, the size of the slider in a scrollbar will grow or shrink in inverse proportion to the difference between the <parameter>lower</parameter> and <parameter>upper</parameter> values of its <classname>Adjustment</classname>.
sr: Елементи <classname>Range</classname> обично повезују руковаоца на овај сигнал, који мења њихов изглед како би одразио промену — на пример, величина клизача у траци клизача ће се повећати или смањити у обрнутој пропорцији са разликом између вредности <parameter>lower</parameter> и <parameter>upper</parameter> свог <classname>Adjustment</classname>-а.

note: (itstool) path: section/para
en: You probably won't ever need to attach a handler to this signal, unless you're writing a new type of range widget.
sr: Вероватно вам никада неће требати да прикачите руковаоца на овај сигнал, осим ако не пишете нову врсту елемента опсега.

note: (itstool) path: chapter/title
en: Dialogs
sr: Прозорчићи

note: (itstool) path: note/para
en: <classname>Gtk::Dialog</classname> and the classes derived from it, are deprecated since <application>gtkmm</application> 4.10. They can still be used in <application>gtkmm</application>4 applications, provided GTKMM_DISABLE_DEPRECATED and GDKMM_DISABLE_DEPRECATED are not defined. Some of the dialog classes are replaced by classes that are available since <application>gtkmm</application> 4.10.
sr: <classname>Gtk::Dialog</classname> и класе изведене из ње су застареле од верзије <application>gtkmm</application> 4.10. Оне се и даље могу користити у <application>gtkmm</application>4 апликацијама, под условом да GTKMM_DISABLE_DEPRECATED и GDKMM_DISABLE_DEPRECATED нису дефинисани. Неке од класа прозорчића су замењене класама које су доступне од верзије <application>gtkmm</application> 4.10.

note: (itstool) path: note/para
en: The examples in this chapter use classes that are available since <application>gtkmm</application> 4.10. Similar examples with the deprecated classes are available in the <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/gtkmm-4-0/examples/book/dialogs/"> gtkmm-4-0 branch</link> in the git repository.
sr: Примери у овом поглављу користе класе које су доступне од верзије <application>gtkmm</application> 4.10. Слични примери са застарелим класама су доступни у <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/gtkmm-4-0/examples/book/dialogs/">грани gtkmm-4-0</link> у гит ризници.

note: (itstool) path: chapter/para
en: Dialogs are used as secondary windows, to provide specific information or to ask questions. <classname>Gtk::Dialog</classname> windows contain a few pre-packed widgets to ensure consistency, and a <literal>response</literal> signal which is emitted when the user dismisses the dialog.
sr: Прозорчићи се користе као секундарни прозори, за пружање специфичних информација или за постављање питања. Прозори <classname>Gtk::Dialog</classname> садрже неколико унапред спакованих елемената како би се осигурала доследност, и сигнал <literal>response</literal> који се емитује када корисник одбаци прозорче.

note: (itstool) path: chapter/para
en: There are several derived <classname>Dialog</classname> classes which you might find useful. <classname>Gtk::MessageDialog</classname> is used for most simple notifications. But at other times you might need to derive your own dialog class to provide more complex functionality.
sr: Постоји неколико изведених класа <classname>Dialog</classname> које би вам могле бити корисне. <classname>Gtk::MessageDialog</classname> се користи за већину једноставних обавештења. Али у другим приликама ће вам можда требати да изведете сопствену класу прозорчета како бисте пружили сложенију функционалност.

note: (itstool) path: chapter/para
en: To pack widgets into a custom dialog, you should pack them into the <classname>Gtk::Box</classname>, available via <methodname>get_content_area()</methodname>. To just add a <classname>Button</classname> to the bottom of the <classname>Dialog</classname>, you could use the <methodname>add_button()</methodname> method.
sr: Да бисте спаковали елементе у произвољно прозорче, требало би да их спакујете у <classname>Gtk::Box</classname>, који је доступан преко <methodname>get_content_area()</methodname>. Да бисте само додали <classname>Button</classname> на дно <classname>Dialog</classname>-а, можете користити метод <methodname>add_button()</methodname>.

note: (itstool) path: chapter/para
en: The <literal>response</literal> signal handler receives an <literal>int</literal>. This may be a value from the <type>Gtk::ResponseType</type> if the user closed the dialog by clicking a standard button, or it could be the custom response value that you specified when using <methodname>add_button()</methodname>.
sr: Руковалац сигнала <literal>response</literal> прима <literal>int</literal>. Ово може бити вредност из <type>Gtk::ResponseType</type> ако је корисник затворио прозорче кликом на стандардно дугме, или би то могла бити произвољна вредност одговора коју сте навели приликом коришћења <methodname>add_button()</methodname>.

note: (itstool) path: chapter/para
en: To show the dialog, call <methodname>set_visible(true)</methodname>. If the same dialog instance will be shown several times, you must also call <methodname>set_hide_on_close()</methodname>, or else the dialog will be destroyed when it's closed. Connect to the <literal>response</literal> signal, if you want to know which button was pressed. The <literal>response</literal> signal handler is also where you should hide the dialog.
sr: Да бисте приказали прозорче, позовите <methodname>set_visible(true)</methodname>. Ако ће се исти примерак прозорчета приказивати неколико пута, морате такође позвати <methodname>set_hide_on_close()</methodname>, иначе ће прозорче бити уништено када се затвори. Повежите се на сигнал <literal>response</literal> ако желите да знате које дугме је притиснуто. Руковалац сигнала <literal>response</literal> је такође место где треба да сакријете прозорче.

note: (itstool) path: chapter/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1Dialog.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1Dialog.html">Референце</link>

note: (itstool) path: section/title
en: AlertDialog and MessageDialog
sr: AlertDialog и MessageDialog

note: (itstool) path: section/para
en: <classname>MessageDialog</classname> (deprecated since <application>gtkmm</application> 4.10) and <classname>AlertDialog</classname> (available since <application>gtkmm</application> 4.10) are convenience classes, used to create simple, standard message dialogs, with a message and buttons for user response.
sr: <classname>MessageDialog</classname> (застарело од <application>gtkmm</application> 4.10) и <classname>AlertDialog</classname> (доступно од <application>gtkmm</application> 4.10) су помоћне класе, које се користе за прављење једноставних, стандардних прозорчића за поруке, са поруком и дугмићима за одговор корисника.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1AlertDialog.html">AlertDialog Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1AlertDialog.html">AlertDialog референце</link>

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1MessageDialog.html">MessageDialog Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1MessageDialog.html">MessageDialog референце</link>

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/dialogs/alertdialog">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/dialogs/alertdialog">Изворни код</link>

note: (itstool) path: section/title
en: FileDialog and FileChooserDialog
sr: FileDialog и FileChooserDialog

note: (itstool) path: section/para
en: The <classname>FileChooserDialog</classname> (deprecated since <application>gtkmm</application> 4.10) and <classname>FileDialog</classname> (available since <application>gtkmm</application> 4.10) are suitable for use with "Open" or "Save" menu items.
sr: <classname>FileChooserDialog</classname> (застарело од верзије <application>gtkmm</application> 4.10) и <classname>FileDialog</classname> (доступно од верзије <application>gtkmm</application> 4.10) су погодни за коришћење са ставкама изборника „Отвори“ или „Сачувај“.

note: (itstool) path: section/para
en: Most of the useful member methods for <classname>FileChooserDialog</classname> are actually in the <classname>Gtk::FileChooser</classname> base class.
sr: Већина корисних метода чланица за <classname>FileChooserDialog</classname> се заправо налазе у основној класи <classname>Gtk::FileChooser</classname>.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1FileDialog.html">FileDialog Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1FileDialog.html">FileDialog референца</link>

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1FileChooserDialog.html">FileChooserDialog Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1FileChooserDialog.html">FileChooserDialog референца</link>

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/dialogs/filedialog">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/dialogs/filedialog">Изворни код</link>

note: (itstool) path: section/title
en: ColorDialog and ColorChooserDialog
sr: ColorDialog и ColorChooserDialog

note: (itstool) path: section/para
en: The <classname>ColorChooserDialog</classname> (deprecated since <application>gtkmm</application> 4.10) and <classname>ColorDialog</classname> (available since <application>gtkmm</application> 4.10) allow the user to choose a color. The <classname>ColorButton</classname> (deprecated since <application>gtkmm</application> 4.10) and <classname>ColorDialogButton</classname> (available since <application>gtkmm</application> 4.10) open a color selection dialog when it is clicked.
sr: <classname>ColorChooserDialog</classname> (застарело од верзије <application>gtkmm</application> 4.10) и <classname>ColorDialog</classname> (доступно од верзије <application>gtkmm</application> 4.10) омогућавају кориснику да изабере боју. <classname>ColorButton</classname> (застарело од верзије <application>gtkmm</application> 4.10) и <classname>ColorDialogButton</classname> (доступно од верзије <application>gtkmm</application> 4.10) отварају прозорче за избор боје када се кликне на њих.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1ColorDialog.html">ColorDialog Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1ColorDialog.html">ColorDialog референца</link>

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1ColorChooserDialog.html">ColorChooserDialog Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1ColorChooserDialog.html">ColorChooserDialog референца</link>

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/dialogs/colordialog">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/dialogs/colordialog">Изворни код</link>

note: (itstool) path: section/title
en: FontDialog and FontChooserDialog
sr: FontDialog и FontChooserDialog

note: (itstool) path: section/para
en: The <classname>FontChooserDialog</classname> (deprecated since <application>gtkmm</application> 4.10) and <classname>FontDialog</classname> (available since <application>gtkmm</application> 4.10) allow the user to choose a font. The <classname>FontButton</classname> (deprecated since <application>gtkmm</application> 4.10) and <classname>FontDialogButton</classname> (available since <application>gtkmm</application> 4.10) open a font chooser dialog when it is clicked.
sr: <classname>FontChooserDialog</classname> (застарело од верзије <application>gtkmm</application> 4.10) и <classname>FontDialog</classname> (доступно од верзије <application>gtkmm</application> 4.10) омогућавају кориснику да изабере фонт. <classname>FontButton</classname> (застарело од верзије <application>gtkmm</application> 4.10) и <classname>FontDialogButton</classname> (доступно од верзије <application>gtkmm</application> 4.10) отварају прозорче за избор фонта када се кликне на њих.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1FontDialog.html">FontDialog Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1FontDialog.html">FontDialog референца</link>

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1FontChooserDialog.html">FontChooserDialog Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1FontChooserDialog.html">FontChooserDialog референца</link>

note: (itstool) path: figure/title
en: FontDialog
sr: Прозорче за избор фонта

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/dialogs/fontdialog">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/dialogs/fontdialog">Изворни код</link>

note: (itstool) path: section/title
en: Non-modal AboutDialog
sr: Немодално прозорче „О програму“

note: (itstool) path: section/para
en: The <classname>AboutDialog</classname> offers a simple way to display information about a program, like its logo, name, copyright, website and license.
sr: <classname>AboutDialog</classname> нуди једноставан начин за приказ података о програму, као што су његов логотип, назив, ауторска права, веб-страница и лиценца.

note: (itstool) path: section/para
en: Most dialogs in this chapter are modal, that is, they freeze the rest of the application while they are shown. It's also possible to create a non-modal dialog, which does not freeze other windows in the application. The following example shows a non-modal <classname>AboutDialog</classname>. This is perhaps not the kind of dialog you would normally make non-modal, but non-modal dialogs can be useful in other cases. E.g. <application>gedit</application>'s search-and-replace dialog is non-modal.
sr: Већина прозорчића у овом поглављу су модални, односно они замрзавају остатак апликације док су приказани. Такође је могуће направити немодално прозорче, које не замрзава остале прозоре у апликацији. Следећи пример приказује немодално прозорче <classname>AboutDialog</classname>. Ово можда није врста прозорчета коју бисте обично учинили немодалним, али немодални прозорчићи могу бити корисни у другим случајевима. Нпр. прозорче за претрагу и замену у <application>gedit-у</application> је немодално.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1AboutDialog.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1AboutDialog.html">Референце</link>

note: (itstool) path: figure/title
en: AboutDialog
sr: Прозорче „О програму“

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/dialogs/aboutdialog">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/dialogs/aboutdialog">Изворни код</link>

note: (itstool) path: section/title
en: Custom Dialog
sr: Произвољно прозорче

note: (itstool) path: section/para
en: When none of the predefined dialog classes suit your needs, you can make your own dialog by deriving a class from <classname>Window</classname> and fill it with the widgets you need.
sr: Када ниједна од унапред дефинисаних класа прозорчића не одговара вашим потребама, можете направити сопствено прозорче извођењем класе из <classname>Window</classname> и попунити је елементима који су вам потребни.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1Window.html">Window Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1Window.html">Референце прозора</link>

note: (itstool) path: figure/title
en: Window Dialog
sr: Прозорче прозора

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/dialogs/windowdialog">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/dialogs/windowdialog">Изворни код</link>

note: (itstool) path: chapter/title
en: The DrawingArea Widget
sr: Елемент DrawingArea

note: (itstool) path: chapter/para
en: The <classname>DrawingArea</classname> widget is a blank window that gives you the freedom to create any graphic you desire. Along with that freedom comes the responsibility to draw on the widget. When a widget is first shown, or when it is covered and then uncovered again it needs to redraw itself. Most widgets have code to do this, but the <classname>DrawingArea</classname> does not, allowing you to write your own draw function to determine how the contents of the widget will be drawn. This is done by setting a draw function with a call to the <methodname>set_draw_func()</methodname> member function.
sr: Елемент <classname>DrawingArea</classname> је празан прозор који вам даје слободу да креирате било коју графику коју желите. Уз ту слободу долази и одговорност исцртавања на елементу. Када се елемент први пут прикаже, или када се прекрије па поново открије, потребно је да се поново исцрта. Већина елемената има код за ово, али <classname>DrawingArea</classname> нема, што вам омогућава да напишете сопствену функцију исцртавања како бисте одредили како ће садржај елемента бити исцртан. То се постиже постављањем функције исцртавања позивом функције чланице <methodname>set_draw_func()</methodname>.

note: (itstool) path: chapter/para
en: GTK uses the <link xlink:href="http://cairographics.org">Cairo</link> drawing API. With <application>gtkmm</application>, you may use the <link xlink:href="http://www.cairographics.org/cairomm/">cairomm</link> <phrase role="nowrap">C++</phrase> API for cairo.
sr: ГТК користи <link xlink:href="http://cairographics.org">Cairo</link> АПИ за цртање. Са <application>gtkmm-ом</application>, можете користити <link xlink:href="http://www.cairographics.org/cairomm/">cairomm</link> <phrase role="nowrap">Ц++</phrase> АПИ за cairo.

note: (itstool) path: chapter/para
en: You can draw very sophisticated shapes using Cairo, but the methods to do so are quite basic. Cairo provides methods for drawing straight lines, curved lines, and arcs (including circles). These basic shapes can be combined to create more complex shapes and paths which can be filled with solid colors, gradients, patterns, and other things. In addition, Cairo can perform complex transformations, do compositing of images, and render antialiased text.
sr: Можете цртати веома софистициране облике користећи Cairo, али су методе за то прилично основне. Cairo пружа методе за цртање правих линија, кривих линија и лукова (укључујући кругове). Ови основни облици се могу комбиновати за прављење сложенијих облика и путања које се могу попунити пуним бојама, преливима, шарама и другим стварима. Поред тога, Cairo може да изврши сложене трансформације, композицију слика и исцртавање умекшаног текста.

note: (itstool) path: note/title
en: Cairo and Pango
sr: Каиро и Панго

note: (itstool) path: note/para
en: Although Cairo can render text, it's not meant to be a replacement for Pango. Pango is a better choice if you need to perform more advanced text rendering such as wrapping or ellipsizing text. Drawing text with Cairo should only be done if the text is part of a graphic.
sr: Иако Каиро може да исцртава текст, он није замишљен као замена за Панго. Панго је бољи избор ако треба да извршите напредније исцртавање текста као што је преламање или скраћивање текста. Цртање текста помоћу Каира треба радити само ако је текст део графике.

note: (itstool) path: chapter/para
en: In this section of the tutorial, we'll cover the basic Cairo drawing model, describe each of the basic drawing elements in some detail (with examples), and then present a simple application that uses Cairo to draw a custom clock widget.
sr: У овом одељку водича, покрићемо основни Каиро модел цртања, описати сваки од основних елемената цртања детаљније (са примерима), а затим представити једноставан програм који користи Каиро за цртање произвољног елемента часовника.

note: (itstool) path: section/title
en: The Cairo Drawing Model
sr: Каиро модел цртања

note: (itstool) path: section/para
en: The basic concept of drawing in Cairo involves defining 'invisible' paths and then stroking or filling them to make them visible.
sr: Основни концепт цртања у Каиру укључује дефинисање „невидљивих“ путања, а затим њихово исцртавање или попуњавање како би постале видљиве.

note: (itstool) path: section/para
en: To do any drawing in <application>gtkmm</application> with Cairo, you must first get a <classname>Cairo::Context</classname> object. This class holds all of the graphics state parameters that describe how drawing is to be done. This includes information such as line width, color, the surface to draw to, and many other things. This allows the actual drawing functions to take fewer arguments to simplify the interface. Usually, you use the <classname>Cairo::Context</classname> that you get as input data to the draw function that you set with the call to <methodname>set_draw_func()</methodname>. It's also possible to create a <classname>Cairo::Context</classname> by calling the <methodname>Gdk::Surface::create_cairo_context()</methodname> and <methodname>Gdk::CairoContext::cairo_create()</methodname> functions. Since Cairo contexts are reference-counted objects, <methodname>cairo_create()</methodname> returns a <classname>Cairo::RefPtr&lt;Cairo::Context&gt;</classname> object. (Note the difference between <classname>Gdk::CairoContext</classname> and <classname>Cairo::Context</classname>.)
sr: Да бисте извршили било какво цртање у <application>gtkmm</application>-у помоћу Каира, прво морате добити објекат <classname>Cairo::Context</classname>. Ова класа садржи све параметре графичког стања који описују како се цртање обавља. Ово укључује информације као што су ширина линије, боја, површина на којој се црта и многе друге ствари. Ово омогућава стварним функцијама цртања да примају мање аргумената како би се поједноставило прочеље. Обично користите <classname>Cairo::Context</classname> који добијете као улазне податке функцији цртања коју постављате позивом <methodname>set_draw_func()</methodname>. Такође је могуће направити <classname>Cairo::Context</classname> позивањем функција <methodname>Gdk::Surface::create_cairo_context()</methodname> и <methodname>Gdk::CairoContext::cairo_create()</methodname>. Будући да су Каиро контексти објекти са бројем референци, <methodname>cairo_create()</methodname> враћа објекат <classname>Cairo::RefPtr&lt;Cairo::Context&gt;</classname>. (Имајте на уму разлику између <classname>Gdk::CairoContext</classname> и <classname>Cairo::Context</classname>.)

note: (itstool) path: section/para
en: The following example shows how to set up a Cairo context with a foreground color of red and a width of 2. Any drawing functions that use this context will use these settings.
sr: Следећи пример показује како да подесите Каиро контекст са црвеном бојом исцртавања и ширином 2. Све функције цртања које користе овај контекст користиће ова подешавања.

note: (itstool) path: section/para
en: Each <classname>Cairo::Context</classname> is associated with a particular <classname>Gdk::Surface</classname>, so the first line of the above example creates a <classname>Gtk::DrawingArea</classname> widget and the next two lines use its associated <classname>Gdk::Surface</classname> to create a <classname>Cairo::Context</classname> object. The final two lines change the graphics state of the context.
sr: Сваки <classname>Cairo::Context</classname> је повезан са одређеном <classname>Gdk::Surface</classname> површином, тако да први ред горњег примера прави <classname>Gtk::DrawingArea</classname> елемент, а следећа два реда користе његову придружену <classname>Gdk::Surface</classname> површину за прављење <classname>Cairo::Context</classname> објекта. Последња два реда мењају графичко стање контекста.

note: (itstool) path: section/para
en: There are a number of graphics state variables that can be set for a Cairo context. The most common context attributes are color (using <methodname>set_source_rgb()</methodname> or <methodname>set_source_rgba()</methodname> for translucent colors), line width (using <methodname>set_line_width()</methodname>), line dash pattern (using <methodname>set_dash()</methodname>), line cap style (using <methodname>set_line_cap()</methodname>), and line join style (using <methodname>set_line_join()</methodname>), and font styles (using <methodname>set_font_size()</methodname>, <methodname>set_font_face()</methodname> and others). There are many other settings as well, such as transformation matrices, fill rules, whether to perform antialiasing, and others. For further information, see the <link xlink:href="http://www.cairographics.org/cairomm/">cairomm</link> API documentation.
sr: Постоји низ променљивих графичког стања које се могу поставити за Каиро контекст. Најчешћи атрибути контекста су боја (коришћењем <methodname>set_source_rgb()</methodname> или <methodname>set_source_rgba()</methodname> за провидне боје), ширина линије (коришћењем <methodname>set_line_width()</methodname>), шара испрекидане линије (коришћењем <methodname>set_dash()</methodname>), стил завршетка линије (коришћењем <methodname>set_line_cap()</methodname>), стил споја линије (коришћењем <methodname>set_line_join()</methodname>) и стилови фонта (коришћењем <methodname>set_font_size()</methodname>, <methodname>set_font_face()</methodname> и других). Постоје и многа друга подешавања, као што су матрице трансформације, правила попуњавања, да ли да се врши умекшавање ивица и друга. За даље информације, погледајте <link xlink:href="http://www.cairographics.org/cairomm/">cairomm</link> АПИ документацију.

note: (itstool) path: tip/para
en: It is good practice to put all modifications to the graphics state between <methodname>save()</methodname>/<methodname>restore()</methodname> function calls. For example, if you have a function that takes a <classname>Cairo::Context</classname> reference as an argument, you might implement it as follows:
sr: Добра је пракса ставити све измене графичког стања између позива функција <methodname>save()</methodname>/<methodname>restore()</methodname>. На пример, ако имате функцију која прима <classname>Cairo::Context</classname> референцу као аргумент, могли бисте је применити на следећи начин:

note: (itstool) path: section/para
en: The current state of a <classname>Cairo::Context</classname> can be saved to an internal stack of saved states and later be restored to the state it was in when you saved it. To do this, use the <methodname>save()</methodname> method and the <methodname>restore()</methodname> method. This can be useful if you need to temporarily change the line width and color (or any other graphics setting) in order to draw something and then return to the previous settings. In this situation, you could call <methodname>Cairo::Context::save()</methodname>, change the graphics settings, draw the lines, and then call <methodname>Cairo::Context::restore()</methodname> to restore the original graphics state. Multiple calls to <methodname>save()</methodname> and <methodname>restore()</methodname> can be nested; each call to <methodname>restore()</methodname> restores the state from the matching paired <methodname>save()</methodname>. <_:tip-1/>
sr: Тренутно стање <classname>Cairo::Context</classname> објекта може бити сачувано на унутрашњи стек сачуваних стања и касније враћено на стање у којем је било када сте га сачували. Да бисте то урадили, користите методе <methodname>save()</methodname> и <methodname>restore()</methodname>. Ово може бити корисно ако треба привремено да промените ширину линије и боју (или било које друго графичко подешавање) како бисте нешто нацртали, а затим се вратили на претходна подешавања. У овој ситуацији, могли бисте позвати <methodname>Cairo::Context::save()</methodname>, променити графичка подешавања, нацртати линије, а затим позвати <methodname>Cairo::Context::restore()</methodname> да бисте повратили првобитно графичко стање. Вишеструки позиви <methodname>save()</methodname> и <methodname>restore()</methodname> могу бити угнежђени; сваки позив <methodname>restore()</methodname> враћа стање из одговарајућег упареног <methodname>save()</methodname> позива. <_:tip-1/>

note: (itstool) path: section/para
en: The draw function that you set with a call to <methodname>set_draw_func()</methodname> is called with a Cairo context that you shall use for drawing in the <classname>Gtk::DrawingArea</classname> widget. It is not necessary to save and restore this Cairo context in the draw function.
sr: Функција цртања коју поставите позивом <methodname>set_draw_func()</methodname> позива се са Каиро контекстом који треба да користите за цртање у <classname>Gtk::DrawingArea</classname> елементу. Није неопходно чувати и враћати овај Каиро контекст у функцији цртања.

note: (itstool) path: section/title
en: Drawing Straight Lines
sr: Цртање правих линија

note: (itstool) path: tip/para
en: Since the Cairo graphics library was written with support for multiple output targets (the X window system, PNG images, OpenGL, etc), there is a distinction between user-space and device-space coordinates. The mapping between these two coordinate systems defaults to one-to-one so that integer values map roughly to pixels on the screen, but this setting can be adjusted if desired. Sometimes it may be useful to scale the coordinates so that the full width and height of a window both range from 0 to 1 (the 'unit square') or some other mapping that works for your application. This can be done with the <methodname>Cairo::Context::scale()</methodname> function.
sr: Будући да је Каиро графичка библиотека написана са подршком за више излазних циљева (X систем прозора, PNG слике, OpenGL итд.), постоји разлика између координата корисничког простора и простора уређаја. Мапирање између ова два координатна система је подразумевано један према један, тако да се целобројне вредности мапирају отприлике на пикселе на екрану, али се ово подешавање може прилагодити по жељи. Понекад може бити корисно променити размеру координата тако да пуна ширина и висина прозора буду у опсегу од 0 до 1 („јединични квадрат“) или неко друго мапирање које одговара вашем програму. Ово се може урадити помоћу функције <methodname>Cairo::Context::scale()</methodname>.

note: (itstool) path: section/para
en: Now that we understand the basics of the Cairo graphics library, we're almost ready to start drawing. We'll start with the simplest of drawing elements: the straight line. But first you need to know a little bit about Cairo's coordinate system. The origin of the Cairo coordinate system is located in the upper-left corner of the window with positive x values to the right and positive y values going down. <_:tip-1/>
sr: Сада када разумемо основе Каиро графичке библиотеке, скоро смо спремни да почнемо са цртањем. Почећемо са најједноставнијим елементом цртања: правом линијом. Али прво морате знати мало о Каировом координатном систему. Почетак Каировог координатног система налази се у горњем левом углу прозора са позитивним x вредностима удесно и позитивним y вредностима наниже. <_:tip-1/>

note: (itstool) path: section/para
en: In this example, we'll construct a small but fully functional <application>gtkmm</application> program and draw some lines into the window. The lines are drawn by creating a path and then stroking it. A path is created using the functions <methodname>Cairo::Context::move_to()</methodname> and <methodname>Cairo::Context::line_to()</methodname>. The function <methodname>move_to()</methodname> is similar to the act of lifting your pen off of the paper and placing it somewhere else -- no line is drawn between the point you were at and the point you moved to. To draw a line between two points, use the <methodname>line_to()</methodname> function.
sr: У овом примеру, конструисаћемо мали али потпуно функционалан <application>gtkmm</application> програм и нацртати неке линије у прозору. Линије се цртају прављењем путање а затим њеним исцртавањем. Путања се прави помоћу функција <methodname>Cairo::Context::move_to()</methodname> и <methodname>Cairo::Context::line_to()</methodname>. Функција <methodname>move_to()</methodname> је слична чину подизања оловке са папира и њеног постављања на друго место — линија се не црта између тачке у којој сте били и тачке у коју сте се померили. Да бисте нацртали линију између две тачке, користите функцију <methodname>line_to()</methodname>.

note: (itstool) path: section/para
en: After you've finished creating your path, you still haven't drawn anything visible yet. To make the path visible, you must use the function <methodname>stroke()</methodname> which will stroke the current path with the line width and style specified in your <classname>Cairo::Context</classname> object. After stroking, the current path will be cleared so that you can start on your next path.
sr: Након што завршите са прављењем путање, још увек нисте нацртали ништа видљиво. Да би путања постала видљива, морате користити функцију <methodname>stroke()</methodname> која ће исцртати тренутну путању са ширином линије и стилом наведеним у вашем <classname>Cairo::Context</classname> објекту. Након исцртавања, тренутна путања ће бити обрисана тако да можете почети са следећом путањом.

note: (itstool) path: tip/para
en: Many Cairo drawing functions have a <methodname>_preserve()</methodname> variant. Normally drawing functions such as <methodname>clip()</methodname>, <methodname>fill()</methodname>, or <methodname>stroke()</methodname> will clear the current path. If you use the <methodname>_preserve()</methodname> variant, the current path will be retained so that you can use the same path with the next drawing function.
sr: Многе Каиро функције цртања имају <methodname>_preserve()</methodname> варијанту. Обично функције цртања као што су <methodname>clip()</methodname>, <methodname>fill()</methodname> или <methodname>stroke()</methodname> бришу тренутну путању. Ако користите <methodname>_preserve()</methodname> варијанту, тренутна путања ће бити задржана тако да можете користити исту путању са следећом функцијом цртања.

note: (itstool) path: figure/title
en: Drawing Area - Lines
sr: Област за цртање — линије

[ctx: _]
note: (itstool) path: imageobject/imagedata This is a reference to an external file such as an image or video. When the file changes, the md5 hash will change to let you know you need to update your localized copy. The msgstr is not used at all. Set it to whatever you like once you have updated your copy 
en: external ref='figures/drawingarea_lines.png' md5='3e205f8303890e4eb2ea88487e8633e7'
sr: _:external ref='figures/drawingarea_lines.png' md5='3e205f8303890e4eb2ea88487e8633e7'

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/drawingarea/simple">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/drawingarea/simple">Изворни код</link>

note: (itstool) path: section/para
en: This program contains a single class, <classname>MyArea</classname>, which is a subclass of <classname>Gtk::DrawingArea</classname> and contains an <methodname>on_draw()</methodname> member function. This function becomes the draw function by a call to <methodname>set_draw_func()</methodname> in <classname>MyArea</classname>'s constructor. <methodname>on_draw()</methodname> is then called whenever the image in the drawing area needs to be redrawn. It is passed a <classname>Cairo::RefPtr</classname> pointer to a <classname>Cairo::Context</classname> that we use for the drawing. The actual drawing code sets the color we want to use for drawing by using <methodname>set_source_rgb()</methodname> which takes arguments defining the Red, Green, and Blue components of the desired color (valid values are between 0 and 1). After setting the color, we created a new path using the functions <methodname>move_to()</methodname> and <methodname>line_to()</methodname>, and then stroked this path with <methodname>stroke()</methodname>.
sr: Овај програм садржи једну класу, <classname>MyArea</classname>, која је подкласа <classname>Gtk::DrawingArea</classname> и садржи функцију чланицу <methodname>on_draw()</methodname>. Ова функција постаје функција за цртање позивом <methodname>set_draw_func()</methodname> у конструктору класе <classname>MyArea</classname>. <methodname>on_draw()</methodname> се затим позива кад год је потребно поново исцртати слику у области за цртање. Прослеђује јој се <classname>Cairo::RefPtr</classname> показивач на <classname>Cairo::Context</classname> који користимо за цртање. Сам код за цртање поставља боју коју желимо да користимо за цртање помоћу <methodname>set_source_rgb()</methodname> која прима аргументе који дефинишу црвену, зелену и плаву компоненту жељене боје (важеће вредности су између 0 и 1). Након постављања боје, направили смо нову путању користећи функције <methodname>move_to()</methodname> и <methodname>line_to()</methodname>, а затим исцртали ову путању помоћу <methodname>stroke()</methodname>.

note: (itstool) path: tip/title
en: Drawing with relative coordinates
sr: Цртање релативним координатама

note: (itstool) path: tip/para
en: In the example above we drew everything using absolute coordinates. You can also draw using relative coordinates. For a straight line, this is done with the function <methodname>Cairo::Context::rel_line_to()</methodname>.
sr: У горњем примеру смо све нацртали користећи апсолутне координате. Такође можете цртати користећи релативне координате. За праву линију, то се ради помоћу функције <methodname>Cairo::Context::rel_line_to()</methodname>.

note: (itstool) path: section/title
en: Line styles
sr: Стилови линија

note: (itstool) path: section/para
en: In addition to drawing basic straight lines, there are a number of things that you can customize about a line. You've already seen examples of setting a line's color and width, but there are others as well.
sr: Поред цртања основних правих линија, постоји низ ствари које можете прилагодити код линије. Већ сте видели примере постављања боје и ширине линије, али постоје и други.

note: (itstool) path: section/para
en: If you've drawn a series of lines that form a path, you may want them to join together in a certain way. Cairo offers three different ways to join lines together: Miter, Bevel, and Round. These are show below:
sr: Ако сте нацртали низ линија које чине путању, можда ћете желети да их спојите на одређени начин. Каиро нуди три различита начина за спајање линија: угаоно (Miter), косо (Bevel) и заобљено (Round). Они су приказани испод:

note: (itstool) path: figure/title
en: Different join types in Cairo
sr: Различите врсте спојева у Каиру

[ctx: _]
note: (itstool) path: imageobject/imagedata This is a reference to an external file such as an image or video. When the file changes, the md5 hash will change to let you know you need to update your localized copy. The msgstr is not used at all. Set it to whatever you like once you have updated your copy 
en: external ref='figures/cairo_joins.png' md5='1b1e2a28e976039f1e4a0aa523ac40fb'
sr: _:external ref='figures/cairo_joins.png' md5='1b1e2a28e976039f1e4a0aa523ac40fb'

note: (itstool) path: section/para
en: The line join style is set using the function <methodname>Cairo::Context::set_line_join()</methodname>.
sr: Стил споја линија се поставља помоћу функције <methodname>Cairo::Context::set_line_join()</methodname>.

note: (itstool) path: section/para
en: Line ends can have different styles as well. The default style is for the line to start and stop exactly at the destination points of the line. This is called a Butt cap. The other options are Round (uses a round ending, with the center of the circle at the end point) or Square (uses a squared ending, with the center of the square at the end point). This setting is set using the function <methodname>Cairo::Context::set_line_cap()</methodname>.
sr: Крајеви линија такође могу имати различите стилове. Подразумевани стил је да линија почиње и зауставља се тачно у одредишним тачкама линије. Ово се зове оштар (Butt) завршетак. Друге опције су заобљено (Round — користи заобљени завршетак, са центром круга у крајњој тачки) или квадратно (Square — користи квадратни завршетак, са центром квадрата у крајњој тачки). Ово подешавање се поставља помоћу функције <methodname>Cairo::Context::set_line_cap()</methodname>.

note: (itstool) path: section/para
en: There are other things you can customize as well, including creating dashed lines and other things. For more information, see the Cairo API documentation. Dashed lines are shown in the example in the <link linkend="cairo-example-curves">Drawing Curved Lines</link> section.
sr: Постоје и друге ствари које можете прилагодити, укључујући прављење испрекиданих линија и друго. За више информација погледајте документацију за Каиро АПИ. Испрекидане линије су приказане у примеру у одељку <link linkend="cairo-example-curves">Цртање закривљених линија</link>.

note: (itstool) path: section/title
en: Drawing thin lines
sr: Цртање танких линија

note: (itstool) path: section/para
en: If you try to draw one pixel wide lines, you may notice that the line sometimes comes up blurred and wider than it ought to be. This happens because Cairo will try to draw from the selected position, to both sides (half to each), so if you're positioned right on the intersection of the pixels, and want a one pixel wide line, Cairo will try to use half of each adjacent pixel, which isn't possible (a pixel is the smallest unit possible). This happens when the width of the line is an odd number of pixels (not just one pixel).
sr: Ако покушате да нацртате линије ширине једног пиксела, можда ћете приметити да линија понекад испадне замућена и шира него што би требало да буде. То се дешава зато што ће Каиро покушати да црта са изабране позиције на обе стране (по пола на сваку), па ако сте позиционирани тачно на пресеку пиксела, а желите линију ширине једног пиксела, Каиро ће покушати да искористи половину сваког суседног пиксела, што није могуће (пиксел је најмања могућа јединица). Ово се дешава када је ширина линије непаран број пиксела (не само један пиксел).

note: (itstool) path: section/para
en: The trick is to position in the middle of the pixel where you want the line to be drawn, and thus guaranteeing you get the desired results. See <link xlink:href="http://cairographics.org/FAQ/#sharp_lines">Cairo FAQ</link>.
sr: Трик је у томе да се позиционирате у средину пиксела где желите да линија буде исцртана, чиме се гарантује добијање жељених резултата. Погледајте <link xlink:href="http://cairographics.org/FAQ/#sharp_lines">Каиро ЧПП</link>.

note: (itstool) path: figure/title
en: Drawing Area - Thin Lines
sr: Област за цртање — танке линије

[ctx: _]
note: (itstool) path: imageobject/imagedata This is a reference to an external file such as an image or video. When the file changes, the md5 hash will change to let you know you need to update your localized copy. The msgstr is not used at all. Set it to whatever you like once you have updated your copy 
en: external ref='figures/drawingarea_thin_lines.png' md5='589cbad88ee60c46503e89c4318822a1'
sr: _:external ref='figures/drawingarea_thin_lines.png' md5='589cbad88ee60c46503e89c4318822a1'

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/drawingarea/thin_lines">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/drawingarea/thin_lines">Изворни код</link>

note: (itstool) path: section/title
en: Drawing Curved Lines
sr: Цртање кривих линија

note: (itstool) path: section/para
en: In addition to drawing straight lines Cairo allows you to easily draw curved lines (technically a cubic Bézier spline) using the <methodname>Cairo::Context::curve_to()</methodname> and <methodname>Cairo::Context::rel_curve_to()</methodname> functions. These functions take coordinates for a destination point as well as coordinates for two 'control' points. This is best explained using an example, so let's dive in.
sr: Поред цртања правих линија, Каиро вам омогућава да лако цртате криве линије (технички кубни Безјеров сп-крива) користећи функције <methodname>Cairo::Context::curve_to()</methodname> и <methodname>Cairo::Context::rel_curve_to()</methodname>. Ове функције узимају координате за одредишну тачку као и координате за две „контролне“ тачке. Ово је најбоље објашњено на примеру, па хајде да уронимо у то.

note: (itstool) path: section/para
en: This simple application draws a curve with Cairo and displays the control points for each end of the curve.
sr: Ова једноставна апликација црта криву помоћу Каира и приказује контролне тачке за сваки крај криве.

note: (itstool) path: figure/title
en: Drawing Area - Curve
sr: Површина за цртање — Крива

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/drawingarea/curve">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/drawingarea/curve">Изворни код</link>

note: (itstool) path: section/para
en: The only difference between this example and the straight line example is in the <methodname>on_draw()</methodname> function, but there are a few new concepts and functions introduced here, so let's examine them briefly.
sr: Једина разлика између овог примера и примера са правом линијом је у функцији <methodname>on_draw()</methodname>, али овде је уведено неколико нових концепата и функција, па хајде да их укратко испитамо.

note: (itstool) path: section/para
en: We make a call to <methodname>Cairo::Context::scale()</methodname>, passing in the width and height of the drawing area. This scales the user-space coordinate system such that the width and height of the widget are both equal to 1.0 'units'. There's no particular reason to scale the coordinate system in this case, but sometimes it can make drawing operations easier.
sr: Позивамо <methodname>Cairo::Context::scale()</methodname>, прослеђујући ширину и висину површине за цртање. Ово мења размеру координатног система корисничког простора тако да су и ширина и висина елемента једнаке 1,0 „јединица“. Нема посебног разлога за промену размере координатног система у овом случају, али понекад то може олакшати операције цртања.

note: (itstool) path: section/para
en: The call to <methodname>Cairo::Context::curve_to()</methodname> should be fairly self-explanatory. The first pair of coordinates define the control point for the beginning of the curve. The second set of coordinates define the control point for the end of the curve, and the last set of coordinates define the destination point. To make the concept of control points a bit easier to visualize, a line has been drawn from each control point to the end-point on the curve that it is associated with. Note that these control point lines are both translucent. This is achieved with a variant of <methodname>set_source_rgb()</methodname> called <methodname>set_source_rgba()</methodname>. This function takes a fourth argument specifying the alpha value of the color (valid values are between 0 and 1).
sr: Позив <methodname>Cairo::Context::curve_to()</methodname> би требало да буде прилично јасан сам по себи. Први пар координата дефинише контролну тачку за почетак криве. Други скуп координата дефинише контролну тачку за крај криве, а последњи скуп координата дефинише одредишну тачку. Да би концепт контролних тачака био мало лакши за визуелизацију, повучена је линија од сваке контролне тачке до крајње тачке на кривој са којом је повезана. Имајте на уму да су ове линије контролних тачака провидне. Ово се постиже варијантом <methodname>set_source_rgb()</methodname> која се зове <methodname>set_source_rgba()</methodname>. Ова функција узима четврти аргумент који одређује алфа вредност боје (важеће вредности су између 0 и 1).

note: (itstool) path: section/para
en: The control point lines are dashed lines. These are just two possible variations. Dashed lines can be more complicated. For instance the dashes can have different lengths like in dash-dotted lines.
sr: Линије контролних тачака су испрекидане линије. Ово су само две могуће варијације. Испрекидане линије могу бити сложеније. На пример, цртице могу имати различите дужине као код линија са цртицама и тачкама.

note: (itstool) path: section/title
en: Drawing Arcs and Circles
sr: Цртање лукова и кругова

note: (itstool) path: section/para
en: With Cairo, the same function is used to draw arcs, circles, or ellipses: <methodname>Cairo::Context::arc()</methodname>. This function takes five arguments. The first two are the coordinates of the center point of the arc, the third argument is the radius of the arc, and the final two arguments define the start and end angle of the arc. All angles are defined in radians, so drawing a circle is the same as drawing an arc from 0 to 2 * M_PI radians. An angle of 0 is in the direction of the positive X axis (in user-space). An angle of M_PI/2 radians (90 degrees) is in the direction of the positive Y axis (in user-space). Angles increase in the direction from the positive X axis toward the positive Y axis. So with the default transformation matrix, angles increase in a clockwise direction. (Remember that the positive Y axis points downwards.)
sr: Са Каиром, иста функција се користи за цртање лукова, кругова или елипси: <methodname>Cairo::Context::arc()</methodname>. Ова функција узима пет аргумената. Прва два су координате средишње тачке лука, трећи аргумент је полупречник лука, а последња два аргумента дефинишу почетни и крајњи угао лука. Сви углови су дефинисани у радијанима, тако да је цртање круга исто што и цртање лука од 0 до 2 * M_PI радијана. Угао 0 је у смеру позитивне X осе (у корисничком простору). Угао од M_PI/2 радијана (90 степени) је у смеру позитивне Y осе (у корисничком простору). Углови се повећавају у смеру од позитивне X осе према позитивној Y оси. Дакле, са подразумеваном матрицом преображаја, углови се повећавају у смеру казаљке на сату. (Запамтите да позитивна Y оса показује надоле.)

note: (itstool) path: section/para
en: To draw an ellipse, you can scale the current transformation matrix by different amounts in the X and Y directions. For example, to draw an ellipse with center at <varname>x</varname>, <varname>y</varname> and size <varname>width</varname>, <varname>height</varname>:
sr: Да бисте нацртали елипсу, можете променити размеру тренутне матрице преображаја за различите износе у X и Y смеровима. На пример, да бисте нацртали елипсу са средиштем у <varname>x</varname>, <varname>y</varname> и величином <varname>width</varname>, <varname>height</varname>:

note: (itstool) path: section/para
en: Here's an example of a simple program that draws an arc, a circle and an ellipse into a drawing area.
sr: Ево примера једноставног програма који црта лук, круг и елипсу у површини за цртање.

note: (itstool) path: figure/title
en: Drawing Area - Arcs
sr: Површина за цртање — Лукови

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/drawingarea/arcs">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/drawingarea/arcs">Изворни код</link>

note: (itstool) path: section/para
en: There are a couple of things to note about this example code. Again, the only real difference between this example and the previous ones is the <methodname>on_draw()</methodname> function, so we'll limit our focus to that function. In addition, the first part of the function is nearly identical to the previous examples, so we'll skip that portion.
sr: Постоји неколико ствари које треба приметити у вези са овим кодним примером. Опет, једина стварна разлика између овог примера и претходних је функција <methodname>on_draw()</methodname>, па ћемо се ограничити на ту функцију. Поред тога, први део функције је скоро идентичан претходним примерима, па ћемо прескочити тај део.

note: (itstool) path: section/para
en: Note that in this case, we've expressed nearly everything in terms of the height and width of the window, including the width of the lines. Because of this, when you resize the window, everything scales with the window. Also note that there are three drawing sections in the function and each is wrapped with a <methodname>save()</methodname>/<methodname>restore()</methodname> pair so that we're back at a known state after each drawing.
sr: Имајте на уму да смо у овом случају скоро све изразили кроз висину и ширину прозора, укључујући и ширину линија. Због тога, када промените величину прозора, све се сразмерно мења са прозором. Такође имајте на уму да у функцији постоје три одељка за цртање и сваки је обмотан паром <methodname>save()</methodname>/<methodname>restore()</methodname> тако да се враћамо у познато стање након сваког цртања.

note: (itstool) path: section/para
en: The section for drawing an arc introduces one new function, <methodname>close_path()</methodname>. This function will in effect draw a straight line from the current point back to the first point in the path. There is a significant difference between calling <methodname>close_path()</methodname> and manually drawing a line back to the starting point, however. If you use <methodname>close_path()</methodname>, the lines will be nicely joined together. If you use <methodname>line_to()</methodname> instead, the lines will end at the same point, but Cairo won't do any special joining.
sr: Одељак за цртање лука уводи једну нову функцију, <methodname>close_path()</methodname>. Ова функција ће заправо нацртати праву линију од тренутне тачке назад до прве тачке на путањи. Међутим, постоји значајна разлика између позивања <methodname>close_path()</methodname> и ручног цртања линије назад до почетне тачке. Ако користите <methodname>close_path()</methodname>, линије ће бити лепо спојене. Ако уместо тога користите <methodname>line_to()</methodname>, линије ће се завршити у истој тачки, али Каиро неће извршити никакво посебно спајање.

note: (itstool) path: note/title
en: Drawing counter-clockwise
sr: Цртање супротно смеру казаљке на сату

note: (itstool) path: note/para
en: The function <methodname>Cairo::Context::arc_negative()</methodname> is exactly the same as <methodname>Cairo::Context::arc()</methodname> but the angles go the opposite direction.
sr: Функција <methodname>Cairo::Context::arc_negative()</methodname> је потпуно иста као <methodname>Cairo::Context::arc()</methodname>, али углови иду у супротном смеру.

note: (itstool) path: section/title
en: Drawing Text
sr: Цртање текста

note: (itstool) path: section/title
en: Drawing Text with Pango
sr: Цртање текста помоћу Панга

note: (itstool) path: section/para
en: Text is drawn via Pango Layouts. The easiest way to create a <classname>Pango::Layout</classname> is to use <methodname>Gtk::Widget::create_pango_layout()</methodname>. Once created, the layout can be manipulated in various ways, including changing the text, font, etc. Finally, the layout can be rendered using the <methodname>Pango::Layout::show_in_cairo_context()</methodname> method.
sr: Текст се исцртава путем Панго распореда. Најлакши начин за прављење <classname>Pango::Layout</classname> објекта је коришћење <methodname>Gtk::Widget::create_pango_layout()</methodname>. Након што се направи, распоредом се може управљати на различите начине, укључујући промену текста, фонта итд. На крају, распоред се може исцртати коришћењем методе <methodname>Pango::Layout::show_in_cairo_context()</methodname>.

note: (itstool) path: section/para
en: Here is an example of a program that draws some text, some of it upside-down. The Printing chapter contains another <link linkend="sec-printing-examples">example</link> of drawing text.
sr: Ево примера програма који исцртава неки текст, а неки од њега наопачке. Поглавље о штампању садржи још један <link linkend="sec-printing-examples">пример</link> исцртавања текста.

note: (itstool) path: figure/title
en: Drawing Area - Text
sr: Површина за цртање — Текст

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/drawingarea/pango_text">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/drawingarea/pango_text">Изворни код</link>

note: (itstool) path: section/title
en: Drawing Images
sr: Цртање слика

note: (itstool) path: section/para
en: There is a method for drawing from a <classname>Gdk::Pixbuf</classname> to a <classname>Cairo::Context</classname>. A <classname>Gdk::Pixbuf</classname> buffer is a useful wrapper around a collection of pixels, which can be read from files, and manipulated in various ways.
sr: Постоји метода за цртање из <classname>Gdk::Pixbuf</classname> у <classname>Cairo::Context</classname>. <classname>Gdk::Pixbuf</classname> бафер је користан омотач око збирке пиксела, који се могу читати из датотека и којима се може управљати на различите начине.

note: (itstool) path: section/para
en: Probably the most common way of creating <classname>Gdk::Pixbuf</classname>s is to use <methodname>Gdk::Pixbuf::create_from_file()</methodname> or <methodname>Gdk::Pixbuf::create_from_resource()</methodname>, which can read an image file, such as a png file into a pixbuf ready for rendering.
sr: Вероватно најчешћи начин прављења <classname>Gdk::Pixbuf</classname> објеката је коришћење <methodname>Gdk::Pixbuf::create_from_file()</methodname> или <methodname>Gdk::Pixbuf::create_from_resource()</methodname>, који могу учитати датотеку слике, као што је png датотека, у пиксбаф спреман за исцртавање.

note: (itstool) path: section/para
en: The <classname>Gdk::Pixbuf</classname> can be rendered by setting it as the source pattern of the Cairo context with <methodname>Gdk::Cairo::set_source_pixbuf()</methodname>. Then draw the image with either <methodname>Cairo::Context::paint()</methodname> (to draw the whole image), or <methodname>Cairo::Context::rectangle()</methodname> and <methodname>Cairo::Context::fill()</methodname> (to fill the specified rectangle). <methodname>set_source_pixbuf()</methodname> is not a member of <classname>Cairo::Context</classname>. It takes a <classname>Cairo::Context</classname> as its first parameter.
sr: <classname>Gdk::Pixbuf</classname> се може исцртати постављањем као изворни шаблон Каиро контекста помоћу <methodname>Gdk::Cairo::set_source_pixbuf()</methodname>. Затим нацртајте слику помоћу <methodname>Cairo::Context::paint()</methodname> (за цртање целе слике), или <methodname>Cairo::Context::rectangle()</methodname> и <methodname>Cairo::Context::fill()</methodname> (за попуњавање наведеног правоугаоника). <methodname>set_source_pixbuf()</methodname> није члан класе <classname>Cairo::Context</classname>. Она узима <classname>Cairo::Context</classname> као свој први параметар.

note: (itstool) path: section/para
en: Here is a small bit of code to tie it all together: (Note that usually you wouldn't load the image every time in the draw signal handler! It's just shown here to keep it all together.)
sr: Ево малог дела кода који све то повезује: (Имајте на уму да обично не бисте учитавали слику сваки пут у руковаоцу сигнала за цртање! То је овде приказано само да би све било на једном месту.)

note: (itstool) path: section/para
en: Here is an example of a simple program that draws an image. The program loads the image from a resource file. See the <link linkend="sec-gio-resource">Gio::Resource and glib-compile-resources</link> section. Use <application>glib-compile-resources</application> to compile the resources into a C source file that can be compiled and linked with the <phrase role="nowrap">C++</phrase> code. E.g. <_:screen-1/>
sr: Ево примера једноставног програма који исцртава слику. Програм учитава слику из датотеке ресурса. Погледајте одељак <link linkend="sec-gio-resource">Gio::Resource и glib-compile-resources</link>. Користите <application>glib-compile-resources</application> за компајлирање ресурса у C изворну датотеку која се може компајлирати и повезати са <phrase role="nowrap">C++</phrase> кодом. Нпр. <_:screen-1/>

note: (itstool) path: figure/title
en: Drawing Area - Image
sr: Површина за цртање — Слика

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/drawingarea/image">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/drawingarea/image">Изворни код</link>

note: (itstool) path: section/title
en: Example Application: Creating a Clock with Cairo
sr: Пример апликације: Прављење сата помоћу Каира

note: (itstool) path: section/para
en: Now that we've covered the basics of drawing with Cairo, let's try to put it all together and create a simple application that actually does something. The following example uses Cairo to create a custom <classname>Clock</classname> widget. The clock has a second hand, a minute hand, and an hour hand, and updates itself every second.
sr: Сада када смо покрили основе цртања помоћу Каира, хајде да покушамо да све то повежемо и направимо једноставну апликацију која заправо нешто ради. Следећи пример користи Каиро за прављење произвољног <classname>Clock</classname> елемента. Сат има секундну, минутну и сатну казаљку, и ажурира се сваке секунде.

[ctx: _]
note: (itstool) path: imageobject/imagedata This is a reference to an external file such as an image or video. When the file changes, the md5 hash will change to let you know you need to update your localized copy. The msgstr is not used at all. Set it to whatever you like once you have updated your copy 
en: external ref='figures/cairo_clock.png' md5='fceab985fd70bec94b273f78dd481d31'
sr: _:external ref='figures/cairo_clock.png' md5='fceab985fd70bec94b273f78dd481d31'

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/drawingarea/clock">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/drawingarea/clock">Изворни код</link>

note: (itstool) path: section/para
en: As before, almost all of the interesting stuff is done in the draw function <methodname>on_draw()</methodname>. Before we dig into the draw function, notice that the constructor for the <classname>Clock</classname> widget connects a handler function <methodname>on_timeout()</methodname> to a timer with a timeout period of 1000 milliseconds (1 second). This means that <methodname>on_timeout()</methodname> will get called once per second. The sole responsibility of this function is to invalidate the window so that <application>gtkmm</application> will be forced to redraw it.
sr: Као и раније, скоро све занимљиве ствари се обављају у функцији исцртавања <methodname>on_draw()</methodname>. Пре него што заронимо у функцију исцртавања, приметимо да конструктор за елемент <classname>Clock</classname> повезује функцију руковаоца <methodname>on_timeout()</methodname> са одбројавачем са периодом истека од 1000 милисекунди (1 секунда). То значи да ће <methodname>on_timeout()</methodname> бити позивана једном у секунди. Једина одговорност ове функције је да поништи прозор како би <application>gtkmm</application> био приморан да га поново исцрта.

note: (itstool) path: section/para
en: Now let's take a look at the code that performs the actual drawing. The first section of <methodname>on_draw()</methodname> should be pretty familiar by now. This example again scales the coordinate system to be a unit square so that it's easier to draw the clock as a percentage of window size so that it will automatically scale when the window size is adjusted. Furthermore, the coordinate system is scaled over and down so that the (0, 0) coordinate is in the very center of the window.
sr: Сада погледајмо код који обавља стварно цртање. Први одељак <methodname>on_draw()</methodname> би до сада требало да буде прилично познат. Овај пример поново мења размеру координатног система тако да буде јединични квадрат како би било лакше нацртати сат као проценат величине прозора, тако да се аутоматски прилагођава када се промени величина прозора. Надаље, координатни систем је померен тако да се координата (0, 0) налази у самом центру прозора.

note: (itstool) path: section/para
en: The function <methodname>Cairo::Context::paint()</methodname> is used here to set the background color of the window. This function takes no arguments and fills the current surface (or the clipped portion of the surface) with the source color currently active. After setting the background color of the window, we draw a circle for the clock outline, fill it with white, and then stroke the outline in black. Notice that both of these actions use the <methodname>_preserve</methodname> variant to preserve the current path, and then this same path is clipped to make sure that our next lines don't go outside the outline of the clock.
sr: Функција <methodname>Cairo::Context::paint()</methodname> се овде користи за постављање боје позадине прозора. Ова функција не узима аргументе и попуњава тренутну површину (или исечени део површине) тренутно активном изворном бојом. Након постављања боје позадине прозора, цртамо круг за обрис сата, попуњавамо га белом бојом, а затим исцртавамо обрис црном бојом. Приметите да обе ове радње користе варијанту <methodname>_preserve</methodname> како би се сачувала тренутна путања, а затим се та иста путања исеца како бисмо били сигурни да наше следеће линије не изађу ван обриса сата.

note: (itstool) path: section/para
en: After drawing the outline, we go around the clock and draw ticks for every hour, with a larger tick at 12, 3, 6, and 9. Now we're finally ready to implement the time-keeping functionality of the clock, which simply involves getting the current values for hours, minutes and seconds, and drawing the hands at the correct angles.
sr: Након цртања обриса, идемо око сата и цртамо цртице за сваки сат, са већом цртицом на 12, 3, 6 и 9. Сада смо коначно спремни да имплементирамо функционалност мерења времена сата, што једноставно укључује добављање тренутних вредности за сате, минуте и секунде, и цртање казаљки под исправним угловима.

note: (itstool) path: chapter/para
en: The <classname>Gtk::DragSource</classname> and <classname>Gtk::DropTarget</classname> event controllers have methods and signals which are used for Drag and Drop.
sr: Управљачи догађајима <classname>Gtk::DragSource</classname> и <classname>Gtk::DropTarget</classname> имају методе и сигнале који се користе за превлачење и спуштање.

note: (itstool) path: section/title
en: Sources and Targets
sr: Извори и циљеви

note: (itstool) path: section/para
en: Things are dragged from <literal>sources</literal> to be dropped on <literal>targets</literal>. Each source and target has information about the data formats that it can send or receive, provided by <classname>Gdk::ContentFormats</classname>. A drop target will only accept a dragged item if they both share a compatible format. Appropriate signals will then be emitted, telling the signal handlers which format was used.
sr: Ствари се превлаче са <literal>извора</literal> да би се спустиле на <literal>циљеве</literal>. Сваки извор и циљ има податке о форматима података које може да пошаље или прими, које обезбеђује <classname>Gdk::ContentFormats</classname>. Циљ спуштања ће прихватити превучену ставку само ако обоје деле компатибилан формат. Тада ће бити емитовани одговарајући сигнали, који говоре руковаоцима сигнала који формат је коришћен.

note: (itstool) path: section/para
en: <classname>Gdk::ContentFormats</classname> objects contain information about available <type>GType</type>s and mime types (media types).
sr: Објекти <classname>Gdk::ContentFormats</classname> садрже податке о доступним <type>GType</type> врстама и миме врстама (медијским врстама).

note: (itstool) path: section/para
en: <classname>Widget</classname>s can be identified as sources or targets using <classname>Gtk::DragSource</classname> and <classname>Gtk::DropTarget</classname> event controllers.
sr: Елементи се могу препознати као извори или циљеви коришћењем управљача догађајима <classname>Gtk::DragSource</classname> и <classname>Gtk::DropTarget</classname>.

note: (itstool) path: listitem/para
en: <literal>void set_content(const Glib::RefPtr&lt;Gdk::ContentProvider&gt;&amp; content)</literal>: Sets a content provider on the drag source.
sr: <literal>void set_content(const Glib::RefPtr&lt;Gdk::ContentProvider&gt;&amp; content)</literal>: Поставља достављача садржаја на извор превлачења.

note: (itstool) path: listitem/para
en: <literal>void set_actions(Gdk::DragAction actions)</literal>: Sets the actions on the drag source. For instance <literal>Gdk::DragAction::COPY | Gdk::DragAction::MOVE</literal>.
sr: <literal>void set_actions(Gdk::DragAction actions)</literal>: Поставља радње на извор превлачења. На пример <literal>Gdk::DragAction::COPY | Gdk::DragAction::MOVE</literal>.

note: (itstool) path: listitem/para
en: <literal>void set_icon(const Glib::RefPtr&lt;const Gdk::Paintable&gt;&amp; paintable, int hot_x, int hot_y)</literal>: Sets a paintable to use as icon during DND operations.
sr: <literal>void set_icon(const Glib::RefPtr&lt;const Gdk::Paintable&gt;&amp; paintable, int hot_x, int hot_y)</literal>: Поставља објекат за исцртавање који ће се користити као иконица током операција превлачења и спуштања.

note: (itstool) path: section/para
en: Some <classname>DragSource</classname> methods: <_:itemizedlist-1/>
sr: Неке методе <classname>DragSource</classname>: <_:itemizedlist-1/>

note: (itstool) path: listitem/para
en: <literal>void set_gtypes(const std::vector&lt;GType&gt;&amp; types)</literal>: Sets the supported types for this drop target.
sr: <literal>void set_gtypes(const std::vector&lt;GType&gt;&amp; types)</literal>: Поставља подржане врсте за овај циљ спуштања.

note: (itstool) path: listitem/para
en: <literal>void set_actions(Gdk::DragAction actions)</literal>: Sets the actions that this drop target supports.
sr: <literal>void set_actions(Gdk::DragAction actions)</literal>: Поставља радње које овај циљ спуштања подржава.

note: (itstool) path: listitem/para
en: <literal>Glib::ValueBase get_value() const</literal>: Gets the current drop data, as a <classname>Glib::Value</classname>.
sr: <literal>Glib::ValueBase get_value() const</literal>: Добавља тренутне податке за спуштање, као <classname>Glib::Value</classname>.

note: (itstool) path: listitem/para
en: <literal>void reject()</literal>: Rejects the ongoing drop operation. This function should be used when delaying the decision on whether to accept a drag or not until after reading the data.
sr: <literal>void reject()</literal>: Одбија текућу радњу спуштања. Ову функцију треба користити када се одлаже одлука о томе да ли да се прихвати превлачење или не до након читања података.

note: (itstool) path: section/para
en: Some <classname>DropTarget</classname> methods: <_:itemizedlist-1/>
sr: Неки начини за <classname>DropTarget</classname>: <_:itemizedlist-1/>

note: (itstool) path: section/para
en: When a drop target has accepted a dragged item, certain signals will be emitted, depending on what action has been selected. For instance, the user might have held down the <keycap>Shift</keycap> key to specify a <literal>move</literal> rather than a <literal>copy</literal>. Remember that the user can only select the actions which you have specified in your calls to <methodname>Gtk::DragSource::set_actions()</methodname> and <methodname>Gtk::DropTarget::set_actions()</methodname>.
sr: Када одредиште спуштања прихвати превучену ставку, биће емитовани одређени сигнали, у зависности од тога која је радња изабрана. На пример, корисник је можда држао тастер <keycap>Shift</keycap> да би навео <literal>move</literal> (премештање) уместо <literal>copy</literal> (копирање). Запамтите да корисник може изабрати само оне радње које сте навели у вашим позивима функцијама <methodname>Gtk::DragSource::set_actions()</methodname> и <methodname>Gtk::DropTarget::set_actions()</methodname>.

note: (itstool) path: listitem/para
en: <literal>drag_begin</literal>: Provides a <classname>Gdk::Drag</classname>.
sr: <literal>drag_begin</literal>: Обезбеђује <classname>Gdk::Drag</classname>.

note: (itstool) path: listitem/para
en: <literal>prepare</literal>: Shall return a <classname>Gdk::ContentProvider</classname>, with the data to use for the drag that is about to start.
sr: <literal>prepare</literal>: Треба да врати <classname>Gdk::ContentProvider</classname>, са подацима који ће се користити за превлачење које управо почиње.

note: (itstool) path: listitem/para
en: <literal>drag_end</literal>: Provides a <classname>Gdk::Drag</classname>, and a <type>bool</type> that tells if the drag was performing a <literal>move</literal> and the data should be deleted.
sr: <literal>drag_end</literal>: Обезбеђује <classname>Gdk::Drag</classname>, и <type>bool</type> који каже да ли је превлачење извршавало <literal>move</literal> (премештање) и да ли податке треба обрисати.

note: (itstool) path: listitem/para
en: <literal>drag_cancel</literal>: Emitted on the drag source when a drag has failed.
sr: <literal>drag_cancel</literal>: Емитује се на извору превлачења када превлачење не успе.

note: (itstool) path: section/para
en: The source widget will emit these <classname>DragSource</classname> signals: <_:itemizedlist-1/>
sr: Изворни елемент ће емитовати ове <classname>DragSource</classname> сигнале: <_:itemizedlist-1/>

note: (itstool) path: listitem/para
en: <literal>enter</literal>: Provides coordinates. Shall return the preferred <type>Gdk::DragAction</type>.
sr: <literal>enter</literal>: Обезбеђује координате. Треба да врати жељени <type>Gdk::DragAction</type>.

note: (itstool) path: listitem/para
en: <literal>motion</literal>: Provides coordinates. Shall return the preferred <type>Gdk::DragAction</type>.
sr: <literal>motion</literal>: Обезбеђује координате. Треба да врати жељени <type>Gdk::DragAction</type>.

note: (itstool) path: listitem/para
en: <literal>leave</literal>: Emitted on the drop site when the pointer leaves the widget.
sr: <literal>leave</literal>: Емитује се на месту спуштања када показивач напусти елемент.

note: (itstool) path: listitem/para
en: <literal>accept</literal>: Provides a <classname>Gdk::Drop</classname>. You can call the <methodname>status()</methodname> method of the <classname>Gdk::Drop</classname> to indicate which actions will be accepted.
sr: <literal>accept</literal>: Обезбеђује <classname>Gdk::Drop</classname>. Можете позвати метод <methodname>status()</methodname> објекта <classname>Gdk::Drop</classname> да назначите које ће радње бити прихваћене.

note: (itstool) path: listitem/para
en: <literal>drop</literal>: Provides the data being dropped and coordinates. Shall return a <type>bool</type> indicating whether the drop was accepted.
sr: <literal>drop</literal>: Обезбеђује податке који се спуштају и координате. Треба да врати <type>bool</type> који указује на то да ли је спуштање прихваћено.

note: (itstool) path: section/para
en: The target widget will emit these <classname>DropTarget</classname> signals: <_:itemizedlist-1/>
sr: Циљни елемент ће емитовати ове <classname>DropTarget</classname> сигнале: <_:itemizedlist-1/>

note: (itstool) path: section/para
en: The following signals call only one signal handler when emitted. When you connect a handler to such a signal, your signal handler must be called before (instead of) the default handler, otherwise it won't be called. Set the <literal>after</literal> parameter in <methodname>connect()</methodname> to <literal>false</literal>. <_:itemizedlist-1/>
sr: Следећи сигнали позивају само једног руковаоца сигналом када се емитују. Када повежете руковаоца на такав сигнал, ваш руковалац сигналом мора бити позван пре (уместо) подразумеваног руковаоца, иначе неће бити позван. Поставите параметар <literal>after</literal> у <methodname>connect()</methodname> на <literal>false</literal>. <_:itemizedlist-1/>

note: (itstool) path: section/para
en: Here is a very simple example, demonstrating a drag and drop <literal>Copy</literal> operation:
sr: Ево веома једноставног примера који демонстрира радњу превлачења и спуштања <literal>Copy</literal> (умножи):

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/drag_and_drop">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/drag_and_drop">Изворни ко̂д</link>

note: (itstool) path: section/para
en: There is a more complex example in examples/others/dnd.
sr: Постоји сложенији пример у examples/others/dnd.

note: (itstool) path: chapter/title
en: The Clipboard
sr: Остава

note: (itstool) path: chapter/para
en: Simple text copy-paste functionality is provided for free by widgets such as <classname>Gtk::Entry</classname> and <classname>Gtk::TextView</classname>, but you might need special code to deal with your own data formats. For instance, a drawing program would need special code to allow copy and paste within a view, or between documents.
sr: Једноставна функционалност умножавања и убацивања текста је обезбеђена бесплатно од стране елемената као што су <classname>Gtk::Entry</classname> и <classname>Gtk::TextView</classname>, али ће вам можда требати посебан ко̂д за рад са вашим сопственим форматима података. На пример, програм за цртање би захтевао посебан ко̂д како би омогућио умножавање и убацивање унутар прегледа или између докумената.

note: (itstool) path: chapter/para
en: You can get a clipboard instance with <methodname>Gtk::Widget::get_clipboard()</methodname> or <methodname>Gdk::Display::get_clipboard()</methodname>.
sr: Примерак оставе можете добити помоћу <methodname>Gtk::Widget::get_clipboard()</methodname> или <methodname>Gdk::Display::get_clipboard()</methodname>.

note: (itstool) path: chapter/para
en: Your application doesn't need to wait for clipboard operations, particularly between the time when the user chooses Copy and then later chooses Paste. Many <classname>Gdk::Clipboard</classname> methods take <classname>sigc::slot</classname>s which specify callback methods. When <classname>Gdk::Clipboard</classname> is ready, it will call these methods, providing the requested data.
sr: Ваш програм не мора да чека на операције са оставом, нарочито између времена када корисник изабере „Умножи“ а затим касније изабере „Убаци“. Многе методе класе <classname>Gdk::Clipboard</classname> примају <classname>sigc::slot</classname>-ове који одређују методе повратног позива. Када је <classname>Gdk::Clipboard</classname> спреман, он ће позвати ове методе, достављајући захтеване податке.

note: (itstool) path: chapter/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGdk_1_1Clipboard.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGdk_1_1Clipboard.html">Референце</link>

note: (itstool) path: section/title
en: Formats
sr: Формати

note: (itstool) path: section/para
en: Different applications contain different types of data, and they might make that data available in a variety of formats. <application>gtkmm</application> calls these data types <literal>format</literal>s.
sr: Различити програми садрже различите врсте података, и они могу учинити те податке доступним у различитим форматима. <application>gtkmm</application> назива ове врсте података <literal>format</literal>-има (записима).

note: (itstool) path: section/para
en: For instance, <application>gedit</application> can supply and receive the <literal>text/plain</literal> mime type, so you can paste data into <application>gedit</application> from any application that supplies that format. Or two different image editing applications might supply and receive a variety of image formats. As long as one application can receive one of the formats that the other supplies then you will be able to copy data from one to the other.
sr: На пример, <application>gedit</application> може да достави и прими <literal>text/plain</literal> МИМЕ врсту, тако да можете убацити податке у <application>gedit</application> из било ког програма који доставља тај формат. Или два различита програма за обраду слика могу достављати и примати различите формате слика. Све док један програм може да прими један од формата који други доставља, моћи ћете да умножавате податке из једног у други.

note: (itstool) path: section/para
en: Clipboard data can be in a variety of binary formats. This chapter, and the examples, assume that the data is 8-bit text. This would allow us to use an XML format for the clipboard data. However this would probably not be appropriate for binary data such as images.
sr: Подаци у остави могу бити у различитим бинарним форматима. Ово поглавље, као и примери, претпостављају да су подаци 8-битни текст. То би нам омогућило да користимо ИксМЛ формат за податке у остави. Међутим, то вероватно не би било прикладно за бинарне податке као што су слике.

note: (itstool) path: section/para
en: The <link linkend="chapter-draganddrop">Drag and Drop</link> API uses the same mechanism. You should probably use the same data formats for both Clipboard and Drag and Drop operations.
sr: АПИ за <link linkend="chapter-draganddrop">превлачење и спуштање</link> користи исти механизам. Вероватно би требало да користите исте формате података и за оставу и за радње превлачења и спуштања.

note: (itstool) path: section/title
en: Copy
sr: Копирај

note: (itstool) path: section/para
en: When the user asks to copy some data, you should copy the data to the <classname>Clipboard</classname>. For instance,
sr: Када корисник затражи умножавање неких података, требало би да умножите податке у <classname>Clipboard</classname> (оставу). На пример,

note: (itstool) path: section/title
en: Paste
sr: Налепи

note: (itstool) path: section/para
en: When the user asks to paste data from the <classname>Clipboard</classname>, you should request a specific format and provide a callback method which will be called with the actual data. For instance:
sr: Када корисник затражи убацивање података из <classname>Clipboard</classname>-а (оставе), требало би да захтевате одређени формат и обезбедите методу повратног позива која ће бити позвана са стварним подацима. На пример:

note: (itstool) path: section/para
en: Here is an example callback method:
sr: Ево примера методе повратног позива:

note: (itstool) path: section/title
en: Discovering the available formats
sr: Откривање доступних формата

note: (itstool) path: section/para
en: To find out what formats are currently available on the <classname>Clipboard</classname> for pasting, call the <methodname>get_formats()</methodname> method. Then call a <classname>Gdk::ContentFormats</classname> method to find out if a format that your application supports is available.
sr: Да бисте сазнали који су формати тренутно доступни у <classname>остави</classname> за убацивање, позовите метод <methodname>get_formats()</methodname>. Затим позовите метод <classname>Gdk::ContentFormats</classname> да бисте сазнали да ли је доступан формат који ваша апликација подржава.

note: (itstool) path: section/title
en: Simple
sr: Једноставно

note: (itstool) path: section/para
en: This example allows copy and pasting of application-specific data, using the standard text format. Although this is simple, it's not ideal because it does not identify the <classname>Clipboard</classname> data as being of a particular type.
sr: Овај пример омогућава копирање и убацивање података специфичних за апликацију, користећи стандардни текстуални формат. Иако је ово једноставно, није идеално јер не идентификује податке <classname>оставе</classname> као податке одређене врсте.

note: (itstool) path: figure/title
en: Clipboard - Simple
sr: Остава — једноставно

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/clipboard/simple/">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/clipboard/simple/">Изворни код</link>

note: (itstool) path: section/title
en: Ideal
sr: Идеално

note: (itstool) path: listitem/simpara
en: Defines a custom clipboard target, though the format is still text.
sr: Дефинише произвољни циљ оставе, иако је формат и даље текстуални.

note: (itstool) path: listitem/simpara
en: It uses the <methodname>Gdk::ContentFormats::signal_changed()</methodname> signal and disables the Paste button if it can't use anything on the clipboard.
sr: Користи сигнал <methodname>Gdk::ContentFormats::signal_changed()</methodname> и онемогућава дугме „Убаци“ ако не може да користи ништа из оставе.

note: (itstool) path: section/para
en: This is like the simple example, but it <_:orderedlist-1/>
sr: Ово је као једноставан пример, али он <_:orderedlist-1/>

note: (itstool) path: figure/title
en: Clipboard - Ideal
sr: Остава — идеално

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/clipboard/ideal/">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/clipboard/ideal/">Изворни код</link>

note: (itstool) path: chapter/title
en: Printing
sr: Штампање

note: (itstool) path: chapter/para
en: At the application development level, <application>gtkmm</application>'s printing API provides dialogs that are consistent across applications and allows use of Cairo's common drawing API, with Pango-driven text rendering. In the implementation of this common API, platform-specific backends and printer-specific drivers are used.
sr: На нивоу развоја апликација, <application>gtkmm</application>-ов API за штампање пружа прозорчиће који су доследни кроз апликације и омогућава коришћење Cairo-вог заједничког API-ја за цртање, са Pango-вођеним исцртавањем текста. У изведби овог заједничког API-ја, користе се позадинци специфични за платформу и драјвери специфични за штампач.

note: (itstool) path: section/para
en: The primary object is <classname>Gtk::PrintOperation</classname>, allocated for each print operation. To handle page drawing connect to its signals, or inherit from it and override the default virtual signal handlers. <classname>PrintOperation</classname> automatically handles all the settings affecting the print loop.
sr: Примарни објекат је <classname>Gtk::PrintOperation</classname>, додељен за сваку радњу штампања. Да бисте управљали цртањем странице, повежите се на његове сигнале или наследите из њега и замените подразумеване виртуелне руковаоце сигнала. <classname>PrintOperation</classname> аутоматски управља свим подешавањима која утичу на петљу штампања.

note: (itstool) path: listitem/para
en: <literal>begin_print</literal>: You must handle this signal, because this is where you create and set up a <classname>Pango::Layout</classname> using the provided <classname>Gtk::PrintContext</classname>, and break up your printing output into pages.
sr: <literal>begin_print</literal>: Морате управљати овим сигналом, јер овде правите и подешавате <classname>Pango::Layout</classname> користећи достављени <classname>Gtk::PrintContext</classname>, и рашчлањујете ваш излаз штампања на странице.

note: (itstool) path: listitem/para
en: <literal>paginate</literal>: Pagination is potentially slow so if you need to monitor it you can call the <methodname>PrintOperation::set_show_progress()</methodname> method and handle this signal.
sr: <literal>paginate</literal>: Пагинација је потенцијално спора, па ако треба да је пратите, можете позвати метод <methodname>PrintOperation::set_show_progress()</methodname> и управљати овим сигналом.

note: (itstool) path: listitem/para
en: <literal>request_page_setup</literal>: Provides a <classname>PrintContext</classname>, page number and <classname>Gtk::PageSetup</classname>. Handle this signal if you need to modify page setup on a per-page basis.
sr: <literal>request_page_setup</literal>: Пружа <classname>PrintContext</classname>, број странице и <classname>Gtk::PageSetup</classname>. Управљајте овим сигналом ако треба да измените подешавање странице на основи појединачних страница.

note: (itstool) path: listitem/para
en: <literal>draw_page</literal>: You must handle this signal, which provides a <classname>PrintContext</classname> and a page number. The <classname>PrintContext</classname> should be used to create a <classname>Cairo::Context</classname> into which the provided page should be drawn. To render text, iterate over the <classname>Pango::Layout</classname> you created in the <literal>begin_print</literal> handler.
sr: Морате обрадити овај сигнал, који обезбеђује <classname>PrintContext</classname> и број странице. <classname>PrintContext</classname> треба користити за прављење <classname>Cairo::Context</classname> у којем треба исцртати достављену страницу. За исцртавање текста, прођите кроз <classname>Pango::Layout</classname> који сте направили у руковаоцу <literal>begin_print</literal>.

note: (itstool) path: listitem/para
en: For each page that needs to be rendered, the following signals are emitted: <_:itemizedlist-1/>
sr: За сваку страницу коју треба исцртати, емитују се следећи сигнали: <_:itemizedlist-1/>

note: (itstool) path: listitem/para
en: <literal>end_print</literal>: A handler for it is a safe place to free any resources related to a <classname>PrintOperation</classname>. If you have your custom class that inherits from <classname>PrintOperation</classname>, it is naturally simpler to do it in the destructor.
sr: Руковалац за њега је безбедно место за ослобађање свих ресурса везаних за <classname>PrintOperation</classname>. Ако имате сопствену класу која наслеђује <classname>PrintOperation</classname>, природно је једноставније то учинити у деструктору.

note: (itstool) path: listitem/para
en: <literal>done</literal>: This signal is emitted when printing is finished, meaning when the print data is spooled. Note that the provided <literal>Gtk::PrintOperation::Result</literal> may indicate that an error occurred. In any case you probably want to notify the user about the final status.
sr: Овај сигнал се емитује када је штампање завршено, што значи када су подаци за штампу послати у ред чекања. Имајте на уму да достављени <literal>Gtk::PrintOperation::Result</literal> може указати на то да је дошло до грешке. У сваком случају вероватно желите да обавестите корисника о коначном стању.

note: (itstool) path: listitem/para
en: <literal>status_changed</literal>: Emitted whenever a print job's status changes, until it is finished. Call the <methodname>PrintOperation::set_track_print_status()</methodname> method to monitor the job status after spooling. To see the status, use <methodname>get_status()</methodname> or <methodname>get_status_string()</methodname>.
sr: Емитује се кад год се промени стање посла штампања, све док се не заврши. Позовите метод <methodname>PrintOperation::set_track_print_status()</methodname> да бисте пратили стање посла након слања у ред чекања. Да бисте видели стање, користите <methodname>get_status()</methodname> или <methodname>get_status_string()</methodname>.

note: (itstool) path: section/para
en: The <methodname>PrintOperation::run()</methodname> method starts the print loop, during which various signals are emitted: <_:itemizedlist-1/>
sr: Метод <methodname>PrintOperation::run()</methodname> покреће петљу штампања, током које се емитују разни сигнали: <_:itemizedlist-1/>

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1PrintOperation.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1PrintOperation.html">Референце</link>

note: (itstool) path: section/title
en: Page setup
sr: Подешавање странице

note: (itstool) path: section/para
en: The <classname>PrintOperation</classname> class has a method called <methodname>set_default_page_setup()</methodname> which selects the default paper size, orientation and margins. To show a page setup dialog from your application, use the <methodname>Gtk::run_page_setup_dialog()</methodname> method, which returns a <classname>Gtk::PageSetup</classname> object with the chosen settings. Use this object to update a <classname>PrintOperation</classname> and to access the selected <classname>Gtk::PaperSize</classname>, <literal>Gtk::PageOrientation</literal> and printer-specific margins.
sr: Класа <classname>PrintOperation</classname> има метод под називом <methodname>set_default_page_setup()</methodname> који бира подразумевану величину папира, усмерење и маргине. Да бисте приказали прозорче за подешавање странице из вашег програма, користите метод <methodname>Gtk::run_page_setup_dialog()</methodname>, који враћа објекат <classname>Gtk::PageSetup</classname> са изабраним подешавањима. Користите овај објекат да ажурирате <classname>PrintOperation</classname> и да приступите изабраној величини папира <classname>Gtk::PaperSize</classname>, усмерењу <literal>Gtk::PageOrientation</literal> и маргинама специфичним за штампач.

note: (itstool) path: section/para
en: You should save the chosen <classname>Gtk::PageSetup</classname> so you can use it again if the page setup dialog is shown again.
sr: Требало би да сачувате изабрано <classname>Gtk::PageSetup</classname> како бисте могли поново да га користите ако се прозорче за подешавање странице поново прикаже.

note: (itstool) path: section/programlisting
en: <code>// Within a class that inherits from Gtk::Window and keeps m_refPageSetup
    // and m_refSettings as members...
    auto new_page_setup = Gtk::run_page_setup_dialog(*this, m_refPageSetup, m_refSettings);
    m_refPageSetup = new_page_setup;
    </code>
sr: <code>// Унутар класе која наслеђује Gtk::Window и чува m_refPageSetup
    // и m_refSettings као чланове...
    auto new_page_setup = Gtk::run_page_setup_dialog(*this, m_refPageSetup, m_refSettings);
    m_refPageSetup = new_page_setup;
    </code>

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1PageSetup.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1PageSetup.html">Референце</link>

note: (itstool) path: section/para
en: The Cairo coordinate system, in the <literal>draw_page</literal> handler, is automatically rotated to the current page orientation. It is normally within the printer margins, but you can change that via the <methodname>PrintOperation::set_use_full_page()</methodname> method. The default measurement unit is device pixels. To select other units, use the <methodname>PrintOperation::set_unit()</methodname> method.
sr: Координатни систем Каира, у руковаоцу <literal>draw_page</literal>, аутоматски се ротира према тренутном усмерењу странице. Обично је унутар маргина штампача, али то можете променити путем метода <methodname>PrintOperation::set_use_full_page()</methodname>. Подразумевана јединица мере су пиксели уређаја. Да бисте изабрали друге јединице, користите метод <methodname>PrintOperation::set_unit()</methodname>.

note: (itstool) path: section/title
en: Rendering text
sr: Исцртавање текста

note: (itstool) path: section/para
en: Text rendering is done using Pango. The <classname>Pango::Layout</classname> object for printing should be created by calling the <methodname>PrintContext::create_pango_layout()</methodname> method. The <classname>PrintContext</classname> object also provides the page metrics, via <methodname>get_width()</methodname> and <methodname>get_height()</methodname>. The number of pages can be set with <methodname>PrintOperation::set_n_pages()</methodname>. To actually render the Pango text in <literal>on_draw_page</literal>, get a <classname>Cairo::Context</classname> with <methodname>PrintContext::get_cairo_context()</methodname> and show the <classname>Pango::LayoutLine</classname>s that appear within the requested page number.
sr: Исцртавање текста се врши помоћу Панго-а. Објекат <classname>Pango::Layout</classname> за штампање треба направити позивањем метода <methodname>PrintContext::create_pango_layout()</methodname>. Објекат <classname>PrintContext</classname> такође обезбеђује метрику странице, путем <methodname>get_width()</methodname> и <methodname>get_height()</methodname>. Број страница се може поставити помоћу <methodname>PrintOperation::set_n_pages()</methodname>. Да бисте заиста исцртали Панго текст у <literal>on_draw_page</literal>, набавите <classname>Cairo::Context</classname> помоћу <methodname>PrintContext::get_cairo_context()</methodname> и прикажите <classname>Pango::LayoutLine</classname> линије које се појављују унутар захтеваног броја странице.

note: (itstool) path: section/para
en: See <link linkend="sec-printing-examples-simple">an example</link> of exactly how this can be done.
sr: Погледајте <link linkend="sec-printing-examples-simple">пример</link> како се тачно то може урадити.

note: (itstool) path: section/title
en: Asynchronous operations
sr: Асинхроне операције

note: (itstool) path: section/para
en: By default, <methodname>PrintOperation::run()</methodname> returns when a print operation is completed. If you need to run a non-blocking print operation, call <methodname>PrintOperation::set_allow_async()</methodname>. Note that <methodname>set_allow_async()</methodname> is not supported on all platforms, however the <literal>done</literal> signal will still be emitted.
sr: По подразумеваној вредности, <methodname>PrintOperation::run()</methodname> се враћа када се операција штампања заврши. Ако треба да покренете неблокирајућу операцију штампања, позовите <methodname>PrintOperation::set_allow_async()</methodname>. Имајте на уму да <methodname>set_allow_async()</methodname> није подржано на свим платформама, међутим сигнал <literal>done</literal> ће и даље бити емитован.

note: (itstool) path: section/para
en: <methodname>run()</methodname> may return <literal>PrintOperation::Result::IN_PROGRESS</literal>. To track status and handle the result or error you need to implement signal handlers for the <literal>done</literal> and <literal>status_changed</literal> signals:
sr: <methodname>run()</methodname> може вратити <literal>PrintOperation::Result::IN_PROGRESS</literal>. Да бисте пратили стање и обрадили резултат или грешку, треба да имплементирате руковаоце сигнала за сигнале <literal>done</literal> и <literal>status_changed</literal>:

note: (itstool) path: section/programlisting
en: <code>// in class ExampleWindow's method...
    auto op = PrintOperation::create();
    // ...set up op...
    op-&gt;signal_done().connect(sigc::bind(sigc::mem_fun(
      *this, &amp;ExampleWindow::on_printoperation_done), op));
    // run the op
    </code>
sr: <code>// у методу класе ExampleWindow...
    auto op = PrintOperation::create();
    // ...подесите op...
    op-&gt;signal_done().connect(sigc::bind(sigc::mem_fun(
      *this, &amp;ExampleWindow::on_printoperation_done), op));
    // покрените op
    </code>

note: (itstool) path: section/para
en: Second, check for an error and connect to the <literal>status_changed</literal> signal. For instance:
sr: Друго, проверите да ли постоји грешка и повежите се на сигнал <literal>status_changed</literal>. На пример:

note: (itstool) path: section/programlisting
en: <code>void ExampleWindow::on_printoperation_done(Gtk::PrintOperation::Result result,
      const Glib::RefPtr&lt;PrintOperation&gt;&amp; op)
    {
      if (result == Gtk::PrintOperation::Result::ERROR)
        //notify user
      else if (result == Gtk::PrintOperation::Result::APPLY)
        //Update PrintSettings with the ones used in this PrintOperation
    
      if (! op-&gt;is_finished())
        op-&gt;signal_status_changed().connect(sigc::bind(sigc::mem_fun(
          *this, &amp;ExampleWindow::on_printoperation_status_changed), op));
    }
    </code>
sr: <code>void ExampleWindow::on_printoperation_done(Gtk::PrintOperation::Result result,
      const Glib::RefPtr&lt;PrintOperation&gt;&amp; op)
    {
      if (result == Gtk::PrintOperation::Result::ERROR)
        //обавести корисника
      else if (result == Gtk::PrintOperation::Result::APPLY)
        //Ажурирај PrintSettings онима који су коришћени у овој операцији штампања
    
      if (! op-&gt;is_finished())
        op-&gt;signal_status_changed().connect(sigc::bind(sigc::mem_fun(
          *this, &amp;ExampleWindow::on_printoperation_status_changed), op));
    }
    </code>

note: (itstool) path: section/para
en: Finally, check the status. For instance,
sr: На крају, проверите стање. На пример,

note: (itstool) path: section/programlisting
en: <code>void ExampleWindow::on_printoperation_status_changed(const Glib::RefPtr&lt;PrintOperation&gt;&amp; op)
    {
      if (op-&gt;is_finished())
        //the print job is finished
      else
        //get the status with get_status() or get_status_string()
    
      //update UI
    }
    </code>
sr: <code>void ExampleWindow::on_printoperation_status_changed(const Glib::RefPtr&lt;PrintOperation&gt;&amp; op)
    {
      if (op-&gt;is_finished())
        //посао штампања је завршен
      else
        //добави стање помоћу get_status() или get_status_string()
    
      //ажурирај корисничко прочеље
    }
    </code>

note: (itstool) path: section/title
en: Export to PDF
sr: Извези у ПДФ

note: (itstool) path: section/para
en: The 'Print to file' option is available in the print dialog, without the need for extra implementation. However, it is sometimes useful to generate a pdf file directly from code. For instance,
sr: Опција „Штампај у датотеку“ је доступна у прозорчету за штампање, без потребе за додатном имплементацијом. Међутим, понекад је корисно направити пдф датотеку директно из кода. На пример,

note: (itstool) path: section/programlisting
en: <code>auto op = Gtk::PrintOperation::create();
    // ...set up op...
    op-&gt;set_export_filename("test.pdf");
    auto res = op-&gt;run(Gtk::PrintOperation::Action::EXPORT);
    </code>
sr: <code>auto op = Gtk::PrintOperation::create();
    // ...подеси op...
    op-&gt;set_export_filename("test.pdf");
    auto res = op-&gt;run(Gtk::PrintOperation::Action::EXPORT);
    </code>

note: (itstool) path: section/title
en: Extending the print dialog
sr: Проширивање прозорчета за штампање

note: (itstool) path: listitem/para
en: Set the title of the tab via <methodname>PrintOperation::set_custom_tab_label()</methodname>, create a new widget and return it from the <literal>create_custom_widget</literal> signal handler. You'll probably want this to be a container widget, packed with some others.
sr: Поставите наслов језичка преко <methodname>PrintOperation::set_custom_tab_label()</methodname>, направите нови елемент и вратите га из руковаоца сигнала <literal>create_custom_widget</literal>. Вероватно ћете желети да ово буде елемент садржалац, упакован са неким другим елементима.

note: (itstool) path: listitem/para
en: Get the data from the widgets in the <literal>custom_widget_apply</literal> signal handler.
sr: Добавите податке из елемената у руковаоцу сигнала <literal>custom_widget_apply</literal>.

note: (itstool) path: section/para
en: You may add a custom tab to the print dialog: <_:itemizedlist-1/>
sr: Можете додати произвољни језичак у прозорче за штампање: <_:itemizedlist-1/>

note: (itstool) path: section/para
en: Although the <literal>custom_widget_apply</literal> signal provides the widget you previously created, to simplify things you can keep the widgets you expect to contain some user input as class members. For example, let's say you have a <classname>Gtk::Entry</classname> called <literal>m_Entry</literal> as a member of your <classname>CustomPrintOperation</classname> class:
sr: Иако сигнал <literal>custom_widget_apply</literal> обезбеђује елемент који сте претходно направили, ради поједностављења можете задржати елементе за које очекујете да садрже неки кориснички унос као чланове класе. На пример, рецимо да имате <classname>Gtk::Entry</classname> под називом <literal>m_Entry</literal> као члана ваше класе <classname>CustomPrintOperation</classname>:

note: (itstool) path: section/programlisting
en: <code>Gtk::Widget* CustomPrintOperation::on_create_custom_widget()
    {
      set_custom_tab_label("My custom tab");
    
      auto hbox = new Gtk::Box(Gtk::Orientation::HORIZONTAL, 8);
      hbox-&gt;set_margin(6);
    
      auto label = Gtk::make_managed&lt;Gtk::Label&gt;("Enter some text: ");
      hbox-&gt;append(*label);
    
      hbox-&gt;append(m_Entry);
    
      return hbox;
    }
    
    void CustomPrintOperation::on_custom_widget_apply(Gtk::Widget* /* widget */)
    {
      auto user_input = m_Entry.get_text();
      //...
    }
    </code>
sr: <code>Gtk::Widget* CustomPrintOperation::on_create_custom_widget()
    {
      set_custom_tab_label("Мој произвољни језичак");
    
      auto hbox = new Gtk::Box(Gtk::Orientation::HORIZONTAL, 8);
      hbox-&gt;set_margin(6);
    
      auto label = Gtk::make_managed&lt;Gtk::Label&gt;("Унесите неки текст: ");
      hbox-&gt;append(*label);
    
      hbox-&gt;append(m_Entry);
    
      return hbox;
    }
    
    void CustomPrintOperation::on_custom_widget_apply(Gtk::Widget* /* widget */)
    {
      auto user_input = m_Entry.get_text();
      //...
    }
    </code>

note: (itstool) path: section/para
en: The example in examples/book/printing/advanced demonstrates this.
sr: Пример у examples/book/printing/advanced ово демонстрира.

note: (itstool) path: section/title
en: Preview
sr: Преглед

note: (itstool) path: section/para
en: The native GTK print dialog has a preview button, but you may also start a preview directly from an application:
sr: Изворно ГТК прозорче за штампање има дугме за преглед, али преглед можете покренути и директно из апликације:

note: (itstool) path: section/programlisting
en: <code>// in a class that inherits from Gtk::Window...
    auto op = PrintOperation::create();
    // ...set up op...
    op-&gt;run(Gtk::PrintOperation::Action::PREVIEW, *this);
    </code>
sr: <code>// у класи која наслеђује Gtk::Window...
    auto op = PrintOperation::create();
    // ...подеси op...
    op-&gt;run(Gtk::PrintOperation::Action::PREVIEW, *this);
    </code>

note: (itstool) path: section/para
en: On Unix, the default preview handler uses an external viewer program. On Windows, the native preview dialog will be shown. If necessary you may override this behavior and provide a custom preview dialog. See the example located in /examples/book/printing/advanced.
sr: На Јуниксу, подразумевани руковалац прегледа користи спољни програм за прегледање. На Виндоузу ће бити приказано изворно прозорче за преглед. Ако је потребно, можете премостити ово понашање и обезбедити произвољно прозорче за преглед. Погледајте пример који се налази у /examples/book/printing/advanced.

note: (itstool) path: section/title
en: PrintDialog
sr: Прозорче за штампање

note: (itstool) path: section/para
en: Since <application>gtkmm</application> 4.14 <classname>Gtk::PrintDialog</classname> is an alternative to <classname>Gtk::PrintOperation</classname>. <classname>PrintDialog</classname> uses the same <classname>PageSetup</classname> and <classname>PrintSettings</classname> classes as <classname>PrintOperation</classname>. The rendering with Cairo and Pango is also similar.
sr: Од <application>gtkmm</application> 4.14 <classname>Gtk::PrintDialog</classname> је алтернатива за <classname>Gtk::PrintOperation</classname>. <classname>PrintDialog</classname> користи исте класе <classname>PageSetup</classname> и <classname>PrintSettings</classname> као и <classname>PrintOperation</classname>. Исцртавање помоћу Каира и Пангоа је такође слично.

note: (itstool) path: section/para
en: The following example demonstrates how to print some input from a user interface using <classname>PrintOperation</classname>. It shows how to implement <literal>on_begin_print</literal> and <literal>on_draw_page</literal>, as well as how to track print status and update the print settings.
sr: Следећи пример демонстрира како одштампати неки унос из корисничког прочеља користећи <classname>PrintOperation</classname>. Показује како применити <literal>on_begin_print</literal> и <literal>on_draw_page</literal>, као и како пратити стање штампања и ажурирати подешавања штампања.

note: (itstool) path: figure/title
en: Printing - Simple
sr: Штампање — једноставно

[ctx: _]
note: (itstool) path: imageobject/imagedata This is a reference to an external file such as an image or video. When the file changes, the md5 hash will change to let you know you need to update your localized copy. The msgstr is not used at all. Set it to whatever you like once you have updated your copy 
en: external ref='figures/printing_simple.png' md5='8e7f72103094230cafcd912cb6b34277'
sr: _:external ref='figures/printing_simple.png' md5='8e7f72103094230cafcd912cb6b34277'

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/printing/simple/">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/printing/simple/">Изворни код</link>

note: (itstool) path: section/para
en: The following example demonstrates how to print some input from a user interface using <classname>PrintDialog</classname>. The user interface is similar to the previous example.
sr: Следећи пример показује како се штампа неки унос из корисничког прочеља коришћењем класе <classname>PrintDialog</classname>. Корисничко прочеље је слично претходном примеру.

note: (itstool) path: figure/title
en: Printing - PrintDialog
sr: Штампање — PrintDialog

[ctx: _]
note: (itstool) path: imageobject/imagedata This is a reference to an external file such as an image or video. When the file changes, the md5 hash will change to let you know you need to update your localized copy. The msgstr is not used at all. Set it to whatever you like once you have updated your copy 
en: external ref='figures/printing_printdialog.png' md5='131a217e90587b80335c230cace02a57'
sr: _:external ref='figures/printing_printdialog.png' md5='131a217e90587b80335c230cace02a57'

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/printing/print_dialog/">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/printing/print_dialog/">Изворни код</link>

note: (itstool) path: chapter/title
en: Recently Used Documents
sr: Скоро коришћени документи

note: (itstool) path: chapter/para
en: <application>gtkmm</application> provides an easy way to manage recently used documents. This functionality is implemented in the <classname>Gtk::RecentManager</classname> class.
sr: <application>gtkmm</application> пружа лак начин за управљање недавно коришћеним документима. Ова функционалност је примењена у класи <classname>Gtk::RecentManager</classname>.

note: (itstool) path: chapter/para
en: Each item in the list of recently used files is identified by its URI, and can have associated metadata. The metadata can be used to specify how the file should be displayed, a description of the file, its mime type, which application registered it, whether it's private to the registering application, and several other things.
sr: Свака ставка на списку недавно коришћених датотека је идентификована својим УРИ-јем и може имати придружене метаподатке. Метаподаци се могу користити за одређивање начина на који датотека треба да буде приказана, опис датотеке, њену миме врсту, који програм ју је регистровао, да ли је приватна за програм који ју је регистровао и неколико других ствари.

note: (itstool) path: section/title
en: RecentManager
sr: Управник недавних ставки

note: (itstool) path: section/para
en: <classname>RecentManager</classname> acts as a database of recently used files. You use this class to register new files, remove files from the list, or look up recently used files. There is one list of recently used files per user.
sr: <classname>RecentManager</classname> делује као база података недавно коришћених датотека. Ову класу користите за регистровање нових датотека, уклањање датотека са списка или за тражење недавно коришћених датотека. Постоји један списак недавно коришћених датотека по кориснику.

note: (itstool) path: section/para
en: You can create a new <classname>RecentManager</classname>, but you'll most likely just want to use the default one. You can get a reference to the default <classname>RecentManager</classname> with <methodname>get_default()</methodname>.
sr: Можете направити нови <classname>RecentManager</classname>, али ћете највероватније само желети да користите подразумевани. Референцу на подразумевани <classname>RecentManager</classname> можете добити помоћу <methodname>get_default()</methodname>.

note: (itstool) path: section/title
en: Adding Items to the List of Recent Files
sr: Додавање ставки на списак недавних датотека

note: (itstool) path: section/para
en: To add a new file to the list of recent documents, in the simplest case, you only need to provide the URI. For example:
sr: Да бисте додали нову датотеку на списак недавних докумената, у најједноставнијем случају, потребно је само да наведете УРИ. На пример:

note: (itstool) path: section/para
en: If you want to register a file with metadata, you can pass a <classname>RecentManager::Data</classname> parameter to <methodname>add_item()</methodname>. The metadata that can be set on a particular file item is as follows:
sr: Ако желите да региструјете датотеку са метаподацима, можете проследити параметар <classname>RecentManager::Data</classname> методу <methodname>add_item()</methodname>. Метаподаци који се могу поставити на одређену ставку датотеке су следећи:

note: (itstool) path: listitem/para
en: <varname>app_exec</varname>: The command line to be used to launch this resource. This string may contain the "f" and "u" escape characters which will be expanded to the resource file path and URI respectively
sr: <varname>app_exec</varname>: Линија наредбе која ће се користити за покретање овог ресурса. Ова ниска може да садржи излазне знакове „f“ и „u“ који ће бити замењени путањом датотеке ресурса и УРИ-јем, респективно

note: (itstool) path: listitem/para
en: <varname>app_name</varname>: The name of the application that registered the resource
sr: <varname>app_name</varname>: Назив програма који је регистровао ресурс

note: (itstool) path: listitem/para
en: <varname>description</varname>: A short description of the resource as a UTF-8 encoded string
sr: <varname>description</varname>: Кратак опис ресурса као УТФ-8 кодирана ниска

note: (itstool) path: listitem/para
en: <varname>display_name</varname>: The name of the resource to be used for display as a UTF-8 encoded string
sr: <varname>display_name</varname>: Назив ресурса који ће се користити за приказ као УТФ-8 кодирана ниска

note: (itstool) path: listitem/para
en: <varname>groups</varname>: A list of groups associated with this item. Groups are essentially arbitrary strings associated with a particular resource. They can be thought of as 'categories' (such as "email", "graphics", etc) or tags for the resource.
sr: <varname>groups</varname>: Списак група придружених овој ставци. Групе су у суштини произвољне ниске повезане са одређеним ресурсом. Могу се посматрати као „категорије“ (као што су „е-пошта“, „графика“, итд.) или ознаке за ресурс.

note: (itstool) path: listitem/para
en: <varname>is_private</varname>: Whether this resource should be visible only to applications that have registered it or not
sr: <varname>is_private</varname>: Да ли овај ресурс треба да буде видљив само програмима који су га регистровали или не

note: (itstool) path: listitem/para
en: <varname>mime_type</varname>: The MIME type of the resource
sr: <varname>mime_type</varname>: MIME врста ресурса

note: (itstool) path: section/para
en: In addition to adding items to the list, you can also look up items from the list and modify or remove items.
sr: Поред додавања ставки на списак, можете такође потражити ставке са списка и изменити их или уклонити.

note: (itstool) path: section/title
en: Looking up Items in the List of Recent Files
sr: Тражење ставки на списку недавних датотека

note: (itstool) path: section/para
en: To look up recently used files, <classname>RecentManager</classname> provides several functions. To look up a specific item by its URI, you can use the <methodname>lookup_item()</methodname> function, which will return a <classname>RecentInfo</classname> class. If the specified URI did not exist in the list of recent files, <methodname>lookup_item()</methodname> throws a <classname>RecentManagerError</classname> exception. For example:
sr: За тражење недавно коришћених датотека, <classname>RecentManager</classname> обезбеђује неколико функција. Да бисте потражили одређену ставку према њеној УРИ адреси, можете користити функцију <methodname>lookup_item()</methodname>, која ће вратити класу <classname>RecentInfo</classname>. Ако наведена УРИ адреса не постоји на списку недавних датотека, <methodname>lookup_item()</methodname> избацује изузетак <classname>RecentManagerError</classname>. На пример:

note: (itstool) path: section/programlisting
en: <code>Glib::RefPtr&lt;Gtk::RecentInfo&gt; info;
    try
    {
      info = recent_manager-&gt;lookup_item(uri);
    }
    catch(const Gtk::RecentManagerError&amp; ex)
    {
      std::cerr &lt;&lt; "RecentManagerError: " &lt;&lt; ex.what() &lt;&lt; std::endl;
    }
    if (info)
    {
      // item was found
    }</code>
sr: <code>Glib::RefPtr&lt;Gtk::RecentInfo&gt; info;
    try
    {
      info = recent_manager-&gt;lookup_item(uri);
    }
    catch(const Gtk::RecentManagerError&amp; ex)
    {
      std::cerr &lt;&lt; "RecentManagerError: " &lt;&lt; ex.what() &lt;&lt; std::endl;
    }
    if (info)
    {
      // ставка је пронађена
    }</code>

note: (itstool) path: section/para
en: A <classname>RecentInfo</classname> object is essentially an object containing all of the metadata about a single recently-used file. You can use this object to look up any of the properties listed <link linkend="list-file-metadata">above</link>.
sr: Објекат <classname>RecentInfo</classname> је у суштини објекат који садржи све метаподатке о једној недавно коришћеној датотеци. Овај објекат можете користити за тражење било ког од својстава наведених <link linkend="list-file-metadata">изнад</link>.

note: (itstool) path: section/para
en: If you don't want to look for a specific URI, but instead want to get a list of all recently used items, <classname>RecentManager</classname> provides the <methodname>get_items()</methodname> function. The return value of this function is a <classname>std::vector</classname> of all recently used files. The following code demonstrates how you might get a list of recently used files:
sr: Ако не желите да тражите одређену УРИ адресу, већ уместо тога желите да добијете списак свих недавно коришћених ставки, <classname>RecentManager</classname> обезбеђује функцију <methodname>get_items()</methodname>. Повратна вредност ове функције је <classname>std::vector</classname> свих недавно коришћених датотека. Следећи код показује како можете добити списак недавно коришћених датотека:

note: (itstool) path: section/para
en: The maximum age of items in the recently used files list can be set with <methodname>Gtk::Settings::property_gtk_recent_files_max_age()</methodname>. Default value: 30 days.
sr: Максимална старост ставки на списку недавно коришћених датотека може се поставити помоћу <methodname>Gtk::Settings::property_gtk_recent_files_max_age()</methodname>. Подразумевана вредност: 30 дана.

note: (itstool) path: section/title
en: Modifying the List of Recent Files
sr: Мењање списка недавних датотека

note: (itstool) path: section/para
en: There may be times when you need to modify the list of recent files. For instance, if a file is moved or renamed, you may need to update the file's location in the recent files list so that it doesn't point to an incorrect location. You can update an item's location by using <methodname>move_item()</methodname>.
sr: Може се десити да требате да измените списак недавних датотека. На пример, ако је датотека премештена или преименована, можда ћете морати да ажурирате место датотеке на списку недавних датотека како она не би показивала на погрешно место. Место ставке можете ажурирати коришћењем <methodname>move_item()</methodname>.

note: (itstool) path: section/para
en: In addition to changing a file's URI, you can also remove items from the list, either one at a time or by clearing them all at once. The former is accomplished with <methodname>remove_item()</methodname>, the latter with <methodname>purge_items()</methodname>.
sr: Поред промене УРИ адресе датотеке, такође можете уклонити ставке са списка, било једну по једну или чишћењем свих одједном. Прво се постиже помоћу <methodname>remove_item()</methodname>, а друго помоћу <methodname>purge_items()</methodname>.

note: (itstool) path: note/para
en: The functions <methodname>move_item()</methodname>, <methodname>remove_item()</methodname> and <methodname>purge_items()</methodname> have no effect on the actual files that are referred to by the URIs, they only modify the list of recent files.
sr: Функције <methodname>move_item()</methodname>, <methodname>remove_item()</methodname> и <methodname>purge_items()</methodname> немају утицаја на стварне датотеке на које УРИ адресе упућују, оне само мењају списак недавних датотека.

note: (itstool) path: section/title
en: FileChooser and FileDialog
sr: Бирач датотека и прозорче за датотеке

note: (itstool) path: section/para
en: <classname>FileChooser</classname> is an interface that can be implemented by widgets displaying a list of files. <application>gtkmm</application> provides three built-in implementations for choosing recent files or other files: <classname>FileChooserWidget</classname>, <classname>FileChooserDialog</classname>, and <classname>FileChooserNative</classname>.
sr: <classname>FileChooser</classname> је интерфејс који могу применити елементи који приказују списак датотека. <application>gtkmm</application> обезбеђује три уграђене имплементације за бирање недавних датотека или других датотека: <classname>FileChooserWidget</classname>, <classname>FileChooserDialog</classname> и <classname>FileChooserNative</classname>.

note: (itstool) path: section/para
en: <classname>FileChooserWidget</classname> is a simple widget for displaying a list of recently used files or other files. <classname>FileChooserWidget</classname> is the basic building block for <classname>FileChooserDialog</classname>, but you can embed it into your user interface if you want to.
sr: <classname>FileChooserWidget</classname> је једноставан елемент за приказивање списка недавно коришћених датотека или других датотека. <classname>FileChooserWidget</classname> је основни градивни блок за <classname>FileChooserDialog</classname>, али га можете уградити у свој кориснички интерфејс ако желите.

note: (itstool) path: note/para
en: <classname>FileChooser</classname> and the classes that implement it are deprecated since <application>gtkmm</application> 4.10. They have been replaced by <classname>FileDialog</classname>, which is available since <application>gtkmm</application> 4.10.
sr: <classname>FileChooser</classname> и класе које га имплементирају су застареле од верзије <application>gtkmm</application> 4.10. Замењене су класом <classname>FileDialog</classname>, која је доступна од верзије <application>gtkmm</application> 4.10.

note: (itstool) path: section/title
en: Simple FileDialog example
sr: Једноставан пример за FileDialog

note: (itstool) path: section/para
en: Shown below is a simple example of how to use the <classname>FileDialog</classname> class in a program. This simple program has a menubar with a <guimenuitem>File Dialog</guimenuitem> menu item. When you select this menu item, a dialog pops up showing a list of files. If you select <guimenuitem>Recent</guimenuitem> in the sidebar, the list of recently used files is shown.
sr: Испод је приказан једноставан пример како се користи класа <classname>FileDialog</classname> у програму. Овај једноставан програм има траку изборника са ставком изборника <guimenuitem>File Dialog</guimenuitem>. Када изаберете ову ставку изборника, појављује се прозорче које приказује списак датотека. Ако изаберете <guimenuitem>Recent</guimenuitem> у бочној површи, приказује се списак недавно коришћених датотека.

note: (itstool) path: note/para
en: If this is the first time you're using a program that uses the Recent Files framework, the dialog may be empty at first. Otherwise it should show the list of recently used documents registered by other applications.
sr: Ако први пут користите програм који користи радни оквир недавних датотека, прозорче може бити празно у почетку. У супротном, требало би да прикаже списак недавно коришћених докумената које су регистровале друге апликације.

note: (itstool) path: section/para
en: After selecting the <guimenuitem>File Dialog</guimenuitem> menu item and the <guimenuitem>Recent</guimenuitem> sidebar item, you should see something similar to the following window.
sr: Након бирања ставке изборника <guimenuitem>File Dialog</guimenuitem> и ставке бочне површи <guimenuitem>Recent</guimenuitem>, требало би да видите нешто слично следећем прозору.

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/recent_files">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/recent_files">Изворни код</link>

note: (itstool) path: section/para
en: The constructor for <classname>ExampleWindow</classname> creates the menu and the toolbar using <classname>Builder</classname> (see <xref linkend="chapter-menus-and-toolbars"/> for more information). It then adds the menu and the toolbar to the window.
sr: Конструктор за <classname>ExampleWindow</classname> прави изборник и траку алата користећи <classname>Builder</classname> (погледајте <xref linkend="chapter-menus-and-toolbars"/> за више информација). Затим додаје изборник и траку алата у прозор.

note: (itstool) path: section/title
en: Filtering Files
sr: Филтрирање датотека

note: (itstool) path: section/para
en: For any of the <classname>FileChooser</classname> classes, if you don't wish to display all of the items in the list of files, you can filter the list to show only those that you want. You can filter the list with the help of the <classname>FileFilter</classname> class. This class allows you to filter files by their name (<methodname>add_pattern()</methodname>), or their mime type (<methodname>add_mime_type()</methodname>).
sr: За било коју од класа <classname>FileChooser</classname>, ако не желите да прикажете све ставке на списку датотека, можете филтрирати списак да приказује само оне које желите. Списак можете филтрирати уз помоћ класе <classname>FileFilter</classname>. Ова класа вам омогућава да филтрирате датотеке према њиховом имену (<methodname>add_pattern()</methodname>) или њиховој миме врсти (<methodname>add_mime_type()</methodname>).

note: (itstool) path: section/para
en: After you've created and set up the filter to match only the items you want, you can apply a filter to a chooser widget with the <methodname>FileChooser::add_filter()</methodname> function.
sr: Након што сте направили и подесили филтер да се поклапа само са ставкама које желите, можете применити филтер на виџет бирача помоћу функције <methodname>FileChooser::add_filter()</methodname>.

note: (itstool) path: chapter/title (itstool) path: figure/title
en: Keyboard and Mouse Events
sr: Догађаји тастатуре и миша

note: (itstool) path: chapter/para
en: Event signals differ in some ways from other signals. These differences are described in the <link linkend="sec-eventsignals">Event signals</link> section in the appendix. Here we will use keyboard events and mouse events to show how events can be used in a program.
sr: Сигнали догађаја се разликују на неке начине од осталих сигнала. Ове разлике су описане у одељку <link linkend="sec-eventsignals">Сигнали догађаја</link> у додатку. Овде ћемо користити догађаје тастатуре и догађаје миша да покажемо како се догађаји могу користити у програму.

note: (itstool) path: section/title
en: Overview
sr: Преглед

note: (itstool) path: section/para
en: Whenever you press or release a key, an event is emitted. You can add an event controller and connect a signal handler to handle such events.
sr: Кад год притиснете или отпустите тастер, емитује се догађај. Можете додати контролер догађаја и повезати руковаоца сигналом за обраду таквих догађаја.

note: (itstool) path: section/para
en: The event signal handler will receive arguments that depend on the type of event. For key press events the arguments are (<type>guint</type> <varname>keyval</varname>, <type>guint</type> <varname>keycode</varname>, <type>Gdk::ModifierType</type> <varname>state</varname>). As described in the <link linkend="sec-eventsignals">appendix</link>, the key press event signal handler returns a <type>bool</type> value, to indicate that the signal is fully handled (<literal>true</literal>) or allow event propagation (<literal>false</literal>).
sr: Руковалац сигналом догађаја ће примити аргументе који зависе од врсте догађаја. За догађаје притиска тастера аргументи су (<type>guint</type> <varname>keyval</varname>, <type>guint</type> <varname>keycode</varname>, <type>Gdk::ModifierType</type> <varname>state</varname>). Као што је описано у <link linkend="sec-eventsignals">додатку</link>, руковалац сигналом догађаја притиска тастера враћа <type>bool</type> вредност, како би указао да је сигнал у потпуности обрађен (<literal>true</literal>) или да дозволи простирање догађаја (<literal>false</literal>).

note: (itstool) path: section/para
en: To determine which key was pressed or released, you read the value of the <varname>keyval</varname> argument and compare it with a constant in the <link xlink:href="https://gitlab.gnome.org/GNOME/gtk/tree/main/gdk/gdkkeysyms.h"> <filename>&lt;gdk/gdkkeysyms.h&gt;</filename></link> header file. The states of modifier keys (shift, ctrl, etc.) are available as bit-flags in <varname>state</varname>.
sr: Да бисте одредили који тастер је притиснут или отпуштен, прочитате вредност аргумента <varname>keyval</varname> и упоредите је са константом у датотеци заглавља <link xlink:href="https://gitlab.gnome.org/GNOME/gtk/tree/main/gdk/gdkkeysyms.h"> <filename>&lt;gdk/gdkkeysyms.h&gt;</filename></link>. Стања тастера модификатора (shift, ctrl, итд.) су доступна као битовске заставице у <varname>state</varname>.

note: (itstool) path: section/para
en: Here's a simple example:
sr: Ево једноставног примера:

note: (itstool) path: section/para
en: In this example there are three keyboard shortcuts: <keycap>Alt</keycap>+<keycap>1</keycap> selects the first radio button, <keycap>Alt</keycap>+<keycap>2</keycap> selects the second one, and the <keycap>Esc</keycap> key closes the window.
sr: У овом примеру постоје три пречице на тастатури: <keycap>Alt</keycap>+<keycap>1</keycap> бира прво радио дугме, <keycap>Alt</keycap>+<keycap>2</keycap> бира друго, а тастер <keycap>Esc</keycap> затвара прозор.

note: (itstool) path: figure/title
en: Keyboard Events - Simple
sr: Догађаји тастатуре — једноставно

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/events/keyboard_simple/">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/events/keyboard_simple/">Изворни код</link>

note: (itstool) path: section/title
en: Event Propagation
sr: Простирање догађаја

note: (itstool) path: listitem/simpara
en: Capture phase - runs from the toplevel down to the event widget.
sr: Фаза хватања – извршава се од највишег нивоа наниже до елемента догађаја.

note: (itstool) path: listitem/simpara
en: Target phase - runs only on the event widget.
sr: Циљна фаза – извршава се само на елементу догађаја.

note: (itstool) path: listitem/simpara
en: Bubble phase - runs from the event widget up to the toplevel.
sr: Фаза мехура – извршава се од елемента догађаја навише до највишег нивоа.

note: (itstool) path: section/para
en: As described in the <link linkend="signal-handler-sequence">appendix</link> event signals are propagated in 3 phases: <_:orderedlist-1/>
sr: Као што је описано у <link linkend="signal-handler-sequence">додатку</link>, сигнали догађаја се простиру у 3 фазе: <_:orderedlist-1/>

note: (itstool) path: section/para
en: A keyboard event is first sent to the toplevel window (<classname>Gtk::Window</classname>), where it will be checked for any keyboard shortcuts that may be set (accelerator keys and mnemonics, used for selecting menu items from the keyboard). After this (and assuming the event wasn't handled), it is propagated down until it reaches the widget which has keyboard focus. The event will then propagate up until it reaches the top-level widget, or until you stop the propagation by returning <literal>true</literal> from an event handler.
sr: Догађај тастатуре се прво шаље прозору највишег нивоа (<classname>Gtk::Window</classname>), где ће бити проверен за било које пречице тастатуре које могу бити постављене (тастери убрзавачи и мнемоници, који се користе за бирање ставки менија са тастатуре). Након овога (и под претпоставком да догађај није обрађен), он се простире наниже док не стигне до елемента који има фокус тастатуре. Догађај ће се затим простирати навише док не стигне до елемента највишег нивоа, или док не зауставите простирање враћањем <literal>true</literal> из руковаоца догађајем.

note: (itstool) path: section/para
en: Notice, that after canceling an event, no other function will be called (even if it is from the same widget).
sr: Имајте на уму да након отказивања догађаја, ниједна друга функција неће бити позвана (чак и ако је из истог елемента).

note: (itstool) path: section/para
en: In this example there are 9 <classname>EventControllerKey</classname>s, 3 in each of a <classname>Gtk::Window</classname>, a <classname>Gtk::Box</classname> and a <classname>Gtk::Label</classname>. In each of the widgets there is one event controller for each propagation phase.
sr: У овом примеру постоји 9 <classname>EventControllerKey</classname> објеката, по 3 у сваком од <classname>Gtk::Window</classname>, <classname>Gtk::Box</classname> и <classname>Gtk::Label</classname>. У сваком од елемената постоји један управљач догађајима за сваку фазу простирања.

note: (itstool) path: section/para
en: The purpose of this example is to show the steps the event takes when it is emitted.
sr: Сврха овог примера је да прикаже кораке које догађај предузима када је емитован.

note: (itstool) path: section/para
en: When you write in the label, a key press event will be emitted, which will go first, in the capture phase, to the toplevel window (<classname>Gtk::Window</classname>), then down to its child, the box, then to the box's child, the label with the keyboard focus. In the target phase the event goes only to the widget with the keyboard focus (the label). In the bubble phase the event goes first to the widget with the keyboard focus (the label), then to its parent (the box), then to the box's parent (the window). If the event propagates all the way down to the label and then up to the window without being stopped, the text you're writing will appear in the <classname>Label</classname> above the <classname>Label</classname> you're writing in.
sr: Када пишете у натпису, биће емитован догађај притиска тастера, који ће ићи прво, у фази хватања, до прозора највишег нивоа (<classname>Gtk::Window</classname>), затим наниже до његовог детета, кутије, па до детета кутије, натписа са фокусом тастатуре. У циљној фази догађај иде само до елемента са фокусом тастатуре (натпис). У фази мехура догађај иде прво до елемента са фокусом тастатуре (натпис), затим до његовог родитеља (кутија), па до родитеља кутије (прозор). Ако се догађај простире свим путем доле до натписа и затим горе до прозора без заустављања, текст који пишете ће се појавити у <classname>Label</classname> изнад <classname>Label</classname> у којем пишете.

note: (itstool) path: figure/title
en: Keyboard Events - Event Propagation
sr: Догађаји тастатуре — Простирање догађаја

[ctx: _]
note: (itstool) path: imageobject/imagedata This is a reference to an external file such as an image or video. When the file changes, the md5 hash will change to let you know you need to update your localized copy. The msgstr is not used at all. Set it to whatever you like once you have updated your copy 
en: external ref='figures/events_propagation.png' md5='4250a1b17c413f3243cf11485e7a7bb9'
sr: _:external ref='figures/events_propagation.png' md5='4250a1b17c413f3243cf11485e7a7bb9'

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/events/keyboard_propagation/">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/events/keyboard_propagation/">Изворни код</link>

note: (itstool) path: section/title
en: Mouse Events
sr: Догађаји миша

note: (itstool) path: listitem/para
en: You use <classname>Gtk::GestureClick</classname> instead of <classname>Gtk::EventControllerKey</classname>.
sr: Користите <classname>Gtk::GestureClick</classname> уместо <classname>Gtk::EventControllerKey</classname>.

note: (itstool) path: listitem/para
en: There are other event classes that can be used for handling mouse events, for instance <classname>Gtk::EventControllerMotion</classname> and <classname>Gtk::EventControllerScroll</classname>.
sr: Постоје и друге класе догађаја које се могу користити за руковање догађајима миша, на пример <classname>Gtk::EventControllerMotion</classname> и <classname>Gtk::EventControllerScroll</classname>.

note: (itstool) path: listitem/para
en: Many signal handlers don't return a <literal>bool</literal>. You can't stop those events from propagating.
sr: Многи руковаоци сигналима не враћају <literal>bool</literal>. Не можете зауставити те догађаје од простирања.

note: (itstool) path: section/para
en: Mouse events are similar to keyboard events. There are some differences, though. <_:itemizedlist-1/>
sr: Догађаји миша су слични догађајима тастатуре. Постоје неке разлике, ипак. <_:itemizedlist-1/>

note: (itstool) path: section/para
en: The event classes that handle mouse events are also useful for handling events from touchscreens. There are also many subclasses of <classname>Gtk::EventController</classname> which are only (or mainly) useful for touchscreens. Examples: <classname>Gtk::GestureRotate</classname>, <classname>Gtk::GestureZoom</classname>, <classname>Gtk::GestureSwipe</classname>, <classname>Gtk::GestureLongPress</classname>.
sr: Класе догађаја које рукују догађајима миша су такође корисне за руковање догађајима са екрана на додир. Постоје такође многе подкласе <classname>Gtk::EventController</classname> које су само (или углавном) корисне за екране на додир. Примери: <classname>Gtk::GestureRotate</classname>, <classname>Gtk::GestureZoom</classname>, <classname>Gtk::GestureSwipe</classname>, <classname>Gtk::GestureLongPress</classname>.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1EventController.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1EventController.html">Референца</link>

note: (itstool) path: section/para
en: This is an expanded version of the simple keyboard events example.
sr: Ово је проширена верзија једноставног примера догађаја тастатуре.

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/events/mouse/">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/events/mouse/">Изворни ко̂д</link>

note: (itstool) path: chapter/title
en: Timeouts, I/O and Idle Functions
sr: Временски рокови, У/И и функције мировања

note: (itstool) path: section/title
en: Timeouts
sr: Временски рокови

note: (itstool) path: section/para
en: You may be wondering how to make <application>gtkmm</application> do useful work while it's idling along. Happily, you have several options. Using the following methods you can create a timeout method that will be called every few milliseconds.
sr: Можда се питате како да натерате <application>gtkmm</application> да ради користан посао док мирује. На срећу, имате неколико опција. Коришћењем следећих метода можете направити метод временског рока који ће бити позиван сваких неколико милисекунди.

note: (itstool) path: section/para
en: The first argument is a <classname>slot</classname> you wish to have called when the timeout occurs. The second argument is the number of milliseconds between calls to that method. You receive a <classname>sigc::connection</classname> object that can be used to deactivate the connection using its <methodname>disconnect()</methodname> method:
sr: Први аргумент је <classname>slot</classname> за који желите да буде позван када дође до истека времена. Други аргумент је број милисекунди између позива тог метода. Добијате објекат <classname>sigc::connection</classname> који се може користити за деактивирање везе помоћу његовог метода <methodname>disconnect()</methodname>:

note: (itstool) path: section/para
en: Another way of destroying the connection is your signal handler. It has to be of the type <classname>sigc::slot&lt;bool()&gt;</classname>. As you see from the definition your signal handler has to return a value of the type <literal>bool</literal>. A definition of a sample method might look like this:
sr: Други начин уништавања везе је ваш руковалац сигналом. Он мора бити врсте <classname>sigc::slot&lt;bool()&gt;</classname>. Као што видите из дефиниције, ваш руковалац сигналом мора да врати вредност врсте <literal>bool</literal>. Дефиниција примера метода би могла изгледати овако:

note: (itstool) path: section/programlisting
en: <code>bool MyCallback() { std::cout &lt;&lt; "Hello World!\n" &lt;&lt; std::endl; return true; }
    </code>
sr: <code>bool MyCallback() { std::cout &lt;&lt; "Hello World!\
    " &lt;&lt; std::endl; return true; }
    </code>

note: (itstool) path: section/para
en: You can stop the timeout method by returning <literal>false</literal> from your signal handler. Therefore, if you want your method to be called repeatedly, it should return <literal>true</literal>.
sr: Метод временског рока можете зауставити враћањем вредности <literal>false</literal> из вашег руковаоца сигналом. Стога, ако желите да се ваш метод позива више пута, треба да врати <literal>true</literal>.

note: (itstool) path: section/para
en: Here's an example of this technique:
sr: Ево примера ове технике:

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/timeout/">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/timeout/">Изворни ко̂д</link>

note: (itstool) path: section/title
en: Monitoring I/O
sr: Надгледање У/И

note: (itstool) path: section/para
en: A nifty feature of Glib (one of the libraries underlying <application>gtkmm</application>) is the ability to have it check for data on a file descriptor for you. This is especially useful for networking applications. The following method is used to do this:
sr: Згодна функција Глиба (једне од библиотека на којима се заснива <application>gtkmm</application>) је могућност да он уместо вас проверава податке на описнику датотеке. Ово је нарочито корисно за мрежне програме. За ово се користи следећи метод:

note: (itstool) path: section/para
en: The first argument is a slot you wish to have called when the specified event (see argument 3) occurs on the file descriptor you specify using argument two. Argument three may be one or more (using <literal>|</literal>) of:
sr: Први аргумент је место (slot) за које желите да буде позвано када се наведени догађај (погледајте аргумент 3) деси на описнику датотеке који наведете помоћу другог аргумента. Аргумент три може бити један или више (користећи <literal>|</literal>) од:

note: (itstool) path: listitem/para
en: Glib::IOCondition::IO_IN - Call your method when there is data ready for reading on your file descriptor.
sr: Glib::IOCondition::IO_IN — Позовите ваш метод када буду спремни подаци за читање на вашем описнику датотеке.

note: (itstool) path: listitem/para
en: Glib::IOCondition::IO_OUT - Call your method when the file descriptor is ready for writing.
sr: Glib::IOCondition::IO_OUT — Позовите ваш метод када описник датотеке буде спреман за писање.

note: (itstool) path: listitem/para
en: Glib::IOCondition::IO_PRI - Call your method when the file descriptor has urgent data to be read.
sr: Glib::IOCondition::IO_PRI – Позовите ваш метод када описник датотеке има хитне податке за читање.

note: (itstool) path: listitem/para
en: Glib::IOCondition::IO_ERR - Call your method when an error has occurred on the file descriptor.
sr: Glib::IOCondition::IO_ERR – Позовите ваш метод када се догоди грешка на описнику датотеке.

note: (itstool) path: listitem/para
en: Glib::IOCondition::IO_HUP - Call your method when hung up (the connection has been broken usually for pipes and sockets).
sr: Glib::IOCondition::IO_HUP – Позовите ваш метод при прекиду везе (веза је обично прекинута код спојки и утичница).

note: (itstool) path: section/para
en: The return value is a <classname>sigc::connection</classname> that may be used to stop monitoring this file descriptor using its <methodname>disconnect()</methodname> method. The <parameter>slot</parameter> signal handler should be declared as follows:
sr: Повратна вредност је <classname>sigc::connection</classname> која се може користити за заустављање надгледања овог описника датотеке коришћењем његовог метода <methodname>disconnect()</methodname>. Руковалац сигнала <parameter>slot</parameter> треба бити објављен на следећи начин:

note: (itstool) path: section/para
en: where <parameter>condition</parameter> is as specified above. As usual the slot is created with <function>sigc::mem_fun()</function> (for a member method of an object), or <function>sigc::ptr_fun()</function> (for a function). A lambda expression can be used, if you don't need the automatic disconnection that <function>sigc::mem_fun()</function> provides when the object goes out of scope.
sr: где је <parameter>condition</parameter> као што је горе наведено. Као и обично, место се прави помоћу <function>sigc::mem_fun()</function> (за метод члана објекта) или <function>sigc::ptr_fun()</function> (за функцију). Ламбда израз се може користити ако вам није потребно аутоматско прекидање везе које <function>sigc::mem_fun()</function> обезбеђује када објекат изађе из опсега.

note: (itstool) path: section/para
en: A little example follows. To use the example just execute it from a terminal; it doesn't create a window. It will create a pipe named <literal>testfifo</literal> in the current directory. Then start another shell and execute <literal>echo "Hello" &gt; testfifo</literal>. The example will print each line you enter until you execute <literal>echo "Q" &gt; testfifo</literal>.
sr: Следи мали пример. Да бисте користили пример, само га извршите из терминала; он не прави прозор. Направиће спојку под називом <literal>testfifo</literal> у текућем директоријуму. Затим покрените другу шкољку и извршите <literal>echo "Hello" &gt; testfifo</literal>. Пример ће исписати сваки ред који унесете док не извршите <literal>echo "Q" &gt; testfifo</literal>.

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/input/">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/input/">Изворни ко̂д</link>

note: (itstool) path: section/title
en: Idle Functions
sr: Функције мировања

note: (itstool) path: section/para
en: If you want to specify a method that gets called when nothing else is happening, use the following:
sr: Ако желите да наведете метод који се позива када се ништа друго не дешава, користите следеће:

note: (itstool) path: section/para
en: This causes <application>gtkmm</application> to call the specified method whenever nothing else is happening. You can add a priority (lower numbers are higher priorities). There are two ways to remove the signal handler: calling <methodname>disconnect()</methodname> on the <classname>sigc::connection</classname> object, or returning <literal>false</literal> in the signal handler, which should be declared as follows:
sr: Ово узрокује да <application>gtkmm</application> позове наведени метод кад год се ништа друго не дешава. Можете додати приоритет (нижи бројеви су виши приоритети). Постоје два начина за уклањање руковаоца сигнала: позивањем <methodname>disconnect()</methodname> на објекту <classname>sigc::connection</classname> или враћањем вредности <literal>false</literal> у руковаоцу сигнала, који треба бити објављен на следећи начин:

note: (itstool) path: section/para
en: Since this is very similar to the methods above this explanation should be sufficient to understand what's going on. However, here's a little example:
sr: Пошто је ово врло слично горе наведеним методима, ово објашњење би требало бити довољно за разумевање онога што се дешава. Ипак, ево малог примера:

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/idle/">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/idle/">Изворни ко̂д</link>

note: (itstool) path: section/para
en: This example points out the difference of idle and timeout methods a little. If you need methods that are called periodically, and speed is not very important, then you want timeout methods. If you want methods that are called as often as possible (like calculating a fractal in background), then use idle methods.
sr: Овај пример мало истиче разлику између метода мировања и истека времена. Ако су вам потребни методи који се позивају периодично, а брзина није врло важна, онда желите методе истека времена. Ако желите методе који се позивају што је чешће могуће (као што је израчунавање фрактала у позадини), онда користите методе мировања.

note: (itstool) path: section/para
en: Try executing the example and increasing the system load. The upper progress bar will increase steadily; the lower one will slow down.
sr: Пробајте да извршите пример и повећате оптерећење система. Горња трака напретка ће се стално повећавати; доња ће успорити.

note: (itstool) path: chapter/title
en: Memory management
sr: Управљање меморијом

note: (itstool) path: section/title
en: Normal C++ memory management
sr: Нормално C++ управљање меморијом

note: (itstool) path: section/para
en: <application>gtkmm</application> allows the programmer to control the lifetime (that is, the construction and destruction) of any widget in the same manner as any other <phrase role="nowrap">C++</phrase> object. This flexibility allows you to use <literal>new</literal> and <literal>delete</literal> to create and destroy objects dynamically or to use regular class members (that are destroyed automatically when the class is destroyed) or to use local instances (that are destroyed when the instance goes out of scope). This flexibility is not present in some <phrase role="nowrap">C++</phrase> GUI toolkits, which restrict the programmer to only a subset of <phrase role="nowrap">C++</phrase>'s memory management features.
sr: <application>gtkmm</application> омогућава програмеру да контролише животни век (то јест, стварање и уништавање) било ког елемента на исти начин као и било ког другог <phrase role="nowrap">C++</phrase> објекта. Ова флексибилност вам омогућава да користите <literal>new</literal> и <literal>delete</literal> за динамичко стварање и уништавање објеката или да користите обичне чланове класе (који се аутоматски уништавају када се класа уништи) или да користите локалне примерке (који се уништавају када примерак изађе из опсега). Ова флексибилност није присутна у неким <phrase role="nowrap">C++</phrase> ГУИ комплетима алата, који ограничавају програмера на само подскуп <phrase role="nowrap">C++</phrase> могућности управљања меморијом.

note: (itstool) path: section/para
en: An important difference in <application>gtkmm</application>-4.0 vs. older versions is that a <phrase role="nowrap">C++</phrase> widgetʼs destruction no longer causes the widget to be destroyed if itʼs within a parent; in that case the C GtkWidget stays alive. If you had relied on that behavior in an older version, in <application>gtkmm</application>-4.0 you must now remove the widget from its parent first. See <link linkend="changes-gtkmm4">Changes in <application>gtkmm</application>-4.0</link>.
sr: Важна разлика у <application>gtkmm</application>-у 4.0 у односу на старије верзије је та што уништавање <phrase role="nowrap">C++</phrase> елемента више не узрокује уништавање самог елемента ако се он налази унутар родитеља; у том случају C GtkWidget остаје жив. Ако сте се ослањали на то понашање у старијој верзији, у <application>gtkmm</application>-у 4.0 сада морате прво уклонити елемент из његовог родитеља. Погледајте <link linkend="changes-gtkmm4">Промене у <application>gtkmm</application>-у 4.0</link>.

note: (itstool) path: section/para
en: Here are some examples of normal <phrase role="nowrap">C++</phrase> memory management:
sr: Ево неколико примера нормалног <phrase role="nowrap">C++</phrase> управљања меморијом:

note: (itstool) path: section/title
en: Class Scope widgets
sr: Елементи у опсегу класе

note: (itstool) path: section/para
en: If a programmer does not need dynamic memory allocation, automatic widgets in class scope may be used. One advantage of automatic widgets in class scope is that memory management is grouped in one place. The programmer does not risk memory leaks from failing to <literal>delete</literal> a widget.
sr: Ако програмеру није потребна динамичка алокација меморије, могу се користити аутоматски елементи у опсегу класе. Једна предност аутоматских елемената у опсегу класе је та што је управљање меморијом груписано на једном месту. Програмер не ризикује цурење меморије услед пропуста да се <literal>delete</literal>-ује елемент.

note: (itstool) path: section/para
en: The primary disadvantage of using class scope widgets is revealing the class implementation rather than the class interface in the class header.
sr: Главни недостатак коришћења елемената у опсегу класе је откривање имплементације класе уместо интерфејса класе у заглављу класе.

note: (itstool) path: section/programlisting
en: <code>#include &lt;gtkmm/button.h&gt;
    #include &lt;gtkmm/window.h&gt;
    class Foo : public Gtk::Window
    {
    private:
      Gtk::Button theButton;
      // will be destroyed when the Foo object is destroyed
    };
    </code>
sr: <code>#include &lt;gtkmm/button.h&gt;
    #include &lt;gtkmm/window.h&gt;
    class Foo : public Gtk::Window
    {
    private:
      Gtk::Button theButton;
      // биће уништено када се уништи објекат Foo
    };
    </code>

note: (itstool) path: section/title
en: Function scope widgets
sr: Елементи у опсегу функције

note: (itstool) path: section/para
en: If a programmer does not need a class scope widget, a function scope widget may also be used. The advantages to function scope over class scope are the increased data hiding and reduced dependencies.
sr: Ако програмеру није потребан елемент у опсегу класе, може се користити и елемент у опсегу функције. Предности опсега функције у односу на опсег класе су повећана скривеност података и смањене зависности.

note: (itstool) path: section/para
en: However, this technique is rarely useful. Most widgets can't safely be created before the application has been registered or activated. They can't safely be deleted after <methodname>Gtk::Application::run()</methodname> or <methodname>Gtk::Application::make_window_and_run()</methodname> returns.
sr: Међутим, ова техника је ретко корисна. Већина елемената се не може безбедно направити пре него што се апликација региструје или активира. Они се не могу безбедно обрисати након што се <methodname>Gtk::Application::run()</methodname> или <methodname>Gtk::Application::make_window_and_run()</methodname> врате.

note: (itstool) path: section/title
en: Dynamic allocation with new and delete
sr: Динамичка алокација помоћу new и delete

note: (itstool) path: section/para
en: Usually, the programmer will prefer to allow containers to automatically destroy their children by creating them using <function>Gtk::make_managed()</function> (see below). This is not strictly required, as the <literal>new</literal> and <literal>delete</literal> operators may also be used, but modern <phrase role="nowrap">C++</phrase> style discourages those in favor of safer models of memory management, so it is better to create widgets using <function>Gtk::make_managed()</function> and let their parent destroy them, than to manually perform dynamic allocation.
sr: Обично ће програмер радије дозволити контејнерима да аутоматски униште своје садржаоце тако што ће их направити помоћу <function>Gtk::make_managed()</function> (види испод). Ово није строго неопходно, јер се могу користити и оператори <literal>new</literal> и <literal>delete</literal>, али савремени <phrase role="nowrap">C++</phrase> стил их обесхрабрује у корист безбеднијих модела управљања меморијом, па је боље правити елементе помоћу <function>Gtk::make_managed()</function> и пустити њиховог родитеља да их уништи, него ручно вршити динамичку алокацију.

note: (itstool) path: section/programlisting
en: <code>auto pButton = new Gtk::Button("Test");
    // do something useful with pButton
    delete pButton;
    </code>
sr: <code>auto pButton = new Gtk::Button("Test");
    // урадите нешто корисно са pButton
    delete pButton;
    </code>

note: (itstool) path: section/para
en: Here, the programmer deletes <varname>pButton</varname> to prevent a memory leak.
sr: Овде програмер брише <varname>pButton</varname> како би спречио цурење меморије.

note: (itstool) path: section/title
en: Managed Widgets
sr: Управљани елементи

note: (itstool) path: section/para
en: Alternatively, you can let a widget's container control when the widget is destroyed. In most cases, you want a widget to last only as long as the container it is in. To delegate the management of a widget's lifetime to its container, create it with <function>Gtk::make_managed()</function> and then pack it into its container with <methodname>Gtk::Box::append()</methodname> or a similar method. Now the widget will be destroyed whenever its container is destroyed.
sr: Алтернативно, можете пустити контејнер елемента да контролише када ће елемент бити уништен. У већини случајева, желите да елемент траје само онолико колико и контејнер у коме се налази. Да бисте делегирали управљање животним веком елемента његовом контејнеру, направите га помоћу <function>Gtk::make_managed()</function>, а затим га сместите у његов контејнер помоћу <methodname>Gtk::Box::append()</methodname> или сличног метода. Сада ће елемент бити уништен кад год се уништи његов контејнер.

note: (itstool) path: section/title
en: Dynamic allocation with make_managed() and append()
sr: Динамичка алокација помоћу make_managed() и append()

note: (itstool) path: section/para
en: <application>gtkmm</application> provides ways including the <function>make_managed()</function> function and <methodname>Gtk::Box::append()</methodname> method to simplify creation and destruction of widgets whose lifetime can be managed by a parent.
sr: <application>gtkmm</application> пружа начине, укључујући функцију <function>make_managed()</function> и метод <methodname>Gtk::Box::append()</methodname>, за поједностављивање стварања и уништавања елемената чијим животним веком може управљати родитељ.

note: (itstool) path: section/para
en: Every widget except a top-level window must be added to a parent container in order to be displayed. The <function>manage()</function> function marks a widget so that when that widget is added to a parent container, said container becomes responsible for deleting the widget, meaning the user no longer needs to do so. The original way to create widgets whose lifetime is managed by their parent in this way was to call <function>manage()</function>, passing in the result of a <literal>new</literal> expression that created a dynamically allocated widget.
sr: Сваки елемент осим прозора највишег нивоа мора бити додат у родитељски контејнер да би био приказан. Функција <function>manage()</function> означава елемент тако да када се тај елемент дода у родитељски контејнер, поменути контејнер постаје одговоран за брисање елемента, што значи да корисник више не мора то да ради. Првобитни начин прављења елемената чијим животним веком на овај начин управља њихов родитељ био је позивање <function>manage()</function>, прослеђујући резултат израза <literal>new</literal> који је направио динамички алоциран елемент.

note: (itstool) path: section/para
en: However, usually, when you create such a widget, you will already know that its parent container should be responsible for destroying it. In addition, modern <phrase role="nowrap">C++</phrase> style discourages use of the <literal>new</literal> operator, which was required when passing a newly created widget to <function>manage()</function>. Therefore, <application>gtkmm</application> has added <function>make_managed()</function>, which combines creation and marking with <function>manage()</function> into a single step. This avoids you having to write <literal>new</literal>, which is discouraged in modern <phrase role="nowrap">C++</phrase> style, and more clearly expresses intent to create a managed widget.
sr: Међутим, обично, када правите такав елемент, већ ћете знати да би његов родитељски контејнер требало да буде одговоран за његово уништавање. Поред тога, савремени <phrase role="nowrap">C++</phrase> стил обесхрабрује употребу оператора <literal>new</literal>, који је био неопходан приликом прослеђивања новоствореног елемента функцији <function>manage()</function>. Стога је <application>gtkmm</application> додао <function>make_managed()</function>, који комбинује стварање и означавање помоћу <function>manage()</function> у један корак. Ово избегава потребу да пишете <literal>new</literal>, што је обесхрабрено у савременом <phrase role="nowrap">C++</phrase> стилу, и јасније изражава намеру да се направи управљани елемент.

note: (itstool) path: section/para
en: Now, when objects of type <classname>MyContainer</classname> are destroyed, the button will also be deleted. It is no longer necessary to delete <varname>pButton</varname> to free the button's memory; its deletion has been delegated to the <classname>MyContainer</classname> object.
sr: Сада, када се објекти врсте <classname>MyContainer</classname> униште, дугме ће такође бити обрисано. Није више неопходно брисати <varname>pButton</varname> ради ослобађања меморије дугмета; његово брисање је поверено објекту <classname>MyContainer</classname>.

note: (itstool) path: section/para
en: If you never added the widget to any parent container, it's your responsibility to delete it. If you add it to a container widget, and later remove it (for instance with <methodname>Gtk::Box::remove()</methodname>), it's deleted by the container.
sr: Ако никада нисте додали елемент у неки родитељски контејнер, ваша је одговорност да га обришете. Ако га додате у елемент контејнера, а касније га уклоните (на пример помоћу <methodname>Gtk::Box::remove()</methodname>), обрисаће га контејнер.

note: (itstool) path: section/para
en: Of course, a top-level container will not be added to another container. The programmer is responsible for destroying the top-level container using one of the traditional <phrase role="nowrap">C++</phrase> techniques. Or you can let <methodname>Gtk::Application::make_window_and_run()</methodname> create a top-level window and delete it when it's closed.
sr: Наравно, контејнер највишег нивоа неће бити додат у други контејнер. Програмер је одговоран за уништавање контејнера највишег нивоа користећи неку од традиционалних <phrase role="nowrap">C++</phrase> техника. Или можете пустити да <methodname>Gtk::Application::make_window_and_run()</methodname> направи прозор највишег нивоа и обрише га када се затвори.

note: (itstool) path: section/title
en: Shared resources
sr: Дељени ресурси

note: (itstool) path: section/para
en: Some objects, such as <classname>Gdk::Pixbuf</classname>s and <classname>Pango::Font</classname>s, are obtained from a shared store. Therefore you cannot instantiate your own instances. These classes typically inherit from <classname>Glib::Object</classname>. Rather than requiring you to reference and unreference these objects, <application>gtkmm</application> uses the <classname>Glib::RefPtr&lt;&gt;</classname> smartpointer. Cairomm has its own smartpointer, <classname>Cairo::RefPtr&lt;&gt;</classname>.
sr: Неки објекти, као што су <classname>Gdk::Pixbuf</classname> и <classname>Pango::Font</classname>, добијају се из дељеног складишта. Због тога не можете стварати сопствене примерке. Ове класе обично наслеђују из <classname>Glib::Object</classname>. Уместо да захтева од вас да референцирате и дереференцирате ове објекте, <application>gtkmm</application> користи паметни показивач <classname>Glib::RefPtr&lt;&gt;</classname>. Cairomm има свој паметни показивач, <classname>Cairo::RefPtr&lt;&gt;</classname>.

note: (itstool) path: section/para
en: Objects such as <classname>Gdk::Pixbuf</classname> can only be instantiated with a <methodname>create()</methodname> function. For instance,
sr: Објекти као што је <classname>Gdk::Pixbuf</classname> могу се створити само помоћу функције <methodname>create()</methodname>. На пример,

note: (itstool) path: section/para
en: You have no way of getting a bare <classname>Gdk::Pixbuf</classname>. In the example, <varname>pixbuf</varname> is a smart pointer, so you can do this, much like a normal pointer:
sr: Немате начина да добијете голи <classname>Gdk::Pixbuf</classname>. У примеру, <varname>pixbuf</varname> је паметни показивач, тако да можете урадити ово, слично обичном показивачу:

note: (itstool) path: section/para
en: When <varname>pixbuf</varname> goes out of scope an <methodname>unref()</methodname> will happen in the background and you don't need to worry about it anymore. There's no <literal>new</literal> so there's no <literal>delete</literal>.
sr: Када <varname>pixbuf</varname> изађе из опсега, <methodname>unref()</methodname> ће се десити у позадини и више не морате да бринете о томе. Нема <literal>new</literal> па нема ни <literal>delete</literal>.

note: (itstool) path: section/para
en: If you copy a <classname>RefPtr</classname>, for instance
sr: Ако копирате <classname>RefPtr</classname>, на пример

note: (itstool) path: section/para
en: or if you pass it as a method argument or a return type, then <classname>RefPtr</classname> will do any necessary referencing to ensure that the instance will not be destroyed until the last <classname>RefPtr</classname> has gone out of scope.
sr: или ако га проследите као аргумент методе или повратну врсту, тада ће <classname>RefPtr</classname> обавити свако неопходно референцирање како би осигурао да примерак неће бити уништен све док последњи <classname>RefPtr</classname> не изађе из опсега.

note: (itstool) path: section/para
en: See the <link linkend="chapter-refptr">appendix</link> for detailed information about RefPtr.
sr: Погледајте <link linkend="chapter-refptr">додатак</link> за детаљне информације о RefPtr.

note: (itstool) path: listitem/para
en: Bjarne Stroustrup, "The C++ Programming Language" Fourth Edition - section 34.3
sr: Бјарне Струструп, „The C++ Programming Language“ четврто издање — одељак 34.3

note: (itstool) path: listitem/para
en: Nicolai M. Josuttis, "The C++ Standard Library" - section 4.2
sr: Николај М. Јосутис, „The C++ Standard Library“ — одељак 4.2

note: (itstool) path: section/para
en: If you wish to learn more about smartpointers, you might look in these books: <_:itemizedlist-1/>
sr: Ако желите да сазнате више о паметним показивачима, можете погледати ове књиге: <_:itemizedlist-1/>

note: (itstool) path: chapter/para
en: Although you can use <phrase role="nowrap">C++</phrase> code to instantiate and arrange widgets, this can soon become tedious and repetitive. And it requires a recompilation to show changes. The <link xlink:href="https://gitlab.gnome.org/jpu/cambalache">Cambalache</link> application allows you to layout widgets on screen and then save an XML description of the arrangement. Your application can then use the <application>Gtk::Builder</application> API to load that XML file at runtime and obtain a pointer to specifically named widget instances.
sr: Иако можете користити <phrase role="nowrap">C++</phrase> код за стварање и распоређивање елемената, то убрзо може постати заморно и често се понављати. Такође захтева поновно превођење програма да би се приказале измене. Апликација <link xlink:href="https://gitlab.gnome.org/jpu/cambalache">Cambalache</link> омогућава вам да распоредите елементе на екрану и затим сачувате XML опис тог распореда. Ваша апликација тада може користити <application>Gtk::Builder</application> API за учитавање те XML датотеке у време извршавања и добијање показивача на специфично именоване примерке елемената.

note: (itstool) path: listitem/simpara
en: Less C++ code is required.
sr: Потребно је мање C++ кода.

note: (itstool) path: listitem/simpara
en: UI changes can be seen more quickly, so UIs are able to improve.
sr: Измене корисничког прочеља се могу видети брже, па се прочеља могу побољшати.

note: (itstool) path: listitem/simpara
en: Designers without programming skills can create and edit UIs.
sr: Дизајнери без програмерских вештина могу да стварају и уређују корисничка прочеља.

note: (itstool) path: chapter/para
en: This has the following advantages: <_:orderedlist-1/>
sr: Ово има следеће предности: <_:orderedlist-1/>

note: (itstool) path: chapter/para
en: You still need <phrase role="nowrap">C++</phrase> code to deal with User Interface changes triggered by user actions, but using <application>Gtk::Builder</application> for the widget layout allows you to focus on implementing that functionality.
sr: И даље вам је потребан <phrase role="nowrap">C++</phrase> код за руковање изменама корисничког прочеља које покрећу корисничке радње, али коришћење <application>Gtk::Builder</application>-а за распоред елемената омогућава вам да се усредсредите на имплементацију те функционалности.

note: (itstool) path: chapter/para
en: <application>Cambalache</application> replaces the <application>Glade</application> application. <application>Glade</application> can generate XML files to be used with gtk3/<application>gtkmm</application>3, but it does not support gtk4/<application>gtkmm</application>4.
sr: <application>Cambalache</application> замењује програм <application>Glade</application>. <application>Glade</application> може да генерише XML датотеке које ће се користити са gtk3/<application>gtkmm</application>3, али не подржава gtk4/<application>gtkmm</application>4.

note: (itstool) path: section/title
en: Loading the .ui file
sr: Учитавање .ui датотеке

note: (itstool) path: section/para
en: <classname>Gtk::Builder</classname> must be used via a <classname>Glib::RefPtr</classname>. Like all such classes, you need to use a <methodname>create()</methodname> method to instantiate it. For instance,
sr: <classname>Gtk::Builder</classname> се мора користити путем <classname>Glib::RefPtr</classname>-а. Као и код свих таквих класа, морате користити метод <methodname>create()</methodname> да бисте га инстанцирали. На пример,

note: (itstool) path: section/para
en: This will instantiate the windows defined in the <filename class="extension">.ui</filename> file.
sr: Ово ће инстанцирати прозоре дефинисане у <filename class="extension">.ui</filename> датотеци.

note: (itstool) path: section/para
en: To instantiate just one window, or just one of the child widgets, you can specify the name of a widget as the second parameter. For instance,
sr: Да бисте инстанцирали само један прозор, или само један од садржаних елемената, можете навести назив елемента као други параметар. На пример,

note: (itstool) path: section/title
en: Accessing widgets
sr: Приступање елементима

note: (itstool) path: section/para
en: To access a widget, for instance to show a dialog, use the <methodname>get_widget()</methodname> method, providing the widget's name. This name should be specified in the <application>Cambalache</application> window. If the widget could not be found, or is of the wrong type, then the pointer will be set to <literal>nullptr</literal>.
sr: Да бисте приступили елементу, на пример да бисте приказали прозорче, користите метод <methodname>get_widget()</methodname>, наводећи назив елемента. Овај назив треба да буде наведен у прозору <application>Cambalache</application>-а. Ако елемент не може бити пронађен, или је погрешне врсте, тада ће показивач бити постављен на <literal>nullptr</literal>.

note: (itstool) path: section/para
en: The dialogs in this chapter are derived from <classname>Gtk::Window</classname> because <classname>Gtk::Dialog</classname> is deprecated since <application>gtkmm</application> 4.10.
sr: Прозорчићи у овом поглављу су изведени из <classname>Gtk::Window</classname> јер је <classname>Gtk::Dialog</classname> застарео од <application>gtkmm</application>-а 4.10.

note: (itstool) path: section/para
en: <classname>Gtk::Builder</classname> checks for a null pointer, and checks that the widget is of the expected type, and will show warnings on the command line about these.
sr: <classname>Gtk::Builder</classname> проверава да ли постоји ништавни показивач и проверава да ли је елемент очекиване врсте, те ће приказати упозорења на линији наредби о томе.

note: (itstool) path: section/para
en: Remember that you are not instantiating a widget with <methodname>get_widget()</methodname>, you are just obtaining a pointer to one that already exists. You will always receive a pointer to the same instance when you call <methodname>get_widget()</methodname> on the same <classname>Gtk::Builder</classname>, with the same widget name. The widgets are instantiated during <methodname>Gtk::Builder::create_from_file()</methodname>.
sr: Запамтите да не инстанцирате елемент помоћу <methodname>get_widget()</methodname>, већ само добијате показивач на онај који већ постоји. Увек ћете примити показивач на исти примерак када позовете <methodname>get_widget()</methodname> на истом <classname>Gtk::Builder</classname>-у, са истим називом елемента. Елементи се инстанцирају током <methodname>Gtk::Builder::create_from_file()</methodname>.

note: (itstool) path: section/para
en: <methodname>get_widget()</methodname> returns child widgets that are <function>manage()</function>ed (see the <link linkend="chapter-memory">Memory Management</link> chapter), so they will be deleted when their parent container is deleted. <classname>Window</classname>s (such as <classname>Dialog</classname>s) cannot be managed because they have no parent container, so you must delete them at some point. The documentation of <classname>Gtk::Builder</classname> has more to say about the memory management of different kinds of objects.
sr: <methodname>get_widget()</methodname> враћа садржане елементе којима се управља (погледајте поглавље <link linkend="chapter-memory">Управљање меморијом</link>), тако да ће они бити обрисани када се обрише њихов родитељски контејнер. Прозори (као што су прозорчићи) не могу бити управљани јер немају родитељски контејнер, тако да их морате обрисати у неком тренутку. Документација <classname>Gtk::Builder</classname>-а има више тога да каже о управљању меморијом различитих врста објеката.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1Builder.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1Builder.html">Упутство</link>

note: (itstool) path: section/para
en: This simple example shows how to load a <filename class="extension">.ui</filename> file at runtime and access the widgets with <classname>Gtk::Builder</classname>.
sr: Овај једноставан пример показује како да учитате <filename class="extension">.ui</filename> датотеку у време извршавања и приступите елементима помоћу <classname>Gtk::Builder</classname>-а.

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/builder/basic">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/builder/basic">Изворни ко̂д</link>

note: (itstool) path: section/title
en: Using derived widgets
sr: Коришћење изведених елемената

note: (itstool) path: section/para
en: You can use <application>Cambalache</application> and <classname>Gtk::Builder</classname> to layout your own custom widgets derived from <application>gtkmm</application> widget classes. This keeps your code organized and encapsulated, separating declarative presentation from business logic, avoiding having most of your source just be setting properties and packing in containers.
sr: Можете користити <application>Cambalache</application> и <classname>Gtk::Builder</classname> за распоређивање сопствених произвољних елемената изведених из <application>gtkmm</application> класа елемената. Ово одржава ваш ко̂д организованим и енкапсулираним, одвајајући декларативни приказ од пословне логике, избегавајући да већина вашег извора буде само подешавање својстава и паковање у контејнере.

note: (itstool) path: section/para
en: Use <methodname>Gtk::Builder::get_widget_derived()</methodname> like so:
sr: Користите <methodname>Gtk::Builder::get_widget_derived()</methodname> на следећи начин:

note: (itstool) path: section/para
en: Your derived class must have a constructor that takes a pointer to the underlying C type, and the <classname>Gtk::Builder</classname> instance. All relevant classes of <application>gtkmm</application> typedef their underlying C type as <classname>BaseObjectType</classname> (<classname>Gtk::Window</classname> typedefs <classname>BaseObjectType</classname> as <type>GtkWindow</type>, for instance).
sr: Ваша изведена класа мора имати конструктор који прихвата показивач на основни Ц тип и примерак <classname>Gtk::Builder</classname>-а. Све релевантне класе <application>gtkmm</application>-а дефинишу свој основни Ц тип као <classname>BaseObjectType</classname> (<classname>Gtk::Window</classname> дефинише <classname>BaseObjectType</classname> као <type>GtkWindow</type>, на пример).

note: (itstool) path: section/para
en: You must call the base class's constructor in the initialization list, providing the C pointer. For instance,
sr: Морате позвати конструктор основне класе у листи иницијализације, обезбеђујући Ц показивач. На пример,

note: (itstool) path: section/para
en: You could then encapsulate the manipulation of the child widgets in the constructor of the derived class, maybe using <methodname>get_widget()</methodname> or <methodname>get_widget_derived()</methodname> again. For instance,
sr: Затим бисте могли да енкапсулирате манипулацију подређеним елементима у конструктору изведене класе, можда поново користећи <methodname>get_widget()</methodname> или <methodname>get_widget_derived()</methodname>. На пример,

note: (itstool) path: section/programlisting
en: <code>DerivedDialog::DerivedDialog(BaseObjectType* cobject, const Glib::RefPtr&lt;Gtk::Builder&gt;&amp; builder)
    : Gtk::Window(cobject),
      m_builder(builder),
      // Get the GtkBuilder-instantiated Button, and connect a signal handler:
      m_pButton(m_builder-&gt;get_widget&lt;Gtk::Button&gt;("quit_button"))
    {
      if (m_pButton)
      {
        m_pButton-&gt;signal_clicked().connect( sigc::mem_fun(*this, &amp;DerivedDialog::on_button_quit) );
      }
    }
    </code>
sr: <code>DerivedDialog::DerivedDialog(BaseObjectType* cobject, const Glib::RefPtr&lt;Gtk::Builder&gt;&amp; builder)
    : Gtk::Window(cobject),
      m_builder(builder),
      // Дохватите Button инстанциран преко GtkBuilder-а и повежите руковаоца сигналом:
      m_pButton(m_builder-&gt;get_widget&lt;Gtk::Button&gt;("quit_button"))
    {
      if (m_pButton)
      {
        m_pButton-&gt;signal_clicked().connect( sigc::mem_fun(*this, &amp;DerivedDialog::on_button_quit) );
      }
    }
    </code>

note: (itstool) path: section/para
en: It's possible to pass additional arguments from <methodname>get_widget_derived()</methodname> to the constructor of the derived widget. For instance, this call to <methodname>get_widget_derived()</methodname>
sr: Могуће је проследити додатне аргументе из <methodname>get_widget_derived()</methodname> у конструктор изведеног елемента. На пример, овај позив <methodname>get_widget_derived()</methodname>

note: (itstool) path: section/para
en: can invoke this constructor
sr: може позвати овај конструктор

note: (itstool) path: section/title
en: Gtk::Builder and Glib::Property
sr: Gtk::Builder и Glib::Property

note: (itstool) path: section/para
en: If your derived widget uses <classname>Glib::Property</classname>, it becomes slightly more complicated. A derived widget that contains <classname>Glib::Property</classname> members must be registered with its own name in the <type>GType</type> system. It must be registered before any of the <methodname>create_from_*()</methodname> or <methodname>add_from_*()</methodname> methods are called, meaning that you may have to create an instance of your derived widget just to have its class registered. Your derived widget must have a constructor that has the parameters required by <methodname>get_widget_derived()</methodname> and calls the <classname>Glib::ObjectBase</classname> constructor to register the <type>GType</type>.
sr: Ако ваш изведени елемент користи <classname>Glib::Property</classname>, ствар постаје мало компликованија. Изведени елемент који садржи <classname>Glib::Property</classname> чланове мора бити регистрован под сопственим именом у <type>GType</type> систему. Мора бити регистрован пре него што се позове било која од <methodname>create_from_*()</methodname> или <methodname>add_from_*()</methodname> метода, што значи да ћете можда морати да направите примерак свог изведеног елемента само да би његова класа била регистрована. Ваш изведени елемент мора имати конструктор који има параметре захтеване од стране <methodname>get_widget_derived()</methodname> и позива <classname>Glib::ObjectBase</classname> конструктор ради регистрације <type>GType</type>-а.

note: (itstool) path: section/programlisting
en: <code>DerivedButton::DerivedButton(BaseObjectType* cobject, const Glib::RefPtr&lt;Gtk::Builder&gt;&amp; builder)
    : Glib::ObjectBase("MyButton"), // The GType name will be gtkmm__CustomObject_MyButton.
      Gtk::Button(cobject),
      prop_ustring(*this, "button-ustring"),
      prop_int(*this, "button-int", 10)
    {
      // ....
    }
    </code>
sr: <code>DerivedButton::DerivedButton(BaseObjectType* cobject, const Glib::RefPtr&lt;Gtk::Builder&gt;&amp; builder)
    : Glib::ObjectBase("MyButton"), // GType име ће бити gtkmm__CustomObject_MyButton.
      Gtk::Button(cobject),
      prop_ustring(*this, "button-ustring"),
      prop_int(*this, "button-int", 10)
    {
      // ....
    }
    </code>

note: (itstool) path: section/para
en: It is possible also to specify properties of derived widgets, declared in <phrase role="nowrap">C++</phrase> using <application>gtkmm</application>, within <filename class="extension">.ui</filename> files and load/set these using <classname>Gtk::Builder</classname>. See the documentation of <classname>Gtk::Builder</classname> for more details on how to achieve this. <application>Cambalache</application> won’t recognize such properties as-is, but you should be able to add a few lines of hand-coded XML to the XML code generated by <application>Cambalache</application>.
sr: Такође је могуће навести својства изведених елемената, декларисаних у <phrase role="nowrap">C++</phrase> језику помоћу <application>gtkmm</application>-а, унутар <filename class="extension">.ui</filename> датотека и учитати/поставити их помоћу <classname>Gtk::Builder</classname>-а. Погледајте документацију за <classname>Gtk::Builder</classname> за више детаља о томе како ово постићи. <application>Cambalache</application> неће препознати таква својства сама по себи, али бисте требали бити у могућности да додате неколико линија ручно кодираног XML-а у XML ко̂д који је генерисао <application>Cambalache</application>.

note: (itstool) path: section/para
en: This example shows how to load a <filename class="extension">.ui</filename> file at runtime and access the widgets via derived classes.
sr: Овај пример показује како да учитате <filename class="extension">.ui</filename> датотеку у време извршавања и приступите елементима преко изведених класа.

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/builder/derived">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/builder/derived">Изворни ко̂д</link>

note: (itstool) path: chapter/title
en: Internationalization and Localization
sr: Интернационализација и локализација

note: (itstool) path: chapter/para
en: <application>gtkmm</application> applications can easily support multiple languages, including non-European languages such as Chinese and right-to-left languages such as Arabic. An appropriately-written and translated <application>gtkmm</application> application will use the appropriate language at runtime based on the user's environment.
sr: <application>gtkmm</application> програми могу лако подржати више језика, укључујући неевропске језике као што је кинески и језике који се пишу здесна налево као што је арапски. Исправно написан и преведен <application>gtkmm</application> програм ће користити одговарајући језик при извршавању на основу корисниковог окружења.

note: (itstool) path: chapter/para
en: You might not anticipate the need to support additional languages, but you can never rule it out. And it's easier to develop the application properly in the first place rather than retrofitting later.
sr: Можда нећете предвидети потребу за подршком додатним језицима, али то никада не можете искључити. И лакше је развити програм исправно од самог почетка него га касније прилагођавати.

note: (itstool) path: chapter/para
en: The process of writing source code that allows for translation is called <literal>internationalization</literal>, often abbreviated to <literal>i18n</literal>. The <literal>Localization</literal> process, sometimes abbreviated as <literal>l10n</literal>, provides translated text for other languages, based on that source code.
sr: Процес писања изворног кода који омогућава превођење назива се <literal>интернационализација</literal>, често скраћено на <literal>i18n</literal>. Процес <literal>локализације</literal>, понекад скраћено као <literal>l10n</literal>, обезбеђује преведени текст за друге језике, на основу тог изворног кода.

note: (itstool) path: chapter/para
en: The main activity in the internationalization process is finding strings seen by users and marking them for translation. You do not need to do it all at once - if you set up the necessary project infrastructure correctly then your application will work normally regardless of how many strings you've covered.
sr: Главна активност у процесу интернационализације је проналажење ниски које корисници виде и њихово означавање за превођење. Не морате то да урадите све одједном — ако исправно подесите неопходну инфраструктуру пројекта, ваш програм ће радити нормално без обзира на то колико сте ниски обухватили.

note: (itstool) path: chapter/para
en: String literals should be typed in the source code in English, but surrounded by a macro. The <application>gettext</application> (or intltool) utility can then extract the marked strings for translation, and substitute the translated text at runtime.
sr: Литерали ниски треба да буду укуцани у изворном коду на енглеском, али окружени макроом. Алатка <application>gettext</application> (или intltool) може затим издвојити означене ниске за превођење и заменити преведени текст при извршавању.

note: (itstool) path: section/title
en: Preparing your project
sr: Припрема вашег пројекта

note: (itstool) path: note/para
en: In the instructions below we will assume that you will not be using <application>gettext</application> directly, but <application>intltool</application>, which was written specifically for <literal>GNOME</literal>. <application>intltool</application> uses <function>gettext()</function>, which extracts strings from source code, but <application>intltool</application> can also combine strings from other files, for example from desktop menu details, and GUI resource files such as <filename class="extension">.ui</filename> files, into standard <application>gettext</application> <filename>.pot/.po</filename> files.
sr: У упутствима испод претпоставићемо да нећете користити <application>gettext</application> директно, већ <application>intltool</application>, који је написан посебно за <literal>Гном</literal>. <application>intltool</application> користи <function>gettext()</function>, који издваја ниске из изворног кода, али <application>intltool</application> такође може да комбинује ниске из других датотека, на пример из детаља изборника радне површине и ГКС датотека ресурса као што су <filename class="extension">.ui</filename> датотеке, у стандардне <application>gettext</application> <filename>.pot/.po</filename> датотеке.

note: (itstool) path: note/para
en: We also assume that you are using autotools (<application>automake</application> and <application>autoconf</application>) to build your project (although autotools is not recommended for new applications), and that you are using <link xlink:href="https://gitlab.gnome.org/Archive/gnome-common/-/blob/master/autogen.sh"> <literal>./autogen.sh</literal> from <application>gnome-common</application></link> or a similar <literal>autogen.sh</literal> file, which, among other things, takes care of some <application>intltool</application> initialization.
sr: Такође претпостављамо да користите autotools (<application>automake</application> и <application>autoconf</application>) за изградњу вашег пројекта (иако се autotools не препоручује за нове програме) и да користите <link xlink:href="https://gitlab.gnome.org/Archive/gnome-common/-/blob/master/autogen.sh"> <literal>./autogen.sh</literal> из <application>gnome-common</application></link> или сличну <literal>autogen.sh</literal> датотеку, која се, између осталог, брине о покретању <application>intltool</application>-а.

note: (itstool) path: note/para
en: If you are using <application>meson</application> (recommended), see the <link xlink:href="https://mesonbuild.com/Localisation.html">Localisation</link> chapter in Meson's manual. You can then skip this section.
sr: Ако користите <application>meson</application> (препоручено), погледајте поглавље <link xlink:href="https://mesonbuild.com/Localisation.html">Локализација</link> у Мезоновом приручнику. Затим можете прескочити овај одељак.

note: (itstool) path: section/para
en: An alternative to <application>gnome-common</application>'s <literal>autogen.sh</literal> may look like this:
sr: Алтернатива за <application>gnome-common</application>-ов <literal>autogen.sh</literal> може изгледати овако:

note: (itstool) path: section/para
en: Create a sub-directory named <literal>po</literal> in your project's root directory. This directory will eventually contain all of your translations. Within it, create a file named <literal>LINGUAS</literal> and a file named <literal>POTFILES.in</literal>.
sr: Направите поддиректоријум под називом <literal>po</literal> у кореном директоријуму вашег пројекта. Овај директоријум ће на крају садржати све ваше преводе. Унутар њега направите датотеку под називом <literal>LINGUAS</literal> и датотеку под називом <literal>POTFILES.in</literal>.

note: (itstool) path: section/para
en: <literal>LINGUAS</literal> contains an alphabetically sorted list of codes identifying the languages for which your program is translated (comment lines starting with a <literal>#</literal> are ignored). Each language code listed in the <literal>LINGUAS</literal> file must have a corresponding <literal>.po</literal> file. So, if your program has German and Japanese translations, your <literal>LINGUAS</literal> file would look like this:
sr: <literal>LINGUAS</literal> садржи азбучно поређан списак кодова који идентификују језике на које је ваш програм преведен (редови коментара који почињу са <literal>#</literal> се занемарују). Сваки код језика наведен у датотеци <literal>LINGUAS</literal> мора имати одговарајућу <literal>.po</literal> датотеку. Дакле, ако ваш програм има немачки и јапански превод, ваша <literal>LINGUAS</literal> датотека би изгледала овако:

note: (itstool) path: section/para
en: (In addition, you'd have the files <literal>de.po</literal> and <literal>ja.po</literal> in your <literal>po</literal> directory which contain the German and Japanese translations, respectively.)
sr: (Поред тога, имали бисте датотеке <literal>de.po</literal> и <literal>ja.po</literal> у вашем <literal>po</literal> директоријуму које садрже немачки и јапански превод.)

note: (itstool) path: section/para
en: <literal>POTFILES.in</literal> is a list of paths to all files which contain strings marked up for translation, starting from the project root directory. So for example, if your project sources were located in a subdirectory named <literal>src</literal>, and you had two files that contained strings that should be translated, your <literal>POTFILES.in</literal> file might look like this:
sr: <literal>POTFILES.in</literal> је списак путања до свих датотека које садрже ниске означене за превођење, почевши од кореног директоријума пројекта. Тако на пример, ако су извори вашег пројекта смештени у поддиректоријуму под називом <literal>src</literal> и имате две датотеке које садрже ниске које треба превести, ваша <literal>POTFILES.in</literal> датотека би могла изгледати овако:

note: (itstool) path: section/para
en: If you are using <application>gettext</application> directly, you can only mark strings for translation if they are in source code file. However, if you use <application>intltool</application>, you can mark strings for translation in a variety of other file formats, including <filename class="extension">.ui</filename> files, xml, <link xlink:href="http://standards.freedesktop.org/desktop-entry-spec/latest/">.desktop files</link> and several more. So, if you have designed some of the application UI in xml files then also add your <filename class="extension">.ui</filename> files to the list in <literal>POTFILES.in</literal>.
sr: Ако користите <application>gettext</application> директно, можете означити ниске за превођење само ако су у датотеци изворног кода. Међутим, ако користите <application>intltool</application>, можете означити ниске за превођење у разним другим форматима датотека, укључујући <filename class="extension">.ui</filename> датотеке, xml, <link xlink:href="http://standards.freedesktop.org/desktop-entry-spec/latest/">.desktop датотеке</link> и још неколико других. Дакле, ако сте дизајнирали део корисничког прочеља програма у xml датотекама, додајте и ваше <filename class="extension">.ui</filename> датотеке на списак у <literal>POTFILES.in</literal>.

note: (itstool) path: section/para
en: Now that there is a place to put your translations, you need to initialize <application>intltool</application> and <application>gettext</application>. Add the following code to your <literal>configure.ac</literal>, substituting 'programname' with the name of your program:
sr: Сада када постоји место за постављање ваших превода, потребно је да покренете <application>intltool</application> и <application>gettext</application>. Додајте следећи код у ваш <literal>configure.ac</literal>, замењујући „programname“ именом вашег програма:

note: (itstool) path: section/para
en: This <varname>PROGRAMNAME_LOCALEDIR</varname> variable will be used later in the <literal>Makefile.am</literal> file, to define a macro that will be used when you initialize <application>gettext</application> in your source code.
sr: Ова променљива <varname>PROGRAMNAME_LOCALEDIR</varname> ће се касније користити у датотеци <literal>Makefile.am</literal> за дефинисање макроа који ће се користити када покренете <application>gettext</application> у вашем изворном коду.

note: (itstool) path: section/para
en: <literal>AM_GLIB_GNU_GETTEXT</literal> has been an alternative to <literal>AM_GNU_GETTEXT</literal> and <literal>AM_GNU_GETTEXT_VERSION</literal>, but <literal>AM_GLIB_GNU_GETTEXT</literal> is now deprecated, and shall not be used in new code.
sr: <literal>AM_GLIB_GNU_GETTEXT</literal> је био алтернатива за <literal>AM_GNU_GETTEXT</literal> и <literal>AM_GNU_GETTEXT_VERSION</literal>, али је <literal>AM_GLIB_GNU_GETTEXT</literal> сада застарео и не треба га користити у новом коду.

note: (itstool) path: listitem/para
en: Add <literal>po</literal> to the <literal>SUBDIRS</literal> variable. Without this, your translations won't get built and installed when you build the program
sr: Додајте <literal>po</literal> у променљиву <literal>SUBDIRS</literal>. Без овога, ваши преводи неће бити изграђени и инсталирани када градите програм

note: (itstool) path: listitem/para
en: Define <literal>INTLTOOL_FILES</literal> as:
sr: Дефинишите <literal>INTLTOOL_FILES</literal> као:

note: (itstool) path: listitem/para
en: Add <literal>INTLTOOL_FILES</literal> to the <literal>EXTRA_DIST</literal> list of files. This ensures that when you do a <command>make dist</command>, these files will be included in the source tarball.
sr: Додајте <literal>INTLTOOL_FILES</literal> на списак датотека <literal>EXTRA_DIST</literal>. Ово осигурава да ће, када покренете <command>make dist</command>, ове датотеке бити укључене у изворну архиву (tarball).

note: (itstool) path: listitem/para
en: Update your <literal>DISTCLEANFILES</literal>:
sr: Ажурирајте ваш <literal>DISTCLEANFILES</literal>:

note: (itstool) path: listitem/para
en: Depending on the types of files that contain translatable strings, add code such as
sr: У зависности од врста датотека које садрже ниске за превођење, додајте код као што је

note: (itstool) path: section/para
en: In the top-level Makefile.am: <_:itemizedlist-1/>
sr: У Makefile.am највишег нивоа: <_:itemizedlist-1/>

note: (itstool) path: section/para
en: In your <literal>src/Makefile.am</literal>, update your <literal>AM_CPPFLAGS</literal> to add the following preprocessor macro definition:
sr: У вашем <literal>src/Makefile.am</literal>, ажурирајте ваш <literal>AM_CPPFLAGS</literal> да додате следећу дефиницију макроа препроцесора:

note: (itstool) path: section/para
en: This macro will be used when you initialize <literal>gettext</literal> in your source code.
sr: Овај макро ће се користити када покренете <literal>gettext</literal> у вашем изворном коду.

note: (itstool) path: section/title
en: Marking strings for translation
sr: Означавање ниски за превођење

note: (itstool) path: section/para
en: String literals should be typed in the source code in English, but they should be surrounded by a call to the <function>gettext()</function> function. These strings will be extracted for translation and the translations may be used at runtime instead of the original English strings.
sr: Литерали ниски треба да буду укуцани у изворном коду на енглеском, али треба да буду окружени позивом функције <function>gettext()</function>. Ове ниске ће бити извучене за превођење и преводи се могу користити током извршавања уместо оригиналних ниски на енглеском.

note: (itstool) path: section/para
en: The <application>GNU gettext</application> package allows you to mark strings in source code, extract those strings for translation, and use the translated strings in your application.
sr: Пакет <application>ГНУ gettext</application> вам омогућава да означите ниске у изворном коду, извучете те ниске за превођење и користите преведене ниске у вашој апликацији.

note: (itstool) path: section/para
en: However, <application>Glib</application> defines <function>gettext()</function> support macros which are shorter wrappers in an easy-to-use form. To use these macros, include <literal>&lt;glibmm/i18n.h&gt;</literal>, and then, for example, substitute:
sr: Међутим, <application>Глиб</application> дефинише макрое подршке за <function>gettext()</function> који су краћи омотачи у облику једноставном за коришћење. Да бисте користили ове макрое, укључите <literal>&lt;glibmm/i18n.h&gt;</literal>, а затим, на пример, замените:

note: (itstool) path: section/para
en: with:
sr: са:

note: (itstool) path: section/programlisting
en: <code>display_message(_("Getting ready for i18n."));</code>
sr: <code>display_message(_("Припрема за интернационализацију."));</code>

note: (itstool) path: section/para
en: For reference, it is possible to generate a file which contains all strings which appear in your code, even if they are not marked for translation, together with file name and line number references. To generate such a file named <literal>my-strings</literal>, execute the following command, within the source code directory:
sr: Ради подсећања, могуће је направити датотеку која садржи све ниске које се појављују у вашем коду, чак и ако нису означене за превод, заједно са називом датотеке и референцама броја реда. Да бисте направили такву датотеку под називом <literal>my-strings</literal>, извршите следећу наредбу унутар директоријума изворног кода:

note: (itstool) path: section/para
en: Finally, to let your program use the translation for the current locale, add this code to the beginning of your <filename>main.cc</filename> file, to initialize gettext.
sr: На крају, да бисте омогућили програму да користи превод за тренутни локал, додајте овај код на почетак ваше <filename>main.cc</filename> датотеке како бисте покренули gettext.

note: (itstool) path: section/title
en: How gettext works
sr: Како gettext ради

note: (itstool) path: section/para
en: The <application>intltool-update</application> or <application>xgettext</application> script extracts the strings and puts them in a <filename>mypackage.pot</filename> file. The translators of your application create their translations by first copying this <filename>.pot</filename> file to a <filename>localename.po</filename> file. A locale identifies a language and an encoding for that language, including date and numerical formats. Later, when the text in your source code has changed, the <application>msgmerge</application> or <application>intltool-update</application> script is used to update the <filename>localename.po</filename> files from the regenerated <filename>.pot</filename> file.
sr: Скрипта <application>intltool-update</application> или <application>xgettext</application> извлачи ниске и ставља их у датотеку <filename>mypackage.pot</filename>. Преводиоци вашег програма стварају своје преводе тако што прво умноже ову <filename>.pot</filename> датотеку у <filename>localename.po</filename> датотеку. Локал одређује језик и кодирање за тај језик, укључујући записе датума и бројева. Касније, када се текст у вашем изворном коду измени, користи се скрипта <application>msgmerge</application> или <application>intltool-update</application> за ажурирање <filename>localename.po</filename> датотека из поново створене <filename>.pot</filename> датотеке.

note: (itstool) path: section/para
en: At install time, the <filename>.po</filename> files are converted to a binary format (with the extension <filename>.mo</filename>) and placed in a system-wide directory for locale files, for example <filename>/usr/share/locale/</filename>.
sr: Приликом инсталације, <filename>.po</filename> датотеке се претварају у бинарни облик (са проширењем <filename>.mo</filename>) и смештају у системски директоријум за датотеке локала, на пример <filename>/usr/share/locale/</filename>.

note: (itstool) path: section/para
en: When the application runs, the <application>gettext</application> library checks the system-wide directory to see if there is a <filename>.mo</filename> file for the user's locale environment (you can set the locale with, for instance, "export LANG=de_DE.UTF-8" from a bash console). Later, when the program reaches a <literal>gettext</literal> call, it looks for a translation of a particular string. If none is found, the original string is used.
sr: Када се програм покрене, библиотека <application>gettext</application> проверава системски директоријум да види да ли постоји <filename>.mo</filename> датотека за корисниково окружење локала (локал можете поставити, на пример, наредбом „export LANG=sr_RS.UTF-8“ из баш конзоле). Касније, када програм дође до позива <literal>gettext</literal>, он тражи превод одређене ниске. Ако га не пронађе, користи се изворна ниска.

note: (itstool) path: section/title
en: Testing and adding translations
sr: Тестирање и додавање превода

note: (itstool) path: section/para
en: To convince yourself that you've done well, you may wish to add a translation for a new locale. In order to do that, go to the <filename>po</filename> subdirectory of your project and execute the following command:
sr: Да бисте се уверили да сте добро урадили посао, можда ћете желети да додате превод за нови локал. Да бисте то урадили, идите у поддиректоријум <filename>po</filename> вашег пројекта и извршите следећу наредбу:

note: (itstool) path: section/para
en: That will create a file named <filename>programname.pot</filename>. Now copy that file to <filename>languagecode.po</filename>, such as <filename>de.po</filename> or <filename>hu.po</filename>. Also add that language code to <literal>LINGUAS</literal>. The <filename>.po</filename> file contains a header and a list of English strings, with space for the translated strings to be entered. Make sure you set the encoding of the <filename>.po</filename> file to <literal>UTF-8</literal>.
sr: То ће направити датотеку под називом <filename>programname.pot</filename>. Сада умножите ту датотеку у <filename>languagecode.po</filename>, као што је <filename>sr.po</filename> или <filename>de.po</filename>. Такође додајте тај код језика у <literal>LINGUAS</literal>. <filename>.po</filename> датотека садржи заглавље и списак енглеских ниски, са простором за унос преведених ниски. Обавезно поставите кодирање <filename>.po</filename> датотеке на <literal>UTF-8</literal>.

note: (itstool) path: section/programlisting
en: <code>"Content-Type: text/plain; charset=UTF-8\n"</code>
sr: <code>"Content-Type: text/plain; charset=UTF-8\
    "</code>

note: (itstool) path: note/para
en: It's possible that certain strings will be marked as <literal>fuzzy</literal> in the <filename>.po</filename> file. These translations will not substitute the original string. To make them appear, simply remove the <literal>fuzzy</literal> tag. A <literal>fuzzy</literal> tag appears if a string content changed, but the location is still the same.
sr: Могуће је да ће одређене ниске бити означене као „нејасне“ (<literal>fuzzy</literal>) у <filename>.po</filename> датотеци. Ови преводи неће заменити изворну ниску. Да би се они појавили, једноставно уклоните ознаку <literal>fuzzy</literal>. Ознака <literal>fuzzy</literal> се појављује ако је садржај ниске измењен, али је место остало исто.

note: (itstool) path: section/title
en: Resources
sr: Ресурси

note: (itstool) path: listitem/para
en: <link xlink:href="https://wiki.gnome.org/TranslationProject/DevGuidelines"> L10N Guidelines for Developers</link>
sr: <link xlink:href="https://wiki.gnome.org/TranslationProject/DevGuidelines"> Смернице за локализацију за програмере</link>

note: (itstool) path: listitem/para
en: <link xlink:href="http://bazaar.launchpad.net/~intltool/intltool/trunk/view/head:/README">Intltool README</link>
sr: <link xlink:href="http://bazaar.launchpad.net/~intltool/intltool/trunk/view/head:/README">Intltool ПРОЧИТАЈМЕ</link>

note: (itstool) path: listitem/para
en: <link xlink:href="https://wiki.gnome.org/TranslationProject/GitHowTo">How to use Git for GNOME translators</link>
sr: <link xlink:href="https://wiki.gnome.org/TranslationProject/GitHowTo">Како користити Гит за Гномове преводиоце</link>

note: (itstool) path: listitem/para
en: <link xlink:href="http://www.gnu.org/software/gettext/manual/gettext.html">gettext manual</link>
sr: <link xlink:href="http://www.gnu.org/software/gettext/manual/gettext.html">gettext упутство</link>

note: (itstool) path: section/para
en: More information about what lies behind the internationalization and localization process is presented and demonstrated in: <_:itemizedlist-1/>
sr: Више података о томе шта стоји иза процеса интернационализације и локализације представљено је и приказано у: <_:itemizedlist-1/>

note: (itstool) path: section/title
en: Expecting UTF8
sr: Очекује се UTF8

note: (itstool) path: section/para
en: A properly internationalized application will not make assumptions about the number of bytes in a character. That means that you shouldn't use pointer arithmetic to step through the characters in a string, and it means you shouldn't use <classname>std::string</classname> or standard C functions such as <function>strlen()</function> because they make the same assumption.
sr: Правилно интернационализована апликација неће доносити претпоставке о броју бајтова у знаку. То значи да не би требало да користите аритметику показивача за кретање кроз знакове у ниски, и значи да не би требало да користите <classname>std::string</classname> или стандардне C функције као што је <function>strlen()</function> јер оне доносе исту претпоставку.

note: (itstool) path: section/para
en: However, you probably already avoid bare char* arrays and pointer arithmetic by using <classname>std::string</classname>, so you just need to start using <classname>Glib::ustring</classname> instead. See the <link linkend="sec-basics-ustring">Basics</link> chapter about <classname>Glib::ustring</classname>.
sr: Међутим, вероватно већ избегавате чисте char* низове и аритметику показивача коришћењем <classname>std::string</classname>, па само треба да почнете да користите <classname>Glib::ustring</classname> уместо тога. Погледајте поглавље <link linkend="sec-basics-ustring">Основе</link> о <classname>Glib::ustring</classname>.

note: (itstool) path: section/title
en: Glib::ustring and std::iostreams
sr: Glib::ustring и std::iostreams

note: (itstool) path: section/para
en: Unfortunately, the integration with the standard iostreams is not completely foolproof. <application>gtkmm</application> converts <classname>Glib::ustring</classname>s to a locale-specific encoding (which usually is not UTF-8) if you output them to an <classname>ostream</classname> with <function>operator&lt;&lt;</function>. Likewise, retrieving <classname>Glib::ustring</classname>s from <classname>istream</classname> with <function>operator&gt;&gt;</function> causes a conversion in the opposite direction. But this scheme breaks down if you go through a <classname>std::string</classname>, e.g. by inputting text from a stream to a <classname>std::string</classname> and then implicitly converting it to a <classname>Glib::ustring</classname>. If the string contained non-ASCII characters and the current locale is not UTF-8 encoded, the result is a corrupted <classname>Glib::ustring</classname>. You can work around this with a manual conversion. For instance, to retrieve the <classname>std::string</classname> from a <classname>ostringstream</classname>:
sr: Нажалост, интеграција са стандардним iostreams није потпуно сигурна. <application>gtkmm</application> претвара <classname>Glib::ustring</classname>-ове у кодирање специфично за локал (које обично није UTF-8) ако их шаљете у <classname>ostream</classname> помоћу <function>operator&lt;&lt;</function>. Исто тако, преузимање <classname>Glib::ustring</classname>-ова из <classname>istream</classname> помоћу <function>operator&gt;&gt;</function> изазива конверзију у супротном смеру. Али ова шема пропада ако идете преко <classname>std::string</classname>, нпр. уносом текста из тока у <classname>std::string</classname> а затим имплицитним претварањем у <classname>Glib::ustring</classname>. Ако је ниска садржала не-ASCII знакове а тренутни локал није UTF-8 кодиран, резултат је оштећен <classname>Glib::ustring</classname>. Ово можете заобићи ручном конверзијом. На пример, за преузимање <classname>std::string</classname> из <classname>ostringstream</classname>:

note: (itstool) path: section/programlisting
en: <code>std::locale::global(std::locale("")); // Set the global locale to the user's preferred locale.
                                          // Usually unnecessary here, because Glib::init()
                                          // or Gtk::Application::create() does it for you.
    std::ostringstream output;
    output &lt;&lt; percentage &lt;&lt; " % done";
    label-&gt;set_text(Glib::locale_to_utf8(output.str()));</code>
sr: <code>std::locale::global(std::locale("")); // Поставите глобални локал на корисников жељени локал.
                                          // Обично непотребно овде, јер Glib::init()
                                          // или Gtk::Application::create() то раде за вас.
    std::ostringstream output;
    output &lt;&lt; percentage &lt;&lt; " % done";
    label-&gt;set_text(Glib::locale_to_utf8(output.str()));</code>

note: (itstool) path: section/title
en: Pitfalls
sr: Замке

note: (itstool) path: section/para
en: There are a few common mistakes that you would discover eventually yourself. But this section might help you to avoid them.
sr: Постоји неколико уобичајених грешака које бисте на крају и сами открили. Али овај одељак би вам могао помоћи да их избегнете.

note: (itstool) path: section/title
en: Same strings, different semantics
sr: Исте ниске, различита семантика

note: (itstool) path: section/para
en: Sometimes two English strings are identical but have different meanings in different contexts, so they would probably not be identical when translated. Since the English strings are used as look-up keys, this causes problems.
sr: Понекад су две енглеске ниске идентичне али имају различита значења у различитим контекстима, па вероватно не би биле идентичне када се преведу. Пошто се енглеске ниске користе као кључеви за претрагу, ово изазива проблеме.

note: (itstool) path: section/para
en: In these cases, you should add extra characters to the strings. For instance, use <literal>"jumps[noun]"</literal> and <literal>"jumps[verb]"</literal> instead of just <literal>"jumps"</literal> and strip them again outside the <function>gettext</function> call. If you add extra characters you should also add a comment for the translators before the <function>gettext</function> call. Such comments will be shown in the <filename>.po</filename> files. For instance:
sr: У овим случајевима, требало би да додате додатне знакове у ниске. На пример, користите <literal>"jumps[noun]"</literal> и <literal>"jumps[verb]"</literal> уместо само <literal>"jumps"</literal> и поново их одсеците изван позива <function>gettext</function>. Ако додате додатне знакове, требало би да додате и коментар за преводиоце пре позива <function>gettext</function>. Такви коментари ће бити приказани у <filename>.po</filename> датотекама. На пример:

note: (itstool) path: section/programlisting
en: <code>// note to translators: don't translate the "[noun]" part - it is
    // just here to distinguish the string from another "jumps" string
    text = strip(gettext("jumps[noun]"), "[noun]");</code>
sr: <code>// напомена за преводиоце: не преводите део „[noun]“ — он је
    // овде само да би се ниска разликовала од друге ниске „jumps“
    text = strip(gettext("jumps[noun]"), "[noun]");</code>

note: (itstool) path: section/para
en: If you use <application>Glib</application>'s support macros, it's easier. Use <function>C_()</function> instead of <function>_()</function>. For instance:
sr: Ако користите <application>Glib</application>-ове макрое подршке, лакше је. Користите <function>C_()</function> уместо <function>_()</function>. На пример:

note: (itstool) path: section/title
en: Composition of strings
sr: Састављање ниски

note: (itstool) path: section/para
en: C programmers use <function>sprintf()</function> to compose and concatenate strings. <phrase role="nowrap">C++</phrase> favors streams, but unfortunately, this approach makes translation difficult, because each fragment of text is translated separately, without allowing the translators to rearrange them according to the grammar of the language.
sr: C програмери користе <function>sprintf()</function> за састављање и спајање ниски. <phrase role="nowrap">C++</phrase> преферира токове (streams), али нажалост, овај приступ отежава превођење, јер се сваки одломак текста преводи засебно, без омогућавања преводиоцима да их преуреде у складу са граматиком језика.

note: (itstool) path: section/para
en: For instance, this code would be problematic:
sr: На пример, овај код би био проблематичан:

note: (itstool) path: section/para
en: So you should either avoid this situation or use <link xlink:href="https://gnome.pages.gitlab.gnome.org/glibmm/classGlib_1_1ustring.html"><function>Glib::ustring::compose()</function></link> which supports syntax such as:
sr: Зато би требало или да избегавате ову ситуацију или да користите <link xlink:href="https://gnome.pages.gitlab.gnome.org/glibmm/classGlib_1_1ustring.html"><function>Glib::ustring::compose()</function></link> који подржава синтаксу као што је:

note: (itstool) path: section/title
en: Assuming the displayed size of strings
sr: Претпостављање приказане величине ниски

note: (itstool) path: section/para
en: You never know how much space a string will take on screen when translated. It might very possibly be twice the size of the original English string. Luckily, most <application>gtkmm</application> widgets will expand at runtime to the required size.
sr: Никада не знате колико ће простора ниска заузети на екрану када се преведе. Врло је могуће да ће бити двоструко већа од изворне ниске на енглеском језику. Срећом, већина <application>gtkmm</application> елемената ће се раширити приликом извршавања на потребну величину.

note: (itstool) path: section/title
en: Unusual words
sr: Необичне речи

note: (itstool) path: section/para
en: You should avoid cryptic abbreviations, slang, or jargon. They are usually difficult to translate, and are often difficult for even native speakers to understand.
sr: Требало би да избегавате криптичне скраћенице, жаргон или сленг. Они су обично тешки за превођење, а често су тешки за разумевање чак и изворним говорницима.

note: (itstool) path: section/title
en: Using non-ASCII characters in strings
sr: Коришћење не-АСКИ знакова у нискама

note: (itstool) path: section/para
en: Currently, <application>gettext</application> does not support non-ASCII characters (i.e. any characters with a code above 127) in source code. For instance, you cannot use the copyright sign (©).
sr: Тренутно, <application>gettext</application> не подржава не-АСКИ знакове (тј. било које знакове са кодом изнад 127) у изворном коду. На пример, не можете користити знак ауторских права (©).

note: (itstool) path: section/para
en: To work around this, you could write a comment in the source code just before the string, telling the translators to use the special character if it is available in their languages. For English, you could then make an American English <filename>en_US.po</filename> translation which used that special character.
sr: Да бисте ово заобишли, могли бисте да напишете коментар у изворном коду непосредно пре ниске, говорећи преводиоцима да користе посебан знак ако је доступан у њиховим језицима. За енглески, тада бисте могли да направите превод за амерички енглески <filename>en_US.po</filename> који користи тај посебан знак.

note: (itstool) path: section/title
en: Getting help with translations
sr: Добијање помоћи око превода

note: (itstool) path: section/para
en: If your program is free software, there is a whole <literal>GNOME</literal> subproject devoted to helping you make translations, the <link xlink:href="https://wiki.gnome.org/TranslationProject/"><literal>GNOME</literal> Translation Project</link>.
sr: Ако је ваш програм слободан софтвер, постоји читав <literal>GNOME</literal> потпројекат посвећен помагању у изради превода, <link xlink:href="https://wiki.gnome.org/TranslationProject/"><literal>GNOME</literal> пројекат превођења</link>.

note: (itstool) path: section/para
en: The way it works is that you upload your source code to a git repository where translators can access it, then file an <link xlink:href="https://gitlab.gnome.org/Infrastructure/damned-lies/-/issues"> issue to the damned-lies project</link> and ask to have your program added to the <link xlink:href="http://l10n.gnome.org/module/">list of modules to translate</link>.
sr: Начин на који то функционише је да отпремите свој изворни код у гит ризницу којој преводиоци могу приступити, а затим поднесете <link xlink:href="https://gitlab.gnome.org/Infrastructure/damned-lies/-/issues">извештај о проблему пројекту damned-lies</link> и затражите да ваш програм буде додат на <link xlink:href="http://l10n.gnome.org/module/">списак модула за превођење</link>.

note: (itstool) path: section/para
en: Then you make sure you update the file <filename>POTFILES.in</filename> in the <filename>po/</filename> subdirectory (<command>intltool-update -m</command> can help with this) so that the translators always access updated <filename>myprogram.pot</filename> files, and simply freeze the strings at least a couple of days before you make a new release. Depending on the number of strings your program contains and how popular it is, the translations will then start to tick in as <filename>.po</filename> files.
sr: Затим се побрините да ажурирате датотеку <filename>POTFILES.in</filename> у <filename>po/</filename> поддиректоријуму (<command>intltool-update -m</command> може помоћи у томе) тако да преводиоци увек приступају ажурираним <filename>myprogram.pot</filename> датотекама, и једноставно замрзните ниске најмање неколико дана пре него што објавите ново издање. У зависности од броја ниски које ваш програм садржи и колико је популаран, преводи ће почети да пристижу као <filename>.po</filename> датотеке.

note: (itstool) path: section/para
en: Note that most language teams only consist of 1-3 persons, so if your program contains a lot of strings, it might last a while before anyone has the time to look at it. Also, most translators do not want to waste their time (translating is a very time-consuming task) so if they do not assess your project as being really serious (in the sense that it is polished and being maintained) they may decide to spend their time on some other project.
sr: Имајте на уму да већина језичких тимова броји само 1-3 особе, па ако ваш програм садржи много ниски, може проћи неко време пре него што ико буде имао времена да га погледа. Такође, већина преводилаца не жели да губи своје време (превођење је веома захтеван задатак), па ако не оцене ваш пројекат као заиста озбиљан (у смислу да је углађен и да се одржава), могу одлучити да своје време потроше на неки други пројекат.

note: (itstool) path: section/para
en: Here is a simple example with translatable strings in <phrase role="nowrap">C++</phrase> code. It shows what you can do if you don't use autotools or <application>meson</application>. It is also an example of using the <classname>Gtk::TextView</classname> widget.
sr: Ево једноставног примера са преводивим нискама у <phrase role="nowrap">C++</phrase> коду. Он показује шта можете да урадите ако не користите autotools или <application>meson</application>. То је такође пример коришћења <classname>Gtk::TextView</classname> елемента.

note: (itstool) path: section/para
en: This program can set the locale, if it's specified in a configuration file. This is not normal behavior. Most programs accept the locale that the user has selected, for instance with an environment variable.
sr: Овај програм може да подеси локалитет, ако је наведен у датотеци подешавања. Ово није нормално понашање. Већина програма прихвата локалитет који је корисник одабрао, на пример помоћу променљиве окружења.

note: (itstool) path: figure/title
en: Translatable Strings
sr: Преводиве ниске

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/i18n">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/i18n">Изворни код</link>

note: (itstool) path: chapter/title (itstool) path: section/title
en: Custom Widgets
sr: Произвољни елементи

note: (itstool) path: chapter/para
en: <application>gtkmm</application> makes it very easy to derive new widgets by inheriting from an existing widget class, either by deriving from a container and adding child widgets, or by deriving from a single-item widget, and changing its behavior. But you might occasionally find that no suitable starting point already exists. In this case, you can implement a widget from scratch.
sr: <application>gtkmm</application> омогућава веома лако извођење нових елемената наслеђивањем из постојеће класе елемента, било извођењем из контејнера и додавањем садржаних елемената, или извођењем из појединачног елемента и променом његовог понашања. Али повремено можете открити да већ не постоји одговарајућа почетна тачка. У овом случају, можете имплементирати елемент испочетка.

note: (itstool) path: section/title
en: Custom Containers
sr: Произвољни контејнери

note: (itstool) path: listitem/para
en: <methodname>get_request_mode_vfunc()</methodname>: Return what <literal>Gtk::SizeRequestMode</literal> is preferred by the container.
sr: <methodname>get_request_mode_vfunc()</methodname>: Враћа који <literal>Gtk::SizeRequestMode</literal> контејнер преферира.

note: (itstool) path: listitem/para
en: <methodname>measure_vfunc()</methodname>: Calculate the minimum and natural width or height of the container.
sr: <methodname>measure_vfunc()</methodname>: Израчунава минималну и природну ширину или висину контејнера.

note: (itstool) path: listitem/para
en: <methodname>size_allocate_vfunc()</methodname>: Position the child widgets, given the height and width that the container has actually been given.
sr: <methodname>size_allocate_vfunc()</methodname>: Поставља садржане елементе, на основу висине и ширине које је контејнер заправо добио.

note: (itstool) path: section/para
en: When deriving a custom container widget directly from <classname>Gtk::Widget</classname>, you should override the following virtual methods: <_:itemizedlist-1/>
sr: Приликом извођења произвољног елемента контејнера директно из <classname>Gtk::Widget</classname>, требало би да преклопите следеће виртуелне методе: <_:itemizedlist-1/>

note: (itstool) path: section/para
en: The <methodname>get_request_mode_vfunc()</methodname>, <methodname>measure_vfunc()</methodname>, and <methodname>size_allocate_vfunc()</methodname> virtual methods control the layout of the child widgets. For instance, if your container has 2 child widgets, with one below the other, your <methodname>get_request_mode_vfunc()</methodname> might request height-for-width layout. Then your <methodname>measure_vfunc()</methodname> might report the maximum of the widths of the child widgets when asked to report width, and it might report the sum of their heights when asked to report height. If you want padding between the child widgets then you would add that to the width and height too. Your widget's container will use this result to ensure that your widget gets enough space, and not less. By examining each widget's parent, and its parent, this logic will eventually decide the size of the top-level window.
sr: Виртуелне методе <methodname>get_request_mode_vfunc()</methodname>, <methodname>measure_vfunc()</methodname> и <methodname>size_allocate_vfunc()</methodname> контролишу распоред садржаних елемената. На пример, ако ваш контејнер има 2 садржана елемента, један испод другог, ваш <methodname>get_request_mode_vfunc()</methodname> може захтевати распоред висине за ширину. Затим ваш <methodname>measure_vfunc()</methodname> може пријавити максимум ширина садржаних елемената када се тражи ширина, а може пријавити збир њихових висина када се тражи висина. Ако желите размак између садржаних елемената, онда бисте то такође додали ширини и висини. Контејнер вашег елемента ће користити овај резултат како би осигурао да ваш елемент добије довољно простора, а не мање. Испитивањем родитеља сваког елемента, и његовог родитеља, ова логика ће на крају одлучити о величини прозора највишег нивоа.

note: (itstool) path: section/para
en: You are not guaranteed to get the <literal>Gtk::SizeRequestMode</literal> that you request. Therefore <methodname>measure_vfunc()</methodname> must return sensible values for all reasonable values of its input parameters. For a description of <methodname>measure_vfunc()</methodname>'s parameters see also the description of <methodname>Gtk::Widget::measure()</methodname>, which may be better documented than <methodname>measure_vfunc()</methodname>.
sr: Није вам загарантовано да ћете добити <literal>Gtk::SizeRequestMode</literal> који захтевате. Стога <methodname>measure_vfunc()</methodname> мора вратити разумне вредности за све прихватљиве вредности својих улазних параметара. За опис параметара методе <methodname>measure_vfunc()</methodname> погледајте такође опис методе <methodname>Gtk::Widget::measure()</methodname>, која може бити боље документована од <methodname>measure_vfunc()</methodname>.

note: (itstool) path: section/para
en: <methodname>size_allocate_vfunc()</methodname> receives the actual height and width that the parent container has decided to give to your widget. This might be more than the minimum, or even more than the natural size, for instance if the top-level window has been expanded. You might choose to ignore the extra space and leave a blank area, or you might choose to expand your child widgets to fill the space, or you might choose to expand the padding between your widgets. It's your container, so you decide.
sr: <methodname>size_allocate_vfunc()</methodname> прима стварну висину и ширину коју је родитељски контејнер одлучио да додели вашем елементу. Ово може бити више од минимума, или чак више од природне величине, на пример ако је прозор највишег нивоа проширен. Можете изабрати да игноришете вишак простора и оставите празну област, или можете изабрати да проширите своје садржане елементе како би попунили простор, или можете изабрати да проширите размак између својих елемената. То је ваш контејнер, па ви одлучујете.

note: (itstool) path: section/para
en: Your container must unparent its children before the underlying C object (a <classname>gtkmm__GtkWidget</classname>) is finalized. If your container is used as a managed widget, it shall unparent its children in a <methodname>Gtk::Widget::signal_destroy()</methodname> handler (available since <application>gtkmm</application> 4.8). If your container is not managed, that signal handler is not called. Instead the children shall be unparented in the <phrase role="nowrap">C++</phrase> destructor. If you want your container to be useful both ways, unparent the children both in the destructor and in a signal handler. See the example code.
sr: Ваш контејнер мора уклонити родитељство својим потомцима пре него што се основни C објекат ( <classname>gtkmm__GtkWidget</classname>) финализује. Ако се ваш контејнер користи као управљани елемент, он ће уклонити родитељство својим потомцима у руковаоцу <methodname>Gtk::Widget::signal_destroy()</methodname> (доступно од верзије <application>gtkmm</application> 4.8). Ако ваш контејнер није управљан, тај руковалац сигнала се не позива. Уместо тога, родитељство потомака ће бити уклоњено у <phrase role="nowrap">C++</phrase> деструктору. Ако желите да ваш контејнер буде користан на оба начина, уклоните родитељство потомцима и у деструктору и у руковаоцу сигнала. Погледајте код примера.

note: (itstool) path: section/para
en: This example implements a container with child widgets, one above the other. Of course, in this case it would be far simpler just to use a vertical <classname>Gtk::Box</classname> or <classname>Gtk::Grid</classname>.
sr: Овај пример имплементира контејнер са садржаним елементима, један изнад другог. Наравно, у овом случају би било далеко једноставније само користити усправни <classname>Gtk::Box</classname> или <classname>Gtk::Grid</classname>.

note: (itstool) path: figure/title
en: Custom Container
sr: Произвољни контејнер

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/custom/custom_container/">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/custom/custom_container/">Изворни код</link>

note: (itstool) path: section/para
en: By deriving directly from <classname>Gtk::Widget</classname> you can do all the drawing for your widget directly, instead of just arranging child widgets. For instance, a <classname>Gtk::Label</classname> draws the text of the label, but does not do this by using other widgets.
sr: Извођењем директно из <classname>Gtk::Widget</classname> можете директно обавити сво цртање за свој елемент, уместо да само распоређујете садржане елементе. На пример, <classname>Gtk::Label</classname> црта текст натписа, али то не чини коришћењем других елемената.

note: (itstool) path: listitem/para
en: <methodname>get_request_mode_vfunc()</methodname>: (optional) Return what <literal>Gtk::SizeRequestMode</literal> is preferred by the widget.
sr: <methodname>get_request_mode_vfunc()</methodname>: (опционо) Враћа који <literal>Gtk::SizeRequestMode</literal> елемент преферира.

note: (itstool) path: listitem/para
en: <methodname>measure_vfunc()</methodname>: Calculate the minimum and natural width or height of the widget.
sr: <methodname>measure_vfunc()</methodname>: Израчунава минималну и природну ширину или висину елемента.

note: (itstool) path: listitem/para
en: <methodname>size_allocate_vfunc()</methodname>: (optional) Position the widget, given the height and width that it has actually been given.
sr: <methodname>size_allocate_vfunc()</methodname>: (опционо) Поставља елемент, на основу висине и ширине које је заправо добио.

note: (itstool) path: listitem/para
en: <methodname>on_realize()</methodname>: (optional)
sr: <methodname>on_realize()</methodname>: (опционо)

note: (itstool) path: listitem/para
en: <methodname>on_unrealize()</methodname>: (optional)
sr: <methodname>on_unrealize()</methodname>: (опционо)

note: (itstool) path: listitem/para
en: <methodname>on_map()</methodname>: (optional)
sr: <methodname>on_map()</methodname>: (опционо)

note: (itstool) path: listitem/para
en: <methodname>on_unmap()</methodname>: (optional)
sr: <methodname>on_unmap()</methodname>: (опционо)

note: (itstool) path: listitem/para
en: <methodname>snapshot_vfunc()</methodname>: Create a render node, e.g. a <classname>Cairo::Context</classname> node, and draw on it.
sr: <methodname>snapshot_vfunc()</methodname>: Направите чвор исцртавања, нпр. чвор <classname>Cairo::Context</classname>, и цртајте на њему.

note: (itstool) path: section/para
en: When deriving from <classname>Gtk::Widget</classname>, you should override the following virtual methods. The methods marked (optional) need not be overridden in all custom widgets. The base class's methods may be appropriate. <_:itemizedlist-1/>
sr: Када изводите из <classname>Gtk::Widget</classname>, требало би да преклопите следеће виртуелне методе. Методе означене са (опционо) не морају бити преклопљене у свим произвољним елементима. Методе основне класе могу бити одговарајуће. <_:itemizedlist-1/>

note: (itstool) path: section/para
en: The first 3 methods in the previous table are also overridden in custom containers. They are briefly described in the <link linkend="sec-custom-containers">Custom Containers</link> section.
sr: Прве 3 методе у претходној табели су такође преклопљене у произвољним контејнерима. Оне су укратко описане у одељку <link linkend="sec-custom-containers">Произвољни контејнери</link>.

note: (itstool) path: section/title
en: Class Init and Instance Init Functions
sr: Функције за покретање класе и покретање примерка

note: (itstool) path: section/para
en: Some <application>GTK</application> functions, if called at all, must be called from the class init function. Some other <application>GTK</application> functions, if called, must be called from the instance init function. If your custom widget must call any of those functions, you can derive a class from <classname>Glib::ExtraClassInit</classname> and derive your custom class from that class. The <link linkend="custom-css-name-example">custom CSS name example</link> shows how that's done.
sr: Неке <application>GTK</application> функције, ако се уопште позивају, морају бити позване из функције за покретање класе. Неке друге <application>GTK</application> функције, ако се позивају, морају бити позване из функције за покретање примерка. Ако ваш произвољни елемент мора да позове било коју од тих функција, можете извести класу из <classname>Glib::ExtraClassInit</classname> и извести вашу произвољну класу из те класе. Пример <link linkend="custom-css-name-example">назива произвољног CSS-а</link> показује како се то ради.

note: (itstool) path: section/para
en: This example implements a widget which draws Penrose triangles.
sr: Овај пример имплементира елемент који црта Пенроузове троуглове.

note: (itstool) path: figure/title
en: Custom Widget
sr: Произвољни елемент

[ctx: _]
note: (itstool) path: imageobject/imagedata This is a reference to an external file such as an image or video. When the file changes, the md5 hash will change to let you know you need to update your localized copy. The msgstr is not used at all. Set it to whatever you like once you have updated your copy 
en: external ref='figures/custom_widget.png' md5='30f9b406a95d5b0d17b6fc081c359b98'
sr: _:external ref='figures/custom_widget.png' md5='30f9b406a95d5b0d17b6fc081c359b98'

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/custom/custom_widget/">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/custom/custom_widget/">Изворни ко̂д</link>

note: (itstool) path: section/title
en: Custom CSS Names
sr: Називи произвољног CSS-а

note: (itstool) path: section/para
en: Many aspects of the look of widgets are controlled by CSS (Cascading Style Sheet) files. With CSS files you can choose color, font, line thickness, etc. If you give some widgets their own names or their own CSS classes, you can define CSS rules that apply only to those widgets, for instance certain buttons, without affecting other similar widgets.
sr: Многи аспекти изгледа елемената су контролисани CSS (Cascading Style Sheet) датотекама. Помоћу CSS датотека можете бирати боју, фонт, дебљину линије, итд. Ако неким елементима дате сопствена имена или сопствене CSS класе, можете дефинисати CSS правила која се примењују само на те елементе, на пример одређену дугмад, без утицаја на друге сличне елементе.

note: (itstool) path: section/title
en: CSS Node Name, Widget Name, CSS Class Name
sr: Назив CSS чвора, назив елемента, назив CSS класе

note: (itstool) path: listitem/para
en: <methodname>gtk_widget_class_set_css_name()</methodname> can only be called from the class init function. It sets the CSS node name of all instances of a class (a GType). See the <link linkend="custom-init-functions"> Class Init and Instance Init Functions</link> section.
sr: <methodname>gtk_widget_class_set_css_name()</methodname> се може позвати само из функције за покретање класе. Поставља назив CSS чвора за све примерке класе (GType). Погледајте одељак <link linkend="custom-init-functions">Функције за покретање класе и покретање примерка</link>.

note: (itstool) path: listitem/para
en: <methodname>Gtk::Widget::set_name()</methodname> can be called from a <phrase role="nowrap">C++</phrase> constructor. It sets the name of a widget instance.
sr: <methodname>Gtk::Widget::set_name()</methodname> се може позвати из <phrase role="nowrap">C++</phrase> конструктора. Поставља назив примерка елемента.

note: (itstool) path: listitem/para
en: <methodname>Gtk::Widget::add_class_name()</methodname> can be called from a <phrase role="nowrap">C++</phrase> constructor. It adds the name of a CSS class, used by a widget instance.
sr: <methodname>Gtk::Widget::add_class_name()</methodname> се може позвати из <phrase role="nowrap">C++</phrase> constructor. Додаје назив CSS класе коју користи примерак елемента.

note: (itstool) path: section/para
en: There are three ways of referring from a widget to data in a CSS file: <_:itemizedlist-1/> The following example shows a button with its own CSS node name, a label with a widget name and a label that uses its own CSS class.
sr: Постоје три начина упућивања из елемента на податке у CSS датотеци: <_:itemizedlist-1/> Следећи пример приказује дугме са сопственим називом CSS чвора, натпис са називом елемента и натпис који користи сопствену CSS класу.

note: (itstool) path: section/title
en: Custom Style Information
sr: Подаци о произвољном стилу

note: (itstool) path: section/para
en: To add a style sheet to an application, use one of the <methodname>Gtk::CssProvider::load_from_*()</methodname> methods. Then add it with <methodname>Gtk::StyleProvider::add_provider_for_display()</methodname> (available since <application>gtkmm</application> 4.10) or <methodname>Gtk::StyleContext::add_provider_for_display()</methodname>. <classname>Gtk::StyleContext</classname> also contains methods to read some style information, but this class is deprecated since <application>gtkmm</application> 4.10.
sr: Да бисте додали стилски лист апликацији, користите једну од <methodname>Gtk::CssProvider::load_from_*()</methodname> метода. Затим га додајте помоћу <methodname>Gtk::StyleProvider::add_provider_for_display()</methodname> (доступно од <application>gtkmm</application> 4.10) или <methodname>Gtk::StyleContext::add_provider_for_display()</methodname>. <classname>Gtk::StyleContext</classname> такође садржи методе за читање неких података о стилу, али је ова класа застарела од <application>gtkmm</application> 4.10.

note: (itstool) path: section/para
en: CSS files are described in the documentation of GTK.
sr: CSS датотеке су описане у документацији за GTK.

note: (itstool) path: section/para
en: This example implements a button and two labels with custom style information.
sr: Овај пример спроводи дугме и два натписа са произвољним подацима о стилу.

note: (itstool) path: figure/title
en: Custom CSS Name
sr: Произвољни ЦСС назив

[ctx: _]
note: (itstool) path: imageobject/imagedata This is a reference to an external file such as an image or video. When the file changes, the md5 hash will change to let you know you need to update your localized copy. The msgstr is not used at all. Set it to whatever you like once you have updated your copy 
en: external ref='figures/custom_css_name.png' md5='fb3d968b1fd40eb219e5a78946adff0f'
sr: _:external ref='figures/custom_css_name.png' md5='fb3d968b1fd40eb219e5a78946adff0f'

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/custom/custom_css_name/">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/custom/custom_css_name/">Изворни ко̂д</link>

note: (itstool) path: chapter/title
en: Multi-threaded programs
sr: Вишенитни програми

note: (itstool) path: section/title
en: The constraints
sr: Ограничења

note: (itstool) path: footnote/para
en: These interactions arise from the fact that, amongst other things, a class inheriting from <classname>sigc::trackable</classname> will, via that inheritance, have a <classname>std::list</classname> object keeping track of slots created by calls to <function>sigc::mem_fun()</function> representing any of its non-static methods (more particularly it keeps a list of callbacks which will null the connected slots on its destruction). Each <classname>sigc::slot</classname> object also keeps, via <classname>sigc::slot_rep</classname>, its own <classname>sigc::trackable</classname> object to track any <classname>sigc::connection</classname> objects which it needs to inform about its demise, and also has a function to deregister itself from any <classname>sigc::trackable</classname> on disconnection or destruction. <classname>sigc::signal</classname> objects also keep lists of slots, which will be updated by a call to their <methodname>connect()</methodname> method or calls to any <classname>sigc::connection</classname> object relating to such a connection.
sr: Ове интеракције произилазе из чињенице да ће, између осталог, класа која наслеђује из <classname>sigc::trackable</classname>, путем тог наслеђивања, имати <classname>std::list</classname> објекат који прати места направљена позивима функције <function>sigc::mem_fun()</function> која представља било који од њених нестатичких метода (тачније, чува списак повратних позива који ће поништити повезана места при њеном уништавању). Сваки <classname>sigc::slot</classname> објекат такође чува, путем <classname>sigc::slot_rep</classname>, сопствени <classname>sigc::trackable</classname> објекат како би пратио било које <classname>sigc::connection</classname> објекте о чијем престанку треба да обавести, а такође има и функцију за сопствено одјављивање из било ког <classname>sigc::trackable</classname> објекта при прекиду везе или уништавању. <classname>sigc::signal</classname> објекти такође чувају спискове места, који ће бити ажурирани позивом њивог <methodname>connect()</methodname> метода или позивима било ког <classname>sigc::connection</classname> објекта који се односи на такву везу.

note: (itstool) path: section/para
en: Care is required when writing programs based on <application>gtkmm</application> using multiple threads of execution, arising from the fact that <application>libsigc++</application>, and in particular <classname>sigc::trackable</classname>, are not thread-safe. That's because none of the complex interactions that occur behind the scenes when using <application>libsigc++</application> are protected by a mutex or other means of synchronization. <_:footnote-1/>
sr: Потребна је пажња при писању програма заснованих на <application>gtkmm</application>-у који користе више нити извршавања, што произилази из чињенице да <application>libsigc++</application>, а посебно <classname>sigc::trackable</classname>, нису безбедни по питању нити. То је зато што ниједна од сложених интеракција које се дешавају иза сцене при коришћењу <application>libsigc++</application>-а није заштићена мутексом или другим средствима усаглашавања. <_:footnote-1/>

note: (itstool) path: section/title
en: The rules
sr: Правила

note: (itstool) path: section/para
en: This requires a number of rules to be observed when writing multi-threaded programs using <application>gtkmm</application>. These are set out below, but one point to note is that extra care is required when deriving classes from <classname>sigc::trackable</classname>, because the effects are unintuitive (see particularly points 4 and 5 below).
sr: Ово захтева поштовање одређеног броја правила при писању вишенитних програма коришћењем <application>gtkmm</application>-а. Она су наведена испод, али треба напоменути да је посебна пажња потребна при извођењу класа из <classname>sigc::trackable</classname>, јер су ефекти неинтуитивни (погледајте нарочито тачке 4 и 5 испод).

note: (itstool) path: listitem/para
en: Use <classname>Glib::Dispatcher</classname> to invoke <application>gtkmm</application> functions from worker threads (this is dealt with in more detail in the next section).
sr: Користите <classname>Glib::Dispatcher</classname> за призивање <application>gtkmm</application> функција из радних нити (ово је детаљније обрађено у следећем одељку).

note: (itstool) path: listitem/para
en: A <classname>sigc::signal</classname> object should be regarded as owned by the thread which created it. Only that thread should connect a <classname>sigc::slot</classname> object to the signal object, and only that thread should <methodname>emit()</methodname> or call <methodname>operator()()</methodname> on the signal, or null any connected <classname>sigc::slot</classname> object. It follows (amongst other things) that any signal object provided by a <application>gtkmm</application> widget should only be operated on in the main GUI thread and any object deriving from <classname>sigc::trackable</classname> having its non-static methods referenced by slots connected to the signal object should only be destroyed in that thread.
sr: <classname>sigc::signal</classname> објекат треба сматрати власништвом нити која га је направила. Само та нит треба да повезује <classname>sigc::slot</classname> објекат са објектом сигнала, и само та нит треба да емитује (<methodname>emit()</methodname>) или позива <methodname>operator()()</methodname> над сигналом, или да поништава било који повезани <classname>sigc::slot</classname> објекат. Из тога следи (између осталог) да било који објекат сигнала који обезбеђује <application>gtkmm</application> елемент треба користити само у главној ГУИ нити, а било који објекат изведен из <classname>sigc::trackable</classname> чији су нестатички методи наведени местима повезаним са објектом сигнала треба уништавати само у тој нити.

note: (itstool) path: listitem/para
en: Any <classname>sigc::connection</classname> object should be regarded as owned by the thread in which the method returning the <classname>sigc::connection</classname> object was called. Only that thread should call <classname>sigc::connection</classname> methods on the object.
sr: Било који <classname>sigc::connection</classname> објекат треба сматрати власништвом нити у којој је позван метод који враћа <classname>sigc::connection</classname> објекат. Само та нит треба да позива <classname>sigc::connection</classname> методе над тим објектом.

note: (itstool) path: listitem/para
en: A <classname>sigc::slot</classname> object created by a call to <function>sigc::mem_fun()</function> which references a method of a class deriving from <classname>sigc::trackable</classname> should never be copied to another thread, nor destroyed by a different thread than the one which created it.
sr: <classname>sigc::slot</classname> објекат направљен позивом функције <function>sigc::mem_fun()</function> који упућује на метод класе изведене из <classname>sigc::trackable</classname> никада не би требало умножавати у другу нит, нити би га смела уништити нит различита од оне која га је направила.

note: (itstool) path: listitem/para
en: If a particular class object derives from <classname>sigc::trackable</classname>, only one thread should create <classname>sigc::slot</classname> objects representing any of the class's non-static methods by calling <function>sigc::mem_fun()</function>. The first thread to create such a slot should be regarded as owning the relevant object for the purpose of creating further slots referencing <emphasis>any</emphasis> of its non-static methods using that function, or nulling those slots by disconnecting them or destroying the trackable object.
sr: Ако одређени објекат класе потиче из <classname>sigc::trackable</classname>, само једна нит треба да прави <classname>sigc::slot</classname> објекте који представљају било који од нестатичких метода класе позивањем функције <function>sigc::mem_fun()</function>. Прву нит која направи такво место треба сматрати власником релевантног објекта у сврху прављења даљих места која упућују на <emphasis>било који</emphasis> од његових нестатичких метода коришћењем те функције, или поништавања тих места прекидањем њихове везе или уништавањем пративог објекта.

note: (itstool) path: listitem/para
en: Although <application>glib</application> is itself thread-safe, any <application>glibmm</application> wrappers which use <application>libsigc++</application> will not be. So for example, only the thread in which a main loop runs should call <methodname>Glib::SignalIdle::connect()</methodname>, <methodname>Glib::SignalIO::connect()</methodname>, <methodname>Glib::SignalTimeout::connect()</methodname>, <methodname>Glib::SignalTimeout::connect_seconds</methodname> for that main loop, or manipulate any <classname>sigc::connection</classname> object returned by them.
sr: Иако је сам <application>glib</application> безбедан по питању нити, било који <application>glibmm</application> омотачи који користе <application>libsigc++</application> то неће бити. Тако на пример, само нит у којој се извршава главна петља треба да позива <methodname>Glib::SignalIdle::connect()</methodname>, <methodname>Glib::SignalIO::connect()</methodname>, <methodname>Glib::SignalTimeout::connect()</methodname>, <methodname>Glib::SignalTimeout::connect_seconds</methodname> за ту главну петљу, или да управља било којим <classname>sigc::connection</classname> објектом који они врате.

note: (itstool) path: listitem/para
en: The connect*_once() variants, <methodname>Glib::SignalIdle::connect_once()</methodname>, <methodname>Glib::SignalTimeout::connect_once()</methodname>, <methodname>Glib::SignalTimeout::connect_seconds_once()</methodname>, are thread-safe for any case where the slot is not created by a call to <function>sigc::mem_fun()</function> which represents a method of a class deriving from <classname>sigc::trackable</classname>.
sr: Varijante connect*_once(), <methodname>Glib::SignalIdle::connect_once()</methodname>, <methodname>Glib::SignalTimeout::connect_once()</methodname>, <methodname>Glib::SignalTimeout::connect_seconds_once()</methodname>, безбедне су по питању нити у сваком случају где место није направљено позивом функције <function>sigc::mem_fun()</function> која представља метод класе изведене из <classname>sigc::trackable</classname>.

note: (itstool) path: section/title
en: Using Glib::Dispatcher
sr: Коришћење Glib::Dispatcher-а

note: (itstool) path: section/para
en: The slots connected to <classname>sigc::signal</classname> objects execute in the thread which calls <methodname>emit()</methodname> or <methodname>operator()()</methodname> on the signal. <classname>Glib::Dispatcher</classname> does not behave this way: instead its connected slots execute in the thread in which the <classname>Glib::Dispatcher</classname> object was constructed (which must have a glib main loop). If a <classname>Glib::Dispatcher</classname> object is constructed in the main GUI thread (which will therefore be the receiver thread), any worker thread can emit on it and have the connected slots safely execute <application>gtkmm</application> functions.
sr: Места повезана са <classname>sigc::signal</classname> објектима извршавају се у нити која позива <methodname>emit()</methodname> или <methodname>operator()()</methodname> над сигналом. <classname>Glib::Dispatcher</classname> се не понаша на овај начин: уместо тога, његова повезана места се извршавају у нити у којој је <classname>Glib::Dispatcher</classname> објекат изграђен (која мора имати glib главну петљу). Ако је <classname>Glib::Dispatcher</classname> објекат изграђен у главној ГУИ нити (која ће стога бити пријемна нит), било која радна нит може емитовати над њим и учинити да повезана места безбедно извршавају <application>gtkmm</application> функције.

note: (itstool) path: section/para
en: Some thread safety rules on the use of <classname>Glib::Dispatcher</classname> still apply. As mentioned, a <classname>Glib::Dispatcher</classname> object must be constructed in the receiver thread (the thread in whose main loop it will execute its connected slots). By default this is the main program thread, although there is a <classname>Glib::Dispatcher</classname> constructor which can take the <classname>Glib::MainContext</classname> object of any thread which has a main loop. Only the receiver thread should call <methodname>connect()</methodname> on the <classname>Glib::Dispatcher</classname> object, or manipulate any related <classname>sigc::connection</classname> object, unless additional synchronization is employed. However, any worker thread can safely emit on the <classname>Glib::Dispatcher</classname> object without any locking once the receiver thread has connected the slots, provided that it is constructed before the worker thread is started (if it is constructed after the thread has started, additional synchronization will normally be required to ensure visibility).
sr: Нека правила о безбедности нити при коришћењу <classname>Glib::Dispatcher</classname>-а и даље важе. Као што је поменуто, <classname>Glib::Dispatcher</classname> објекат мора бити изграђен у пријемној нити (нити у чијој главној петљи ће извршавати своја повезана места). По подразумеваним подешавањима ово је нит главног програма, иако постоји <classname>Glib::Dispatcher</classname> конструктор који може примити <classname>Glib::MainContext</classname> објекат било које нити која има главну петљу. Само пријемна нит треба да позива <methodname>connect()</methodname> над <classname>Glib::Dispatcher</classname> објектом, или да управља било којим повезаним <classname>sigc::connection</classname> објектом, осим ако се не примени додатно усаглашавање. Међутим, било која радна нит може безбедно емитовати над <classname>Glib::Dispatcher</classname> објектом без икаквог закључавања након што је пријемна нит повезала места, под условом да је изграђен пре него што је радна нит покренута (ако је изграђен након што је нит покренута, обично ће бити потребно додатно усаглашавање како би се осигурала видљивост).

note: (itstool) path: section/para
en: Aside from the fact that connected slots always execute in the receiver thread, <classname>Glib::Dispatcher</classname> objects are similar to <classname>sigc::signal&lt;void()&gt;</classname> objects. They therefore cannot pass unbound arguments nor return a value. The best way to pass unbound arguments is with a thread-safe (asynchronous) queue. At the time of writing <application>glibmm</application> does not have one, although most people writing multi-threaded code will have one available to them (they are relatively easy to write although there are subtleties in combining thread safety with strong exception safety).
sr: Осим чињенице да се повезани слотови увек извршавају у нити примаоца, објекти <classname>Glib::Dispatcher</classname> су слични објектима <classname>sigc::signal&lt;void()&gt;</classname>. Стога не могу преносити невезане аргументе нити враћати вредност. Најбољи начин за пренос невезаних аргумената је помоћу безбедног (асинхроног) реда нити. У време писања <application>glibmm</application> га нема, иако ће га већина људи који пишу вишенитни код имати на располагању (релативно их је лако написати, иако постоје суптилности у комбиновању безбедности нити са јаком безбедношћу изузетака).

note: (itstool) path: section/para
en: A <classname>Glib::Dispatcher</classname> object can be emitted on by the receiver thread as well as by a worker thread, although this should be done within reasonable bounds. On unix-like systems <classname>Glib::Dispatcher</classname> objects share a single common pipe, which could in theory at least fill up on a very heavily loaded system running a program with a very large number of <classname>Dispatcher</classname> objects in use. Were the pipe to fill up before the receiver thread's main loop has had an opportunity to read from it to empty it, and the receiver thread attempt to emit and so write to it when it is in that condition, the receiver thread would block on the write, so deadlocking. Where the receiver thread is to emit, a normal <classname>sigc::signal&lt;void()&gt;</classname> object could of course be used instead.
sr: Објекат <classname>Glib::Dispatcher</classname> може бити емитован од стране нити примаоца као и од стране радне нити, иако би то требало радити у разумним границама. На системима налик јуниксу, објекти <classname>Glib::Dispatcher</classname> деле једну заједничку спојку, која би у теорији барем могла да се попуни на веома оптерећеном систему који покреће програм са веома великим бројем објеката <classname>Dispatcher</classname> у употреби. Ако би се спојка попунила пре него што главна петља нити примаоца добије прилику да чита из ње како би је испразнила, а нит примаоца покуша да емитује и тако пише у њу када је у том стању, нит примаоца би се блокирала при писању, што би довело до мртвог чвора. Тамо где нит примаоца треба да емитује, уместо тога се наравно може користити обичан објекат <classname>sigc::signal&lt;void()&gt;</classname>.

note: (itstool) path: section/para
en: This is an example program with two threads, one GUI thread, like in all <application>gtkmm</application> programs, and one worker thread. The worker thread is created when you press the <literal>Start work</literal> button. It is deleted when the work is finished, when you press the <literal>Stop work</literal> button, or when you press the <literal>Quit</literal> button.
sr: Ово је пример програма са две нити, једном ГУИ нити, као у свим <application>gtkmm</application> програмима, и једном радном нити. Радна нит се прави када притиснете дугме <literal>Start work</literal>. Брише се када се посао заврши, када притиснете дугме <literal>Stop work</literal> или када притиснете дугме <literal>Quit</literal>.

note: (itstool) path: section/para
en: A <classname>Glib::Dispatcher</classname> is used for sending notifications from the worker thread to the GUI thread. The <classname>ExampleWorker</classname> class contains data which is accessed by both threads. This data is protected by a <classname>std::mutex</classname>. Only the GUI thread updates the GUI.
sr: <classname>Glib::Dispatcher</classname> се користи за слање обавештења из радне нити у ГУИ нит. Класа <classname>ExampleWorker</classname> садржи податке којима приступају обе нити. Ови подаци су заштићени помоћу <classname>std::mutex</classname>. Само ГУИ нит ажурира ГУИ.

note: (itstool) path: section/para
en: Compiling and linking a multi-threaded program can require special compiler and linker options. If you use the <application>g++</application> compiler, add the <literal>-pthread</literal> option. Other compilers may require other options. If you build with <application>meson</application>, it handles the multi-threading complications for you, if you add <function>dependency('threads')</function>.
sr: Превођење и повезивање вишенитног програма може захтевати посебне опције преводиоца и повезивача. Ако користите <application>g++</application> преводилац, додајте опцију <literal>-pthread</literal>. Други преводиоци могу захтевати друге опције. Ако градите помоћу <application>meson</application>-а, он решава компликације вишенитног рада уместо вас, ако додате <function>dependency('threads')</function>.

note: (itstool) path: figure/title
en: Multi-Threaded Program
sr: Вишенитни програм

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/multithread">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/multithread">Изворни код</link>

note: (itstool) path: chapter/title
en: Recommended Techniques
sr: Препоручене технике

note: (itstool) path: chapter/para
en: This section is simply a gathering of wisdom, general style guidelines and hints for creating <application>gtkmm</application> applications.
sr: Овај одељак је једноставно скуп мудрости, општих смерница за стил и савета за прављење <application>gtkmm</application> апликација.

note: (itstool) path: chapter/para
en: Use <application>Meson</application>! It is your friend :) It examines C and <phrase role="nowrap">C++</phrase> files, determines how they depend on each other, and generates <filename>build.ninja</filename> or an equivalent file so the files can be compiled in the correct order. <application>Meson</application> permits automatic configuration of software installation, handling a large number of system quirks to increase portability.
sr: Користите <application>Meson</application>! Он вам је пријатељ :) Он испитује C и <phrase role="nowrap">C++</phrase> датотеке, одређује како оне зависе једна од друге и генерише <filename>build.ninja</filename> или еквивалентну датотеку како би се датотеке могле превести исправним редоследом. <application>Meson</application> омогућава аутоматско подешавање инсталације софтвера, решавајући велики број системских специфичности ради повећања преносивости.

note: (itstool) path: chapter/para
en: Subclass Widgets to better organize your code. You should probably subclass your main <classname>Window</classname> at least. Then you can make your child Widgets and signal handlers members of that class.
sr: Изводите класе елемената (widgets) како бисте боље организовали свој код. Вероватно би требало да изведете барем свој главни <classname>Window</classname>. Тада можете учинити своје подређене елементе и руковаоце сигналима члановима те класе.

note: (itstool) path: chapter/para
en: Create your own signals instead of passing pointers around. Objects can communicate with each other via signals and signal handlers. This is much simpler than objects holding pointers to each other and calling each other's methods. <application>gtkmm</application>'s classes use special versions of <classname>sigc::signal</classname>, but you should use normal <classname>sigc::signal</classname>s, as described in the <application>libsigc++</application> documentation.
sr: Правите сопствене сигнале уместо да прослеђујете показиваче унаоколо. Објекти могу међусобно комуницирати путем сигнала и руковаоца сигналима. Ово је много једноставније него да објекти држе показиваче једни на друге и позивају методе једни других. Класе <application>gtkmm</application>-а користе посебне верзије <classname>sigc::signal</classname>, али би требало да користите обичне <classname>sigc::signal</classname>, као што је описано у документацији за <application>libsigc++</application>.

note: (itstool) path: section/title
en: Application Lifetime
sr: Животни век апликације

note: (itstool) path: section/para
en: Most applications will have only one <classname>Window</classname>, or only one main window. These applications can use <methodname>Gtk::Application::make_window_and_run(int argc, char** argv, T_Args&amp;&amp;... args)</methodname>. It creates and shows a window. When the window is closed, <methodname>make_window_and_run()</methodname> deletes the window and returns to the caller. This might happen when the user closes the window, or when your code decides to close the window with <methodname>Gtk::Window::close()</methodname>. You can prevent the user from closing the window (for instance, if there are unsaved changes) by overriding <methodname>Gtk::Window::on_close_request()</methodname>.
sr: Већина апликација ће имати само један <classname>Window</classname>, или само један главни прозор. Ове апликације могу користити <methodname>Gtk::Application::make_window_and_run(int argc, char** argv, T_Args&amp;&amp;... args)</methodname>. Она прави и приказује прозор. Када се прозор затвори, <methodname>make_window_and_run()</methodname> брише прозор и враћа се позиваоцу. Ово се може догодити када корисник затвори прозор, или када ваш код одлучи да затвори прозор помоћу <methodname>Gtk::Window::close()</methodname>. Можете спречити корисника да затвори прозор (на пример, ако постоје несачуване измене) преклапањем <methodname>Gtk::Window::on_close_request()</methodname>.

note: (itstool) path: section/para
en: Most of our examples use this technique.
sr: Већина наших примера користи ову технику.

note: (itstool) path: section/title
en: Using a <application>gtkmm</application> widget
sr: Коришћење <application>gtkmm</application> елемента

note: (itstool) path: section/para
en: Our examples all tend to have the same structure. They follow these steps for using a <classname>Widget</classname>:
sr: Сви наши примери теже да имају исту структуру. Они прате ове кораке за коришћење <classname>Widget</classname>-а:

note: (itstool) path: listitem/para
en: Declare a variable of the type of <classname>Widget</classname> you wish to use, generally as member variable of a derived container class. You could also declare a pointer to the widget type, and then create it with <literal>new</literal> or <function>Gtk::make_managed()</function> in your code.
sr: Декларишите променљиву типа <classname>Widget</classname> који желите да користите, углавном као члана променљиве изведене класе контејнера. Такође можете декларисати показивач на тип елемента, а затим га направити помоћу <literal>new</literal> или <function>Gtk::make_managed()</function> у свом коду.

note: (itstool) path: listitem/para
en: Set the attributes of the widget. If the widget has no default constructor, then you will need to initialize the widget in the initializer list of your container class's constructor.
sr: Поставите атрибуте елемента. Ако елемент нема подразумевани конструктор, тада ћете морати да иницијализујете елемент у листи иницијализатора конструктора ваше класе контејнера.

note: (itstool) path: listitem/para
en: Connect any signals you wish to use to the appropriate handlers.
sr: Повежите све сигнале које желите да користите са одговарајућим руковаоцима.

note: (itstool) path: listitem/para
en: Pack the widget into a container using the appropriate call, e.g. <methodname>Gtk::Box::append()</methodname>.
sr: Спакујте елемент у контејнер користећи одговарајући позив, нпр. <methodname>Gtk::Box::append()</methodname>.

note: (itstool) path: section/para
en: If you don't want all widgets to be shown, call <methodname>Gtk::Widget::set_visible(false)</methodname> on the widgets that you don't want to show. If a container widget is hidden, all of its child widgets are also hidden, even if <methodname>set_visible(false)</methodname> is not called on the child widgets.
sr: Ако не желите да сви елементи буду приказани, позовите <methodname>Gtk::Widget::set_visible(false)</methodname> на елементима које не желите да прикажете. Ако је контејнер сакривен, сви његови садржани елементи су такође сакривени, чак и ако <methodname>set_visible(false)</methodname> није позвано на њима.

note: (itstool) path: chapter/title
en: Building applications
sr: Изградња програма

note: (itstool) path: chapter/para
en: This chapter is similar to <emphasis>Building applications</emphasis> and following sections in the <link xlink:href="https://docs.gtk.org/gtk4/getting_started.html">Getting Started</link> chapter in the GTK documentation. The same application is built, but <application>gtkmm</application> is used instead of <application>GTK</application>.
sr: Ово поглавље је слично поглављу <emphasis>Изградња програма</emphasis> и следећим одељцима у поглављу <link xlink:href="https://docs.gtk.org/gtk4/getting_started.html">Први кораци</link> у ГТК документацији. Гради се исти програм, али се користи <application>gtkmm</application> уместо <application>GTK</application>-а.

note: (itstool) path: varlistentry/term
en: The binary file
sr: Бинарна датотека

note: (itstool) path: listitem/para
en: This gets installed in <filename>/usr/bin</filename>.
sr: Она се инсталира у <filename>/usr/bin</filename>.

note: (itstool) path: varlistentry/term
en: A desktop file
sr: Датотека радне површине

note: (itstool) path: listitem/para
en: The desktop file provides important information about the application to the desktop shell, such as its name, icon, D-Bus name, commandline to launch it, etc. It is installed in <filename>/usr/share/applications</filename>.
sr: Датотека радне површине пружа важне податке о програму шкољки радне површине, као што су његов назив, иконица, Д-бас назив, линија наредби за покретање итд. Инсталира се у <filename>/usr/share/applications</filename>.

note: (itstool) path: varlistentry/term
en: An icon
sr: Иконица

note: (itstool) path: listitem/para
en: The icon gets installed in <filename>/usr/share/icons/hicolor/48x48/apps</filename>, where it will be found regardless of the current theme.
sr: Иконица се инсталира у <filename>/usr/share/icons/hicolor/48x48/apps</filename>, где ће бити пронађена без обзира на тренутну тему.

note: (itstool) path: varlistentry/term
en: A settings schema
sr: Шема подешавања

note: (itstool) path: listitem/para
en: If the application uses <classname>Gio::Settings</classname>, it will install its schema in <filename>/usr/share/glib-2.0/schemas</filename>, so that tools like dconf-editor can find it.
sr: Ако програм користи <classname>Gio::Settings</classname>, инсталираће своју шему у <filename>/usr/share/glib-2.0/schemas</filename>, тако да алати као што је dconf-editor могу да је пронађу.

note: (itstool) path: varlistentry/term
en: Other resources
sr: Други ресурси

note: (itstool) path: listitem/para
en: Other files, such as <classname>Gtk::Builder</classname> ui files, are best loaded from resources stored in the application binary itself. This eliminates the need for most of the files that would traditionally be installed in an application-specific location in <filename>/usr/share</filename>.
sr: Друге датотеке, као што су <classname>Gtk::Builder</classname> датотеке корисничког прочеља, најбоље је учитавати из ресурса сачуваних у самој бинарној датотеци програма. Ово елиминише потребу за већином датотека које би се традиционално инсталирале на место специфично за програм у <filename>/usr/share</filename>.

note: (itstool) path: chapter/para
en: An application consists of a number of files: <_:variablelist-1/>
sr: Програм се састоји од низа датотека: <_:variablelist-1/>

note: (itstool) path: chapter/para
en: <application>gtkmm</application> includes application support that is built on top of <classname>Gio::Application</classname>. In this chapter we'll build a simple application by starting from scratch, adding more and more pieces over time. Along the way, we'll learn about <classname>Gtk::Application</classname>, <classname>Gtk::Builder</classname>, resources, menus, settings, <classname>Gtk::HeaderBar</classname>, <classname>Gtk::Stack</classname>, <classname>Gtk::SearchBar</classname>, <classname>Gtk::ListBox</classname>, and more.
sr: <application>gtkmm</application> укључује подршку за програме која је изграђена на врху <classname>Gio::Application</classname>. У овом поглављу ћемо изградити једноставан програм почевши од нуле, додајући све више и више делова током времена. Уз пут ћемо научити о <classname>Gtk::Application</classname>, <classname>Gtk::Builder</classname>, ресурсима, изборницима, подешавањима, <classname>Gtk::HeaderBar</classname>, <classname>Gtk::Stack</classname>, <classname>Gtk::SearchBar</classname>, <classname>Gtk::ListBox</classname> и још много тога.

note: (itstool) path: chapter/para
en: The full, buildable sources for these examples can be found in the <filename>examples/book/buildapp</filename> directory of the <application>gtkmm-documentation</application> source distribution, or online in the <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/buildapp"><application>gtkmm-documentation</application> git repository</link>. You can build each example separately by using <command>meson</command> and <command>ninja</command> with the <filename>meson.build</filename> file or by using <command>make</command> with the <filename>Makefile.example</filename> file. For more information, see the <filename>README</filename> included in the <filename>buildapp</filename> directory.
sr: Потпуни изворни ко̂дови за ове примере који се могу изградити могу се наћи у директоријуму <filename>examples/book/buildapp</filename> изворне дистрибуције <application>gtkmm-documentation</application>, или на мрежи у <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/buildapp">гит ризници <application>gtkmm-documentation</application></link>. Сваки пример можете изградити засебно користећи <command>meson</command> и <command>ninja</command> са <filename>meson.build</filename> датотелом или користећи <command>make</command> са <filename>Makefile.example</filename> датотелом. За више података, погледајте <filename>README</filename> који се налази у директоријуму <filename>buildapp</filename>.

note: (itstool) path: section/title (itstool) path: figure/title
en: A trivial application
sr: Безначајан програм

note: (itstool) path: section/para
en: When using <classname>Gtk::Application</classname>, the <function>main()</function> function can be very simple. We just call <methodname>Gtk::Application::run()</methodname> on an instance of our application class.
sr: Када се користи <classname>Gtk::Application</classname>, функција <function>main()</function> може бити врло једноставна. Само позивамо <methodname>Gtk::Application::run()</methodname> на примерку наше класе програма.

note: (itstool) path: section/para
en: All the application logic is in the application class, which is a subclass of <classname>Gtk::Application</classname>. Our example does not yet have any interesting functionality. All it does is open a window when it is activated without arguments, and open the files it is given, if it is started with arguments. (Or rather, our application class tries to open the files, but our subclassed application window does not yet do what it's told to do.)
sr: Сва логика програма је у класи програма, која је подкласа <classname>Gtk::Application</classname>. Наш пример још увек нема никакву занимљиву функционалност. Све што ради је да отвара прозор када се активира без аргумената, и отвара датотеке које су му дате, ако се покрене са аргументима. (Тачније, наша класа програма покушава да отвори датотеке, али наш прозор програма изведен у подкласи још увек не ради оно што му је речено.)

note: (itstool) path: section/para
en: To handle these two cases, we override <methodname>signal_activate()</methodname>'s default handler, which gets called when the application is launched without commandline arguments, and <methodname>signal_open()</methodname>'s default handler, which gets called when the application is launched with commandline arguments.
sr: Да бисмо обрадили ова два случаја, преписујемо подразумевани руковалац за <methodname>signal_activate()</methodname>, који се позива када се програм покрене без аргумената линије наредби, и подразумевани руковалац за <methodname>signal_open()</methodname>, који се позива када се програм покрене са аргументима линије наредби.

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/glibmm/classGio_1_1Application.html">Gio::Application Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/glibmm/classGio_1_1Application.html">Gio::Application референца</link>

note: (itstool) path: section/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1Application.html">Gtk::Application Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/gtkmm/classGtk_1_1Application.html">Gtk::Application референца</link>

note: (itstool) path: section/para
en: Another important class that is part of the application support in <application>gtkmm</application> is <classname>Gtk::ApplicationWindow</classname>. It is typically subclassed as well. Our subclass does not do anything yet, so we will just get an empty window.
sr: Још једна важна класа која је део подршке за програме у <application>gtkmm</application>-у је <classname>Gtk::ApplicationWindow</classname>. Обично се и она изводи у подкласу. Наша подкласа још увек не ради ништа, тако да ћемо само добити празан прозор.

note: (itstool) path: section/para
en: As part of the initial setup of our application, we also create an icon and a desktop file. Note that @bindir@ in the desktop file needs to be replaced with the actual path to the binary before this desktop file can be used.
sr: Као део почетног подешавања нашег програма, такође правимо иконицу и датотеку радне површине. Имајте на уму да @bindir@ у датотеци радне површине треба да буде замењен стварном путањом до извршне датотеке пре него што се ова датотека радне површине може користити.

note: (itstool) path: section/para
en: Here is what we've achieved so far:
sr: Ево шта смо до сада постигли:

note: (itstool) path: section/para
en: This does not look very impressive yet, but our application is already presenting itself on the session bus, it has single-instance semantics, and it accepts files as commandline arguments.
sr: Ово још увек не изгледа врло импресивно, али се наш програм већ представља на магистрали сесије, има семантику једног примерка и прихвата датотеке као аргументе линије наредби.

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/buildapp/step1">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/buildapp/step1">Изворни код</link>

note: (itstool) path: section/title (itstool) path: figure/title
en: Populating the window
sr: Попуњавање прозора

note: (itstool) path: section/para
en: In this step, we use a <classname>Gtk::Builder</classname> instance to associate a <classname>Gtk::Builder</classname> ui file with our application window class.
sr: У овом кораку користимо примерак <classname>Gtk::Builder</classname>-а да бисмо повезали <classname>Gtk::Builder</classname> корисничку датотеку са нашом класом прозора програма.

note: (itstool) path: section/para
en: Our simple ui file gives the window a title, and puts a <classname>Gtk::Stack</classname> widget as the main content.
sr: Наша једноставна корисничка датотека даје прозору наслов и поставља елемент <classname>Gtk::Stack</classname> као главни садржај.

note: (itstool) path: section/para
en: To make use of this file in our application, we revisit our <classname>Gtk::ApplicationWindow</classname> subclass, and call <methodname>Gtk::Builder::create_from_resource()</methodname> and <methodname>Gtk::Builder::get_widget_derived()</methodname> from the <methodname>ExampleAppWindow::create()</methodname> method to get an instance of our subclassed <classname>Gtk::ApplicationWindow</classname>. See the <link linkend="sec-builder-using-derived-widgets">Using derived widgets</link> section for more information about <methodname>get_widget_derived()</methodname>.
sr: Да бисмо искористили ову датотеку у нашем програму, поново посећујемо нашу подкласу <classname>Gtk::ApplicationWindow</classname> и позивамо <methodname>Gtk::Builder::create_from_resource()</methodname> и <methodname>Gtk::Builder::get_widget_derived()</methodname> из методе <methodname>ExampleAppWindow::create()</methodname> да бисмо добили примерак наше подкласе <classname>Gtk::ApplicationWindow</classname>. Погледајте одељак <link linkend="sec-builder-using-derived-widgets">Коришћење изведених елемената</link> за више информација о <methodname>get_widget_derived()</methodname>.

note: (itstool) path: section/para
en: You may have noticed that we use the <methodname>_from_resource()</methodname> variant of the method that reads the ui file. Now we need to use <application>GLib</application>'s resource functionality to include the ui file in the binary. This is commonly done by listing all resources in a .gresource.xml file. This file has to be converted into a C source file that will be compiled and linked into the application together with the other source files. To do so, we use the <application>glib-compile-resources</application> utility: <_:screen-1/> The <link linkend="sec-gio-resource">Gio::Resource and glib-compile-resources</link> section contains more information about resource files. If you build with Meson, use the <function>compile_resources()</function> function in Meson's <link xlink:href="https://mesonbuild.com/Gnome-module.html">GNOME module</link>.
sr: Можда сте приметили да користимо варијанту методе <methodname>_from_resource()</methodname> која чита корисничку датотеку. Сада треба да користимо <application>GLib</application>-ову функционалност ресурса да бисмо укључили корисничку датотеку у извршну датотеку. То се обично ради навођењем свих ресурса у .gresource.xml датотеци. Ова датотека мора бити претворена у C изворну датотеку која ће бити компајлирана и повезана у програм заједно са осталим изворним датотекама. Да бисмо то урадили, користимо алатку <application>glib-compile-resources</application>: <_:screen-1/> Одељак <link linkend="sec-gio-resource">Gio::Resource и glib-compile-resources</link> садржи више информација о датотекама ресурса. Ако градите помоћу Мезона, користите функцију <function>compile_resources()</function> у Мезоновом <link xlink:href="https://mesonbuild.com/Gnome-module.html">ГНОМ модулу</link>.

note: (itstool) path: section/para
en: Our application now looks like this:
sr: Наш програм сада изгледа овако:

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/buildapp/step2">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/buildapp/step2">Изворни код</link>

note: (itstool) path: section/title (itstool) path: figure/title
en: Opening files
sr: Отварање датотека

note: (itstool) path: section/para
en: In this step, we make our application show the contents of all the files that it is given on the commandline.
sr: У овом кораку ћемо учинити да наш програм прикаже садржај свих датотека које му се проследе преко линије наредби.

note: (itstool) path: section/para
en: To this end, we add a data member to our application window and keep a pointer to the <classname>Gtk::Stack</classname> there. We get the pointer with a call to <methodname>Gtk::Builder::get_widget()</methodname> in the application window's constructor.
sr: У ту сврху, додајемо члан података у прозор нашег програма и тамо чувамо показивач на <classname>Gtk::Stack</classname>. Показивач добијамо позивом <methodname>Gtk::Builder::get_widget()</methodname> у конструктору прозора програма.

note: (itstool) path: section/para
en: Now we revisit the <methodname>ExampleAppWindow::open_file_view()</methodname> method that is called for each commandline argument, and construct a <classname>Gtk::TextView</classname> that we then add as a page to the stack.
sr: Сада се враћамо на метод <methodname>ExampleAppWindow::open_file_view()</methodname> који се позива за сваки аргумент линије наредби, и правимо <classname>Gtk::TextView</classname> који затим додајемо као страницу у спремник (стек).

note: (itstool) path: section/para
en: Lastly, we add a <classname>Gtk::StackSwitcher</classname> to the titlebar area in the ui file, and we tell it to display information about our stack.
sr: На крају, додајемо <classname>Gtk::StackSwitcher</classname> у област траке наслова у КС датотеци, и кажемо му да прикаже податке о нашем спремнику.

note: (itstool) path: section/para
en: The stack switcher gets all its information it needs to display tabs from the stack that it belongs to. Here, we are passing the label to show for each file as the last argument to the <methodname>Gtk::Stack::add()</methodname> method.
sr: Пребацивач спремника добија све податке који су му потребни за приказ језичака из спремника којем припада. Овде прослеђујемо натпис који ће се приказати за сваку датотеку као последњи аргумент методу <methodname>Gtk::Stack::add()</methodname>.

note: (itstool) path: section/para
en: Our application is beginning to take shape:
sr: Наш програм почиње да добија облик:

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/buildapp/step3">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/buildapp/step3">Изворни код</link>

note: (itstool) path: section/title (itstool) path: figure/title
en: A menu
sr: Мени

note: (itstool) path: section/para
en: The menu is shown at the right side of the headerbar. It is meant to collect infrequently used actions that affect the whole application.
sr: Мени је приказан на десној страни траке заглавља. Намењен је за прикупљање ретко коришћених радњи које утичу на цео програм.

note: (itstool) path: section/para
en: Just like the application window, we specify our menu in a ui file, and add it as a resource to our binary.
sr: Баш као и прозор програма, наш мени наводимо у КС датотеци и додајемо га као ресурс у нашу извршну датотеку.

note: (itstool) path: section/para
en: To make the menu appear, we have to load the ui file and associate the resulting menu model with the menu button that we've added to the headerbar. Since menus work by activating <classname>Gio::Action</classname>s, we also have to add a suitable set of actions to our application.
sr: Да би се мени појавио, морамо да учитамо КС датотеку и повежемо резултујући модел менија са дугметом менија које смо додали у траку заглавља. Пошто менији раде активирањем <classname>Gio::Action</classname> радњи, такође морамо да додамо одговарајући скуп радњи у наш програм.

note: (itstool) path: section/para
en: Adding the actions is best done in the <methodname>on_startup()</methodname> default signal handler, which is guaranteed to be called once for each primary application instance.
sr: Додавање радњи је најбоље урадити у подразумеваном руковаоцу сигнала <methodname>on_startup()</methodname>, за који је загарантовано да ће бити позван једном за сваку примарну појаву програма.

note: (itstool) path: section/para
en: Our preferences menu item does not do anything yet, but the Quit menu item is fully functional. It can also be activated by the usual Ctrl-Q shortcut. The shortcut is added with <methodname>Gtk::Application::set_accel_for_action()</methodname>.
sr: Наша ставка менија за поставке још увек не ради ништа, али је ставка менија „Изађи“ потпуно функционална. Такође се може активирати уобичајеном пречицом Ctrl-Q. Пречица се додаје помоћу <methodname>Gtk::Application::set_accel_for_action()</methodname>.

note: (itstool) path: section/para
en: The menu looks like this:
sr: Мени изгледа овако:

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/buildapp/step4">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/buildapp/step4">Изворни код</link>

note: (itstool) path: section/title (itstool) path: figure/title
en: A preference dialog
sr: Прозорче за поставке

note: (itstool) path: section/para
en: A typical application will have some preferences that should be remembered from one run to the next. Even for our simple example application, we may want to change the font that is used for the content.
sr: Уобичајени програм ће имати нека подешавања која треба запамтити од једног покретања до следећег. Чак и за наш једноставан пример програма, можда ћемо желети да променимо фонт који се користи за садржај.

note: (itstool) path: section/para
en: We are going to use <classname>Gio::Settings</classname> to store our preferences. <classname>Gio::Settings</classname> requires a schema that describes our settings, in our case the <filename>org.gtkmm.exampleapp.gschema.xml</filename> file.
sr: Користићемо <classname>Gio::Settings</classname> за чување наших подешавања. <classname>Gio::Settings</classname> захтева шему која описује наша подешавања, у нашем случају датотеку <filename>org.gtkmm.exampleapp.gschema.xml</filename>.

note: (itstool) path: section/para
en: Before we can make use of this schema in our application, we need to compile it into the binary form that <classname>Gio::Settings</classname> expects. GIO provides macros to do this in autotools-based projects. See the description of <link xlink:href="https://docs.gtk.org/gio/class.Settings.html">GSettings</link>. Meson provides the <function>compile_schemas()</function> function in the <link xlink:href="https://mesonbuild.com/Gnome-module.html">GNOME module</link>.
sr: Пре него што будемо могли да користимо ову шему у нашем програму, морамо је превести у бинарни облик који <classname>Gio::Settings</classname> очекује. ГИО обезбеђује макрое за ово у пројектима заснованим на ауто-алатима. Погледајте опис за <link xlink:href="https://docs.gtk.org/gio/class.Settings.html">GSettings</link>. Мезон обезбеђује функцију <function>compile_schemas()</function> у <link xlink:href="https://mesonbuild.com/Gnome-module.html">Гномовом модулу</link>.

note: (itstool) path: section/para
en: Next, we need to connect our settings to the widgets that they are supposed to control. One convenient way to do this is to use <methodname>Gio::Settings::bind()</methodname> to bind settings keys to object properties, as we do for the transition setting in <classname>ExampleAppWindow</classname>'s constructor.
sr: Затим, морамо да повежемо наша подешавања са елементима којима би требало да управљају. Један згодан начин да то урадите је коришћење <methodname>Gio::Settings::bind()</methodname> за повезивање кључева подешавања са својствима објекта, као што то радимо за подешавање прелаза у конструктору класе <classname>ExampleAppWindow</classname>.

note: (itstool) path: section/para
en: The code to connect the font setting is a little more involved, since it corresponds to an object property in a <classname>Gtk::TextTag</classname> that we must first create. The code is in <methodname>ExampleAppWindow::open_file_view()</methodname>.
sr: Код за повезивање подешавања фонта је мало сложенији, пошто одговара својству објекта у <classname>Gtk::TextTag</classname> који прво морамо направити. Код се налази у <methodname>ExampleAppWindow::open_file_view()</methodname>.

note: (itstool) path: section/para
en: At this point, the application will already react if you change one of the settings, e.g. using the <command>gsettings</command> commandline tool. Of course, we expect the application to provide a preference dialog for these. So lets do that now. Our preference dialog will be a subclass of <classname>Gtk::Window</classname>, and we'll use the same techniques that we've already seen in <classname>ExampleAppWindow</classname>: a <classname>Gtk::Builder</classname> ui file and settings bindings. In this case the bindings are more involved, though. We use <classname>Gtk::FontDialogButton</classname> and <classname>Gtk::DropDown</classname> in the preference dialog. The types of the properties in these classes can't be automatically converted to the string type that <classname>Gio::Settings</classname> requires.
sr: У овом тренутку, програм ће већ реаговати ако промените неко од подешавања, нпр. коришћењем алатке командне линије <command>gsettings</command>. Наравно, очекујемо да програм обезбеди прозорче за подешавања за ово. Па урадимо то сада. Наше прозорче за подешавања ће бити подкласа <classname>Gtk::Window</classname>, и користићемо исте технике које смо већ видели у <classname>ExampleAppWindow</classname>: <classname>Gtk::Builder</classname> корисничку датотеку и повезивање подешавања. У овом случају, повезивања су ипак сложенија. Користимо <classname>Gtk::FontDialogButton</classname> и <classname>Gtk::DropDown</classname> у прозорчету за подешавања. Врсте својстава у овим класама не могу се аутоматски претворити у ниску коју <classname>Gio::Settings</classname> захтева.

note: (itstool) path: section/para
en: When we've created the <filename>prefs.ui</filename> file and the <classname>ExampleAppPrefs</classname> class, we revisit the <methodname>ExampleApplication::on_action_preferences()</methodname> method in our application class, and make it open a new preference dialog.
sr: Након што направимо датотеку <filename>prefs.ui</filename> и класу <classname>ExampleAppPrefs</classname>, поново ћемо погледати метод <methodname>ExampleApplication::on_action_preferences()</methodname> у нашој класи програма, и учинити да отвара ново прозорче за подешавања.

note: (itstool) path: section/para
en: After all this work, our application can now show a preference dialog like this:
sr: Након свег овог рада, наш програм сада може да прикаже прозорче за подешавања овако:

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/buildapp/step5">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/buildapp/step5">Изворни код</link>

note: (itstool) path: section/title (itstool) path: figure/title
en: Adding a search bar
sr: Додавање траке претраге

note: (itstool) path: section/para
en: We continue to flesh out the functionality of our application. For now, we add search. <application>gtkmm</application> supports this with <classname>Gtk::SearchEntry</classname> and <classname>Gtk::SearchBar</classname>. The search bar is a widget that can slide in from the top to present a search entry.
sr: Настављамо да допуњавамо функционалност нашег програма. За сада, додајемо претрагу. <application>gtkmm</application> ово подржава помоћу <classname>Gtk::SearchEntry</classname> и <classname>Gtk::SearchBar</classname>. Трака претраге је елемент који може да склизне са врха како би приказао поље за унос претраге.

note: (itstool) path: section/para
en: We add a toggle button to the header bar, which can be used to slide out the search bar below the header bar. The new widgets are added in the <filename>window.ui</filename> file.
sr: Додајемо дугме за пребацивање у траку заглавља, које се може користити за извлачење траке претраге испод траке заглавља. Нови елементи су додати у датотеку <filename>window.ui</filename>.

note: (itstool) path: section/para
en: Implementing the search needs quite a few code changes that we are not going to completely go over here. The central piece of the search implementation is a signal handler that listens for text changes in the search entry, shown here without error handling.
sr: Примена претраге захтева доста измена у коду које овде нећемо у потпуности проћи. Централни део примене претраге је руковалац сигналом који ослушкује промене текста у пољу за унос претраге, приказан овде без обраде грешака.

note: (itstool) path: section/para
en: With the search bar, our application now looks like this:
sr: Са траком претраге, наш програм сада изгледа овако:

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/buildapp/step6">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/buildapp/step6">Изворни код</link>

note: (itstool) path: section/title (itstool) path: figure/title
en: Adding a side bar
sr: Додавање бочне површи

note: (itstool) path: section/para
en: As another piece of functionality, we are adding a sidebar, which demonstrates <classname>Gtk::Revealer</classname> and <classname>Gtk::ListBox</classname>. The new widgets are added in the <filename>window.ui</filename> file.
sr: Као још један део функционалности, додајемо бочну површ, која демонстрира <classname>Gtk::Revealer</classname> и <classname>Gtk::ListBox</classname>. Нови елементи су додати у датотеку <filename>window.ui</filename>.

note: (itstool) path: section/para
en: The code to populate the sidebar with buttons for the words found in each file is a little too involved to go into here. But we'll look at the code to add a checkbutton for the new feature to the menu. A menu item is added to the ui file <filename>gears_menu.ui</filename>.
sr: Код за попуњавање бочне површи дугмадима за речи пронађене у свакој датотеци је мало превише сложен да бисмо овде улазили у њега. Али погледаћемо код за додавање дугмета за штиклирање за нову функцију у изборник. Ставка изборника је додата у КС датотеку <filename>gears_menu.ui</filename>.

note: (itstool) path: section/para
en: To connect the menu item to the new <literal>show-words</literal> setting, we use a <classname>Gio::Action</classname> corresponding to the given <classname>Gio::Settings</classname> key. In <classname>ExampleAppWindow</classname>'s constructor:
sr: Да бисмо повезали ставку изборника са новим <literal>show-words</literal> подешавањем, користимо <classname>Gio::Action</classname> који одговара датом <classname>Gio::Settings</classname> кључу. У конструктору <classname>ExampleAppWindow</classname>-а:

note: (itstool) path: section/programlisting
en: <code>// Connect the menu to the MenuButton m_gears, and bind the show-words setting
    // to the win.show-words action and the "Words" menu item.
    // (The connection between action and menu item is specified in gears_menu.ui.)
    auto menu_builder = Gtk::Builder::create_from_resource("/org/gtkmm/exampleapp/gears_menu.ui");
    auto menu = menu_builder-&gt;get_object&lt;Gio::MenuModel&gt;("menu");
    m_gears-&gt;set_menu_model(menu);
    add_action(m_settings-&gt;create_action("show-words"));
    </code>
sr: <code>// Повежите изборник са MenuButton m_gears и вежите подешавање show-words
    // на радњу win.show-words и ставку изборника „Words“.
    // (Веза између радње и ставке изборника је наведена у gears_menu.ui.)
    auto menu_builder = Gtk::Builder::create_from_resource("/org/gtkmm/exampleapp/gears_menu.ui");
    auto menu = menu_builder-&gt;get_object&lt;Gio::MenuModel&gt;("menu");
    m_gears-&gt;set_menu_model(menu);
    add_action(m_settings-&gt;create_action("show-words"));
    </code>

note: (itstool) path: section/para
en: What our application looks like now:
sr: Како наш програм сада изгледа:

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/buildapp/step7">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/buildapp/step7">Изворни код</link>

note: (itstool) path: section/title (itstool) path: figure/title
en: Properties
sr: Својства

note: (itstool) path: section/para
en: Widgets and other objects have many useful properties. Here we show some ways to use them in new and flexible ways, by wrapping them in actions with <classname>Gio::PropertyAction</classname> or by binding them with <classname>Glib::Binding</classname>.
sr: Елементи и други објекти имају многа корисна својства. Овде приказујемо неке начине за њихово коришћење на нове и флексибилне начине, умотавањем у радње помоћу <classname>Gio::PropertyAction</classname> или њиховим везивањем помоћу <classname>Glib::Binding</classname>.

note: (itstool) path: section/para
en: To set this up, we add two labels to the header bar in our <filename>window.ui</filename> file, named <literal>lines_label</literal> and <literal>lines</literal>, and get pointers to them in the application window's constructor, as we've seen a couple of times by now. We add a new "Lines" menu item to the gears menu, which triggers the <literal>show-lines</literal> action.
sr: Да бисмо ово подесили, додајемо два натписа у траку заглавља у нашој <filename>window.ui</filename> датотеци, именоване <literal>lines_label</literal> и <literal>lines</literal>, и добијамо показиваче на њих у конструктору прозора програма, као што смо већ видели неколико пута. Додајемо нову ставку „Lines“ у изборник зупчаника, која покреће радњу <literal>show-lines</literal>.

note: (itstool) path: section/para
en: To make this menu item do something, we create a property action for the <literal>visible</literal> property of the <literal>lines</literal> label, and add it to the actions of the window. The effect of this is that the visibility of the label gets toggled every time the action is activated. Since we want both labels to appear and disappear together, we bind the <literal>visible</literal> property of the <literal>lines_label</literal> widget to the same property of the <literal>lines</literal> widget. In <classname>ExampleAppWindow</classname>'s constructor:
sr: Да би ова ставка изборника нешто радила, правимо радњу својства за својство <literal>visible</literal> натписа <literal>lines</literal> и додајемо је у радње прозора. Ефекат овога је да се видљивост натписа мења сваки пут када се радња активира. Будући да желимо да се оба натписа појављују и нестају заједно, везујемо својство <literal>visible</literal> елемента <literal>lines_label</literal> за исто својство елемента <literal>lines</literal>. У конструктору <classname>ExampleAppWindow</classname>-а:

note: (itstool) path: section/para
en: We also need a function that counts the lines of the currently active tab, and updates the <literal>lines</literal> label. See the full source if you are interested in the details.
sr: Такође нам је потребна функција која броји редове тренутно активног језичка и ажурира натпис <literal>lines</literal>. Погледајте цео изворни код ако сте заинтересовани за детаље.

note: (itstool) path: section/para
en: This brings our example application to this appearance:
sr: Ово доводи наш пример програма до овог изгледа:

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/buildapp/step8">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/buildapp/step8">Изворни код</link>

note: (itstool) path: section/title (itstool) path: figure/title
en: Header bar
sr: Трака заглавља

note: (itstool) path: section/para
en: Our application already uses a <classname>Gtk::HeaderBar</classname> instead of a 'normal' window titlebar. The header bar is a direct child of the window, and its type is <literal>titlebar</literal>. This is set in the <filename>window.ui</filename> file.
sr: Наш програм већ користи <classname>Gtk::HeaderBar</classname> уместо „обичне“ насловне траке прозора. Трака заглавља је директни садржани елемент прозора, а њена врста је <literal>titlebar</literal>. Ово је постављено у датотеци <filename>window.ui</filename>.

note: (itstool) path: section/para
en: Here we'll just make two small changes to the header bar. The <literal>decoration-layout</literal> property is set in the <filename>window.ui</filename> file, to show only the close button, and hide the minimize and maximize buttons. We also include an icon in the resource file, and set up this icon as the window icon. In <classname>ExampleAppWindow</classname>'s constructor:
sr: Овде ћемо само направити две мале измене на траци заглавља. Својство <literal>decoration-layout</literal> је постављено у датотеци <filename>window.ui</filename> да приказује само дугме за затварање и сакрива дугмад за умањивање и увећавање. Такође укључујемо иконицу у датотеку ресурса и постављамо ову иконицу као иконицу прозора. У конструктору <classname>ExampleAppWindow</classname>-а:

note: (itstool) path: section/para
en: Here is how the application now looks:
sr: Ево како апликација сада изгледа:

note: (itstool) path: section/para
en: The <filename>window.ui</filename> file sets a header bar title, but this title is not shown. That's because the stack switcher is a child of type <literal>title</literal>. The stack switcher becomes a custom title that hides the title label.
sr: Датотека <filename>window.ui</filename> поставља наслов траке заглавља, али овај наслов није приказан. То је зато што је пребацивач стека дете врсте <literal>title</literal>. Пребацивач стека постаје произвољни наслов који скрива натпис наслова.

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/buildapp/step9">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/buildapp/step9">Изворни код</link>

note: (itstool) path: chapter/title
en: Contributing
sr: Допринеси

note: (itstool) path: chapter/para
en: This document, like so much other great software out there, was created for free by volunteers. If you are at all knowledgeable about any aspect of <application>gtkmm</application> that does not already have documentation, please consider contributing to this document.
sr: Овај документ, као и толико другог сјајног софтвера, направили су бесплатно волонтери. Ако сте уопште упућени у било који аспект <application>gtkmm</application>-а који већ нема документацију, размислите о доприносу овом документу.

note: (itstool) path: chapter/para
en: Ideally, we would like you to <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/-/merge_requests"> provide a merge request</link> to the <filename>docs/tutorial/C/index-in.docbook</filename> file. This file is in the <literal>gtkmm-documentation</literal> module in GNOME git.
sr: Идеално би било да <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/-/merge_requests">пошаљете захтев за спајање</link> за датотеку <filename>docs/tutorial/C/index-in.docbook</filename>. Ова датотека се налази у модулу <literal>gtkmm-documentation</literal> у Гномовом гиту.

note: (itstool) path: chapter/para
en: If you do decide to contribute, please post your contribution as an issue or merge request to <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation">GitLab</link>. You can also discuss your ideas on GNOME's <link xlink:href="https://discourse.gnome.org">Discourse</link> instance, under the <link xlink:href="https://discourse.gnome.org/c/platform/language-bindings"> Platform/Language bindings</link> category with a <literal>cplusplus</literal> tag. Also, be aware that the entirety of this document is free, and any addition you provide must also be free. That is, people must be able to use any portion of your examples in their programs, and copies of this document (including your contribution) may be distributed freely.
sr: Ако одлучите да допринесете, пошаљите свој допринос као проблем или захтев за спајање на <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation">Гитлабу</link>. Такође можете разговарати о својим идејама на Гномовом <link xlink:href="https://discourse.gnome.org">Discourse</link> примерку, у категорији <link xlink:href="https://discourse.gnome.org/c/platform/language-bindings">Platform/Language bindings</link> са ознаком <literal>cplusplus</literal>. Такође, имајте на уму да је цео овај документ слободан, и сваки додатак који пружите мора такође бити слободан. То значи да људи морају бити у могућности да користе било који део ваших примера у својим програмима, а примерци овог документа (укључујући ваш допринос) се могу слободно дистрибуирати.

note: (itstool) path: appendix/title
en: The RefPtr smartpointer
sr: Паметни показивач RefPtr

note: (itstool) path: appendix/para
en: <classname>Glib::RefPtr</classname> is a smartpointer. Specifically, it is a reference-counting smartpointer. You might be familiar with <classname>std::unique_ptr&lt;&gt;</classname> and <classname>std::shared_ptr&lt;&gt;</classname>, which are also smartpointers. In <application>gtkmm</application>-4.0 <classname>Glib::RefPtr&lt;&gt;</classname> is an alias for <classname>std::shared_ptr&lt;&gt;</classname>, which is reference-counting. <classname>Glib::RefPtr&lt;&gt;</classname> was introduced long before there was a reference-counting smartpointer in the <phrase role="nowrap">C++</phrase> Standard Library.
sr: <classname>Glib::RefPtr</classname> је паметни показивач. Тачније, то је паметни показивач са бројањем референци. Можда сте упознати са <classname>std::unique_ptr&lt;&gt;</classname> и <classname>std::shared_ptr&lt;&gt;</classname>, који су такође паметни показивачи. У <application>gtkmm</application>-у 4.0 <classname>Glib::RefPtr&lt;&gt;</classname> је алијас за <classname>std::shared_ptr&lt;&gt;</classname>, који користи бројање референци. <classname>Glib::RefPtr&lt;&gt;</classname> је уведен много пре него што је постојао паметни показивач са бројањем референци у <phrase role="nowrap">C++</phrase> стандардној библиотеци.

note: (itstool) path: appendix/para
en: If you make your own <classname>Glib::ObjectBase</classname>-derived classes with <methodname>create()</methodname> methods that return a <classname>Glib::RefPtr</classname>, you must use <function>Glib::make_refptr_for_instance()</function> in your <methodname>create()</methodname> methods. This function creates a <classname>std::shared_ptr</classname> with a special deleter, which handles the reference-count for the wrapped C object.
sr: Ако правите сопствене класе изведене из <classname>Glib::ObjectBase</classname> са методама <methodname>create()</methodname> које враћају <classname>Glib::RefPtr</classname>, морате користити <function>Glib::make_refptr_for_instance()</function> у својим методама <methodname>create()</methodname>. Ова функција прави <classname>std::shared_ptr</classname> са посебним брисачем, који управља бројањем референци за умотани C објекат.

note: (itstool) path: appendix/para
en: <classname>Glib::RefPtr</classname> is not used for storing widgets derived from <classname>Gtk::Widget</classname>. Widgets have public constructors instead of protected constructors and <methodname>create()</methodname> methods.
sr: <classname>Glib::RefPtr</classname> се не користи за чување елемената изведених из <classname>Gtk::Widget</classname>. Елементи имају јавне конструкторе уместо заштићених конструктора и метода <methodname>create()</methodname>.

note: (itstool) path: appendix/para
en: <link xlink:href="https://gnome.pages.gitlab.gnome.org/glibmm/group__RefPtr.html">Reference</link>
sr: <link xlink:href="https://gnome.pages.gitlab.gnome.org/glibmm/group__RefPtr.html">Референца</link>

note: (itstool) path: appendix/para
en: A smartpointer acts much like a normal pointer. Here are a few examples.
sr: Паметни показивач се понаша слично као обичан показивач. Ево неколико примера.

note: (itstool) path: section/title
en: Copying
sr: Умножавање

note: (itstool) path: section/para
en: You can copy <classname>RefPtr</classname>s, just like normal pointers. But unlike normal pointers, you don't need to worry about deleting the underlying instance.
sr: Можете копирати <classname>RefPtr</classname>-ове, баш као и обичне показиваче. Али за разлику од обичних показивача, не морате да бринете о брисању основног примерка.

note: (itstool) path: section/para
en: Of course this means that you can store <classname>RefPtr</classname>s in standard containers, such as <classname>std::vector</classname> or <classname>std::list</classname>.
sr: Наравно, ово значи да можете чувати <classname>RefPtr</classname>-ове у стандардним контејнерима, као што су <classname>std::vector</classname> или <classname>std::list</classname>.

note: (itstool) path: section/title
en: Dereferencing
sr: Дереференцирање

note: (itstool) path: section/para
en: You can dereference a smartpointer with the -&gt; operator, to call the methods of the underlying instance, just like a normal pointer.
sr: Можете дереференцирати паметни показивач помоћу оператора -&gt;, да бисте позвали методе основног примерка, баш као и код обичног показивача.

note: (itstool) path: section/para
en: You can also use the * operator and the <methodname>get()</methodname> method to access the underlying instance, but it's usually a bad idea to do so. Unless you are careful, you can end up with a pointer or a reference which is not included in the reference count.
sr: Такође можете користити оператор * и метод <methodname>get()</methodname> да приступите основној појави, али је то обично лоша идеја. Осим ако нисте пажљиви, можете завршити са показивачем или референцом која није укључена у број референци.

note: (itstool) path: section/programlisting
en: <code>auto refPixbuf = Gdk::Pixbuf::create_from_file(filename);
    auto&amp; underlying = *refPixbuf; // Possible, but not recommended
    </code>
sr: <code>auto refPixbuf = Gdk::Pixbuf::create_from_file(filename);
    auto&amp; underlying = *refPixbuf; // Могуће, али се не препоручује
    </code>

note: (itstool) path: section/title
en: Casting
sr: Промена врсте (Casting)

note: (itstool) path: section/para
en: You can cast <classname>RefPtr</classname>s to base types, just like normal pointers.
sr: Можете променити врсту <classname>RefPtr</classname>-а у основне врсте, баш као и код обичних показивача.

note: (itstool) path: section/para
en: This means that any method which takes a <type>const Glib::RefPtr&lt;BaseType&gt;&amp;</type> argument can also take a <type>const Glib::RefPtr&lt;DerivedType&gt;&amp;</type>. The cast is implicit, just as it would be for a normal pointer.
sr: Ово значи да било који метод који прима аргумент <type>const Glib::RefPtr&lt;BaseType&gt;&amp;</type> такође може примити и <type>const Glib::RefPtr&lt;DerivedType&gt;&amp;</type>. Промена врсте је имплицитна, баш као што би била за обичан показивач.

note: (itstool) path: section/para
en: You can also cast to a derived type, but the syntax is a little different than with a normal pointer.
sr: Такође можете променити врсту у изведену врсту, али је синтакса мало другачија него код обичног показивача.

note: (itstool) path: section/title
en: Checking for nullptr
sr: Проверавање за nullptr

note: (itstool) path: section/para
en: Just like normal pointers, you can check whether a <classname>RefPtr</classname> points to anything.
sr: Баш као и код обичних показивача, можете проверити да ли <classname>RefPtr</classname> показује на било шта.

note: (itstool) path: section/para
en: But unlike normal pointers, <classname>RefPtr</classname>s are automatically initialized to <literal>nullptr</literal> so you don't need to remember to do that yourself.
sr: Али за разлику од обичних показивача, <classname>RefPtr</classname>-ови се аутоматски покрећу на <literal>nullptr</literal> тако да не морате сами да се сећате да то урадите.

note: (itstool) path: section/title
en: Constness
sr: Константност

note: (itstool) path: section/para
en: The use of the <literal>const</literal> keyword in <phrase role="nowrap">C++</phrase> is not always clear. You might not realize that <type>const Something*</type> declares a pointer to a <type>const Something</type>. The pointer can be changed, but not the <type>Something</type> that it points to.
sr: Употреба кључне речи <literal>const</literal> у <phrase role="nowrap">C++</phrase>-у није увек јасна. Можда нећете схватити да <type>const Something*</type> објављује показивач на <type>const Something</type>. Показивач се може изменити, али не и <type>Something</type> на који он показује.

note: (itstool) path: section/para
en: Therefore, the <classname>RefPtr</classname> equivalent of <type>Something*</type> for a method parameter is <type>const Glib::RefPtr&lt;Something&gt;&amp;</type>, and the equivalent of <type>const Something*</type> is <type>const Glib::RefPtr&lt;const Something&gt;&amp;</type>.
sr: Стога је <classname>RefPtr</classname> еквивалент за <type>Something*</type> за параметар метода <type>const Glib::RefPtr&lt;Something&gt;&amp;</type>, а еквивалент за <type>const Something*</type> је <type>const Glib::RefPtr&lt;const Something&gt;&amp;</type>.

note: (itstool) path: section/para
en: The <literal>const ... &amp;</literal> around both is just for efficiency, like using <classname>const std::string&amp;</classname> instead of <classname>std::string</classname> for a method parameter to avoid unnecessary copying.
sr: Окружење <literal>const ... &amp;</literal> код оба је само због ефикасности, попут коришћења <classname>const std::string&amp;</classname> уместо <classname>std::string</classname> за параметар метода како би се избегло непотребно умножавање.

note: (itstool) path: section/title
en: Connecting signal handlers
sr: Повезивање руковалаца сигналима

note: (itstool) path: section/para
en: <application>gtkmm</application> widget classes have signal accessor methods, such as <methodname>Gtk::Button::signal_clicked()</methodname>, which allow you to connect your signal handler. Thanks to the flexibility of <application>libsigc++</application>, the callback library used by <application>gtkmm</application>, the signal handler can be almost any kind of function, but you will probably want to use a class method. Among <application>GTK</application> C coders, these signal handlers are often named callbacks.
sr: Разреди <application>gtkmm</application> елемената имају методе за приступ сигналима, као што је <methodname>Gtk::Button::signal_clicked()</methodname>, који вам омогућавају да повежете ваш руковалац сигналом. Захваљујући флексибилности библиотеке <application>libsigc++</application>, библиотеке повратних позива коју користи <application>gtkmm</application>, руковалац сигналом може бити скоро било која врста функције, али ћете вероватно желети да користите метод разреда. Међу <application>GTK</application> C програмерима, ови руковаоци сигналима се често називају повратни позиви (callbacks).

note: (itstool) path: section/para
en: Here's an example of a signal handler being connected to a signal:
sr: Ево примера руковаоца сигналом који се повезује на сигнал:

note: (itstool) path: section/para
en: There's rather a lot to think about in this (non-functional) code. First let's identify the parties involved:
sr: У овом (нефункционалном) коду има доста тога за размишљање. Прво идентификујмо укључене стране:

note: (itstool) path: listitem/para
en: The signal handler is <methodname>on_button_clicked()</methodname>.
sr: Руковалац сигналом је <methodname>on_button_clicked()</methodname>.

note: (itstool) path: listitem/para
en: We're hooking it up to the <classname>Gtk::Button</classname> object called <varname>button</varname>.
sr: Повезујемо га са објектом <classname>Gtk::Button</classname> под називом <varname>button</varname>.

note: (itstool) path: listitem/para
en: When the Button emits its <literal>clicked</literal> signal, <methodname>on_button_clicked()</methodname> will be called.
sr: Када дугме емитује свој сигнал <literal>clicked</literal>, биће позвана функција <methodname>on_button_clicked()</methodname>.

note: (itstool) path: section/para
en: Now let's look at the connection again:
sr: Погледајмо сада поново везу:

note: (itstool) path: section/para
en: Note that we don't pass a pointer to <methodname>on_button_clicked()</methodname> directly to the signal's <methodname>connect()</methodname> method. Instead, we call <function>sigc::ptr_fun()</function>, and pass the result to <methodname>connect()</methodname>.
sr: Имајте на уму да показивач на <methodname>on_button_clicked()</methodname> не прослеђујемо директно методу <methodname>connect()</methodname> сигнала. Уместо тога, позивамо <function>sigc::ptr_fun()</function> и прослеђујемо резултат методу <methodname>connect()</methodname>.

note: (itstool) path: section/para
en: <function>sigc::ptr_fun()</function> generates a <classname>sigc::slot</classname>. A slot is an object which looks and feels like a function, but is actually an object. These are also known as function objects, or functors. <function>sigc::ptr_fun()</function> generates a slot for a standalone function or static method. <function>sigc::mem_fun()</function> generates a slot for a member method of a particular instance.
sr: <function>sigc::ptr_fun()</function> генерише <classname>sigc::slot</classname>. Слот је објекат који изгледа и понаша се као функција, али је заправо објекат. Они су такође познати као функцијски објекти или функтори. <function>sigc::ptr_fun()</function> генерише слот за самосталну функцију или статички метод. <function>sigc::mem_fun()</function> генерише слот за метод члана одређеног примерка.

note: (itstool) path: section/para
en: A <phrase role="nowrap">C++</phrase> lambda expression is a functor which can be implicitly converted to a <classname>sigc::slot</classname> in the call to <methodname>connect()</methodname>. A lambda expression can be used instead of <function>sigc::ptr_fun()</function>. It's also possible to use a lambda expression instead of <function>sigc::mem_fun()</function>, but then you won't get automatic disconnection of the signal handler when a <classname>sigc::trackable</classname>-derived object goes out of scope.
sr: <phrase role="nowrap">C++</phrase> ламбда израз је функтор који се може имплицитно конвертовати у <classname>sigc::slot</classname> у позиву <methodname>connect()</methodname>. Ламбда израз се може користити уместо <function>sigc::ptr_fun()</function>. Такође је могуће користити ламбда израз уместо <function>sigc::mem_fun()</function>, али тада нећете добити аутоматско раскидање везе руковаоца сигналом када објекат изведен из <classname>sigc::trackable</classname> изађе из опсега.

note: (itstool) path: section/para
en: Here's a slightly larger example of slots in action:
sr: Ево нешто већег примера слотова на делу:

note: (itstool) path: section/para
en: The first call to <methodname>connect()</methodname> is just like the one we saw last time; nothing new here.
sr: Први позив <methodname>connect()</methodname> је баш као онај који смо видели прошли пут; овде нема ничег новог.

note: (itstool) path: section/para
en: The next is more interesting. <function>sigc::mem_fun()</function> is called with two arguments. The first argument is <parameter>*this</parameter>, which is the object that our new slot will be pointing at. The second argument is a pointer to one of its methods. This particular version of <function>sigc::mem_fun()</function> creates a slot which will, when "called", call the pointed-to method of the specified object.
sr: Следећи је занимљивији. <function>sigc::mem_fun()</function> се позива са два аргумента. Први аргумент је <parameter>*this</parameter>, што је објекат на који ће наш нови слот показивати. Други аргумент је показивач на један од његових метода. Ова конкретна верзија <function>sigc::mem_fun()</function> прави слот који ће, када буде „позван“, позвати наведени метод наведеног објекта.

note: (itstool) path: section/para
en: Another thing to note about this example is that we made the call to <methodname>connect()</methodname> twice for the same signal object. This is perfectly fine - when the button is clicked, both signal handlers will be called.
sr: Још једна ствар коју треба приметити у вези са овим примером је да смо два пута позвали <methodname>connect()</methodname> за исти објекат сигнала. Ово је сасвим у реду — када се кликне на дугме, биће позвана оба руковаоца сигналом.

note: (itstool) path: section/para
en: We just told you that the button's <literal>clicked</literal> signal is expecting to call a method with no arguments. All signals have requirements like this - you can't hook a function with two arguments to a signal expecting none (unless you use an adapter, such as <function>sigc::bind()</function>, of course). Therefore, it's important to know what type of signal handler you'll be expected to connect to a given signal.
sr: Управо смо вам рекли да сигнал дугмета <literal>clicked</literal> очекује позив метода без аргумената. Сви сигнали имају овакве захтеве — не можете повезати функцију са два аргумента на сигнал који не очекује ниједан (осим ако наравно не користите адаптер, као што је <function>sigc::bind()</function>). Стога је важно знати који тип руковаоца сигналом ће се очекивати да повежете са датим сигналом.

note: (itstool) path: section/title
en: Writing signal handlers
sr: Писање руковалаца сигналима

note: (itstool) path: section/para
en: To find out what type of signal handler you can connect to a signal, you can look it up in the reference documentation or the header file. Here's an example of a signal declaration you might see in the <application>gtkmm</application> headers:
sr: Да бисте сазнали који тип руковаоца сигналом можете да повежете са сигналом, можете га потражити у референтној документацији или у датотеци заглавља. Ево примера декларације сигнала коју бисте могли видети у <application>gtkmm</application> заглављима:

note: (itstool) path: section/para
en: Other than the signal's name (<literal>focus</literal>), the template arguments are important to note here. The first argument, <type>bool</type>, is the type that the signal handler should return; and the type within parentheses, <type>Gtk::DirectionType</type>, is the type of this signal's first, and only, argument. By looking at the reference documentation, you can see the names of the arguments too.
sr: Осим имена сигнала (<literal>focus</literal>), овде је важно приметити аргументе шаблона. Први аргумент, <type>bool</type>, је тип који руковалац сигналом треба да врати; а тип унутар заграда, <type>Gtk::DirectionType</type>, је тип првог и јединог аргумента овог сигнала. Гледајући референтну документацију, можете видети и имена аргумената.

note: (itstool) path: section/para
en: The same principles apply for signals which have more arguments. Here's one with three (taken from <filename>&lt;gtkmm/textbuffer.h&gt;</filename>):
sr: Исти принципи важе и за сигнале који имају више аргумената. Ево једног са три (преузето из <filename>&lt;gtkmm/textbuffer.h&gt;</filename>):

note: (itstool) path: section/para
en: It follows the same form. The first type is <type>void</type>, so that should be our signal handler's return type. The following three types are the argument types, in order. Our signal handler's prototype could look like this:
sr: Прати исти облик. Први тип је <type>void</type>, тако да би то требало да буде повратни тип нашег руковаоца сигналом. Следећа три типа су типови аргумената, по реду. Прототип нашег руковаоца сигналом би могао изгледати овако:

note: (itstool) path: section/title
en: Disconnecting signal handlers
sr: Прекидање везе руковалаца сигналима

note: (itstool) path: section/para
en: Let's take another look at a Signal's <literal>connect</literal> method:
sr: Погледајмо још једном метод <literal>connect</literal> сигнала:

note: (itstool) path: section/para
en: The returned <classname>sigc::connection</classname> can be used to control the connection. By keeping a connection object you can disconnect its associated signal handler using the <methodname>sigc::connection::disconnect()</methodname> method.
sr: Враћени <classname>sigc::connection</classname> се може користити за управљање везом. Чувањем објекта везе можете прекинути везу његовог придруженог руковаоца сигналом коришћењем метода <methodname>sigc::connection::disconnect()</methodname>.

note: (itstool) path: section/title
en: Overriding default signal handlers
sr: Преклапање подразумеваних руковалаца сигналима

note: (itstool) path: section/para
en: So far we've told you to perform actions in response to button-presses and the like by handling signals. That's certainly a good way to do things, but it's not the only way.
sr: До сада смо вам говорили да извршавате радње као одговор на притиске дугмади и слично руковањем сигналима. То је свакако добар начин за обављање ствари, али није и једини.

note: (itstool) path: section/para
en: Instead of laboriously connecting signal handlers to signals, you can simply make a new class which inherits from a widget - say, a Button - and then override the default signal handler, such as Button::on_clicked(). This can be a lot simpler than hooking up signal handlers for everything.
sr: Уместо мукотрпног повезивања руковалаца сигналима са сигналима, можете једноставно направити нову класу која наслеђује елемент — рецимо, дугме (Button) — а затим преклопити подразумевани руковалац сигналом, као што је Button::on_clicked(). Ово може бити много једноставније од повезивања руковалаца сигналима за све.

note: (itstool) path: section/para
en: Subclassing isn't always the best way to accomplish things. It is only useful when you want the widget to handle its own signal by itself. If you want some other class to handle the signal then you'll need to connect a separate handler. This is even more true if you want several objects to handle the same signal, or if you want one signal handler to respond to the same signal from different objects.
sr: Прављење подкласа није увек најбољи начин за постизање ствари. Корисно је само када желите да елемент сам рукује својим сигналом. Ако желите да нека друга класа рукује сигналом, мораћете да повежете посебан руковалац. Ово је још тачније ако желите да неколико објеката рукује истим сигналом, или ако желите да један руковалац сигналом одговара на исти сигнал из различитих објеката.

note: (itstool) path: section/para
en: <application>gtkmm</application> classes are designed with overriding in mind; they contain virtual member methods specifically intended to be overridden.
sr: Класе <application>gtkmm</application>-а су дизајниране имајући на уму преклапање; оне садрже виртуелне методе чланице посебно намењене преклапању.

note: (itstool) path: section/para
en: Let's look at an example of overriding:
sr: Погледајмо пример преклапања:

note: (itstool) path: section/para
en: Here we define a new class called <classname>OverriddenButton</classname>, which inherits from <classname>Gtk::Button</classname>. The only thing we change is the <methodname>on_clicked()</methodname> method, which is called whenever <classname>Gtk::Button</classname> emits the <literal>clicked</literal> signal. This method prints "Hello World" to <literal>stdout</literal>, and then calls the original, overridden method, to let <classname>Gtk::Button</classname> do what it would have done had we not overridden.
sr: Овде дефинишемо нову класу под називом <classname>OverriddenButton</classname>, која наслеђује <classname>Gtk::Button</classname>. Једина ствар коју мењамо је метод <methodname>on_clicked()</methodname>, који се позива кад год <classname>Gtk::Button</classname> емитује сигнал <literal>clicked</literal>. Овај метод исписује „Hello World“ на <literal>stdout</literal>, а затим позива оригинални, преклопљени метод, како би омогућио да <classname>Gtk::Button</classname> уради оно што би урадио да нисмо извршили преклапање.

note: (itstool) path: section/para
en: You don't always need to call the parent's method; there are times when you might not want to. Note that we called the parent method <emphasis>after</emphasis> writing "Hello World", but we could have called it before. In this simple example, it hardly matters much, but there are times when it will. With connected signal handlers, it's not quite so easy to change details like this, and you can do something here which you can't do at all with connected signal handlers: you can call the parent method in the <emphasis>middle</emphasis> of your custom code.
sr: Не морате увек да позивате родитељски метод; постоје тренуци када то можда нећете желети. Имајте на уму да смо позвали родитељски метод <emphasis>након</emphasis> исписивања „Hello World“, али смо могли да га позовемо и пре. У овом једноставном примеру то једва да је битно, али постоје тренуци када ће бити. Са повезаним руковаоцима сигналима није баш тако лако променити овакве детаље, а овде можете урадити нешто што уопште не можете са повезаним руковаоцима сигналима: можете позвати родитељски метод у <emphasis>средини</emphasis> свог прилагођеног кода.

note: (itstool) path: section/title
en: Binding extra arguments
sr: Везивање додатних аргумената

note: (itstool) path: section/para
en: If you use one signal handler to catch the same signal from several widgets, you might like that signal handler to receive some extra information. For instance, you might want to know which button was clicked. You can do this with <function>sigc::bind()</function>. Here's some code from the <link linkend="sec-helloworld2">helloworld2</link> example.
sr: Ако користите један руковалац сигналом за хватање истог сигнала из неколико елемената, можда ћете желети да тај руковалац сигналом прими неке додатне информације. На пример, можда ћете желети да знате које дугме је кликнуто. То можете урадити помоћу <function>sigc::bind()</function>. Ево неког кода из примера <link linkend="sec-helloworld2">helloworld2</link>.

note: (itstool) path: section/para
en: This says that we want the signal to send an extra <classname>Glib::ustring</classname> argument to the signal handler, and that the value of that argument should be "button 1". Of course we will need to add that extra argument to the declaration of our signal handler:
sr: Ово каже да желимо да сигнал пошаље додатни <classname>Glib::ustring</classname> аргумент руковаоцу сигнала, и да вредност тог аргумента треба да буде „button 1“. Наравно, мораћемо да додамо тај додатни аргумент у декларацију нашег руковаоца сигнала:

note: (itstool) path: section/para
en: Of course, a normal "clicked" signal handler would have no arguments.
sr: Наравно, обичан руковалац сигнала „clicked“ не би имао аргументе.

note: (itstool) path: section/para
en: <function>sigc::bind()</function> is not commonly used, but you might find it helpful sometimes. If you are familiar with <application>GTK</application> programming then you have probably noticed that this is similar to the extra <literal>gpointer data</literal> arguments which all GTK callbacks have. This is generally overused in <application>GTK</application> to pass information that should be stored as member data in a derived widget, but widget derivation is very difficult in C. We have far less need of this hack in <application>gtkmm</application>.
sr: <function>sigc::bind()</function> се не користи често, али вам понекад може бити од користи. Ако сте упознати са <application>GTK</application> програмирањем, вероватно сте приметили да је ово слично додатним <literal>gpointer data</literal> аргументима које имају сви GTK повратни позиви. Ово се углавном превише користи у <application>GTK</application>-у за пренос информација које би требало да буду сачуване као подаци чланови у изведеном елементу, али је извођење елемената веома тешко у C-у. У <application>gtkmm</application>-у имамо далеко мању потребу за овим триком.

note: (itstool) path: section/title
en: Event signals
sr: Сигнали догађаја

note: (itstool) path: section/para
en: Event signals are emitted as a result of some user input, for instance a key press or a mouse motion. Usually you don't handle these events directly. Instead, you use a subclass of <classname>Gtk::EventController</classname>, such as <classname>Gtk::EventControllerKey</classname> or <classname>Gtk::GestureClick</classname>. Event controllers can be added to a widget with <methodname>Gtk::Widget::add_controller()</methodname>.
sr: Сигнали догађаја се емитују као резултат неког корисничког уноса, на пример притиска тастера или померања миша. Обично не рукујете овим догађајима директно. Уместо тога, користите подразред <classname>Gtk::EventController</classname>-а, као што су <classname>Gtk::EventControllerKey</classname> или <classname>Gtk::GestureClick</classname>. Управљачи догађајима се могу додати елементу помоћу <methodname>Gtk::Widget::add_controller()</methodname>.

note: (itstool) path: section/para
en: You might occasionally find it useful to handle events when there's something you can't accomplish with normal signals. <classname>Gtk::Button</classname>, for example, does not send mouse-pointer coordinates with its <literal>clicked</literal> signal, but you could handle <methodname>Gtk::GestureClick::signal_pressed()</methodname> if you needed this information. <methodname>Gtk::EventControllerKey::signal_key_pressed()</methodname> is often used to handle key-presses.
sr: Повремено вам може бити корисно да рукујете догађајима када постоји нешто што не можете постићи обичним сигналима. <classname>Gtk::Button</classname>, на пример, не шаље координате показивача миша са својим сигналом <literal>clicked</literal>, али бисте могли да рукујете са <methodname>Gtk::GestureClick::signal_pressed()</methodname> ако су вам потребни ови подаци. <methodname>Gtk::EventControllerKey::signal_key_pressed()</methodname> се често користи за руковање притисцима тастера.

note: (itstool) path: section/para
en: Some event controller signals behave slightly differently. The value returned from the signal handler indicates whether it has fully "handled" the event. If the value is <literal>false</literal> then <application>gtkmm</application> will pass the event on to the next signal handler. If the value is <literal>true</literal> then no other signal handlers will need to be called.
sr: Неки сигнали управљача догађајима се понашају мало другачије. Вредност коју враћа руковалац сигнала указује на то да ли је он у потпуности „обрадио“ догађај. Ако је вредност <literal>false</literal>, тада ће <application>gtkmm</application> проследити догађај следећем руковаоцу сигнала. Ако је вредност <literal>true</literal>, тада неће бити потребно позивати друге руковаоце сигнала.

note: (itstool) path: section/para
en: Handling an event doesn't affect the Widget's other signals. If you handle <methodname>Gtk::GestureClick::signal_pressed()</methodname> for <classname>Gtk::Button</classname>, you'll still be able to get the <literal>clicked</literal> signal. They are emitted at (nearly) the same time.
sr: Руковање догађајем не утиче на остале сигнале елемента. Ако рукујете са <methodname>Gtk::GestureClick::signal_pressed()</methodname> за <classname>Gtk::Button</classname>, и даље ћете моћи да добијете сигнал <literal>clicked</literal>. Они се емитују у (скоро) исто време.

note: (itstool) path: section/para
en: When the mouse is over the button and a mouse button is pressed, <methodname>on_button_press()</methodname> will be called.
sr: Када је миш изнад дугмета и притисне се тастер миша, биће позвано <methodname>on_button_press()</methodname>.

note: (itstool) path: section/para
en: The call to <methodname>set_propagation_phase()</methodname> is necessary in this case because the <classname>GtkButton</classname> C class adds an event controller, handling button clicks in the capture phase. <classname>GtkButton</classname> claims the event, meaning that the event is not propagated in the bubble phase, where event controllers handle events by default.
sr: Позив <methodname>set_propagation_phase()</methodname> је неопходан у овом случају јер C класа <classname>GtkButton</classname> додаје управљач догађајима, рукујући кликовима дугмета у фази хватања (capture phase). <classname>GtkButton</classname> заузима догађај, што значи да се догађај не шири у фази мехура (bubble phase), где управљачи догађајима подразумевано рукују догађајима.

note: (itstool) path: section/title
en: Signal Handler sequence
sr: Редослед руковаоца сигнала

note: (itstool) path: section/para
en: By default, signal handlers that return <type>void</type> are called after any previously-connected signal handlers. However, this can be a problem with event signals that can stop event propagation by returning <literal>true</literal>. For instance, the existing signal handlers, or the default signal handler, might return <literal>true</literal> to stop other signal handlers from being called. To specify that your signal handler should be called before the other signal handlers, you can specify <literal>false</literal> for the <literal>after</literal> parameter. This <methodname>connect()</methodname> parameter is optional, if the signal handler returns <type>void</type>. For instance,
sr: Подразумевано, руковаоци сигнала који враћају <type>void</type> се позивају након свих претходно повезаних руковаоца сигнала. Међутим, ово може бити проблем са сигналима догађаја који могу зауставити ширење догађаја враћањем вредности <literal>true</literal>. На пример, постојећи руковаоци сигнала, или подразумевани руковалац сигнала, могу вратити <literal>true</literal> како би спречили позивање других руковаоца сигнала. Да бисте навели да ваш руковалац сигнала треба да буде позван пре осталих руковаоца сигнала, можете навести <literal>false</literal> за параметар <literal>after</literal>. Овај параметар функције <methodname>connect()</methodname> је опционалан ако руковалац сигнала враћа <type>void</type>. На пример,

note: (itstool) path: section/para
en: The event is propagated between widgets in 3 phases. <_:orderedlist-1/>
sr: Догађај се шири између елемената у 3 фазе. <_:orderedlist-1/>

note: (itstool) path: section/para
en: The <link xlink:href="https://docs.gtk.org/gtk4/input-handling.html">Input Handling</link> chapter in the GTK documentation describes user input handling in more detail.
sr: Поглавље <link xlink:href="https://docs.gtk.org/gtk4/input-handling.html">Руковање улазом</link> у GTK документацији детаљније описује руковање корисничким уносом.

note: (itstool) path: section/title
en: Exceptions in signal handlers
sr: Изузеци у руковаоцима сигнала

note: (itstool) path: section/para
en: When a program is aborted because of an unhandled <phrase role="nowrap">C++</phrase> exception, it's sometimes possible to use a debugger to find the location where the exception was thrown. This is more difficult than usual if the exception was thrown from a signal handler.
sr: Када се програм прекине због необрађеног <phrase role="nowrap">C++</phrase> изузетка, понекад је могуће користити исправљач грешака (debugger) за проналажење места где је изузетак избачен. Ово је теже него обично ако је изузетак избачен из руковаоца сигнала.

note: (itstool) path: section/para
en: This section describes primarily what you can expect on a Linux system, when you use <link xlink:href="http://www.gnu.org/software/gdb/">the gdb debugger</link>.
sr: Овај одељак првенствено описује шта можете очекивати на Линукс систему када користите <link xlink:href="http://www.gnu.org/software/gdb/">gdb исправљач грешака</link>.

note: (itstool) path: section/para
en: First, let's look at a simple example where an exception is thrown from a normal function (no signal handler).
sr: Прво, погледајмо једноставан пример где је изузетак избачен из обичне функције (без руковаоца сигналом).

note: (itstool) path: section/programlisting
en: <code>// without_signal.cc
    #include &lt;gtkmm.h&gt;
    
    bool throwSomething()
    {
      throw "Something";
      return true;
    }
    
    int main(int argc, char** argv)
    {
      throwSomething();
      auto app = Gtk::Application::create("org.gtkmm.without_signal");
      return app-&gt;run();
    }
    </code>
sr: refs: C/index-in.docbook:9330 | flags: no-wrap | notes: (itstool) path: section/programlisting

note: (itstool) path: section/para
en: Here is an excerpt from a <application>gdb</application> session. Only the most interesting parts of the output are shown.
sr: Ево исечка из <application>gdb</application> сесије. Приказани су само најзанимљивији делови излаза.

note: (itstool) path: section/para
en: You can see that the exception was thrown from <filename>without_signal.cc</filename>, line 6 (<code>throw "Something";</code>).
sr: Можете видети да је изузетак избачен из <filename>without_signal.cc</filename>, линија 6 (<code>throw "Something";</code>).

note: (itstool) path: section/para
en: Now let's see what happens when an exception is thrown from a signal handler. Here's the source code.
sr: Сада да видимо шта се дешава када се изузетак избаци из руковаоца сигналом. Ево изворног кода.

note: (itstool) path: section/para
en: And here's an excerpt from a <application>gdb</application> session.
sr: А ево исечка из <application>gdb</application> сесије.

note: (itstool) path: section/para
en: The exception is caught in <application>glibmm</application>, and the program ends with a call to <function>g_error()</function>. Other exceptions may result in different behavior, but in any case the exception from a signal handler is caught in <application>glibmm</application> or <application>gtkmm</application>, and <application>gdb</application> can't see where it was thrown.
sr: Изузетак је ухваћен у <application>glibmm</application>-у, а програм се завршава позивом функције <function>g_error()</function>. Остали изузеци могу резултирати другачијим понашањем, али у сваком случају изузетак из руковаоца сигналом је ухваћен у <application>glibmm</application>-у или <application>gtkmm</application>-у, а <application>gdb</application> не може да види где је избачен.

note: (itstool) path: section/para
en: To see where the exception is thrown, you can use the <application>gdb</application> command <userinput>catch throw</userinput>.
sr: Да бисте видели где је изузетак избачен, можете користити <application>gdb</application> наредбу <userinput>catch throw</userinput>.

note: (itstool) path: section/para
en: If there are many caught exceptions before the interesting uncaught one, this method can be tedious. It can be automated with the following <application>gdb</application> commands.
sr: Ако има много ухваћених изузетака пре занимљивог неухваћеног, овај метод може бити заморан. Може се аутоматизовати следећим <application>gdb</application> наредбама.

note: (itstool) path: section/programlisting
en: <code>(gdb) catch throw
    (gdb) commands
    (gdb)   backtrace
    (gdb)   continue
    (gdb)   end
    (gdb) set pagination off
    (gdb) run
    </code>
sr: refs: C/index-in.docbook:9429 | flags: no-wrap | notes: (itstool) path: section/programlisting

note: (itstool) path: section/para
en: These commands will print a backtrace from each <code>throw</code> and continue. The backtrace from the last (or possibly the last but one) <code>throw</code> before the program stops, is the interesting one.
sr: Ове наредбе ће исписати бектрејс из сваког <code>throw</code> и наставити. Бектрејс из последњег (или можда претпоследњег) <code>throw</code> пре него што се програм заустави је онај занимљив.

note: (itstool) path: appendix/title
en: Creating your own signals
sr: Прављење сопствених сигнала

note: (itstool) path: appendix/para
en: Now that you've seen signals and signal handlers in <application>gtkmm</application>, you might like to use the same technique to allow interaction between your own classes. That's actually very simple by using the <application>libsigc++</application> library directly.
sr: Сада када сте видели сигнале и руковаоце сигналима у <application>gtkmm</application>-у, можда ћете желети да користите исту технику да омогућите интеракцију између сопствених класа. То је заправо врло једноставно коришћењем библиотеке <application>libsigc++</application> директно.

note: (itstool) path: appendix/para
en: This isn't purely a <application>gtkmm</application> or GUI issue. <application>gtkmm</application> uses <application>libsigc++</application> to implement its proxy wrappers for the <application>GTK</application> signal system, but for new, non-GTK signals, you can create pure <phrase role="nowrap">C++</phrase> signals, using the <classname>sigc::signal&lt;&gt;</classname> template.
sr: Ово није чисто <application>gtkmm</application> или GUI питање. <application>gtkmm</application> користи <application>libsigc++</application> за имплементацију својих прокси омотача за <application>GTK</application> систем сигнала, али за нове, не-GTK сигнале, можете направити чисте <phrase role="nowrap">C++</phrase> сигнале, користећи <classname>sigc::signal&lt;&gt;</classname> шаблон.

note: (itstool) path: appendix/para
en: For instance, to create a signal that sends 2 parameters, a <type>bool</type> and an <type>int</type>, just declare a <classname>sigc::signal</classname>, like so:
sr: На пример, да бисте направили сигнал који шаље 2 параметра, <type>bool</type> и <type>int</type>, само објавите <classname>sigc::signal</classname>, овако:

note: (itstool) path: appendix/programlisting
en: <code>sigc::signal&lt;void(bool, int)&gt; signal_something;
    </code>
sr: refs: C/index-in.docbook:9466 | flags: no-wrap | notes: (itstool) path: appendix/programlisting

note: (itstool) path: appendix/para
en: You could just declare that signal as a public member variable, but some people find that distasteful and prefer to make it available via an accessor method, like so:
sr: Могли бисте само декларисати тај сигнал као јавну променљиву чланицу, али неки људи то сматрају неукусним и више воле да га учине доступним преко приступне методе, овако:

note: (itstool) path: appendix/para
en: You can then connect to the signal using the same syntax used when connecting to <application>gtkmm</application> signals. For instance,
sr: Затим се можете повезати на сигнал користећи исту синтаксу која се користи при повезивању на <application>gtkmm</application> сигнале. На пример,

note: (itstool) path: appendix/programlisting
en: <code>server.signal_something().connect(
      sigc::mem_fun(client, &amp;Client::on_server_something) );
    </code>
sr: refs: C/index-in.docbook:9494 | flags: no-wrap | notes: (itstool) path: appendix/programlisting

note: (itstool) path: section/para
en: This is a full working example that defines and uses custom signals.
sr: Ово је потпуно функционалан пример који дефинише и користи прилагођене сигнале.

note: (itstool) path: section/para
en: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/signals/custom/">Source Code</link>
sr: <link xlink:href="https://gitlab.gnome.org/GNOME/gtkmm-documentation/tree/master/examples/book/signals/custom/">Изворни код</link>

note: (itstool) path: appendix/title
en: Comparison with other signalling systems
sr: Поређење са другим системима сигнализације

note: (itstool) path: appendix/para
en: (An aside: <application>GTK</application> calls this scheme "signalling"; the sharp-eyed reader with GUI toolkit experience will note that this same design is often seen under the name of "broadcaster-listener" (e.g., in Metrowerks' PowerPlant framework for the Macintosh). It works in much the same way: one sets up <literal>broadcasters</literal>, and then connects <literal>listeners</literal> to them; the broadcaster keeps a list of the objects listening to it, and when someone gives the broadcaster a message, it calls all of its objects in its list with the message. In <application>gtkmm</application>, signal objects play the role of broadcasters, and slots play the role of listeners - sort of. More on this later.)
sr: (Напомена: <application>GTK</application> назива ову шему „сигнализацијом“; пажљиви читалац са искуством у GUI скуповима алата приметиће да се овај исти дизајн често среће под називом „емитер-слушалац“ (нпр. у Metrowerks-овом PowerPlant оквиру за Мекинтош). Ради на веома сличан начин: постављају се <literal>емитери</literal>, а затим се на њих повезују <literal>слушаоци</literal>; емитер чува списак објеката који га слушају, и када неко пошаље поруку емитеру, он позива све своје објекте на списку са том поруком. У <application>gtkmm</application>-у, објекти сигнала играју улогу емитера, а слотови играју улогу слушалаца — донекле. Више о овоме касније.)

note: (itstool) path: appendix/para
en: <application>gtkmm</application> signal handlers are strongly-typed, whereas <application>GTK</application> C code allows you to connect a callback with the wrong number and type of arguments, leading to a segfault at runtime. And, unlike <application>Qt</application>, <application>gtkmm</application> achieves this without modifying the <phrase role="nowrap">C++</phrase> language.
sr: Руковаоци сигналима у <application>gtkmm</application>-у су строго типизирани, док <application>GTK</application> C код дозвољава да повежете повратни позив са погрешним бројем и врстом аргумената, што доводи до сегфаулта у време извршавања. И, за разлику од <application>Qt</application>-а, <application>gtkmm</application> то постиже без мењања <phrase role="nowrap">C++</phrase> језика.

note: (itstool) path: appendix/para
en: Re. Overriding signal handlers: You can do this in the straight-C world of GTK too; that's what GTK's object system is for. But in GTK, you have to go through some complicated procedures to get object-oriented features like inheritance and overloading. In <phrase role="nowrap">C++</phrase>, it's simple, since those features are supported in the language itself; you can let the compiler do the dirty work.
sr: О заобилажењу руковалаца сигналима: Ово можете урадити и у чистом C свету GTK-а; томе и служи GTK-ов систем објеката. Али у GTK-у морате проћи кроз неке компликоване процедуре да бисте добили објектно-оријентисане функције као што су наслеђивање и преклапање. У <phrase role="nowrap">C++</phrase>-у је то једноставно, пошто су те функције подржане у самом језику; можете пустити компајлер да обави прљав посао.

note: (itstool) path: appendix/para
en: This is one of the places where the beauty of <phrase role="nowrap">C++</phrase> really comes out. One wouldn't think of subclassing a GTK widget simply to override its action method; it's just too much trouble. In GTK, you almost always use signals to get things done, unless you're writing a new widget. But because overriding methods is so easy in <phrase role="nowrap">C++</phrase>, it's entirely practical - and sensible - to subclass a button for that purpose.
sr: Ово је једно од места где лепота <phrase role="nowrap">C++</phrase>-а заиста долази до изражаја. Човек не би помислио на прављење подкласе ГТК елемента само да би преписао његов метод радње; то је једноставно превише посла. У ГТК-у скоро увек користите сигнале да бисте нешто урадили, осим ако не пишете нови елемент. Али пошто је преписивање метода тако лако у <phrase role="nowrap">C++</phrase>-у, потпуно је практично — и разумно — направити подкласу дугмета за ту сврху.

note: (itstool) path: appendix/title
en: <application>gtkmm</application> and Win32
sr: <application>gtkmm</application> и Win32

note: (itstool) path: appendix/para
en: One of the major advantages of <application>gtkmm</application> is that it is crossplatform. <application>gtkmm</application> programs written on other platforms such as GNU/Linux can generally be transferred to Windows (and vice versa) with few modifications to the source.
sr: Једна од главних предности <application>gtkmm</application>-а је то што је вишеплатформски. <application>gtkmm</application> програми написани на другим платформама као што је ГНУ/Линукс могу се углавном пренети на Виндоуз (и обрнуто) са мало измена у изворном коду.

note: (itstool) path: appendix/para
en: <application>gtkmm</application> currently works with the <link xlink:href="http://mingw.org/">MinGW/GCC compiler</link> with a compiler version that supports <phrase role="nowrap">C++17</phrase>, such as gcc 7 or later. It also works with Microsoft Visual <phrase role="nowrap">C++</phrase> 2017 15.7.x or later (including the freely available express/community editions) on the Windows platform. There is an <link xlink:href="https://download.gnome.org/binaries/win32/gtkmm">installer</link> available for <application>gtkmm</application> on Microsoft Windows, but as of this writing (December 2024) it only contains an installer for gtkmm2. Please be aware that although normally it is fine to mix builds done with Visual Studio 2017 and 2019, please do not do so when building <application>gtkmm</application> with its -mm dependencies.
sr: <application>gtkmm</application> тренутно ради са <link xlink:href="http://mingw.org/">MinGW/GCC преводиоцем</link> верзије која подржава <phrase role="nowrap">C++17</phrase>, као што је gcc 7 или новији. Такође ради са Microsoft Visual <phrase role="nowrap">C++</phrase> 2017 15.7.x или новијим (укључујући слободно доступна express/community издања) на Виндоуз платформи. Постоји <link xlink:href="https://download.gnome.org/binaries/win32/gtkmm">инсталатер</link> доступан за <application>gtkmm</application> на Мајкрософт Виндоузу, али у време писања овог текста (децембар 2024.) он садржи само инсталатер за gtkmm2. Имајте на уму да иако је обично у реду мешати градње урађене са Visual Studio 2017 и 2019, немојте то радити када градите <application>gtkmm</application> са његовим -mm зависностима.

note: (itstool) path: appendix/para
en: There are README files, describing how to build <application>gtkmm</application> and its dependencies on Windows:
sr: Постоје README датотеке које описују како да изградите <application>gtkmm</application> и његове зависности на Виндоузу:

note: (itstool) path: appendix/title
en: Working with gtkmm's Source Code
sr: Рад са изворним кодом gtkmm-а

note: (itstool) path: appendix/para
en: If you are interested in helping out with the development of <application>gtkmm</application>, or fixing a bug in <application>gtkmm</application>, you'll probably need to build the development version of <application>gtkmm</application>. However, you should not install a development version over your stable version. Instead, you should install it alongside your existing <application>gtkmm</application> installation, in a separate path.
sr: Ако сте заинтересовани да помогнете у развоју <application>gtkmm</application>-а или да исправите грешку у <application>gtkmm</application>-у, вероватно ћете морати да изградите развојну верзију <application>gtkmm</application>-а. Међутим, не би требало да инсталирате развојну верзију преко ваше стабилне верзије. Уместо тога, требало би да је инсталирате поред ваше постојеће <application>gtkmm</application> инсталације, у посебну путању.

note: (itstool) path: appendix/para
en: The easiest way to do this is using <link xlink:href="https://wiki.gnome.org/Projects/Jhbuild">jhbuild</link>. <application>jhbuild</application> is a program that makes building GNOME software much easier by calculating dependencies and building things in the correct order. This section will give a brief explanation of how to set up <application>jhbuild</application> to build and install <application>gtkmm</application> from the source repository (git). For up-to-date information on <application>jhbuild</application>, please refer to the <link xlink:href="https://gnome.pages.gitlab.gnome.org/jhbuild/">jhbuild manual</link>.
sr: Најлакши начин да то урадите је коришћењем <link xlink:href="https://wiki.gnome.org/Projects/Jhbuild">jhbuild</link>-а. <application>jhbuild</application> је програм који знатно олакшава изградњу Гном софтвера израчунавањем зависности и изградњом ствари исправним редоследом. Овај одељак ће дати кратко објашњење како да подесите <application>jhbuild</application> за изградњу и инсталацију <application>gtkmm</application>-а из ризнице изворног кода (git). За најновије информације о <application>jhbuild</application>-у, погледајте <link xlink:href="https://gnome.pages.gitlab.gnome.org/jhbuild/">jhbuild упутство</link>.

note: (itstool) path: note/para
en: Note that to build <application>gtkmm</application> from git, you'll often need to build many of its dependencies from git as well. <application>jhbuild</application> makes this easier than it would normally be, but it will take quite a while to build and install them all. You will probably encounter build problems, though these will usually be corrected quickly if you report them.
sr: Имајте на уму да ћете за изградњу <application>gtkmm</application>-а из гита често морати да изградите и многе његове зависности из гита. <application>jhbuild</application> то чини лакшим него што би иначе било, али ће бити потребно доста времена да се све изграде и инсталирају. Вероватно ћете наићи на проблеме при градњи, иако ће они обично бити брзо исправљени ако их пријавите.

note: (itstool) path: appendix/para
en: <application>gnome-build-meta</application> is an alternative to <application>jhbuild</application>. It is described at the <link xlink:href="https://wiki.gnome.org/Newcomers/BuildSystemComponent">Building system components</link> wiki page, but here we concentrate on <application>jhbuild</application>.
sr: <application>gnome-build-meta</application> је алтернатива за <application>jhbuild</application>. Описан је на вики страници <link xlink:href="https://wiki.gnome.org/Newcomers/BuildSystemComponent">Building system components</link>, али овде се концентришемо на <application>jhbuild</application>.

note: (itstool) path: section/title
en: Setting up jhbuild
sr: Подешавање jhbuild-а

note: (itstool) path: section/para
en: To set up <application>jhbuild</application>, follow the basic installation instructions from the <link xlink:href="https://gnome.pages.gitlab.gnome.org/jhbuild/">jhbuild manual</link>. After you have installed <application>jhbuild</application>, you should copy the sample <application>jhbuild</application> configuration file into your home directory by executing the following command from the <application>jhbuild</application> directory: <_:screen-1/>
sr: Да бисте подесили <application>jhbuild</application>, пратите основна упутства за инсталацију из <link xlink:href="https://gnome.pages.gitlab.gnome.org/jhbuild/">jhbuild упутства</link>. Након што инсталирате <application>jhbuild</application>, требало би да копирате пример <application>jhbuild</application> датотеке подешавања у ваш лични директоријум извршавањем следеће наредбе из <application>jhbuild</application> директоријума: <_:screen-1/>

note: (itstool) path: section/para
en: The <application>gtkmm</application> module is defined in the <filename>gnome-suites-core-deps-latest.modules</filename> moduleset. So edit your <filename>jhbuildrc</filename> file and set your moduleset setting like so:
sr: Модул <application>gtkmm</application> је дефинисан у <filename>gnome-suites-core-deps-latest.modules</filename> комплету модула. Зато уредите вашу <filename>jhbuildrc</filename> датотеку и поставите подешавање moduleset овако:

note: (itstool) path: section/para
en: After setting the correct moduleset, you need to tell <application>jhbuild</application> which module or modules to build. To build <application>gtkmm</application> and all of its dependencies, set <varname>modules</varname> like so:
sr: Након што подесите исправан скуп модула, треба да кажете <application>jhbuild</application>-у који модул или модуле да изгради. Да бисте изградили <application>gtkmm</application> и све његове зависности, подесите <varname>modules</varname> овако:

note: (itstool) path: section/para
en: You can build several modules by setting the <varname>modules</varname> variable to a meta-package, e.g. <literal>meta-gnome-core</literal>, or listing more than one module name. The <varname>modules</varname> variable specifies which modules will be built when you don't explicitly specify anything on the command line. You can always build a different moduleset later by specifying it on the commandline (e.g. <command>jhbuild build gtkmm</command>).
sr: Можете изградити неколико модула постављањем променљиве <varname>modules</varname> на мета-пакет, нпр. <literal>meta-gnome-core</literal>, или навођењем више од једног назива модула. Променљива <varname>modules</varname> одређује који ће модули бити изграђени када ништа изричито не наведете у линији наредби. Касније увек можете изградити другачији скуп модула тако што ћете га навести у линији наредби (нпр. <command>jhbuild build gtkmm</command>).

note: (itstool) path: important/title
en: Setting a prefix
sr: Постављање префикса

note: (itstool) path: important/para
en: By default, <application>jhbuild</application>'s configuration is configured to install all software built with <application>jhbuild</application> under the <filename>~/jhbuild/install</filename> prefix. You can choose a different prefix, but it is recommended that you keep this prefix different from other software that you've installed (don't set it to <filename>/usr</filename>!) If you've followed the jhbuild instructions then this prefix belongs to your user, so you don't need to run jhbuild as <literal>root</literal>.
sr: По подразумеваним поставкама, <application>jhbuild</application> је подешен да инсталира сав софтвер изграђен помоћу <application>jhbuild</application>-а под префиксом <filename>~/jhbuild/install</filename>. Можете изабрати другачији префикс, али се препоручује да овај префикс буде другачији од осталог софтвера који сте инсталирали (немојте га поставити на <filename>/usr</filename>!). Ако сте пратили упутства за jhbuild, онда овај префикс припада вашем кориснику, тако да не морате да покрећете jhbuild као <literal>root</literal>.

note: (itstool) path: section/para
en: You should also set <varname>buildroot</varname> in <filename>jhbuildrc</filename>. <application>jhbuild</application> builds <application>gtkmm</application> and many of its dependencies with Meson. Meson does not allow building in the source tree. <application>jhbuild</application>'s default action is to build in a <filename>build</filename> directory directly below the source root directory. Some modules have a <filename>build</filename> directory with files used when building with Autotools. Those files can be destroyed if you let <application>jhbuild</application> build in that directory.
sr: Такође би требало да подесите <varname>buildroot</varname> у <filename>jhbuildrc</filename>. <application>jhbuild</application> изграђује <application>gtkmm</application> и многе његове зависности помоћу Мезона. Мезон не дозвољава изградњу унутар самог изворног стабла. Подразумевана радња <application>jhbuild</application>-а је изградња у директоријуму <filename>build</filename> који се налази непосредно испод корена изворног кода. Неки модули имају директоријум <filename>build</filename> са датотекама које се користе приликом изградње помоћу Autotools-а. Те датоке могу бити уништене ако дозволите <application>jhbuild</application>-у да гради у том директоријуму.

note: (itstool) path: section/para
en: When you downloaded <application>jhbuild</application> from the git repository, you got a number of <filename>.modules</filename> files, specifying dependencies between modules. By default <application>jhbuild</application> does not use the downloaded versions of these files, but reads the latest versions in the git repository. This is usually what you want. If you don't want it, use the <varname>use_local_modulesets</varname> variable in <filename>jhbuildrc</filename>.
sr: Када сте преузели <application>jhbuild</application> из гит ризнице, добили сте одређени број <filename>.modules</filename> датотека које одређују зависности између модула. По подразумеваним поставкама <application>jhbuild</application> не користи преузете верзије ових датотека, већ чита најновије верзије из гит ризнице. Ово је обично оно што желите. Ако то не желите, користите променљиву <varname>use_local_modulesets</varname> у <filename>jhbuildrc</filename>.

note: (itstool) path: section/title
en: Installing and Using the git version of <application>gtkmm</application>
sr: Инсталирање и коришћење гит верзије <application>gtkmm</application>-а

note: (itstool) path: section/para
en: Once you've configured <application>jhbuild</application> as described above, building <application>gtkmm</application> should be relatively straightforward. The first time you run <application>jhbuild</application>, you should run the following sequence of commands to ensure that <application>jhbuild</application> has the required tools and verify that it is set up correctly: <_:screen-1/>
sr: Након што подесите <application>jhbuild</application> као што је горе описано, изградња <application>gtkmm</application>-а би требало да буде релативно једноставна. Када први пут покренете <application>jhbuild</application>, требало би да извршите следећи низ наредби како бисте се уверили да <application>jhbuild</application> има потребне алате и потврдили да је исправно подешен: <_:screen-1/>

note: (itstool) path: section/title
en: Installing <application>gtkmm</application> with <application>jhbuild</application>
sr: Инсталирање <application>gtkmm</application>-а помоћу <application>jhbuild</application>-а

note: (itstool) path: section/para
en: If everything worked correctly, you should be able to build <application>gtkmm</application> and all of its dependencies from git by executing <command>jhbuild build</command> (or, if you didn't specify <application>gtkmm</application> in the <varname>modules</varname> variable, with the command <command>jhbuild build gtkmm</command>).
sr: Ако је све прошло како треба, требало би да можете да изградите <application>gtkmm</application> и све његове зависности из гита извршавањем наредбе <command>jhbuild build</command> (или, ако нисте навели <application>gtkmm</application> у променљивој <varname>modules</varname>, наредбом <command>jhbuild build gtkmm</command>).

note: (itstool) path: section/para
en: This command will build and install a series of modules and will probably take quite a long time the first time through. After the first time, however, it should go quite a bit faster since it only needs to rebuild files that changed since the last build. Alternatively, after you've built and installed <application>gtkmm</application> the first time, you can rebuild <application>gtkmm</application> by itself (without rebuilding all of its dependencies) with the command <command>jhbuild buildone gtkmm</command>.
sr: Ова наредба ће изградити и инсталирати низ модула и вероватно ће потрајати доста времена при првом покретању. Након првог пута, међутим, требало би да иде знатно брже јер треба само поново изградити датотеке које су се измениле од последње изградње. Алтернативно, након што први пут изградите и инсталирате <application>gtkmm</application>, можете поново изградити само <application>gtkmm</application> (без поновне изградње свих његових зависности) наредбом <command>jhbuild buildone gtkmm</command>.

note: (itstool) path: section/title
en: Using the git version of <application>gtkmm</application>
sr: Коришћење гит верзије <application>gtkmm</application>-а

note: (itstool) path: section/para
en: After you've installed the git version of <application>gtkmm</application>, you're ready to start using and experimenting with it. In order to use the new version of <application>gtkmm</application> you've just installed, you need to set some environment variables so that your <filename>configure</filename> or <filename>meson.build</filename> script knows where to find the new libraries. Fortunately, <application>jhbuild</application> offers an easy solution to this problem. Executing the command <command>jhbuild shell</command> will start a new shell with all of the correct environment variables set. Now if you re-configure and build your project just as you usually do, it should link against the newly installed libraries. To return to your previous environment, simply exit the <application>jhbuild</application> shell.
sr: Након што инсталирате гит верзију <application>gtkmm</application>-а, спремни сте да почнете да је користите и експериментишете са њом. Да бисте користили нову верзију <application>gtkmm</application>-а коју сте управо инсталирали, морате да подесите неке променљиве окружења како би ваша <filename>configure</filename> или <filename>meson.build</filename> скрипта знала где да пронађе нове библиотеке. Срећом, <application>jhbuild</application> нуди лако решење за овај проблем. Извршавање наредбе <command>jhbuild shell</command> ће покренути нову шкољку са свим исправно подешеним променљивама окружења. Сада, ако поново конфигуришете и изградите свој пројекат као што то обично радите, он би требало да се повеже са новоинсталираним библиотекама. Да бисте се вратили у претходно окружење, једноставно изађите из <application>jhbuild</application> шкољке.

note: (itstool) path: section/para
en: Once you've built your software, you'll need to run your program within the jhbuild environment as well. To do this, you can again use the <command>jhbuild shell</command> command to start a new shell with the <application>jhbuild</application> environment set up. Alternatively, you can execute a one-off command in the <application>jhbuild</application> environment using the following command: <command>jhbuild run command-name</command>. In this case, the command will be run with the correct environment variables set, but will return to your previous environment after the program exits.
sr: Након што изградите свој софтвер, мораћете да покренете свој програм и унутар jhbuild окружења. Да бисте то урадили, можете поново користити наредбу <command>jhbuild shell</command> за покретање нове шкољку са подешеним <application>jhbuild</application> окружењем. Алтернативно, можете извршити једнократну наредбу у <application>jhbuild</application> окружењу користећи следећу наредбу: <command>jhbuild run назив-наредбе</command>. У овом случају, наредба ће бити покренута са постављеним исправним променљивама окружења, али ће се вратити у ваше претходно окружење након што програм изађе.

note: (itstool) path: appendix/title
en: Wrapping C Libraries with gmmproc
sr: Обмотавање C библиотека помоћу gmmproc-а

note: (itstool) path: appendix/para
en: <application>gtkmm</application> uses the <command>gmmproc</command> tool to generate most of its source code, using .defs files that define the APIs of <classname>GObject</classname>-based libraries. So it's quite easy to create additional gtkmm-style wrappers of other glib/GObject-based libraries.
sr: <application>gtkmm</application> користи алат <command>gmmproc</command> за генерисање већине свог изворног кода, користећи .defs датотеке које дефинишу АПИ-је библиотека заснованих на <classname>GObject</classname>-у. Тако је прилично лако направити додатне омотаче у gtkmm стилу за друге библиотеке засноване на glib/GObject-у.

note: (itstool) path: appendix/para
en: This involves a variety of tools, some of them crufty, but at least they work, and has been used successfully by several projects.
sr: Ово укључује разне алате, од којих су неки застарели, али барем раде, и успешно су коришћени у неколико пројеката.

note: (itstool) path: section/title
en: The build structure
sr: Структура изградње

note: (itstool) path: section/para
en: Generation of the source code for a gtkmm-style wrapper API requires use of tools such as <command>gmmproc</command> and <filename>generate_wrap_init.pl</filename>, which are included in <application>glibmm</application>. In theory you could write your own build files to use these appropriately, but a much better option is to make use of the build infrastructure provided by the <application>mm-common</application> module. To get started, it helps a lot to pick an existing binding module as an example to look at.
sr: Стварање изворног кода за gtkmm-ов омотачки API захтева коришћење алата као што су <command>gmmproc</command> и <filename>generate_wrap_init.pl</filename>, који су укључени у <application>glibmm</application>. У теорији бисте могли сами да напишете своје датотеке изградње како бисте их користили на одговарајући начин, али много боља опција је да искористите инфраструктуру изградње коју обезбеђује модул <application>mm-common</application>. За почетак, много помаже ако изаберете постојећи модул увезивања као пример који ћете погледати.

note: (itstool) path: section/para
en: For instance, let's pretend that we are wrapping a C library called libsomething. It provides a <classname>GObject</classname>-based API with types named, for instance, <classname>SomeWidget</classname> and <classname>SomeStuff</classname>.
sr: На пример, замислимо да правимо омотач за C библиотеку под називом libsomething. Она обезбеђује API заснован на <classname>GObject</classname>-у са типовима названим, на пример, <classname>SomeWidget</classname> и <classname>SomeStuff</classname>.

note: (itstool) path: section/title
en: Copying the skeleton project
sr: Копирање скелетног пројекта

note: (itstool) path: section/para
en: Typically our wrapper library would be called libsomethingmm. We can start by copying the <link xlink:href="https://gitlab.gnome.org/GNOME/mm-common/tree/master/skeletonmm"> skeleton source tree</link> from the <application>mm-common</application> module. Starting with <application>mm-common</application> 1.0.0 this skeleton application is built with the <link xlink:href="https://mesonbuild.com/">Meson build system</link>.
sr: Обично би се наша библиотека омотача звала libsomethingmm. Можемо почети тако што ћемо копирати <link xlink:href="https://gitlab.gnome.org/GNOME/mm-common/tree/master/skeletonmm">изворно стабло скелета</link> из модула <application>mm-common</application>. Почевши од верзије <application>mm-common</application> 1.0.0, ова скелетна апликација се гради помоћу <link xlink:href="https://mesonbuild.com/">Мезоновог система изградње</link>.

note: (itstool) path: listitem/para
en: <filename>libsomethingmm</filename>: The top-level directory.
sr: <filename>libsomethingmm</filename>: Директоријум највишег нивоа.

note: (itstool) path: listitem/para
en: <filename>libsomething</filename>: Contains the main include file and the pkg-config .pc file.
sr: <filename>libsomething</filename>: Садржи главну датотеку укључивања и pkg-config .pc датотеку.

note: (itstool) path: listitem/para
en: <filename>src</filename>: Contains .hg and .ccg source files.
sr: <filename>src</filename>: Садржи .hg и .ccg изворне датотеке.

note: (itstool) path: listitem/para
en: <filename>libsomethingmm</filename>: Contains hand-written .h and .cc files.
sr: <filename>libsomethingmm</filename>: Садржи ручно писане .h и .cc датотеке.

note: (itstool) path: section/para
en: This provides a directory structure for the source .hg and .ccg files and the hand-written .h and .cc files, with <filename>meson.build</filename> files that can specify the various files in use, in terms of Meson variables. The directory structure usually looks like this, after we have renamed the directories appropriately: <_:itemizedlist-1/>
sr: Ово обезбеђује структуру директоријума за изворне .hg и .ccg датотеке и ручно писане .h и .cc датотеке, са <filename>meson.build</filename> датотекама које могу да наведу различите датотеке у употреби, изражене Мезоновим променљивама. Структура директоријума обично изгледа овако, након што одговарајуће преименујемо директоријуме: <_:itemizedlist-1/>

note: (itstool) path: section/para
en: As well as renaming the directories, we should rename some of the source files. For instance:
sr: Осим преименовања директоријума, требало би да преименујемо и неке изворне датотеке. На пример:

note: (itstool) path: section/para
en: A number of the skeleton files must still be filled in with project-specific content later.
sr: Одређени број скелетних датотека мора се касније попунити садржајем специфичним за пројекат.

note: (itstool) path: section/para
en: Note that files ending in <filename>.in</filename> will be used to generate files with the same name but without the <filename>.in</filename> suffix, by replacing some variables with actual values during the configure stage.
sr: Имајте на уму да ће се датотеке које се завршавају на <filename>.in</filename> користити за генерисање датотека са истим именом, али без суфикса <filename>.in</filename>, заменом неких променљивих стварним вредностима током фазе конфигурисања.

note: (itstool) path: section/para
en: Generated files are saved in the build tree, which is separated from the source tree when <command>meson</command> and <command>ninja</command> are used.
sr: Генерисане датотеке се чувају у стаблу изградње, које је одвојено од изворног стабла када се користе <command>meson</command> и <command>ninja</command>.

note: (itstool) path: section/title
en: Modifying build files
sr: Мењање датотека изградње

note: (itstool) path: section/para
en: Now we edit the files to adapt them to our needs. You might prefer to use a multiple-file search-replace utility for this, such as <command>regexxer</command>. Note that nearly all of the files provided with the skeleton source tree contain placeholder text. Thus, the substitutions should be performed globally, and not be limited to the Meson files.
sr: Сада уређујемо датотеке како бисмо их прилагодили нашим потребама. Можда бисте радије користили алатку за претрагу и замену у више датотека, као што је <command>regexxer</command>. Имајте на уму да скоро све датотеке обезбеђене у изворном стаблу скелета садрже текст чувара места. Стога, замене треба извршити глобално, а не ограничавати их само на Мезонове датотеке.

note: (itstool) path: section/para
en: All mentions of <varname>skeleton</varname> should be replaced by the correct name of the C library you are wrapping, such as "something" or "libsomething". In the same manner, all instances of <varname>SKELETON</varname> should be replaced by "SOMETHING" or "LIBSOMETHING", and all occurrences of <varname>Skeleton</varname> changed to "Something".
sr: Сва помињања <varname>skeleton</varname> треба заменити исправним именом C библиотеке за коју правите омотач, као што је „something“ или „libsomething“. На исти начин, све појаве <varname>SKELETON</varname> треба заменити са „SOMETHING“ или „LIBSOMETHING“, а све појаве <varname>Skeleton</varname> променити у „Something“.

note: (itstool) path: section/para
en: Likewise, replace all instances of <varname>Joe Hacker</varname> by the name of the intended copyright holder, which is probably you. Do the same for the <varname>joe@example.com</varname> email address.
sr: Исто тако, замените све појаве <varname>Joe Hacker</varname> именом предвиђеног носиоца ауторских права, што сте вероватно ви. Урадите исто и за адресу е-поште <varname>joe@example.com</varname>.

note: (itstool) path: section/title
en: meson.build in the top-level directory
sr: meson.build у директоријуму највишег нивоа

note: (itstool) path: listitem/para
en: It is common for binding modules to track the version number of the library they are wrapping. So, for instance, if the C library is at version 1.23.4, then the initial version of the binding module would be 1.23.0. However, avoid starting with an even minor version number as that usually indicates a stable release.
sr: Уобичајено је да везни модули прате број издања библиотеке коју омотавају. Тако би, на пример, ако је Ц библиотека на издању 1.23.4, почетно издање везног модула било 1.23.0. Међутим, избегавајте почетак са парним бројем споредног издања јер то обично указује на стабилно издање.

note: (itstool) path: listitem/para
en: In the <function>project()</function> function, change the license and the <phrase role="nowrap">C++</phrase> version, if necessary.
sr: У функцији <function>project()</function>, измените лиценцу и <phrase role="nowrap">Ц++</phrase> издање, ако је потребно.

note: (itstool) path: listitem/para
en: You probably need to add more required modules than <application>glibmm</application> and <application>skeleton</application> (<application>libsomething</application>).
sr: Вероватно ћете морати да додате више потребних модула осим <application>glibmm</application> и <application>skeleton</application> (<application>libsomething</application>).

note: (itstool) path: section/title
en: Other meson.build files
sr: Остале meson.build датотеке

note: (itstool) path: listitem/para
en: <filename>skeleton/meson.build</filename>: Perhaps not much to change here more than the global name substitutions.
sr: <filename>skeleton/meson.build</filename>: Можда овде нема много тога за измену осим општих замена назива.

note: (itstool) path: listitem/para
en: If we have more .defs and docs.xml files, we add them here.
sr: Ако имамо више .defs и docs.xml датотека, додајемо их овде.

note: (itstool) path: listitem/para
en: We must mention all of our <filename>.hg</filename> and <filename>.ccg</filename> files here.
sr: Овде морамо навести све наше <filename>.hg</filename> и <filename>.ccg</filename> датотеке.

note: (itstool) path: listitem/para
en: Any additional hand-written <filename>.h</filename> and <filename>.cc</filename> source files go here.
sr: Било које додатне ручно писане <filename>.h</filename> и <filename>.cc</filename> изворне датотеке иду овде.

note: (itstool) path: section/para
en: Next we must adapt the other <filename>meson.build</filename> files: <_:itemizedlist-1/>
sr: Затим морамо прилагодити остале <filename>meson.build</filename> датотеке: <_:itemizedlist-1/>

note: (itstool) path: section/title
en: Creating .hg and .ccg files
sr: Стварање .hg и .ccg датотека

note: (itstool) path: section/para
en: We should now create our first <filename>.hg</filename> and <filename>.ccg</filename> files, to wrap one of the objects in the C library. One pair of example source files already exists: <filename>skeleton.ccg</filename> and <filename>skeleton.hg</filename>. Create copies of these files as necessary.
sr: Сада треба да направимо наше прве <filename>.hg</filename> и <filename>.ccg</filename> датотеке, како бисмо омотали један од објеката у Ц библиотеци. Један пар примерних изворних датотека већ постоји: <filename>skeleton.ccg</filename> и <filename>skeleton.hg</filename>. Направите копије ових датотека по потреби.

note: (itstool) path: section/para
en: In the <link linkend="sec-wrapping-hg-files">.hg and .ccg files</link> section you can learn about the syntax used in these files.
sr: У одељку <link linkend="sec-wrapping-hg-files">.hg и .ccg датотеке</link> можете сазнати више о синтакси која се користи у овим датотекама.

note: (itstool) path: section/title
en: Generating the .defs files.
sr: Стварање .defs датотека.

note: (itstool) path: listitem/para
en: objects (GObjects, widgets, interfaces, boxed-types and plain structs)
sr: објекти (GObjects, елементи, прочеља, „boxed“ типови и обичне структуре)

note: (itstool) path: listitem/para
en: functions
sr: функције

note: (itstool) path: listitem/para
en: enums
sr: набројиви типови

note: (itstool) path: listitem/para
en: signals
sr: сигнали

note: (itstool) path: listitem/para
en: properties
sr: својства

note: (itstool) path: listitem/para
en: vfuncs
sr: в-функције

note: (itstool) path: section/para
en: The <filename>.defs</filename> files are text files, in a lisp format, that describe the API of a C library, including its <_:itemizedlist-1/>
sr: Датотеке <filename>.defs</filename> су текстуалне датотеке, у формату лиспа, које описују АПИ Ц библиотеке, укључујући њене <_:itemizedlist-1/>

note: (itstool) path: listitem/para
en: Includes the other files.
sr: Укључује остале датотеке.

note: (itstool) path: listitem/para
en: Objects and functions.
sr: Објекти и функције.

note: (itstool) path: listitem/para
en: Enumerations.
sr: Набрајања.

note: (itstool) path: listitem/para
en: Signals and properties.
sr: Сигнали и својства.

note: (itstool) path: listitem/para
en: vfuncs (function pointer member fields in structs), written by hand.
sr: в-функције (поља чланова показивача функција у структурама), писана ручно.

note: (itstool) path: section/para
en: At the moment, we have separate tools for generating different parts of these <filename>.defs</filename>, so we split them up into separate files. For instance, in the <filename>gtk/src</filename> directory of the <application>gtkmm</application> sources, you will find these files: <_:variablelist-1/>
sr: Тренутно имамо засебне алате за стварање различитих делова ових <filename>.defs</filename> датотека, па смо их поделили у засебне датотеке. На пример, у директоријуму <filename>gtk/src</filename> изворног кода <application>gtkmm</application>-а, наћи ћете ове датотеке: <_:variablelist-1/>

note: (itstool) path: section/para
en: The <filename>skeletonmm/tools/generate_defs_and_docs.sh</filename> script generates all <filename>.defs</filename> files and the <filename>*_docs.xml</filename> file, described in the <link linkend="sec-wrapping-documentation">Documentation</link> section.
sr: Скрипта <filename>skeletonmm/tools/generate_defs_and_docs.sh</filename> ствара све <filename>.defs</filename> датотеке и <filename>*_docs.xml</filename> датотеку, описану у одељку <link linkend="sec-wrapping-documentation">Документација</link>.

note: (itstool) path: section/title
en: Generating the methods .defs
sr: Стварање .defs датотека метода

note: (itstool) path: section/para
en: This <filename>.defs</filename> file describes objects and their functions. It is generated by the <command>h2def.py</command> script which you can find in glibmm's <filename>tools/defs_gen</filename> directory. For instance,
sr: Ова <filename>.defs</filename> датотека описује објекте и њихове функције. Ствара је скрипта <command>h2def.py</command> коју можете наћи у glibmm-овом директоријуму <filename>tools/defs_gen</filename>. На пример,

note: (itstool) path: section/title
en: Generating the enums .defs
sr: Стварање .defs датотека набрајања

note: (itstool) path: section/para
en: This <filename>.defs</filename> file describes enum types and their possible values. It is generated by the <filename>enumextract.py</filename> script which you can also find in glibmm's <filename>tools/defs_gen</filename> directory. For instance,
sr: Ова <filename>.defs</filename> датотека описује набројиве типове и њихове могуће вредности. Генерише је скрипта <filename>enumextract.py</filename> коју такође можете пронаћи у glibmm-овом директоријуму <filename>tools/defs_gen</filename>. На пример,

note: (itstool) path: section/title
en: Generating the signals and properties .defs
sr: Стварање .defs датотека за сигнале и својства

note: (itstool) path: section/para
en: This <filename>.defs</filename> file describes signals and properties. It is generated by the special <filename>generate_extra_defs</filename> utility that is in every wrapping project, such as <filename>gtkmm/tools/extra_defs_gen/</filename>. For instance
sr: Ова <filename>.defs</filename> датотека описује сигнале и својства. Генерише је посебно помагало <filename>generate_extra_defs</filename> које се налази у сваком пројекту за премотавање, као што је <filename>gtkmm/tools/extra_defs_gen/</filename>. На пример

note: (itstool) path: section/para
en: You must edit the source code of your own <filename>generate_extra_defs</filename> tool in order to generate the <filename>.defs</filename> for the GObject C types that you wish to wrap. In the skeleton source tree, the source file is named <filename>tools/extra_defs_gen/generate_defs_skeleton.cc</filename>. If not done so already, the file should be renamed, with the basename of your new binding substituted for the <varname>skeleton</varname> placeholder. The <filename>tools/extra_defs_gen/meson.build</filename> file should also mention the new source filename.
sr: Морате уредити изворни код сопствене алатке <filename>generate_extra_defs</filename> како бисте генерисали <filename>.defs</filename> за GObject C типове које желите да премотате. У скелетном изворном стаблу, изворна датотека се зове <filename>tools/extra_defs_gen/generate_defs_skeleton.cc</filename>. Ако то већ нисте урадили, датотеку треба преименовати, замењујући чувар места <varname>skeleton</varname> основним називом вашег новог увезивања. Датотека <filename>tools/extra_defs_gen/meson.build</filename> такође треба да помиње назив нове изворне датотеке.

note: (itstool) path: section/para
en: Then edit the <filename>.cc</filename> file to specify the correct types. For instance, your <function>main()</function> function might look like this:
sr: Затим уредите <filename>.cc</filename> датотеку да бисте навели исправне типове. На пример, ваша <function>main()</function> функција може изгледати овако:

note: (itstool) path: section/title
en: Writing the vfuncs .defs
sr: Писање .defs за виртуелне функције (vfuncs)

note: (itstool) path: section/para
en: This <filename>.defs</filename> file describes virtual functions (vfuncs). It must be written by hand. There is the skeleton file <filename>skeleton/src/skeleton_vfunc.defs</filename> to start from. You can also look at <application>gtkmm</application>'s <filename>gtk/src/gtk_vfuncs.defs</filename> file.
sr: Ова <filename>.defs</filename> датотека описује виртуелне функције (vfuncs). Мора се написати ручно. Постоји скелетна датотека <filename>skeleton/src/skeleton_vfunc.defs</filename> од које можете почети. Такође можете погледати <application>gtkmm</application>-ову датотеку <filename>gtk/src/gtk_vfuncs.defs</filename>.

note: (itstool) path: section/title
en: The .hg and .ccg files
sr: .hg и .ccg датотеке

note: (itstool) path: section/para
en: The .hg and .ccg source files are very much like .h and .cc <phrase role="nowrap">C++</phrase> source files, but they contain extra macros, such as <function>_CLASS_GOBJECT()</function> and <function>_WRAP_METHOD()</function>, from which <command>gmmproc</command> generates appropriate <phrase role="nowrap">C++</phrase> source code, usually at the same position in the header. Any additional <phrase role="nowrap">C++</phrase> source code will be copied verbatim into the corresponding .h or .cc file.
sr: .hg и .ccg изворне датотеке су веома сличне .h и .cc <phrase role="nowrap">C++</phrase> изворним датотекама, али садрже додатне макрое, као што су <function>_CLASS_GOBJECT()</function> и <function>_WRAP_METHOD()</function>, из којих <command>gmmproc</command> генерише одговарајући <phrase role="nowrap">C++</phrase> изворни код, обично на истом месту у заглављу. Сав додатни <phrase role="nowrap">C++</phrase> изворни код ће бити дословно прекопиран у одговарајућу .h или .cc датотеку.

note: (itstool) path: section/para
en: A .hg file will typically include some headers and then declare a class, using some macros to add API or behavior to this class. For instance, <application>gtkmm</application>'s <filename>button.hg</filename> looks roughly like this:
sr: .hg датотека ће обично укључивати нека заглавља и затим декларисати класу, користећи неке макрое за додавање API-ја или понашања тој класи. На пример, <application>gtkmm</application>-ова <filename>button.hg</filename> изгледа отприлике овако:

note: (itstool) path: listitem/para
en: Specifies the destination directory for generated sources, and the name of the main .defs file that <command>gmmproc</command> should parse.
sr: Наводи одредишни директоријум за генерисане изворе и назив главне .defs датотеке коју <command>gmmproc</command> треба да обради.

note: (itstool) path: listitem/para
en: Tells <command>gmmproc</command> to include a header in the generated <filename>private/button_p.h</filename> file.
sr: Говори <command>gmmproc</command>-у да укључи заглавље у генерисану <filename>private/button_p.h</filename> датотеку.

note: (itstool) path: listitem/para
en: Tells <command>gmmproc</command> to add some typedefs, constructors, and standard methods to this class, as appropriate when wrapping a widget.
sr: Говори <command>gmmproc</command>-у да дода неке typedef-ове, конструкторе и стандардне методе овој класи, што је прикладно при премотавању виџета.

note: (itstool) path: listitem/para
en: Tells <command>gmmproc</command> to add initialization code for the interface.
sr: Говори наредби <command>gmmproc</command> да дода код за покретање за прочеље.

note: (itstool) path: listitem/para
en: Adds a default constructor.
sr: Додаје подразумевани конструктор.

note: (itstool) path: varlistentry/term
en: <function>_WRAP_METHOD()</function>, <function>_WRAP_SIGNAL()</function>, and <function>_WRAP_PROPERTY()</function>
sr: <function>_WRAP_METHOD()</function>, <function>_WRAP_SIGNAL()</function> и <function>_WRAP_PROPERTY()</function>

note: (itstool) path: listitem/para
en: Add methods to wrap parts of the C API.
sr: Додаје начине за премошћавање делова Ц API-ја.

note: (itstool) path: section/para
en: The macros in this example do the following: <_:variablelist-1/>
sr: Макрои у овом примеру раде следеће: <_:variablelist-1/>

note: (itstool) path: section/para
en: The .h and .cc files will be generated from the .hg and .ccg files by processing them with <command>gmmproc</command> like so, though this happens automatically when using the above build structure:
sr: Датотеке .h и .cc ће бити створене из датотека .hg и .ccg њиховом обрадом помоћу наредбе <command>gmmproc</command> на овај начин, иако се то дешава аутоматски када се користи горе наведена структура изградње:

note: (itstool) path: section/para
en: Notice that we provided <command>gmmproc</command> with the path to the .m4 convert files, the path to the .defs file, the name of a .hg file, the source directory, and the destination directory.
sr: Приметите да смо доставили наредби <command>gmmproc</command> путању до .m4 датотека претварања, путању до .defs датотеке, назив .hg датотеке, изворни директоријум и одредишни директоријум.

note: (itstool) path: section/para
en: You should avoid including the C header from your <phrase role="nowrap">C++</phrase> header, to avoid polluting the global namespace, and to avoid exporting unnecessary public API. But you will need to include the necessary C headers from your .ccg file.
sr: Требало би да избегавате укључивање Ц заглавља из вашег <phrase role="nowrap">Ц++</phrase> заглавља, како бисте избегли загађивање општег именског простора и извожење непотребног јавног API-ја. Али ћете морати да укључите неопходна Ц заглавља из ваше .ccg датотеке.

note: (itstool) path: section/para
en: The macros are explained in more detail in the following sections.
sr: Макрои су објашњени детаљније у следећим одељцима.

note: (itstool) path: section/title
en: m4 Conversions
sr: М4 претварања

note: (itstool) path: section/para
en: The macros that you use in the .hg and .ccg files often need to know how to convert a <phrase role="nowrap">C++</phrase> type to a C type, or vice-versa. <command>gmmproc</command> takes this information from an .m4 file in your <literal>tools/m4/</literal> or <literal>codegen/m4/</literal> directory. This allows it to call a C function in the implementation of your <phrase role="nowrap">C++</phrase> method, passing the appropriate parameters to that C function. For instance, this tells <command>gmmproc</command> how to convert a <classname>GtkTreeView</classname> pointer to a <classname>Gtk::TreeView</classname> pointer:
sr: Макрои које користите у .hg и .ccg датотекама често морају да знају како да претворе <phrase role="nowrap">Ц++</phrase> врсту у Ц врсту, или обрнуто. <command>gmmproc</command> узима ове податке из .m4 датотеке у вашем <literal>tools/m4/</literal> или <literal>codegen/m4/</literal> директоријуму. Ово му омогућава да позове Ц функцију у изведби вашег <phrase role="nowrap">Ц++</phrase> начина, прослеђујући одговарајуће параметре тој Ц функцији. На пример, ово говори наредби <command>gmmproc</command> како да претвори <classname>GtkTreeView</classname> показивач у <classname>Gtk::TreeView</classname> показивач:

note: (itstool) path: section/para
en: <literal>$3</literal> will be replaced by the parameter name when this conversion is used by <command>gmmproc</command>.
sr: <literal>$3</literal> ће бити замењен називом параметра када ово претварање користи наредба <command>gmmproc</command>.

note: (itstool) path: section/para
en: Some extra macros make this easier and consistent. Look in <application>gtkmm</application>'s .m4 files for examples. For instance:
sr: Неки додатни макрои чине ово лакшим и доследнијим. Погледајте у <application>gtkmm</application> .m4 датотекама за примере. На пример:

note: (itstool) path: section/title
en: m4 Initializations
sr: М4 покретања

note: (itstool) path: section/para
en: Often when wrapping methods, it is desirable to store the return of the C function in what is called an output parameter. In this case, the <phrase role="nowrap">C++</phrase> method returns <type>void</type> but an output parameter in which to store the value of the C function is included in the argument list of the <phrase role="nowrap">C++</phrase> method. <command>gmmproc</command> allows such functionality, but appropriate initialization macros must be included to tell <command>gmmproc</command> how to initialize the <phrase role="nowrap">C++</phrase> parameter from the return of the C function.
sr: Често при премошћавању начина, пожељно је сачувати повратну вредност Ц функције у оно што се назива излазни параметар. У овом случају, <phrase role="nowrap">Ц++</phrase> начин враћа <type>void</type>, али је излазни параметар у којем се чува вредност Ц функције укључен у списак аргумената <phrase role="nowrap">Ц++</phrase> начина. <command>gmmproc</command> омогућава такву функционалност, али морају бити укључени одговарајући макрои покретања како би рекли наредби <command>gmmproc</command> како да покрене <phrase role="nowrap">Ц++</phrase> параметар из повратне вредности Ц функције.

note: (itstool) path: section/para
en: For example, if there was a C function that returned a <type>GtkWidget*</type> and for some reason, instead of having the <phrase role="nowrap">C++</phrase> method also return the widget, it was desirable to have the <phrase role="nowrap">C++</phrase> method place the widget in a specified output parameter, an initialization macro such as the following would be necessary:
sr: На пример, ако постоји Ц функција која враћа <type>GtkWidget*</type> и из неког разлога, уместо да <phrase role="nowrap">Ц++</phrase> метод такође враћа елемент, пожељно је да <phrase role="nowrap">Ц++</phrase> метод постави елемент у наведени излазни параметар, макро за покретање као што је следећи би био неопходан:

note: (itstool) path: section/para
en: <literal>$3</literal> will be replaced by the output parameter name of the <phrase role="nowrap">C++</phrase> method and <literal>$4</literal> will be replaced by the return of the C function when this initialization is used by <command>gmmproc</command>. For convenience, <literal>$1</literal> will also be replaced by the <phrase role="nowrap">C++</phrase> type without the ampersand (&amp;) and <literal>$2</literal> will be replaced by the C type.
sr: <literal>$3</literal> ће бити замењено именом излазног параметра <phrase role="nowrap">Ц++</phrase> метода, а <literal>$4</literal> ће бити замењено повратном вредношћу Ц функције када ово покретање користи <command>gmmproc</command>. Ради практичности, <literal>$1</literal> ће такође бити замењено <phrase role="nowrap">Ц++</phrase> врстом без амперсанда (&amp;), а <literal>$2</literal> ће бити замењено Ц врстом.

note: (itstool) path: section/title
en: Class macros
sr: Макрои класа

note: (itstool) path: section/para
en: The class macro declares the class itself and its relationship with the underlying C type. It generates some internal constructors, the member <varname>gobject_</varname>, typedefs, the <function>gobj()</function> accessors, type registration, and the <function>Glib::wrap()</function> method, among other things.
sr: Макро класе декларише саму класу и њен однос са основним Ц типом. Он генерише неке унутрашње конструкторе, члан <varname>gobject_</varname>, дефиниције типова (typedefs), <function>gobj()</function> приступнике, регистрацију типа и метод <function>Glib::wrap()</function>, између осталог.

note: (itstool) path: section/para
en: Other macros, such as <function>_WRAP_METHOD()</function> and <function>_WRAP_SIGNAL()</function> may only be used after a call to a <function>_CLASS_*</function> macro.
sr: Остали макрои, као што су <function>_WRAP_METHOD()</function> и <function>_WRAP_SIGNAL()</function>, могу се користити само након позива <function>_CLASS_*</function> макроа.

note: (itstool) path: section/para
en: Most class macros take an optional argument, <parameter>declaration prefix</parameter>. It's typically used for a C preprocessor macro defined as <literal>__declspec(dllexport)</literal> or <literal>__declspec(dllimport)</literal> when building with MSVC on Windows, defined as an empty string otherwise.
sr: Већина макроа класа узима необавезни аргумент, <parameter>префикс декларације</parameter>. Обично се користи за макро Ц препроцесора дефинисан као <literal>__declspec(dllexport)</literal> или <literal>__declspec(dllimport)</literal> приликом изградње са MSVC на Windows-у, а у супротном је дефинисан као празна ниска.

note: (itstool) path: section/para
en: This macro declares a wrapper for a type that is derived from <classname>GObject</classname>, but whose wrapper is not derived from <classname>Gtk::Object</classname>.
sr: Овај макро декларише омотач за тип који је изведен из <classname>GObject</classname>, али чији омотач није изведен из <classname>Gtk::Object</classname>.

note: (itstool) path: section/para
en: <function>_CLASS_GOBJECT( C++ class, C class, C casting macro, C++ base class, C base class, real C class, real C base class, declaration prefix )</function>
sr: <function>_CLASS_GOBJECT( Ц++ класа, Ц класа, Ц макро за кастовање, Ц++ основна класа, Ц основна класа, права Ц класа, права Ц основна класа, префикс декларације )</function>

note: (itstool) path: section/para
en: <parameter>real C class</parameter> and <parameter>real C base class</parameter> are optional. They are seldom used. For instance, from <filename>adjustment.hg</filename>:
sr: <parameter>права Ц класа</parameter> и <parameter>права Ц основна класа</parameter> су необавезни. Ретко се користе. На пример, из <filename>adjustment.hg</filename>:

note: (itstool) path: section/para
en: This macro declares a wrapper for a type whose wrapper is derived from <classname>Gtk::Object</classname>, such as a widget or dialog.
sr: Овај макро декларише омотач за тип чији је омотач изведен из <classname>Gtk::Object</classname>, као што је елемент (widget) или прозорче (dialog).

note: (itstool) path: section/para
en: <function>_CLASS_GTKOBJECT( C++ class, C class, C casting macro, C++ base class, C base class, real C class, real C base class, declaration prefix )</function>
sr: <function>_CLASS_GTKOBJECT( Ц++ класа, Ц класа, Ц макро за кастовање, Ц++ основна класа, Ц основна класа, права Ц класа, права Ц основна класа, префикс декларације )</function>

note: (itstool) path: section/para
en: <parameter>real C class</parameter> and <parameter>real C base class</parameter> are optional. They are seldom used. For instance, from <filename>button.hg</filename>:
sr: <parameter>права Ц класа</parameter> и <parameter>права Ц основна класа</parameter> су необавезни. Ретко се користе. На пример, из <filename>button.hg</filename>:

note: (itstool) path: section/para
en: You will typically use this macro when the class already derives from <classname>Gtk::Object</classname>. For instance, you will use it when wrapping a GTK Widget, because <classname>Gtk::Widget</classname> derives from <classname>Gtk::Object</classname>.
sr: Обично ћете користити овај макро када је класа већ изведена из <classname>Gtk::Object</classname>. На пример, користићете га када омотавате ГТК елемент, јер је <classname>Gtk::Widget</classname> изведен из <classname>Gtk::Object</classname>.

note: (itstool) path: section/para
en: You might also derive non-widget classes from <classname>Gtk::Object</classname> so they can be used without <classname>Glib::RefPtr</classname>. For instance, they could then be instantiated with <function>Gtk::make_managed()</function> or on the stack as a member variable. This is convenient, but you should use this only when you are sure that true reference-counting is not needed. We consider it useful for widgets.
sr: Такође можете извести класе које нису елементи из <classname>Gtk::Object</classname> како би се могле користити без <classname>Glib::RefPtr</classname>. На пример, тада би се могле инстанцирати помоћу <function>Gtk::make_managed()</function> или на стеку као члан променљива. Ово је практично, али ово треба да користите само када сте сигурни да право бројање референци није потребно. Сматрамо га корисним за елементе.

note: (itstool) path: section/para
en: This macro declares a wrapper for a non-<classname>GObject</classname> struct, registered with <function>g_boxed_type_register_static()</function>.
sr: Овај макро декларише омотач за структуру која није <classname>GObject</classname>, регистровану помоћу <function>g_boxed_type_register_static()</function>.

note: (itstool) path: section/para
en: For instance, from <classname>Gdk::RGBA</classname>:
sr: На пример, из <classname>Gdk::RGBA</classname>:

note: (itstool) path: section/para
en: This macro declares a wrapper for a simple assignable struct such as <classname>GdkRectangle</classname>. It is similar to <function>_CLASS_BOXEDTYPE</function>, but the C struct is not allocated dynamically.
sr: Овај макро декларише омотач за једноставну доделиву структуру као што је <classname>GdkRectangle</classname>. Сличан је макроу <function>_CLASS_BOXEDTYPE</function>, али се C структура не додељује динамички.

note: (itstool) path: section/para
en: For instance, for <classname>Gdk::Rectangle</classname>:
sr: На пример, за <classname>Gdk::Rectangle</classname>:

note: (itstool) path: section/para
en: This macro declares a wrapper for an opaque struct that has copy and free functions. The new, copy and free functions will be used to instantiate the default constructor, copy constructor and destructor.
sr: Овај макро декларише омотач за непровидну структуру која има функције за копирање и ослобађање. Нове функције, функције за копирање и ослобађање ће се користити за инстанцирање подразумеваног конструктора, конструктора копије и деструктора.

note: (itstool) path: section/para
en: For instance, from <classname>Glib::VariantType</classname>:
sr: На пример, из <classname>Glib::VariantType</classname>:

note: (itstool) path: section/para
en: This macro declares a wrapper for a reference-counted opaque struct. The <phrase role="nowrap">C++</phrase> wrapper cannot be directly instantiated and can only be used with <classname>Glib::RefPtr</classname>.
sr: Овај макро декларише омотач за непровидну структуру са бројањем референци. <phrase role="nowrap">C++</phrase> омотач се не може директно инстанцирати и може се користити само са <classname>Glib::RefPtr</classname>.

note: (itstool) path: section/para
en: For instance, for <classname>Gtk::CssSection</classname>:
sr: На пример, за <classname>Gtk::CssSection</classname>:

note: (itstool) path: section/para
en: This macro can be used to wrap structs which don't fit into any specialized category.
sr: Овај макро се може користити за омотавање структура које се не уклапају ни у једну специјализовану категорију.

note: (itstool) path: section/para
en: Note: No <parameter>declaration prefix</parameter> argument. For instance, for <classname>Gdk::TimeCoord</classname>:
sr: Напомена: Без аргумента <parameter>declaration prefix</parameter>. На пример, за <classname>Gdk::TimeCoord</classname>:

note: (itstool) path: section/para
en: This macro declares a wrapper for a type that is derived from <classname>GTypeInterface</classname>.
sr: Овај макро дефинише омотач за тип који је изведен из <classname>GTypeInterface</classname>.

note: (itstool) path: section/para
en: For instance, from <filename>celleditable.hg</filename>:
sr: На пример, из <filename>celleditable.hg</filename>:

note: (itstool) path: section/para
en: Two extra optional parameters were once added, for the case that the interface derives from another interface, which was believed to be the case when the GInterface has another GInterface as a prerequisite. This is a misunderstanding, though. When GInterface A has GInterface B as a prerequisite, it means that every class that implements A shall also implement B. For instance, from <filename>loadableicon.hg</filename> in glibmm-2.4:
sr: Два додатна опциона параметра су својевремено додата за случај када је интерфејс изведен из другог интерфејса, за шта се веровало да је случај када GInterface има други GInterface као предуслов. Ово је међутим неспоразум. Када GInterface A има GInterface B као предуслов, то значи да свака класа која имплементира A мора такође имплементирати и B. На пример, из <filename>loadableicon.hg</filename> у glibmm-2.4:

note: (itstool) path: section/title
en: Constructor macros
sr: Макрои конструктора

note: (itstool) path: section/para
en: The <function>_CTOR_DEFAULT()</function> and <function>_WRAP_CTOR()</function> macros add constructors, wrapping the specified <function>*_new()</function> C functions. These macros assume that the C object has properties with the same names as the function parameters, as is usually the case, so that it can supply the parameters directly to a <function>g_object_new()</function> call. These constructors never actually call the <function>*_new()</function> C functions, because <application>gtkmm</application> must actually instantiate derived GTypes, and the <function>*_new()</function> C functions are meant only as convenience functions for C programmers.
sr: Макрои <function>_CTOR_DEFAULT()</function> и <function>_WRAP_CTOR()</function> додају конструкторе, омотавајући наведене <function>*_new()</function> C функције. Ови макрои претпостављају да C објекат има својства са истим именима као и параметри функције, као што је обично случај, тако да може проследити параметре директно позиву <function>g_object_new()</function>. Ови конструктори никада заправо не позивају <function>*_new()</function> C функције, јер <application>gtkmm</application> мора заправо инстанцирати изведене GType-ове, а <function>*_new()</function> C функције су замишљене само као помоћне функције за C програмере.

note: (itstool) path: section/para
en: When using <function>_CLASS_GOBJECT()</function>, the constructors should be protected (rather than public) and each constructor should have a corresponding <function>_WRAP_CREATE()</function> in the public section. This prevents the class from being instantiated without using a <classname>RefPtr</classname>. For instance:
sr: Када се користи <function>_CLASS_GOBJECT()</function>, конструктори треба да буду заштићени (protected, а не јавни) и сваки конструктор треба да има одговарајући <function>_WRAP_CREATE()</function> у јавном одељку. Ово спречава да класа буде инстанцирана без коришћења <classname>RefPtr</classname>-а. На пример:

note: (itstool) path: section/para
en: This macro creates a default constructor with no arguments.
sr: Овај макро креира подразумевани конструктор без аргумената.

note: (itstool) path: section/para
en: This macro creates a constructor with arguments, equivalent to a <function>*_new()</function> C function. It won't actually call the <function>*_new()</function> function, but will simply create an equivalent constructor with the same argument types. It takes a <phrase role="nowrap">C++</phrase> constructor signature, and a C function name.
sr: Овај макро креира конструктор са аргументима, еквивалентан <function>*_new()</function> C функцији. Он заправо неће позвати <function>*_new()</function> функцију, већ ће једноставно креирати еквивалентан конструктор са истим типовима аргумената. Прихвата <phrase role="nowrap">C++</phrase> потпис конструктора и име C функције.

note: (itstool) path: listitem/para
en: This tells <command>gmmproc</command> that the C <function>*_new()</function> has a final <type>GError**</type> parameter which should be ignored.
sr: Ово саопштава <command>gmmproc</command>-у да Ц <function>*_new()</function> има завршни <type>GError**</type> параметар који треба занемарити.

note: (itstool) path: section/para
en: It also takes an optional extra argument: <_:variablelist-1/>
sr: Такође прихвата необавезан додатни аргумент: <_:variablelist-1/>

note: (itstool) path: section/title
en: Hand-coding constructors
sr: Ручно кодирање конструктора

note: (itstool) path: section/para
en: When a constructor must be partly hand written because, for instance, the <function>*_new()</function> C function's parameters do not correspond directly to object properties, or because the <function>*_new()</function> C function does more than call <function>g_object_new()</function>, the <function>_CONSTRUCT()</function> macro may be used in the .ccg file to save some work. The <function>_CONSTRUCT</function> macro takes a series of property names and values. For instance, from <filename>button.ccg</filename>:
sr: Када конструктор мора бити делимично ручно написан јер, на пример, параметри Ц функције <function>*_new()</function> не одговарају директно својствима објекта, или зато што Ц функција <function>*_new()</function> ради више од позивања <function>g_object_new()</function>, макро <function>_CONSTRUCT()</function> се може користити у .ccg датотеци како би се уштедело нешто труда. Макро <function>_CONSTRUCT</function> прихвата низ назива својстава и вредности. На пример, из <filename>button.ccg</filename>:

note: (itstool) path: section/title
en: Macros that suppress generation of some code
sr: Макрои који потискују стварање неког кода

note: (itstool) path: section/para
en: Some macros suppress the generation of some code when they are used after a <function>_CLASS_*</function> macro. Some suppress the definition in the generated .cc file, others suppress both the declaration in the .h file and the definition in the .cc file.
sr: Неки макрои потискују стварање неког кода када се користе након <function>_CLASS_*</function> макроа. Неки потискују дефиницију у створеној .cc датотеци, други потискују и декларацију у .h датотеци и дефиницију у .cc датотеци.

note: (itstool) path: section/para
en: Suppresses declaration and definition of default constructor in <function>_CLASS_BOXEDTYPE</function>, <function>_CLASS_BOXEDTYPE_STATIC</function> and <function>_CLASS_OPAQUE_COPYABLE</function>.
sr: Потискује декларацију и дефиницију подразумеваног конструктора у <function>_CLASS_BOXEDTYPE</function>, <function>_CLASS_BOXEDTYPE_STATIC</function> и <function>_CLASS_OPAQUE_COPYABLE</function>.

note: (itstool) path: section/para
en: Suppresses declaration and definition of the constructor that takes a pointer to the wrapped C object in <function>_CLASS_BOXEDTYPE</function> and <function>_CLASS_BOXEDTYPE_STATIC</function>.
sr: Потискује декларацију и дефиницију конструктора који прихвата показивач на умотани Ц објекат у <function>_CLASS_BOXEDTYPE</function> и <function>_CLASS_BOXEDTYPE_STATIC</function>.

note: (itstool) path: section/para
en: Suppresses definition of the constructor that takes a pointer to the wrapped C object in <function>_CLASS_INTERFACE</function> and <function>_CLASS_OPAQUE_COPYABLE</function>.
sr: Потискује дефиницију конструктора који прихвата показивач на умотани Ц објекат у <function>_CLASS_INTERFACE</function> и <function>_CLASS_OPAQUE_COPYABLE</function>.

note: (itstool) path: section/para
en: Suppresses definition of the constructor that takes a pointer to the wrapped C object and the constructor that takes construct_params in <function>_CLASS_GOBJECT</function> and <function>_CLASS_GTKOBJECT</function>.
sr: Потискује дефиницију конструктора који прихвата показивач на умотани Ц објекат и конструктора који прихвата construct_params у <function>_CLASS_GOBJECT</function> и <function>_CLASS_GTKOBJECT</function>.

note: (itstool) path: section/para
en: Suppresses definition of destructor in <function>_CLASS_GOBJECT</function> and <function>_CLASS_GTKOBJECT</function>.
sr: Потискује дефиницију деструктора у <function>_CLASS_GOBJECT</function> и <function>_CLASS_GTKOBJECT</function>.

note: (itstool) path: section/para
en: Suppresses declaration and definition of move constructor and move assignment operator in <function>_CLASS_GOBJECT</function> and <function>_CLASS_GTKOBJECT</function>.
sr: Потискује декларацију и дефиницију конструктора премештања и оператора доделе премештања у <function>_CLASS_GOBJECT</function> и <function>_CLASS_GTKOBJECT</function>.

note: (itstool) path: section/para
en: For example:
sr: На пример:

note: (itstool) path: section/para
en: Suppresses definition of <function>Glib::wrap_new()</function> function in <function>_CLASS_GOBJECT</function>.
sr: Потискује дефиницију <function>Glib::wrap_new()</function> функције у <function>_CLASS_GOBJECT</function>.

note: (itstool) path: section/para
en: Suppresses definition of <function>Glib::wrap()</function> function in <function>_CLASS_GOBJECT</function> and <function>_CLASS_GTKOBJECT</function>.
sr: Потискује дефиницију <function>Glib::wrap()</function> функције у <function>_CLASS_GOBJECT</function> и <function>_CLASS_GTKOBJECT</function>.

note: (itstool) path: section/para
en: Suppresses declaration and definition of <function>Glib::wrap()</function> function in <function>_CLASS_GOBJECT</function>, <function>_CLASS_BOXEDTYPE</function>, <function>_CLASS_BOXEDTYPE_STATIC</function>, <function>_CLASS_OPAQUE_COPYABLE</function>, <function>_CLASS_INTERFACE</function> and <function>_CLASS_GTKOBJECT</function>.
sr: Потискује декларацију и дефиницију <function>Glib::wrap()</function> функције у <function>_CLASS_GOBJECT</function>, <function>_CLASS_BOXEDTYPE</function>, <function>_CLASS_BOXEDTYPE_STATIC</function>, <function>_CLASS_OPAQUE_COPYABLE</function>, <function>_CLASS_INTERFACE</function> и <function>_CLASS_GTKOBJECT</function>.

note: (itstool) path: section/title
en: Method macros
sr: Макрои метода

note: (itstool) path: section/para
en: This macro generates the <phrase role="nowrap">C++</phrase> method to wrap a C function.
sr: Овај макро ствара <phrase role="nowrap">Ц++</phrase> методу за обавијање Ц функције.

note: (itstool) path: section/para
en: <function>_WRAP_METHOD( C++ method signature, C function name)</function>
sr: <function>_WRAP_METHOD( потпис Ц++ методе, назив Ц функције)</function>

note: (itstool) path: section/para
en: For instance, from <filename>entry.hg</filename>:
sr: На пример, из <filename>entry.hg</filename>:

note: (itstool) path: section/para
en: The C function (e.g. <function>gtk_entry_set_text</function>) is described more fully in the .defs file, and the <filename>convert*.m4</filename> files contain the necessary conversion from the <phrase role="nowrap">C++</phrase> parameter type to the C parameter type. This macro also generates doxygen documentation comments based on the <filename>*_docs.xml</filename> and <filename>*_docs_override.xml</filename> files.
sr: Ц функција (нпр. <function>gtk_entry_set_text</function>) је потпуније описана у .defs датотеци, а <filename>convert*.m4</filename> датотеке садрже неопходну конверзију из <phrase role="nowrap">Ц++</phrase> врсте параметра у Ц врсту параметра. Овај макро такође ствара doxygen коментаре документације на основу <filename>*_docs.xml</filename> и <filename>*_docs_override.xml</filename> датотека.

note: (itstool) path: listitem/para
en: Do an extra <function>reference()</function> on the return value, in case the C function does not provide a reference.
sr: Извршите додатно <function>reference()</function> над повратном вредношћу, у случају да Ц функција не пружа референцу.

note: (itstool) path: listitem/para
en: Use the last GError** parameter of the C function to throw an exception. The optional "&lt;exceptions&gt;" is a comma-separated list of exceptions that can be thrown. It determines which @throws Doxygen commands are added to the documentation. Default value is <classname>Glib::Error</classname>. If you want a comma in the description of an exception, precede it by a backslash. Example: <code>errthrow "Glib::OptionError Hello\, world, Glib::ConvertError"</code>
sr: Користите последњи GError** параметар Ц функције за избацивање изузетка. Опционо „&lt;exceptions&gt;“ је списком зарезима раздвојених изузетака који могу бити избачени. То одређује које @throws Doxygen наредбе се додају у документацију. Подразумевана вредност је <classname>Glib::Error</classname>. Ако желите зарез у опису изузетка, ставите контра косу црту испред њега. Пример: <code>errthrow "Glib::OptionError Hello\, world, Glib::ConvertError"</code>

note: (itstool) path: listitem/para
en: Puts the generated code in #ifdef blocks. Text about the deprecation can be specified as an optional parameter.
sr: Смешта створени код у #ifdef блокове. Текст о застарелости може бити наведен као опциони параметар.

note: (itstool) path: listitem/para
en: Puts the generated code in the .cc file in a G_GNUC_BEGIN_IGNORE_DEPRECATIONS / G_GNUC_END_IGNORE_DEPRECATIONS block. (Only in glibmm &gt;= 2.70.1)
sr: Смешта створени код у .cc датотеку унутар G_GNUC_BEGIN_IGNORE_DEPRECATIONS / G_GNUC_END_IGNORE_DEPRECATIONS блока. (Само у glibmm &gt;= 2.70.1)

note: (itstool) path: listitem/para
en: Just call the non-const version of the same function, instead of generating almost duplicate code.
sr: Само позовите неконстантну верзију исте функције, уместо да стварате скоро истоветан код.

note: (itstool) path: varlistentry/term
en: newin "&lt;version&gt;"
sr: newin "&lt;издање&gt;"

note: (itstool) path: listitem/para
en: Adds a @newin Doxygen command to the documentation, or replaces the @newin command generated from the C documentation.
sr: Додаје @newin Doxygen наредбу у документацију, или замењује @newin наредбу створену из Ц документације.

note: (itstool) path: varlistentry/term
en: ifdef &lt;identifier&gt;
sr: ifdef &lt;одредник&gt;

note: (itstool) path: listitem/para
en: Puts the generated code in #ifdef blocks.
sr: Смешта створени код у #ifdef блокове.

note: (itstool) path: varlistentry/term
en: slot_name &lt;parameter_name&gt;
sr: slot_name &lt;назив_параметра&gt;

note: (itstool) path: listitem/para
en: Specifies the name of the slot parameter of the method, if it has one. This enables <command>gmmproc</command> to generate code to copy the slot and pass the copy on to the C function in its final <literal>gpointer user_data</literal> parameter. The <literal>slot_callback</literal> option must also be used to specify the name of the glue callback function to also pass on to the C function.
sr: Наводи назив параметра места (slot) за метод, ако га има. Ово омогућава програму <command>gmmproc</command> да створи код за умножавање места и прослеђивање умношка Ц функцији у њеном завршном <literal>gpointer user_data</literal> параметру. Опција <literal>slot_callback</literal> се такође мора користити за навођење назива везивне функције повратног позива која се такође прослеђује Ц функцији.

note: (itstool) path: varlistentry/term
en: slot_callback &lt;function_name&gt;
sr: slot_callback &lt;назив_функције&gt;

note: (itstool) path: listitem/para
en: Used in conjunction with the <literal>slot_name</literal> option to specify the name of the glue callback function that handles extracting the slot and then calling it. The address of this callback is also passed on to the C function that the method wraps.
sr: Користи се заједно са опцијом <literal>slot_name</literal> за навођење назива везивне функције повратног позива која управља извлачењем места и његовим позивањем. Адреса овог повратног позива се такође прослеђује Ц функцији коју метод обавија.

note: (itstool) path: listitem/para
en: Tells <command>gmmproc</command> not to pass a copy of the slot to the C function, if the method has one. Instead the slot itself is passed. The slot parameter name and the glue callback function must have been specified with the <literal>slot_name</literal> and <literal>slot_callback</literal> options respectively.
sr: Говори програму <command>gmmproc</command> да не прослеђује умножак места Ц функцији, ако га метод има. Уместо тога се прослеђује само место. Назив параметра места и везивна функција повратног позива морају бити наведени опцијама <literal>slot_name</literal> и <literal>slot_callback</literal>.

note: (itstool) path: section/para
en: There are some optional extra arguments: <_:variablelist-1/>
sr: Постоје неки необавезни додатни аргументи: <_:variablelist-1/>

note: (itstool) path: listitem/para
en: Objects used via <classname>RefPtr</classname>: Pass the <classname>RefPtr</classname> as a const reference. For instance, <code>const Glib::RefPtr&lt;Gtk::FileFilter&gt;&amp; filter</code>.
sr: Објекти који се користе преко <classname>RefPtr</classname>-а: Проследите <classname>RefPtr</classname> као константну референцу. На пример, <code>const Glib::RefPtr&lt;Gtk::FileFilter&gt;&amp; filter</code>.

note: (itstool) path: listitem/para
en: Const Objects used via <classname>RefPtr</classname>: If the object should not be changed by the function, then make sure that the object is const, even if the <classname>RefPtr</classname> is already const. For instance, <code>const Glib::RefPtr&lt;const Gtk::FileFilter&gt;&amp; filter</code>.
sr: Константни објекти који се користе преко <classname>RefPtr</classname>-а: Ако функција не треба да мења објекат, побрините се да објекат буде константан, чак и ако је <classname>RefPtr</classname> већ константан. На пример, <code>const Glib::RefPtr&lt;const Gtk::FileFilter&gt;&amp; filter</code>.

note: (itstool) path: listitem/para
en: Wrapping <classname>GList*</classname> and <classname>GSList*</classname> parameters: First, you need to discover what objects are contained in the list's data field for each item, usually by reading the documentation for the C function. The list can then be wrapped by a <classname>std::vector</classname> type. For instance, <code>std::vector&lt;Glib::RefPtr&lt;Gdk::Pixbuf&gt;&gt;</code>. You may need to define a Traits type to specify how the C and <phrase role="nowrap">C++</phrase> types should be converted.
sr: Обавијање <classname>GList*</classname> и <classname>GSList*</classname> параметара: Прво треба да откријете који се објекти налазе у пољу података списка за сваку ставку, обично читањем документације за Ц функцију. Списак се затим може обавити типом <classname>std::vector</classname>. На пример, <code>std::vector&lt;Glib::RefPtr&lt;Gdk::Pixbuf&gt;&gt;</code>. Можда ћете морати да дефинишете Traits тип како бисте навели како Ц и <phrase role="nowrap">C++</phrase> типови треба да се претворе.

note: (itstool) path: listitem/para
en: Wrapping <classname>GList*</classname> and <classname>GSList*</classname> return types: You must discover whether the caller should free the list and whether it should release the items in the list, again by reading the documentation of the C function. With this information you can choose the ownership (none, shallow or deep) for the m4 conversion rule, which you should probably put directly into the .hg file because the ownership depends on the function rather than the type. For instance:
sr: Обавијање <classname>GList*</classname> и <classname>GSList*</classname> повратних типова: Морате открити да ли позивалац треба да ослободи списак и да ли треба да отпусти ставке у списку, поново читањем документације Ц функције. Помоћу ових података можете изабрати власништво (никакво, површно или дубоко) за m4 правило конверзије, које вероватно треба да ставите директно у .hg датотеку јер власништво зависи од функције пре него од типа. На пример:

note: (itstool) path: section/para
en: Selecting which <phrase role="nowrap">C++</phrase> types should be used is also important when wrapping C API. Though it's usually obvious what <phrase role="nowrap">C++</phrase> types should be used in the <phrase role="nowrap">C++</phrase> method, here are some hints: <_:itemizedlist-1/>
sr: Бирање који <phrase role="nowrap">C++</phrase> типови треба да се користе је такође важно приликом обавијања Ц АПИ-ја. Иако је обично очигледно који <phrase role="nowrap">C++</phrase> типови треба да се користе у <phrase role="nowrap">C++</phrase> методу, ево неких савета: <_:itemizedlist-1/>

note: (itstool) path: section/para
en: This macro is like <function>_WRAP_METHOD()</function>, but it generates only the documentation for a <phrase role="nowrap">C++</phrase> method that wraps a C function. Use this when you must hand-code the method, but you want to use the documentation that would be generated if the method was generated.
sr: Овај макро је сличан <function>_WRAP_METHOD()</function>, али генерише само документацију за <phrase role="nowrap">C++</phrase> метод који обавија C функцију. Користите ово када морате ручно да напишете метод, али желите да користите документацију која би била генерисана да је метод генерисан.

note: (itstool) path: section/para
en: <function>_WRAP_METHOD_DOCS_ONLY(C function name)</function>
sr: <function>_WRAP_METHOD_DOCS_ONLY(назив C функције)</function>

note: (itstool) path: section/para
en: For instance, from <filename>recentinfo.hg</filename>:
sr: На пример, из <filename>recentinfo.hg</filename>:

note: (itstool) path: listitem/para
en: Excludes documentation of the last GError** parameter of the C function. The optional "&lt;exceptions&gt;" is a comma-separated list of exceptions that can be thrown. It determines which @throws Doxygen commands are added to the documentation. Default value is <classname>Glib::Error</classname>. If you want a comma in the description of an exception, precede it by a backslash. Example: <code>errthrow "Glib::OptionError Hello\, world, Glib::ConvertError"</code>
sr: Искључује документацију последњег GError** параметра C функције. Опционо „&lt;exceptions&gt;“ је листа изузетака раздвојених зарезом који могу бити избачени. То одређује које @throws Doxygen наредбе се додају у документацију. Подразумевана вредност је <classname>Glib::Error</classname>. Ако желите зарез у опису изузетка, ставите обрнуту косу црту испред њега. Пример: <code>errthrow "Glib::OptionError Hello\, world, Glib::ConvertError"</code>

note: (itstool) path: listitem/para
en: Don't include a @return Doxygen command in the documentation. Useful if the wrapped C function returns a value, but the corresponding <phrase role="nowrap">C++</phrase> method returns <type>void</type>.
sr: Не укључујте @return Doxygen наредбу у документацију. Корисно ако обавијена C функција враћа вредност, али одговарајући <phrase role="nowrap">C++</phrase> метод враћа <type>void</type>.

note: (itstool) path: section/para
en: <command>gmmproc</command> will warn you on stdout about functions, signals, properties and child properties that you have forgotten to wrap, helping to ensure that you are wrapping the complete API. But if you don't want to wrap some functions, signals, properties or child properties, or if you chose to hand-code some methods then you can use the _IGNORE(), _IGNORE_SIGNAL() or _IGNORE_PROPERTY() macro to make <command>gmmproc</command> stop complaining.
sr: <command>gmmproc</command> ће вас упозорити на стандардном излазу о функцијама, сигналима, својствима и својствима деце које сте заборавили да обавијете, помажући да осигурате да обавијате комплетан API. Али ако не желите да обавијете неке функције, сигнале, својства или својства деце, или ако сте изабрали да ручно напишете неке методе, онда можете користити _IGNORE(), _IGNORE_SIGNAL() или _IGNORE_PROPERTY() макро да зауставите <command>gmmproc</command> да се жали.

note: (itstool) path: para/literallayout
en: <function>_IGNORE(C function name 1, C function name 2, etc)
    _IGNORE_SIGNAL(C signal name 1, C signal name 2, etc)
    _IGNORE_PROPERTY(C property name 1, C property name 2, etc)</function>
sr: <function>_IGNORE(назив C функције 1, назив C функције 2, итд)
    _IGNORE_SIGNAL(назив C сигнала 1, назив C сигнала 2, итд)
    _IGNORE_PROPERTY(назив C својства 1, назив C својства 2, итд)</function>

note: (itstool) path: section/para
en: For instance, from <filename>flowbox.hg</filename>:
sr: На пример, из <filename>flowbox.hg</filename>:

note: (itstool) path: section/para
en: This macro generates the <phrase role="nowrap">C++</phrase> libsigc++-style signal to wrap a C GObject signal. It actually generates a public accessor method, such as <function>signal_clicked()</function>, which returns a proxy object. <command>gmmproc</command> uses the .defs file to discover the C parameter types and the .m4 convert files to discover appropriate type conversions.
sr: Овај макро генерише <phrase role="nowrap">C++</phrase> сигнал у libsigc++ стилу за обавијање C GObject сигнала. Он заправо генерише јавни метод приступа, као што је <function>signal_clicked()</function>, који враћа прокси објекат. <command>gmmproc</command> користи .defs датотеку да открије врсте C параметара и .m4 датотеке конверзије да открије одговарајуће конверзије врста.

note: (itstool) path: section/para
en: <function>_WRAP_SIGNAL( C++ signal handler signature, C signal name)</function>
sr: <function>_WRAP_SIGNAL(потпис C++ руковаоца сигналом, назив C сигнала)</function>

note: (itstool) path: section/para
en: For instance, from <filename>button.hg</filename>:
sr: На пример, из <filename>button.hg</filename>:

note: (itstool) path: section/para
en: Signals usually have function pointers in the GTK struct, with a corresponding enum value and a <function>g_signal_new()</function> in the .c file.
sr: Сигнали обично имају показиваче функција у GTK структури, са одговарајућом вредношћу набрајања и <function>g_signal_new()</function> у .c датотеци.

note: (itstool) path: listitem/para
en: Do not generate an <function>on_something()</function> virtual method to allow easy overriding of the default signal handler. Use this when adding a signal with a default signal handler would break the ABI by increasing the size of the class's virtual function table, and when adding a signal without a public C default handler.
sr: Немојте генерисати <function>on_something()</function> виртуелни метод како бисте омогућили лако преклапање подразумеваног руковаоца сигналом. Користите ово када би додавање сигнала са подразумеваним руковаоцем сигналом нарушило ABI повећањем величине табеле виртуелних функција класе, и када додајете сигнал без јавног C подразумеваног руковаоца.

note: (itstool) path: listitem/para
en: Generate a declaration of the <function>on_something()</function> virtual method in the <filename>.h</filename> file, but do not generate a definition in the <filename>.cc</filename> file. Use this when you must generate the definition by hand.
sr: Генеришите декларацију виртуелног метода <function>on_something()</function> у <filename>.h</filename> датотеци, али немојте генерисати дефиницију у <filename>.cc</filename> датотеци. Користите ово када дефиницију морате генерисати ручно.

note: (itstool) path: listitem/para
en: Do not generate a C callback function for the signal. Use this when you must generate the callback function by hand.
sr: Немојте генерисати C функцију повратног позива за сигнал. Користите ово када функцију повратног позива морате генерисати ручно.

note: (itstool) path: listitem/para
en: Do an extra <function>reference()</function> on the return value of the <function>on_something()</function> virtual method, in case the C function does not provide a reference.
sr: Извршите додатно <function>reference()</function> над повратном вредношћу виртуелног метода <function>on_something()</function>, у случају да C функција не обезбеђује референцу.

note: (itstool) path: listitem/para
en: Allows to use custom exception handler instead of default one. Exception might be rethrown by user-defined handler, and it will be caught by default handler.
sr: Омогућава коришћење произвољног руковаоца изузецима уместо подразумеваног. Кориснички дефинисан руковалац може поново избацити изузетак, а тада ће га ухватити подразумевани руковалац.

note: (itstool) path: listitem/para
en: Adds a <type>const Glib::ustring&amp;</type> parameter to the <methodname>signal_something()</methodname> method. Use it, if the signal accepts a detailed signal name, i.e. if the underlying C code registers the signal with the <literal>G_SIGNAL_DETAILED</literal> flag.
sr: Додаје параметар <type>const Glib::ustring&amp;</type> методу <methodname>signal_something()</methodname>. Користите га ако сигнал прихвата детаљан назив сигнала, тј. ако основни C код региструје сигнал са заставицом <literal>G_SIGNAL_DETAILED</literal>.

note: (itstool) path: listitem/para
en: Used in conjunction with the <literal>detail_name</literal> option to generate two <methodname>signal_something()</methodname> methods, one without a parameter and one with a parameter without a default value. With only the <literal>detail_name</literal> option one method is generated, with a parameter with default value. Use the <literal>two_signal_methods</literal> option, if it's necessary in order to preserve ABI.
sr: Користи се заједно са опцијом <literal>detail_name</literal> за генерисање два <methodname>signal_something()</methodname> метода, једног без параметра и једног са параметром без подразумеване вредности. Само са опцијом <literal>detail_name</literal> генерише се један метод, са параметром са подразумеваном вредношћу. Користите опцију <literal>two_signal_methods</literal> ако је то неопходно ради очувања ABI-ја.

note: (itstool) path: section/para
en: This macro generates the <phrase role="nowrap">C++</phrase> method to wrap a C GObject property. You must specify the property name and the wanted <phrase role="nowrap">C++</phrase> type for the property. <command>gmmproc</command> uses the .defs file to discover the C type and the .m4 convert files to discover appropriate type conversions.
sr: Овај макро генерише <phrase role="nowrap">C++</phrase> метод за премошћавање својства C GObject-а. Морате навести назив својства и жељену <phrase role="nowrap">C++</phrase> врсту за то својство. <command>gmmproc</command> користи .defs датотеку за откривање C врсте и .m4 датотеке конверзије за откривање одговарајућих претварања врста.

note: (itstool) path: section/para
en: This macro generates the <phrase role="nowrap">C++</phrase> method to wrap a virtual C function.
sr: Овај макро генерише <phrase role="nowrap">C++</phrase> метод за премошћавање виртуелне C функције.

note: (itstool) path: section/para
en: For instance, from <filename>widget.hg</filename>:
sr: На пример, из <filename>widget.hg</filename>:

note: (itstool) path: section/para
en: The C function (e.g. <function>get_request_mode</function>) is described more fully in the <filename>*_vfuncs.defs</filename> file, and the <filename>convert*.m4</filename> files contain the necessary conversion from the <phrase role="nowrap">C++</phrase> parameter type to the C parameter type. Conversions can also be written in the .hg file. Virtual functions often require special conversions that are best kept local to the .hg file where they are used.
sr: Ц функција (нпр. <function>get_request_mode</function>) је детаљније описана у датотеци <filename>*_vfuncs.defs</filename>, а датотеке <filename>convert*.m4</filename> садрже неопходну конверзију из <phrase role="nowrap">C++</phrase> типа параметра у Ц тип параметра. Конверзије се такође могу писати у .hg датотеци. Виртуелне функције често захтевају посебне конверзије које је најбоље држати локално у .hg датотеци где се користе.

note: (itstool) path: listitem/para
en: Do an extra <function>reference()</function> on the return value of the <function>something_vfunc()</function> function, in case the virtual C function does not provide a reference.
sr: Извршите додатно <function>reference()</function> на повратну вредност функције <function>something_vfunc()</function>, у случају да виртуелна Ц функција не обезбеђује референцу.

note: (itstool) path: listitem/para
en: Do an extra <function>reference()</function> on the return value of an overridden <function>something_vfunc()</function> function in the C callback function, in case the calling C function expects it to provide a reference.
sr: Извршите додатно <function>reference()</function> на повратну вредност преклопљене функције <function>something_vfunc()</function> у Ц повратном позиву, у случају да Ц функција која позива очекује да она обезбеди референцу.

note: (itstool) path: listitem/para
en: Keep a copy of the return value in the C callback function, in case the calling C function does not expect to get its own reference.
sr: Задржите копију повратне вредности у Ц повратној функцији, у случају да Ц функција која позива не очекује да добије сопствену референцу.

note: (itstool) path: listitem/para
en: Use the last GError** parameter of the C virtual function (if there is one) to throw an exception.
sr: Користите последњи GError** параметар Ц виртуелне функције (ако постоји) за избацивање изузетка.

note: (itstool) path: listitem/para
en: Do not generate a definition of the vfunc in the <filename>.cc</filename> file. Use this when you must generate the vfunc by hand.
sr: Немојте генерисати дефиницију виртуелне функције (vfunc) у <filename>.cc</filename> датотеци. Користите ово када морате ручно генерисати виртуелну функцију.

note: (itstool) path: listitem/para
en: Do not generate a C callback function for the vfunc. Use this when you must generate the callback function by hand.
sr: Немојте генерисати Ц функцију повратног позива за виртуелну функцију. Користите ово када морате ручно генерисати функцију повратног позива.

note: (itstool) path: listitem/para
en: Defines a non-default return value.
sr: Дефинише неподразумевану повратну вредност.

note: (itstool) path: listitem/para
en: Defines a non-default return value, used only if the <phrase role="nowrap">C++</phrase> <function>something_vfunc()</function> function throws an exception which is propagated to the C callback function. If return_value is specified, but err_return_value is not, then return_value is used also when an exception is propagated.
sr: Дефинише неподразумевану повратну вредност, која се користи само ако <phrase role="nowrap">C++</phrase> функција <function>something_vfunc()</function> избаци изузетак који се прослеђује до Ц функције повратног позива. Ако је наведено return_value, али није err_return_value, тада се return_value користи и када се изузетак прослеђује.

note: (itstool) path: section/para
en: A rule to which there may be exceptions: If the virtual C function returns a pointer to an object derived from <classname>GObject</classname>, i.e. a reference-counted object, then the virtual <phrase role="nowrap">C++</phrase> function shall return a <classname>Glib::RefPtr&lt;&gt;</classname> object. One of the extra arguments <parameter>refreturn</parameter> or <parameter>refreturn_ctype</parameter> is required.
sr: Правило за које могу постојати изузеци: Ако виртуелна Ц функција враћа показивач на објекат изведен из <classname>GObject</classname>, тј. објекат са бројањем референци, тада виртуелна <phrase role="nowrap">C++</phrase> функција треба да врати <classname>Glib::RefPtr&lt;&gt;</classname> објекат. Један од додатних аргумената <parameter>refreturn</parameter> или <parameter>refreturn_ctype</parameter> је обавезан.

note: (itstool) path: section/title
en: Other macros
sr: Остали макрои

note: (itstool) path: section/para
en: This macro generates initialization code for the interface.
sr: Овај макро генерише код за покретање интерфејса.

note: (itstool) path: section/para
en: For instance, from <filename>grid.hg</filename>:
sr: На пример, из <filename>grid.hg</filename>:

note: (itstool) path: section/para
en: There is one optional extra argument: <_:variablelist-1/>
sr: Постоји један опциони додатни аргумент: <_:variablelist-1/>

note: (itstool) path: section/para
en: This macro generates a <phrase role="nowrap">C++</phrase> enum to wrap a C enum. You must specify the desired <phrase role="nowrap">C++</phrase> name and the name of the underlying C enum.
sr: Овај макро генерише <phrase role="nowrap">C++</phrase> набрајање (enum) за омотавање Ц набрајања. Морате навести жељено <phrase role="nowrap">C++</phrase> име и име основног Ц набрајања.

note: (itstool) path: section/para
en: For instance, from <filename>enums.hg</filename>:
sr: На пример, из <filename>enums.hg</filename>:

note: (itstool) path: listitem/para
en: Use this option, if the enum is not a <classname>GType</classname>. This is the case when there is no <function>*_get_type()</function> function for the C enum, but be careful that you don't just need to include an extra header for that function. You should also file a bug against the C API, because all enums should be registered as GTypes.
sr: Користите ову опцију ако набрајање није <classname>GType</classname>. Ово је случај када не постоји функција <function>*_get_type()</function> за Ц набрајање, али пазите да вам можда не треба само додатна датотека заглавља за ту функцију. Такође би требало да пошаљете извештај о грешци за Ц АПИ, јер би сва набрајања требало да буду регистрована као Г-врсте (GTypes).

note: (itstool) path: listitem/para
en: If you specify <literal>NO_GTYPE</literal>, don't use that enum as the type in _WRAP_PROPERTY. It would cause a runtime error, when the generated <methodname>property_*()</methodname> method is called.
sr: Ако наведете <literal>NO_GTYPE</literal>, немојте користити то набрајање као врсту у _WRAP_PROPERTY. То би изазвало грешку у време извршавања када се позове генерисани метод <methodname>property_*()</methodname>.

note: (itstool) path: listitem/para
en: For example, from <filename>icontheme.hg</filename>:
sr: На пример, из <filename>icontheme.hg</filename>:

note: (itstool) path: varlistentry/term
en: gtype_func &lt;function_name&gt;
sr: gtype_func &lt;назив_функције&gt;

note: (itstool) path: listitem/para
en: Specifies the name of the <function>*_get_type()</function> function for the C enum. Use this parameter if <command>gmmproc</command> can't deduce the correct function name from the name of the C enum type.
sr: Одређује назив функције <function>*_get_type()</function> за Ц набрајање. Користите овај параметар ако <command>gmmproc</command> не може да изведе исправан назив функције из назива врсте Ц набрајања.

note: (itstool) path: listitem/para
en: For example, from <filename>dbusproxy.hg</filename> in glibmm:
sr: На пример, из <filename>dbusproxy.hg</filename> у glibmm-у:

note: (itstool) path: listitem/para
en: "Convertible to int." Generates a plain enum (not an enum class) within a class. Such an enum is scoped like an enum class, but unlike an enum class, it can be implicitly converted to <type>int</type>.
sr: „Претвориво у цео број.“ Генерише обично набрајање (не класу набрајања) унутар класе. Такво набрајање има опсег као класа набрајања, али за разлику од класе набрајања, може се имплицитно претворити у <type>int</type>.

note: (itstool) path: listitem/para
en: For example, from <filename>dialog.hg</filename>:
sr: На пример, из <filename>dialog.hg</filename>:

note: (itstool) path: varlistentry/term
en: s#&lt;from&gt;#&lt;to&gt;#
sr: s#&lt;од&gt;#&lt;у&gt;#

note: (itstool) path: listitem/para
en: Substitutes (part of) the name of one or more enum constants. You can add any number of substitutions.
sr: Замењује (део) назива једне или више константи набрајања. Можете додати било који број замена.

note: (itstool) path: listitem/para
en: For example, from <filename>toplevel.hg</filename>:
sr: На пример, из <filename>toplevel.hg</filename>:

note: (itstool) path: varlistentry/term
en: decl_prefix &lt;declaration_prefix&gt;
sr: decl_prefix &lt;префикс_декларације&gt;

note: (itstool) path: listitem/para
en: Typically used for a C preprocessor macro defined as <literal>__declspec(dllexport)</literal> or <literal>__declspec(dllimport)</literal> when building with MSVC on Windows, defined as an empty string otherwise.
sr: Обично се користи за макро Ц препроцесора дефинисан као <literal>__declspec(dllexport)</literal> или <literal>__declspec(dllimport)</literal> приликом изградње помоћу MSVC-а на Виндоузу, а у супротном је дефинисан као празна ниска.

note: (itstool) path: section/para
en: This macro just generates a Doxygen documentation block for the enum. This is useful for enums that can't be wrapped with <function>_WRAP_ENUM()</function> because they are complexly defined (maybe using C macros) but including the generated enum documentation is still desired. It is used with the same syntax as <function>_WRAP_ENUM()</function> and also processes the same options (though NO_GTYPE, gtype_func &lt;function_name&gt; and CONV_TO_INT are ignored because they make no difference when just generating the enum's documentation).
sr: Овај макро само генерише блок Доксиген документације за набрајање. Ово је корисно за набрајања која се не могу преломити помоћу <function>_WRAP_ENUM()</function> јер су сложено дефинисана (можда коришћењем Ц макроа), али је и даље пожељно укључивање генерисане документације набрајања. Користи се са истом синтаксом као и <function>_WRAP_ENUM()</function> и такође обрађује исте опције (иако се NO_GTYPE, gtype_func &lt;назив_функције&gt; и CONV_TO_INT занемарују јер не праве разлику када се само генерише документација набрајања).

note: (itstool) path: section/para
en: This macro generates a <phrase role="nowrap">C++</phrase> exception class, derived from <classname>Glib::Error</classname>, with a <type>Code</type> enum and a <methodname>code()</methodname> method. You must specify the desired <phrase role="nowrap">C++</phrase> name, the name of the corresponding C enum, and the prefix for the C enum values.
sr: Овај макро ствара <phrase role="nowrap">Ц++</phrase> класу изузетка, изведену из <classname>Glib::Error</classname>, са <type>Code</type> набрајањем и <methodname>code()</methodname> методом. Морате навести жељени <phrase role="nowrap">Ц++</phrase> назив, назив одговарајућег Ц набрајања, и префикс за вредности Ц набрајања.

note: (itstool) path: section/para
en: This exception can then be thrown by methods which are generated from _WRAP_METHOD() with the errthrow option.
sr: Овај изузетак затим могу избацити методе које су створене из _WRAP_METHOD() са опцијом „errthrow“.

note: (itstool) path: section/para
en: For instance, from <filename>pixbuf.hg</filename>:
sr: На пример, из <filename>pixbuf.hg</filename>:

note: (itstool) path: section/para
en: _WRAP_GERROR() accepts the same optional arguments as _WRAP_ENUM() (though CONV_TO_INT is ignored because all exception class enums are plain enums within a class).
sr: _WRAP_GERROR() прихвата исте необавезне аргументе као и _WRAP_ENUM() (иако се CONV_TO_INT занемарује јер су сва набрајања класе изузетка обична набрајања унутар класе).

note: (itstool) path: section/para
en: Use these macros if you're wrapping a simple struct or boxed type that provides direct access to its data members, to create getters and setters for the data members.
sr: Користите ове макрое ако обавијате једноставну структуру или уоквирену врсту која пружа директан приступ својим члановима података, како бисте направили добављаче и постављаче за чланове података.

note: (itstool) path: section/para
en: <function>_MEMBER_GET(C++ name, C name, C++ type, C type)</function>
sr: <function>_MEMBER_GET(Ц++ назив, Ц назив, Ц++ врста, Ц врста)</function>

note: (itstool) path: section/para
en: <function>_MEMBER_SET(C++ name, C name, C++ type, C type)</function>
sr: <function>_MEMBER_SET(Ц++ назив, Ц назив, Ц++ врста, Ц врста)</function>

note: (itstool) path: section/para
en: For example, in <filename>rectangle.hg</filename>:
sr: На пример, у <filename>rectangle.hg</filename>:

note: (itstool) path: section/para
en: Use these macros to automatically provide getters and setters for a data member that is a pointer type. For the getter function, it will create two methods, one const and one non-const.
sr: Користите ове макрое да аутоматски обезбедите добављаче и постављаче за члана података који је врста показивача. За функцију добављача, направиће две методе, једну константну и једну неконстантну.

note: (itstool) path: section/para
en: <function>_MEMBER_GET_PTR(C++ name, C name, C++ type, C type)</function>
sr: <function>_MEMBER_GET_PTR(Ц++ назив, Ц назив, Ц++ врста, Ц врста)</function>

note: (itstool) path: section/para
en: <function>_MEMBER_SET_PTR(C++ name, C name, C++ type, C type)</function>
sr: <function>_MEMBER_SET_PTR(Ц++ назив, Ц назив, Ц++ врста, Ц врста)</function>

note: (itstool) path: section/para
en: For example, for <classname>Pango::Analysis</classname> in <filename>item.hg</filename>:
sr: На пример, за <classname>Pango::Analysis</classname> у <filename>item.hg</filename>:

note: (itstool) path: section/programlisting
en: <code>// _MEMBER_GET_PTR(engine_lang, lang_engine, EngineLang*, PangoEngineLang*)
    // It's just a comment. It's difficult to find a real-world example.
    </code>
sr: <code>// _MEMBER_GET_PTR(engine_lang, lang_engine, EngineLang*, PangoEngineLang*)
    // То је само коментар. Тешко је пронаћи пример из стварног света.
    </code>

note: (itstool) path: section/para
en: Use these macros to provide getters and setters for a data member that is a <classname>GObject</classname> type that must be referenced before being returned.
sr: Користите ове макрое да обезбедите добављаче и постављаче за члана података који је <classname>GObject</classname> врста која мора бити упућена пре него што буде враћена.

note: (itstool) path: section/para
en: For example, in Pangomm, <filename>layoutline.hg</filename>:
sr: На пример, у Pangomm-у, <filename>layoutline.hg</filename>:

note: (itstool) path: section/title
en: gmmproc Parameter Processing
sr: gmmproc обрада параметара

note: (itstool) path: section/para
en: <command>gmmproc</command> allows processing the parameters in a method signature for the macros that process method signatures (like <function>_WRAP_METHOD()</function>, <function>_WRAP_CTOR()</function> and <function>_WRAP_CREATE()</function>) in a variety of ways:
sr: <command>gmmproc</command> омогућава обраду параметара у потпису методе за макрое који обрађују потписе метода (као што су <function>_WRAP_METHOD()</function>, <function>_WRAP_CTOR()</function> и <function>_WRAP_CREATE()</function>) на различите начине:

note: (itstool) path: section/title
en: Parameter Reordering
sr: Промена редоследа параметара

note: (itstool) path: section/para
en: For all the macros that process method signatures, it is possible to specify a different order for the <phrase role="nowrap">C++</phrase> parameters than the existing order in the C function, virtual function or signal. For example, say that the following C function were being wrapped as a <phrase role="nowrap">C++</phrase> method for the <classname>Gtk::Widget</classname> class:
sr: За све макрое који обрађују потписе метода, могуће је навести другачији редослед за <phrase role="nowrap">C++</phrase> параметре од постојећег редоследа у C функцији, виртуелној функцији или сигналу. На пример, рецимо да је следећа C функција преломљена као <phrase role="nowrap">C++</phrase> метода за класу <classname>Gtk::Widget</classname>:

note: (itstool) path: section/para
en: However, changing the order of the <phrase role="nowrap">C++</phrase> method's two parameters is necessary. Something like the following would wrap the function as a <phrase role="nowrap">C++</phrase> method with a different order for the two parameters:
sr: Међутим, промена редоследа два параметра C++ методе је неопходна. Нешто попут следећег би преломило функцију као <phrase role="nowrap">C++</phrase> методу са другачијим редоследом за два параметра:

note: (itstool) path: section/para
en: The <literal>{c_param_name}</literal> following the method parameter names tells <command>gmmproc</command> to map the <phrase role="nowrap">C++</phrase> parameter to the specified C parameter within the <literal>{}</literal>. Since the <phrase role="nowrap">C++</phrase> parameter names correspond to the C ones, the above could be re-written as:
sr: <literal>{c_param_name}</literal> који следи након назива параметара методе говори програму <command>gmmproc</command> да мапира <phrase role="nowrap">C++</phrase> параметар на наведени C параметар унутар <literal>{}</literal>. Пошто називи <phrase role="nowrap">C++</phrase> параметара одговарају C параметрима, горенаведено се може поново написати као:

note: (itstool) path: warning/para
en: Please note that when reordering parameters for a <function>_WRAP_SIGNAL()</function> method signature, the C parameter names would always be <literal>p0</literal>, <literal>p1</literal>, etc. because the <filename>generate_extra_defs</filename> utility uses those parameter names no matter what the C API's parameter names may be. It's how the utility is written presently.
sr: Имајте на уму да приликом промене редоследа параметара за потпис методе <function>_WRAP_SIGNAL()</function>, називи C параметара ће увек бити <literal>p0</literal>, <literal>p1</literal>, итд. јер алатка <filename>generate_extra_defs</filename> користи те називе параметара без обзира на то који су називи параметара у C API-ју. Тако је алатка тренутно написана.

note: (itstool) path: section/title
en: Optional Parameter Processing
sr: Обрада опционих параметара

note: (itstool) path: section/para
en: For all macros processing method signatures except <function>_WRAP_SIGNAL()</function> and <function>_WRAP_VFUNC()</function> it is also possible to make the parameters optional so that extra <phrase role="nowrap">C++</phrase> methods are generated without the specified optional parameter. For example, say that the following <function>*_new()</function> function were being wrapped as a constructor in the <classname>Gtk::ToolButton</classname> class:
sr: За све макрое који обрађују потписе метода осим <function>_WRAP_SIGNAL()</function> и <function>_WRAP_VFUNC()</function> такође је могуће учинити параметре опционим тако да се генеришу додатне <phrase role="nowrap">C++</phrase> методе без наведеног опционог параметра. На пример, рецимо да је следећа <function>*_new()</function> функција преломљена као конструктор у класи <classname>Gtk::ToolButton</classname>:

note: (itstool) path: section/para
en: Also, say that the C API allowed NULL for the function's <parameter>label</parameter> parameter so that that parameter is optional. It would be possible to have <command>gmmproc</command> generate the original constructor (with all the parameters) along with an additional constructor without that optional parameter by appending a <literal>{?}</literal> to the parameter name like so:
sr: Такође, рецимо да C API дозвољава NULL за параметар <parameter>label</parameter> функције тако да је тај параметар опциони. Било би могуће да <command>gmmproc</command> генерише изворни конструктор (са свим параметрима) заједно са додатним конструктором без тог опционог параметра додавањем <literal>{?}</literal> на назив параметра овако:

note: (itstool) path: section/para
en: In this case, two constructors would be generated: One with the optional parameter and one without it.
sr: У овом случају, биће генерисана два конструктора: један са опционим параметром и један без њега.

note: (itstool) path: section/title
en: Output Parameter Processing
sr: Обрада излазних параметара

note: (itstool) path: section/para
en: With <function>_WRAP_METHOD()</function> it is also possible for the return of the wrapped C function (if it has one) to be placed in an output parameter of the <phrase role="nowrap">C++</phrase> method instead of having the <phrase role="nowrap">C++</phrase> method also return a value like the C function does. To do that, simply include the output parameter in the <phrase role="nowrap">C++</phrase> method parameter list appending a <literal>{OUT}</literal> to the output parameter name. For example, if <function>gtk_widget_get_request_mode()</function> is declared as the following:
sr: Помоћу <function>_WRAP_METHOD()</function> је такође могуће да се повратна вредност умотане C функције (ако је има) постави у излазни параметар <phrase role="nowrap">C++</phrase> методе уместо да <phrase role="nowrap">C++</phrase> метода такође враћа вредност као што то чини C функција. Да бисте то урадили, једноставно укључите излазни параметар у списак параметара <phrase role="nowrap">C++</phrase> методе додајући <literal>{OUT}</literal> на назив излазног параметра. На пример, ако је <function>gtk_widget_get_request_mode()</function> декларисана на следећи начин:

note: (itstool) path: section/para
en: And having the <phrase role="nowrap">C++</phrase> method set an output parameter is desired instead of returning a <type>SizeRequestMode</type>, something like the following could be used:
sr: А ако се жели да <phrase role="nowrap">C++</phrase> метода постави излазни параметар уместо да враћа <type>SizeRequestMode</type>, могло би се употребити нешто попут следећег:

note: (itstool) path: section/para
en: The <literal>{OUT}</literal> appended to the name of the <parameter>mode</parameter> output parameter tells <command>gmmproc</command> to place the return of the C function in that output parameter. In this case, however, a necessary initialization macro like the following would also have to be specified:
sr: Ознака <literal>{OUT}</literal> додата на назив излазног параметра <parameter>mode</parameter> говори програму <command>gmmproc</command> да постави повратну вредност C функције у тај излазни параметар. У овом случају, међутим, такође би морао бити наведен неопходан макро за покретање попут следећег:

note: (itstool) path: section/para
en: Which could also be written as:
sr: Што би се такође могло написати као:

note: (itstool) path: section/para
en: <function>_WRAP_METHOD()</function> also supports setting <phrase role="nowrap">C++</phrase> output parameters from C output parameters if the C function being wrapped has any. Suppose, for example, that we want to wrap the following C function that returns a value in its C output parameter <parameter>out_mime_type</parameter>:
sr: <function>_WRAP_METHOD()</function> такође подржава постављање <phrase role="nowrap">C++</phrase> излазних параметара из C излазних параметара ако их C функција која се умотава има. Претпоставимо, на пример, да желимо да умотамо следећу C функцију која враћа вредност у свом C излазном параметру <parameter>out_mime_type</parameter>:

note: (itstool) path: section/para
en: To have <command>gmmproc</command> place the value returned in the <phrase role="nowrap">C++</phrase> <parameter>out_mime_type</parameter> output parameter, something like the following <function>_WRAP_METHOD()</function> macro could be used:
sr: Да би <command>gmmproc</command> поставио вредност враћену у <phrase role="nowrap">C++</phrase> излазни параметар <parameter>out_mime_type</parameter>, могао би се употребити макро <function>_WRAP_METHOD()</function> попут следећег:

note: (itstool) path: section/para
en: The <literal>{&gt;&gt;}</literal> following the <parameter>out_mime_type</parameter> parameter name indicates that the <phrase role="nowrap">C++</phrase> output parameter should be set from the value returned in the C parameter from the C function. <command>gmmproc</command> will generate a declaration of a temporary variable in which to store the value of the C output parameter and a statement that sets the <phrase role="nowrap">C++</phrase> output parameter from the temporary variable. In this case it may be necessary to have an <function>_INITIALIZATION()</function> describing how to set a <classname>Glib::ustring&amp;</classname> from a <classname>const char**</classname> such as the following:
sr: Ознака <literal>{&gt;&gt;}</literal> након назива параметра <parameter>out_mime_type</parameter> указује на то да <phrase role="nowrap">C++</phrase> излазни параметар треба да буде постављен из вредности враћене у C параметру из C функције. <command>gmmproc</command> ће генерисати декларацију привремене променљиве у којој ће се чувати вредност C излазног параметра и наредбу која поставља <phrase role="nowrap">C++</phrase> излазни параметар из привремене променљиве. У овом случају може бити неопходно имати <function>_INITIALIZATION()</function> који описује како да се постави <classname>Glib::ustring&amp;</classname> из <classname>const char**</classname> као што је следеће:

note: (itstool) path: section/title
en: String Parameter Processing
sr: Обрада ниски као параметара

note: (itstool) path: section/para
en: A string-valued input parameter in a <phrase role="nowrap">C++</phrase> method is usually a <type>const Glib::ustring&amp;</type> or a <type>const std::string&amp;</type>. In C code it's a <type>const gchar*</type>. When an empty string is converted to <type>const gchar*</type>, it can be converted either to <literal>nullptr</literal> or to a pointer to an empty string (with <methodname>c_str()</methodname>). Some parameters in some C functions accept a <literal>nullptr</literal>, and interpret it in a special way. Other parameters must not be <literal>nullptr</literal>.
sr: Улазни параметар вредности ниске у <phrase role="nowrap">C++</phrase> методи је обично <type>const Glib::ustring&amp;</type> или <type>const std::string&amp;</type>. У C коду то је <type>const gchar*</type>. Када се празна ниска претвори у <type>const gchar*</type>, она се може претворити или у <literal>nullptr</literal> или у показивач на празну ниску (помоћу <methodname>c_str()</methodname>). Неки параметри у неким C функцијама прихватају <literal>nullptr</literal> и тумаче га на посебан начин. Други параметри не смеју бити <literal>nullptr</literal>.

note: (itstool) path: listitem/para
en: for mandatory parameters (with or without default values): empty string to empty string,
sr: за обавезне параметре (са или без подразумеваних вредности): празна ниска у празну ниску,

note: (itstool) path: listitem/para
en: for optional parameters (with appended <literal>{?}</literal>): empty string to <literal>nullptr</literal>.
sr: за опционе параметре (са додатим <literal>{?}</literal>): празна ниска у <literal>nullptr</literal>.

note: (itstool) path: section/para
en: The default conversion in <function>_WRAP_METHOD()</function> and similar macros is <_:itemizedlist-1/> If the default conversion is not the best conversion, append <literal>{NULL}</literal> to a mandatory parameter or <literal>{?!NULL}</literal> to an optional parameter (<literal>!NULL</literal> = not <literal>NULL</literal>). If you append both a C parameter name and <literal>NULL</literal>, separate them with a space: <literal>{c_param_name NULL}</literal>.
sr: Подразумевана конверзија у <function>_WRAP_METHOD()</function> и сличним макроима је <_:itemizedlist-1/> Ако подразумевана конверзија није најбоља конверзија, додајте <literal>{NULL}</literal> на обавезни параметар или <literal>{?!NULL}</literal> на опциони параметар (<literal>!NULL</literal> = није <literal>NULL</literal>). Ако додате и назив C параметра и <literal>NULL</literal>, раздвојте их размаком: <literal>{c_param_name NULL}</literal>.

note: (itstool) path: section/title
en: Basic Types
sr: Основни типови

note: (itstool) path: section/para
en: Some of the basic types that are used in C APIs have better alternatives in <phrase role="nowrap">C++</phrase>. For example, there's no need for a <type>gboolean</type> type since <phrase role="nowrap">C++</phrase> has <type>bool</type>. The following list shows some commonly-used types in C APIs and what you might convert them to in a <phrase role="nowrap">C++</phrase> wrapper library.
sr: Неки од основних типова који се користе у C АПИ-јима имају боље алтернативе у <phrase role="nowrap">C++</phrase>-у. На пример, нема потребе за типом <type>gboolean</type> пошто <phrase role="nowrap">C++</phrase> има <type>bool</type>. Следећи списак приказује неке често коришћене типове у C АПИ-јима и у шта бисте их могли претворити у <phrase role="nowrap">C++</phrase> омотачкој библиотеци.

note: (itstool) path: segmentedlist/segtitle
en: C type
sr: C тип

note: (itstool) path: segmentedlist/segtitle
en: C++ type
sr: C++ тип

note: (itstool) path: seglistitem/seg
en: <classname>Glib::ustring</classname> (or <classname>std::string</classname> for filenames)
sr: <classname>Glib::ustring</classname> (или <classname>std::string</classname> за називе датотека)

note: (itstool) path: section/title
en: Hand-coded source files
sr: Ручно кодиране изворне датотеке

note: (itstool) path: section/para
en: You might want to include additional source files that will not be generated by <command>gmmproc</command> from <filename>.hg</filename> and <filename>.ccg</filename> files. You can simply place these in your <filename>libsomething/libsomethingmm</filename> directory and mention them in the <filename>meson.build</filename> in the <varname>extra_h_files</varname> and <varname>extra_cc_files</varname> variables.
sr: Можда ћете желети да укључите додатне изворне датотеке које неће бити генерисане помоћу <command>gmmproc</command> из <filename>.hg</filename> и <filename>.ccg</filename> датотека. Њих можете једноставно поставити у ваш <filename>libsomething/libsomethingmm</filename> директоријум и навести их у <filename>meson.build</filename> у променљивама <varname>extra_h_files</varname> и <varname>extra_cc_files</varname>.

note: (itstool) path: section/title
en: Initialization
sr: Покретање

note: (itstool) path: section/para
en: Your library must be initialized before it can be used, to register the new types that it makes available. Also, the C library that you are wrapping might have its own initialization function that you should call. You can do this in an <function>init()</function> function that you can place in hand-coded <filename>init.h</filename> and <filename>init.cc</filename> files. This function should initialize your dependencies (such as the C function, and <application>gtkmm</application>) and call your generated <function>wrap_init()</function> function. For instance:
sr: Ваша библиотека мора бити покренута пре него што се може користити, како би се регистровали нови типови које она чини доступним. Такође, C библиотека коју омотавате може имати сопствену функцију покретања коју треба да позовете. То можете учинити у функцији <function>init()</function> коју можете поставити у ручно кодиране датотеке <filename>init.h</filename> и <filename>init.cc</filename>. Ова функција треба да покрене ваше зависности (као што су C функција и <application>gtkmm</application>) и позове вашу генерисану функцију <function>wrap_init()</function>. На пример:

note: (itstool) path: section/programlisting
en: <code>void init()
    {
      Gtk::init_gtkmm_internals(); //Sets up the g type system and the Glib::wrap() table.
      wrap_init(); //Tells the Glib::wrap() table about the libsomethingmm classes.
    }
    </code>
sr: <code>void init()
    {
      Gtk::init_gtkmm_internals(); //Поставља g систем типова и Glib::wrap() табелу.
      wrap_init(); //Обавештава Glib::wrap() табелу о libsomethingmm класама.
    }
    </code>

note: (itstool) path: section/para
en: The implementation of the <function>wrap_init()</function> method in <filename>wrap_init.cc</filename> is generated by <filename>generate_wrap_init.pl</filename>, but the declaration in <filename>wrap_init.h</filename> is hand-coded, so you will need to adjust <filename>wrap_init.h</filename> so that the <function>wrap_init()</function> function appears in the correct <phrase role="nowrap">C++</phrase> namespace.
sr: Имплементација методе <function>wrap_init()</function> у <filename>wrap_init.cc</filename> је генерисана помоћу <filename>generate_wrap_init.pl</filename>, али је декларација у <filename>wrap_init.h</filename> ручно кодирана, тако да ћете морати да прилагодите <filename>wrap_init.h</filename> како би се функција <function>wrap_init()</function> појавила у исправном <phrase role="nowrap">C++</phrase> именском простору.

note: (itstool) path: section/title
en: Problems in the C API.
sr: Проблеми у C АПИ-ју.

note: (itstool) path: section/para
en: You are likely to encounter some problems in the library that you are wrapping, particularly if it is a new project. Here are some common problems, with solutions.
sr: Вероватно ћете наићи на неке проблеме у библиотеци коју омотавате, нарочито ако је реч о новом пројекту. Ево неких уобичајених проблема са решењима.

note: (itstool) path: section/title
en: Unable to predeclare structs
sr: Немогућност унапредне декларације структура

note: (itstool) path: section/para
en: By convention, structs are declared in glib/GTK-style headers like so:
sr: По конвенцији, структуре се деклиришу у заглављима glib/GTK стила на следећи начин:

note: (itstool) path: section/para
en: The extra typedef allows the struct to be used in a header without including its full definition, simply by predeclaring it, by repeating that typedef. This means that you don't have to include the C library's header in your <phrase role="nowrap">C++</phrase> header, thus keeping it out of your public API. <command>gmmproc</command> assumes that this technique was used, so you will see compiler errors if that is not the case.
sr: Додатни typedef омогућава да се структура користи у заглављу без укључивања њене пуне дефиниције, једноставно њеним унапредним деклирисањем, понављањем тог typedef-а. То значи да не морате да укључујете заглавље C библиотеке у ваше <phrase role="nowrap">C++</phrase> заглавље, чиме га држите изван вашег јавног АПИ-ја. <command>gmmproc</command> претпоставља да је ова техника коришћена, па ћете видети грешке преводиоца ако то није случај.

note: (itstool) path: section/para
en: This compiler error might look like this:
sr: Ова грешка преводиоца може изгледати овако:

note: (itstool) path: section/para
en: or this:
sr: или овако:

note: (itstool) path: section/para
en: This is easy to correct in the C library, so do send a patch to the relevant maintainer.
sr: Ово је лако исправити у C библиотеци, па пошаљите закрпу релевантном одржаваоцу.

note: (itstool) path: section/title
en: Lack of properties
sr: Недостатак својстава

note: (itstool) path: section/para
en: By convention, glib/GTK-style objects have <function>*_new()</function> functions, such as <function>example_widget_new()</function> that do nothing more than call <function>g_object_new()</function> and return the result. The input parameters are supplied to <function>g_object_new()</function> along with the names of the properties for which they are values. For instance,
sr: По конвенцији, објекти glib/GTK стила имају <function>*_new()</function> функције, као што је <function>example_widget_new()</function> које не раде ништа више осим што позивају <function>g_object_new()</function> и враћају резултат. Улазни параметри се достављају функцији <function>g_object_new()</function> заједно са називима својстава за које су они вредности. На пример,

note: (itstool) path: section/para
en: This allows language bindings to implement their own equivalents (such as <phrase role="nowrap">C++</phrase> constructors), without using the <function>*_new()</function> function. This is often necessary so that they can actually instantiate a derived GType, to add their own hooks for signal handlers and vfuncs.
sr: Ово омогућава језичким везама да примене сопствене еквиваленте (као што су <phrase role="nowrap">Ц++</phrase> конструктори), без коришћења функције <function>*_new()</function>. Ово је често неопходно како би заправо могли да инстанцирају изведени Г-тип (GType), да додају сопствене кукице за руковаоце сигналима и виртуелне функције (vfuncs).

note: (itstool) path: section/para
en: At the least, the <function>_new()</function> function should not use any private API (functions that are only in a .c file). Even when there are no functions, we can sometimes reimplement 2 or 3 lines of code in a <function>_new()</function> function as long as those lines of code use API that is available to us.
sr: У најмању руку, функција <function>_new()</function> не би требало да користи никакав приватни АПИ (функције које се налазе само у .c датотеци). Чак и када нема функција, понекад можемо поново применити 2 или 3 линије кода у функцији <function>_new()</function> све док те линије кода користе АПИ који нам је доступан.

note: (itstool) path: section/para
en: Another workaround is to add a <function>*_construct()</function> function that the <phrase role="nowrap">C++</phrase> constructor can call after instantiating its own type. For instance,
sr: Друго решење је додавање функције <function>*_construct()</function> коју Ц++ конструктор може позвати након инстанцирања сопственог типа. На пример,

note: (itstool) path: section/para
en: Adding properties, and ensuring that they interact properly with each other, is relatively difficult to correct in the C library, but it is possible, so do file a bug and try to send a patch to the relevant maintainer.
sr: Додавање својстава и осигуравање да она исправно међусобно делују је релативно тешко исправити у Ц библиотеци, али је могуће, па пријавите грешку и покушајте да пошаљете закрпу релевантном одржаваоцу.

note: (itstool) path: section/title
en: Documentation
sr: Документација

note: (itstool) path: section/para
en: In general, gtkmm-style projects use Doxygen, which reads specially formatted <phrase role="nowrap">C++</phrase> comments and generates HTML documentation. You may write these doxygen comments directly in the header files.
sr: Уопштено говорећи, пројекти у gtkmm стилу користе Doxygen, који чита посебно обликоване <phrase role="nowrap">Ц++</phrase> коментаре и генерише ХТМЛ документацију. Ове doxygen коментаре можете писати директно у заглављима датотека.

note: (itstool) path: section/title
en: Reusing C documentation
sr: Поновно коришћење Ц документације

note: (itstool) path: section/para
en: You might wish to reuse documentation that exists for the C library that you are wrapping. GTK-style C libraries typically use gtk-doc or gi-docgen and therefore have source code comments formatted for gtk-doc or gi-docgen and some extra documentation in .sgml and .xml files. The docextract_to_xml.py script, from glibmm's <filename>tools/defs_gen</filename> directory, can read these files and generate an .xml file that <command>gmmproc</command> can use to generate doxygen comments. <command>gmmproc</command> will even try to transform the documentation to make it more appropriate for a <phrase role="nowrap">C++</phrase> API.
sr: Можда ћете желети да поново искористите документацију која постоји за Ц библиотеку коју обавијате. Ц библиотеке у ГТК стилу обично користе gtk-doc или gi-docgen и стога имају коментаре изворног кода обликоване за gtk-doc или gi-docgen и неку додатну документацију у .sgml и .xml датотекама. Скрипта docextract_to_xml.py, из glibmm-овог директоријума <filename>tools/defs_gen</filename>, може да прочита ове датотеке и генерише .xml датотеку коју <command>gmmproc</command> може да користи за генерисање doxygen коментара. <command>gmmproc</command> ће чак покушати да преобрази документацију како би је учинио прикладнијом за <phrase role="nowrap">Ц++</phrase> АПИ.

note: (itstool) path: section/para
en: Because this automatic transformation is not always appropriate, you might want to provide hand-written text for a particular method. You can do this by copying the XML node for the function from your <filename>something_docs.xml</filename> file to the <filename>something_docs_override.xml</filename> file and changing the contents. Alternatively you can write your own documentation in the <filename>.hg</filename> file.
sr: Будући да овај аутоматски преображај није увек прикладан, можда ћете желети да обезбедите ручно писани текст за одређени метод. То можете учинити тако што ћете копирати ИксМЛ чвор за функцију из ваше <filename>something_docs.xml</filename> датотеке у <filename>something_docs_override.xml</filename> датотеку и променити садржај. Алтернативно, можете написати сопствену документацију у <filename>.hg</filename> датотеци.

note: (itstool) path: section/title
en: Documentation build structure
sr: Структура изградње документације

note: (itstool) path: section/para
en: If you copied the skeleton source tree in <application>mm-common</application> and substituted the placeholder text, then you will already have suitable <filename>meson.build</filename> and <filename>Doxyfile.in</filename> files in the <filename>doc/reference/</filename> directory. You probably need to modify the <varname>tag_file_modules</varname> variable in <filename>meson.build</filename>, though. With the <application>mm-common</application> build setup, the list of Doxygen input files is not defined in the Doxygen configuration file, but passed along from <command>meson/ninja</command> to the standard input of <command>doxygen</command>.
sr: Ако сте копирали скелетно изворно стабло у <application>mm-common</application> и заменили текст чувара места, већ ћете имати одговарајуће <filename>meson.build</filename> и <filename>Doxyfile.in</filename> датотеке у директоријуму <filename>doc/reference/</filename>. Вероватно ћете морати да измените променљиву <varname>tag_file_modules</varname> у <filename>meson.build</filename>. Са <application>mm-common</application> поставком градње, листа Doxygen улазних датотека није дефинисана у Doxygen датотеци подешавања, већ се прослеђује из <command>meson/ninja</command> на стандардни улаз за <command>doxygen</command>.

note: (itstool) path: appendix/title
en: GNU Free Documentation License
sr: ГНУ-ова лиценца за слободну документацију

note: (itstool) path: appendix/para
en: Copyright (C) 2000, 2001, 2002 Free Software Foundation, <link xlink:href="https://fsf.org/">https://fsf.org/</link>. Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
sr: Ауторска права (C) 2000, 2001, 2002 Free Software Foundation, <link xlink:href="https://fsf.org/">https://fsf.org/</link>. Свакоме је дозвољено да умножава и расподељује верне примерке овог документа лиценце, али његово мењање није дозвољено.

note: (itstool) path: appendix/bridgehead (itstool) id: index-in.docbook#Preamble
en: 0. PREAMBLE
sr: 0. УВОД

note: (itstool) path: appendix/para
en: The purpose of this License is to make a manual, textbook, or other functional and useful document "free" in the sense of freedom: to assure everyone the effective freedom to copy and redistribute it, with or without modifying it, either commercially or noncommercially. Secondarily, this License preserves for the author and publisher a way to get credit for their work, while not being considered responsible for modifications made by others.
sr: Сврха ове Лиценце је да приручник, уџбеник или други функционалан и користан документ учини „слободним“ у смислу слободе: да свима осигура стварну слободу умножавања и расподеле, са или без измена, било комерцијално или некомерцијално. Секундарно, ова Лиценца чува аутору и издавачу начин да добију признање за свој рад, док се не сматрају одговорним за измене које су направили други.

note: (itstool) path: appendix/para
en: This License is a kind of "copyleft", which means that derivative works of the document must themselves be free in the same sense. It complements the GNU General Public License, which is a copyleft license designed for free software.
sr: Ова Лиценца је врста „copyleft-а“, што значи да изведени радови документа и сами морају бити слободни у истом смислу. Она допуњује ГНУ-ову општу јавну лиценцу, која је copyleft лиценца дизајнирана за слободан софтвер.

note: (itstool) path: appendix/para
en: We have designed this License in order to use it for manuals for free software, because free software needs free documentation: a free program should come with manuals providing the same freedoms that the software does. But this License is not limited to software manuals; it can be used for any textual work, regardless of subject matter or whether it is published as a printed book. We recommend this License principally for works whose purpose is instruction or reference.
sr: Ову Лиценцу смо осмислили како бисмо је користили за приручнике за слободан софтвер, јер слободан софтвер захтева слободну документацију: слободан програм треба да долази са приручницима који пружају исте слободе као и сам софтвер. Али ова Лиценца није ограничена на софтверске приручнике; може се користити за било који текстуални рад, без обзира на предметну област или на то да ли је објављен као штампана књига. Препоручујемо ову Лиценцу првенствено за радове чија је сврха подучавање или референца.

note: (itstool) path: appendix/bridgehead (itstool) id: index-in.docbook#Definitions
en: 1. APPLICABILITY AND DEFINITIONS
sr: 1. ПРИМЕЊИВОСТ И ДЕФИНИЦИЈЕ

note: (itstool) path: appendix/para
en: This License applies to any manual or other work, in any medium, that contains a notice placed by the copyright holder saying it can be distributed under the terms of this License. Such a notice grants a world-wide, royalty-free license, unlimited in duration, to use that work under the conditions stated herein. The "Document", below, refers to any such manual or work. Any member of the public is a licensee, and is addressed as "you". You accept the license if you copy, modify or distribute the work in a way requiring permission under copyright law.
sr: Ова лиценца се примењује на било које корисничко упутство или други рад, на било ком медијуму, који садржи обавештење постављено од стране носиоца ауторских права у коме се наводи да се може дистрибуирати под условима ове Лиценце. Такво обавештење даје светску, бесплатну лиценцу, неограниченог трајања, за коришћење тог рада под овде наведеним условима. „Документ“ се у даљем тексту односи на било које такво упутство или рад. Сваки члан јавности је носилац лиценце и њему се обраћа са „ви“. Прихватате лиценцу ако умножавате, мењате или дистрибуирате рад на начин који захтева дозволу према закону о ауторским правима.

note: (itstool) path: appendix/para
en: A "Modified Version" of the Document means any work containing the Document or a portion of it, either copied verbatim, or with modifications and/or translated into another language.
sr: „Измењено издање“ Документа означава било који рад који садржи Документ или његов део, било да је копиран дословно, или са изменама и/или преведен на други језик.

note: (itstool) path: appendix/para
en: A "Secondary Section" is a named appendix or a front-matter section of the Document that deals exclusively with the relationship of the publishers or authors of the Document to the Document's overall subject (or to related matters) and contains nothing that could fall directly within that overall subject. (Thus, if the Document is in part a textbook of mathematics, a Secondary Section may not explain any mathematics.) The relationship could be a matter of historical connection with the subject or with related matters, or of legal, commercial, philosophical, ethical or political position regarding them.
sr: „Секундарни одељак“ је именовани додатак или уводни део Документа који се искључиво бави односом издавача или аутора Документа према општој теми Документа (или сродним питањима) и не садржи ништа што би могло потпасти директно под ту општу тему. (Дакле, ако је Документ делом уџбеник математике, Секундарни одељак не сме објашњавати математику.) Однос може бити питање историјске повезаности са темом или сродним питањима, или правног, комерцијалног, филозофског, етичког или политичког става у вези са њима.

note: (itstool) path: appendix/para
en: The "Invariant Sections" are certain Secondary Sections whose titles are designated, as being those of Invariant Sections, in the notice that says that the Document is released under this License. If a section does not fit the above definition of Secondary then it is not allowed to be designated as Invariant. The Document may contain zero Invariant Sections. If the Document does not identify any Invariant Sections then there are none.
sr: „Непроменљиви одељци“ су одређени Секундарни одељци чији су наслови одређени као наслови Непроменљивих одељака у обавештењу које каже да је Документ издат под овом Лиценцом. Ако се одељак не уклапа у горњу дефиницију Секундарног, онда није дозвољено да буде означен као Непроменљив. Документ може садржати нула Непроменљивих одељака. Ако Документ не идентификује ниједан Непроменљиви одељак, онда их нема.

note: (itstool) path: appendix/para
en: The "Cover Texts" are certain short passages of text that are listed, as Front-Cover Texts or Back-Cover Texts, in the notice that says that the Document is released under this License. A Front-Cover Text may be at most 5 words, and a Back-Cover Text may be at most 25 words.
sr: „Текстови на корицама“ су одређени кратки одломци текста који су наведени као Текстови на предњој корици или Текстови на задњој корици, у обавештењу које каже да је Документ издат под овом Лиценцом. Текст на предњој корици може имати највише 5 речи, а текст на задњој корици највише 25 речи.

note: (itstool) path: appendix/para
en: A "Transparent" copy of the Document means a machine-readable copy, represented in a format whose specification is available to the general public, that is suitable for revising the document straightforwardly with generic text editors or (for images composed of pixels) generic paint programs or (for drawings) some widely available drawing editor, and that is suitable for input to text formatters or for automatic translation to a variety of formats suitable for input to text formatters. A copy made in an otherwise Transparent file format whose markup, or absence of markup, has been arranged to thwart or discourage subsequent modification by readers is not Transparent. An image format is not Transparent if used for any substantial amount of text. A copy that is not "Transparent" is called "Opaque".
sr: „Провидна“ копија Документа означава машински читљиву копију, представљену у формату чија је спецификација доступна широј јавности, која је погодна за једноставно ревидирање документа генеричким уређивачима текста или (за слике састављене од пиксела) генеричким програмима за сликање или (за цртеже) неким широко доступним уређивачем цртежа, и која је погодна за унос у форматизере текста или за аутоматско превођење у различите формате погодне за унос у форматизере текста. Копија направљена у иначе Провидном формату датотеке чије је означавање, или одсуство означавања, уређено тако да омета или обесхрабрује накнадне измене од стране читалаца није Провидна. Формат слике није Провидан ако се користи за било коју значајну количину текста. Копија која није „Провидна“ назива се „Непровидна“.

note: (itstool) path: appendix/para
en: Examples of suitable formats for Transparent copies include plain ASCII without markup, Texinfo input format, LaTeX input format, SGML or XML using a publicly available DTD, and standard-conforming simple HTML, PostScript or PDF designed for human modification. Examples of transparent image formats include PNG, XCF and JPG. Opaque formats include proprietary formats that can be read and edited only by proprietary word processors, SGML or XML for which the DTD and/or processing tools are not generally available, and the machine-generated HTML, PostScript or PDF produced by some word processors for output purposes only.
sr: Примери погодних формата за Провидне копије укључују обичан АСКИ без означавања, ТеКсинфо улазни формат, ЛаТеКс улазни формат, СГМЛ или ИксМЛ користећи јавно доступан ДТД, и стандардно усклађен једноставан ХТМЛ, Постскрипт или ПДФ дизајниран за људске измене. Примери провидних формата слика укључују ПНГ, ИксЦФ и ЈПГ. Непровидни формати укључују власничке формате који се могу читати и уређивати само власничким процесорима текста, СГМЛ или ИксМЛ за које ДТД и/или алати за обраду нису опште доступни, и машински генерисан ХТМЛ, Постскрипт или ПДФ који производе неки процесори текста само за излазне сврхе.

note: (itstool) path: appendix/para
en: The "Title Page" means, for a printed book, the title page itself, plus such following pages as are needed to hold, legibly, the material this License requires to appear in the title page. For works in formats which do not have any title page as such, "Title Page" means the text near the most prominent appearance of the work's title, preceding the beginning of the body of the text.
sr: „Насловна страна“ означава, за штампану књигу, саму насловну страну, плус следеће странице које су потребне да би се читљиво држао материјал који ова Лиценца захтева да се појави на насловној страни. За радове у форматима који немају насловну страну као такву, „Насловна страна“ означава текст близу најистакнутијег појављивања наслова рада, који претходи почетку тела текста.

note: (itstool) path: appendix/para
en: A section "Entitled XYZ" means a named subunit of the Document whose title either is precisely XYZ or contains XYZ in parentheses following text that translates XYZ in another language. (Here XYZ stands for a specific section name mentioned below, such as "Acknowledgements", "Dedications", "Endorsements", or "History".) To "Preserve the Title" of such a section when you modify the Document means that it remains a section "Entitled XYZ" according to this definition.
sr: Одељак „Под насловом ИксИпсилонЗет“ означава именовану подјединицу Документа чији је наслов или прецизно ИксИпсилонЗет или садржи ИксИпсилонЗет в заградама након текста који преводи ИксИпсилонЗет на други језик. (Овде ИксИпсилонЗет стоји за специфичан назив одељка поменут испод, као што су „Захвалнице“, „Посвете“, „Подршке“ или „Историјат“.) „Очувати наслов“ таквог одељка када мењате Документ значи да он остаје одељак „Под насловом ИксИпсилонЗет“ према овој дефиницији.

note: (itstool) path: appendix/para
en: The Document may include Warranty Disclaimers next to the notice which states that this License applies to the Document. These Warranty Disclaimers are considered to be included by reference in this License, but only as regards disclaiming warranties: any other implication that these Warranty Disclaimers may have is void and has no effect on the meaning of this License.
sr: Документ може укључивати Одрицања од гаранције поред обавештења које наводи да се ова Лиценца примењује на Документ. Ова Одрицања од гаранције се сматрају укљученим референцом у ову Лиценцу, али само у погледу одрицања од гаранција: било која друга импликација коју ова Одрицања од гаранције могу имати је ништавна и нема ефекта на значење ове Лиценце.

note: (itstool) path: appendix/bridgehead (itstool) id: index-in.docbook#VerbatimCopying
en: 2. VERBATIM COPYING
sr: 2. ДОСЛОВНО УМНОЖАВАЊЕ

note: (itstool) path: appendix/para
en: You may copy and distribute the Document in any medium, either commercially or noncommercially, provided that this License, the copyright notices, and the license notice saying this License applies to the Document are reproduced in all copies, and that you add no other conditions whatsoever to those of this License. You may not use technical measures to obstruct or control the reading or further copying of the copies you make or distribute. However, you may accept compensation in exchange for copies. If you distribute a large enough number of copies you must also follow the conditions in section 3.
sr: Можете умножавати и дистрибуирати Документ на било ком медијуму, комерцијално или некомерцијално, под условом да су ова Лиценца, обавештења о ауторским правима и обавештење о лиценци које каже да се ова Лиценца примењује на Документ репродуковани у свим копијама, и да не додајете никакве друге услове онима из ове Лиценце. Не смете користити техничке мере за ометање или контролу читања или даљег умножавања копија које правите или дистрибуирате. Међутим, можете прихватити накнаду у замену за копије. Ако дистрибуирате довољно велики број копија, морате такође поштовати услове из одељка 3.

note: (itstool) path: appendix/para
en: You may also lend copies, under the same conditions stated above, and you may publicly display copies.
sr: Такође можете позајмљивати копије, под истим горе наведеним условима, и можете јавно приказивати копије.

note: (itstool) path: appendix/bridgehead (itstool) id: index-in.docbook#QuantityCopying
en: 3. COPYING IN QUANTITY
sr: 3. УМНОЖАВАЊЕ У ВЕЛИКИМ КОЛИЧИНАМА

note: (itstool) path: appendix/para
en: If you publish printed copies (or copies in media that commonly have printed covers) of the Document, numbering more than 100, and the Document's license notice requires Cover Texts, you must enclose the copies in covers that carry, clearly and legibly, all these Cover Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on the back cover. Both covers must also clearly and legibly identify you as the publisher of these copies. The front cover must present the full title with all words of the title equally prominent and visible. You may add other material on the covers in addition. Copying with changes limited to the covers, as long as they preserve the title of the Document and satisfy these conditions, can be treated as verbatim copying in other respects.
sr: Ако објављујете штампане копије (или копије у медијима који обично имају штампане корице) Документа, у броју већем од 100, а обавештење о лиценци Документа захтева Текстове на корицама, морате приложити копије у корицама које јасно и читљиво носе све ове Текстове на корицама: Текстове на предњој корици на предњој корици, и Текстове на задњој корици на задњој корици. Обе корице морају такође јасно и читљиво идентификовати вас као издавача ових копија. Предња корица мора представити пун наслов са свим речима наслова подједнако истакнутим и видљивим. Можете додати и други материјал на корице. Умножавање са изменама ограниченим на корице, све док оне чувају наслов Документа и задовољавају ове услове, може се сматрати дословним умножавањем у другим аспектима.

note: (itstool) path: appendix/para
en: If the required texts for either cover are too voluminous to fit legibly, you should put the first ones listed (as many as fit reasonably) on the actual cover, and continue the rest onto adjacent pages.
sr: Ако су захтевани текстови за било коју корицу превише обимни да би се читљиво уклопили, требало би да поставите прве наведене (колико год разумно стане) на саму корицу, а остатак наставите на суседним страницама.

note: (itstool) path: appendix/para
en: If you publish or distribute Opaque copies of the Document numbering more than 100, you must either include a machine-readable Transparent copy along with each Opaque copy, or state in or with each Opaque copy a computer-network location from which the general network-using public has access to download using public-standard network protocols a complete Transparent copy of the Document, free of added material. If you use the latter option, you must take reasonably prudent steps, when you begin distribution of Opaque copies in quantity, to ensure that this Transparent copy will remain thus accessible at the stated location until at least one year after the last time you distribute an Opaque copy (directly or through your agents or retailers) of that edition to the public.
sr: Ако објављујете или дистрибуирате Непровидне копије Документа в броју већем од 100, морате или укључити машински читљиву Провидну копију уз сваку Непровидну копију, или навести у или уз сваку Непровидну копију локацију на рачунарској мрежи са које општа јавност која користи мрежу има приступ за преузимање користећи стандардне мрежне протоколе потпуне Провидне копије Документа, без додатног материјала. Ако користите ову другу опцију, морате предузети разумно опрезне кораке, када започнете дистрибуцију Непровидних копија у великој количини, како бисте осигурали да ова Провидна копија остане тако доступна на наведеној локацији најмање годину дана након последњег пута када сте дистрибуирали Непровидну копију (директно или преко својих агената или продаваца) тог издања јавности.

note: (itstool) path: appendix/para
en: It is requested, but not required, that you contact the authors of the Document well before redistributing any large number of copies, to give them a chance to provide you with an updated version of the Document.
sr: Тражи се, али се не захтева, да контактирате ауторе Документа знатно пре редистрибуције било ког великог броја копија, како бисте им дали прилику да вам доставе ажурирану верзију Документа.

note: (itstool) path: appendix/bridgehead (itstool) id: index-in.docbook#Modifications
en: 4. MODIFICATIONS
sr: 4. ИЗМЕНЕ

note: (itstool) path: appendix/para
en: You may copy and distribute a Modified Version of the Document under the conditions of sections 2 and 3 above, provided that you release the Modified Version under precisely this License, with the Modified Version filling the role of the Document, thus licensing distribution and modification of the Modified Version to whoever possesses a copy of it. In addition, you must do these things in the Modified Version:
sr: Можете умножавати и дистрибуирати Измењено издање Документа под условима из одељака 2 и 3 изнад, под условом да издате Измењено издање под управо овом Лиценцом, при чему Измењено издање преузима улогу Документа, чиме се лиценцира дистрибуција и измена Измењеног издања свакоме ко поседује његову копију. Поред тога, у Измењеном издању морате урадити следеће:

note: (itstool) path: listitem/simpara
en: Use in the Title Page (and on the covers, if any) a title distinct from that of the Document, and from those of previous versions (which should, if there were any, be listed in the History section of the Document). You may use the same title as a previous version if the original publisher of that version gives permission.
sr: На насловној страни (и на корицама, ако их има) користите наслов који се разликује од наслова Документа и од наслова претходних верзија (које би, ако их је било, требало да буду наведене у одељку Историјат Документа). Можете користити исти наслов као и у претходној верзији ако првобитни издавач те верзије да дозволу.

note: (itstool) path: listitem/simpara
en: List on the Title Page, as authors, one or more persons or entities responsible for authorship of the modifications in the Modified Version, together with at least five of the principal authors of the Document (all of its principal authors, if it has fewer than five), unless they release you from this requirement.
sr: Наведите на насловној страни, као ауторе, једну или више особа или ентитета одговорних за ауторство измена у Измењеној верзији, заједно са најмање пет главних аутора Документа (свим његовим главним ауторима, ако их има мање од пет), осим ако вас они не ослободе овог захтева.

note: (itstool) path: listitem/simpara
en: State on the Title page the name of the publisher of the Modified Version, as the publisher.
sr: Наведите на насловној страни назив издавача Измењене верзије, као издавача.

note: (itstool) path: listitem/simpara
en: Preserve all the copyright notices of the Document.
sr: Сачувајте сва обавештења о ауторским правима Документа.

note: (itstool) path: listitem/simpara
en: Add an appropriate copyright notice for your modifications adjacent to the other copyright notices.
sr: Додајте одговарајуће обавештење о ауторским правима за ваше измене поред осталих обавештења о ауторским правима.

note: (itstool) path: listitem/simpara
en: Include, immediately after the copyright notices, a license notice giving the public permission to use the Modified Version under the terms of this License, in the form shown in the Addendum below.
sr: Укључите, одмах након обавештења о ауторским правима, обавештење о лиценци којим се јавности даје дозвола за коришћење Измењене верзије под условима ове Лиценце, у облику приказаном у Додатку испод.

note: (itstool) path: listitem/simpara
en: Preserve in that license notice the full lists of Invariant Sections and required Cover Texts given in the Document's license notice.
sr: Сачувајте у том обавештењу о лиценци комплетне спискове Непроменљивих одељака и обавезних Текстова на корицама наведених у обавештењу о лиценци Документа.

note: (itstool) path: listitem/simpara
en: Include an unaltered copy of this License.
sr: Укључите неизмењену копију ове Лиценце.

note: (itstool) path: listitem/simpara
en: Preserve the section Entitled "History", Preserve its Title, and add to it an item stating at least the title, year, new authors, and publisher of the Modified Version as given on the Title Page. If there is no section Entitled "History" in the Document, create one stating the title, year, authors, and publisher of the Document as given on its Title Page, then add an item describing the Modified Version as stated in the previous sentence.
sr: Сачувајте одељак под насловом „Историјат“, сачувајте његов наслов и додајте му ставку која наводи барем наслов, годину, нове ауторе и издавача Измењене верзије као што је наведено на насловној страни. Ако у Документу не постоји одељак под насловом „Историјат“, направите га наводећи наслов, годину, ауторе и издавача Документа као што је наведено на његовој насловној страни, а затим додајте ставку која описује Измењену верзију као што је наведено у претходној реченици.

note: (itstool) path: listitem/simpara
en: Preserve the network location, if any, given in the Document for public access to a Transparent copy of the Document, and likewise the network locations given in the Document for previous versions it was based on. These may be placed in the "History" section. You may omit a network location for a work that was published at least four years before the Document itself, or if the original publisher of the version it refers to gives permission.
sr: Сачувајте мрежну локацију, ако постоји, наведену у Документу за јавни приступ Транспарентној копији Документа, као и мрежне локације наведене у Документу за претходне верзије на којима је заснован. Оне се могу поставити у одељак „Историјат“. Можете изоставити мрежну локацију за дело које је објављено најмање четири године пре самог Документа, или ако првобитни издавач верзије на коју се односи да дозволу.

note: (itstool) path: listitem/simpara
en: For any section Entitled "Acknowledgements" or "Dedications", Preserve the Title of the section, and preserve in the section all the substance and tone of each of the contributor acknowledgements and/or dedications given therein.
sr: За било који одељак под насловом „Захвалнице“ или „Посвете“, сачувајте наслов одељка и сачувајте у одељку сву суштину и тон сваке од захвалница и/или посвета сарадника које су тамо наведене.

note: (itstool) path: listitem/simpara
en: Preserve all the Invariant Sections of the Document, unaltered in their text and in their titles. Section numbers or the equivalent are not considered part of the section titles.
sr: Сачувајте све Непроменљиве одељке Документа, неизмењене у њиховом тексту и у њиховим насловима. Бројеви одељака или еквиваленти се не сматрају делом наслова одељака.

note: (itstool) path: listitem/simpara
en: Delete any section Entitled "Endorsements". Such a section may not be included in the Modified Version.
sr: Обришите сваки одељак под насловом „Потврде“. Такав одељак не сме бити укључен у Измењену верзију.

note: (itstool) path: listitem/simpara
en: Do not retitle any existing section to be Entitled "Endorsements" or to conflict in title with any Invariant Section.
sr: Немојте мењати наслов ниједном постојећем одељку тако да се зове „Потврде“ или да буде у сукобу са насловом било ког Непроменљивог одељка.

note: (itstool) path: listitem/simpara
en: Preserve any Warranty Disclaimers.
sr: Сачувајте сва Одрицања од гаранције.

note: (itstool) path: appendix/para
en: If the Modified Version includes new front-matter sections or appendices that qualify as Secondary Sections and contain no material copied from the Document, you may at your option designate some or all of these sections as invariant. To do this, add their titles to the list of Invariant Sections in the Modified Version's license notice. These titles must be distinct from any other section titles.
sr: Ако Измењена верзија укључује нове уводне одељке или додатке који се квалификују као Секундарни одељци и не садрже материјал копиран из Документа, можете по свом избору означити неке или све ове одељке као непроменљиве. Да бисте то урадили, додајте њихове наслове на листу Непроменљивих одељака у обавештењу о лиценци Измењене верзије. Ови наслови морају бити различити од свих осталих наслова одељака.

note: (itstool) path: appendix/para
en: You may add a section Entitled "Endorsements", provided it contains nothing but endorsements of your Modified Version by various parties--for example, statements of peer review or that the text has been approved by an organization as the authoritative definition of a standard.
sr: Можете додати одељак под насловом „Потврде“, под условом да не садржи ништа осим потврда ваше Измењене верзије од стране различитих страна – на пример, изјаве о стручној ревизији или да је текст одобрен од стране неке организације као меродавна дефиниција стандарда.

note: (itstool) path: appendix/para
en: You may add a passage of up to five words as a Front-Cover Text, and a passage of up to 25 words as a Back-Cover Text, to the end of the list of Cover Texts in the Modified Version. Only one passage of Front-Cover Text and one of Back-Cover Text may be added by (or through arrangements made by) any one entity. If the Document already includes a cover text for the same cover, previously added by you or by arrangement made by the same entity you are acting on behalf of, you may not add another; but you may replace the old one, on explicit permission from the previous publisher that added the old one.
sr: Можете додати пасус од највише пет речи као Текст на предњој корици, и пасус од највише 25 речи као Текст на задњој корици, на крај листе Текстова на корицама у Измењеној верзији. Било који ентитет може додати (или путем договора) само један пасус Текста на предњој корици и један на задњој корици. Ако Документ већ садржи текст на корици за исту корицу, који сте претходно додали ви или је додат путем договора који је склопио исти ентитет у чије име наступате, не можете додати други; али можете заменити стари, уз изричиту дозволу претходног издавача који је додао стари.

note: (itstool) path: appendix/para
en: The author(s) and publisher(s) of the Document do not by this License give permission to use their names for publicity for or to assert or imply endorsement of any Modified Version.
sr: Аутор(и) и издавач(и) Документа овом Лиценцом не дају дозволу за коришћење њихових имена ради рекламирања или ради потврђивања или имплицирања подршке било којој Измењеној верзији.

note: (itstool) path: appendix/bridgehead (itstool) id: index-in.docbook#Combining
en: 5. COMBINING DOCUMENTS
sr: 5. КОМБИНОВАЊЕ ДОКУМЕНАТА

note: (itstool) path: appendix/para
en: You may combine the Document with other documents released under this License, under the terms defined in section 4 above for modified versions, provided that you include in the combination all of the Invariant Sections of all of the original documents, unmodified, and list them all as Invariant Sections of your combined work in its license notice, and that you preserve all their Warranty Disclaimers.
sr: Можете комбиновати овај Документ са другим документима објављеним под овом Лиценцом, под условима дефинисаним у одељку 4 изнад за измењене верзије, под условом да у комбинацију укључите све Непроменљиве одељке свих изворних докумената, неизмењене, и наведете их све као Непроменљиве одељке вашег комбинованог рада у његовом обавештењу о лиценци, и да сачувате сва њихова Одрицања од гаранције.

note: (itstool) path: appendix/para
en: The combined work need only contain one copy of this License, and multiple identical Invariant Sections may be replaced with a single copy. If there are multiple Invariant Sections with the same name but different contents, make the title of each such section unique by adding at the end of it, in parentheses, the name of the original author or publisher of that section if known, or else a unique number. Make the same adjustment to the section titles in the list of Invariant Sections in the license notice of the combined work.
sr: Комбиновани рад треба да садржи само један примерак ове Лиценце, а више идентичних Непроменљивих одељака може бити замењено једним примерком. Ако постоји више Непроменљивих одељака са истим називом али различитим садржајем, учините наслов сваког таквог одељка јединственим тако што ћете на његов крај додати, у заградама, име изворног аутора или издавача тог одељка ако је познато, или у супротном јединствени број. Направите исто прилагођавање насловима одељака у списку Непроменљивих одељака у обавештењу о лиценци комбинованог рада.

note: (itstool) path: appendix/para
en: In the combination, you must combine any sections Entitled "History" in the various original documents, forming one section Entitled "History"; likewise combine any sections Entitled "Acknowledgements", and any sections Entitled "Dedications". You must delete all sections Entitled "Endorsements".
sr: У комбинацији, морате комбиновати све одељке под насловом „Историјат“ у различитим изворним документима, формирајући један одељак под насловом „Историјат“; исто тако комбинујте све одељке под насловом „Захвалнице“, и све одељке под насловом „Посвете“. Морате обрисати све одељке под насловом „Подршке“.

note: (itstool) path: appendix/bridgehead (itstool) id: index-in.docbook#Collections
en: 6. COLLECTIONS OF DOCUMENTS
sr: 6. ЗБИРКЕ ДОКУМЕНАТА

note: (itstool) path: appendix/para
en: You may make a collection consisting of the Document and other documents released under this License, and replace the individual copies of this License in the various documents with a single copy that is included in the collection, provided that you follow the rules of this License for verbatim copying of each of the documents in all other respects.
sr: Можете направити збирку која се састоји од Документа и других докумената објављених под овом Лиценцом, и заменити појединачне примерке ове Лиценце у различитим документима једним примерком који је укључен у збирку, под условом да пратите правила ове Лиценце за дословно умножавање сваког од докумената у свим осталим аспектима.

note: (itstool) path: appendix/para
en: You may extract a single document from such a collection, and distribute it individually under this License, provided you insert a copy of this License into the extracted document, and follow this License in all other respects regarding verbatim copying of that document.
sr: Можете извући појединачни документ из такве збирке, и дистрибуирати га појединачно под овом Лиценцом, под условом да уметнете примерак ове Лиценце у извучени документ, и пратите ову Лиценцу у свим осталим аспектима који се тичу дословног умножавања тог документа.

note: (itstool) path: appendix/bridgehead (itstool) id: index-in.docbook#Aggregation
en: 7. AGGREGATION WITH INDEPENDENT WORKS
sr: 7. ПРИКУПЉАЊЕ СА НЕЗАВИСНИМ РАДОВИМА

note: (itstool) path: appendix/para
en: A compilation of the Document or its derivatives with other separate and independent documents or works, in or on a volume of a storage or distribution medium, is called an "aggregate" if the copyright resulting from the compilation is not used to limit the legal rights of the compilation's users beyond what the individual works permit. When the Document is included in an aggregate, this License does not apply to the other works in the aggregate which are not themselves derivative works of the Document.
sr: Збирка Документа или његових деривата са другим засебним и независним документима или радовима, у или на волумену медијума за складиштење или дистрибуцију, назива се „збирним“ (aggregate) ако се ауторска права која произилазе из збирке не користе за ограничавање законских права корисника збирке изван онога што појединачни радови дозвољавају. Када је Документ укључен у збирку, ова Лиценца се не примењује на друге радове у збирци који сами по себи нису деривативни радови Документа.

note: (itstool) path: appendix/para
en: If the Cover Text requirement of section 3 is applicable to these copies of the Document, then if the Document is less than one half of the entire aggregate, the Document's Cover Texts may be placed on covers that bracket the Document within the aggregate, or the electronic equivalent of covers if the Document is in electronic form. Otherwise they must appear on printed covers that bracket the whole aggregate.
sr: Ако је захтев за Текстом на корицама из одељка 3 применљив на ове примерке Документа, онда ако Документ чини мање од једне половине целе збирке, Текстови на корицама Документа могу се поставити на корице које окружују Документ унутар збирке, или на електронски еквивалент корица ако је Документ у електронском облику. У супротном, морају се појавити на штампаним корицама које окружују целу збирку.

note: (itstool) path: appendix/bridgehead (itstool) id: index-in.docbook#Translation
en: 8. TRANSLATION
sr: 8. ПРЕВОД

note: (itstool) path: appendix/para
en: Translation is considered a kind of modification, so you may distribute translations of the Document under the terms of section 4. Replacing Invariant Sections with translations requires special permission from their copyright holders, but you may include translations of some or all Invariant Sections in addition to the original versions of these Invariant Sections. You may include a translation of this License, and all the license notices in the Document, and any Warranty Disclaimers, provided that you also include the original English version of this License and the original versions of those notices and disclaimers. In case of a disagreement between the translation and the original version of this License or a notice or disclaimer, the original version will prevail.
sr: Превод се сматра врстом измене, тако да можете дистрибуирати преводе Документа под условима из одељка 4. Замена Непроменљивих одељака преводима захтева посебну дозволу њихових носилаца ауторских права, али можете укључити преводе неких или свих Непроменљивих одељака поред изворних верзија тих Непроменљивих одељака. Можете укључити превод ове Лиценце, и свих обавештења о лиценци у Документу, и сва Одрицања од гаранције, под условом да такође укључите изворну енглеску верзију ове Лиценце и изворне верзије тих обавештења и одрицања. У случају неслагања између превода и изворне верзије ове Лиценце или обавештења или одрицања, изворна верзија ће превладати.

note: (itstool) path: appendix/para
en: If a section in the Document is Entitled "Acknowledgements", "Dedications", or "History", the requirement (section 4) to Preserve its Title (section 1) will typically require changing the actual title.
sr: Ако је одељак у Документу под насловом „Захвалнице“, „Посвете“ или „Историјат“, захтев (одељак 4) за очувањем његовог наслова (одељак 1) обично ће захтевати измену стварног наслова.

note: (itstool) path: appendix/bridgehead (itstool) id: index-in.docbook#Termination
en: 9. TERMINATION
sr: 9. ОКОНЧАВАЊЕ

note: (itstool) path: appendix/para
en: You may not copy, modify, sublicense, or distribute the Document except as expressly provided for under this License. Any other attempt to copy, modify, sublicense or distribute the Document is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance.
sr: Не смете умножавати, мењати, подлиценцирати или дистрибуирати Документ осим како је изричиво предвиђено овом Лиценцом. Сваки други покушај умножавања, измене, подлиценцирања или дистрибуције Документа је ништаван, и аутоматски ће окончати ваша права под овом Лиценцом. Међутим, странама које су од вас примиле примерке, или права, под овом Лиценцом, лиценце неће бити окончане све док те стране остану у потпуној усклађености.

note: (itstool) path: appendix/bridgehead (itstool) id: index-in.docbook#FutureRevisions
en: 10. FUTURE REVISIONS OF THIS LICENSE
sr: 10. БУДУЋЕ РЕВИЗИЈЕ ОВЕ ЛИЦЕНЦЕ

note: (itstool) path: appendix/para
en: The Free Software Foundation may publish new, revised versions of the GNU Free Documentation License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. See <link xlink:href="https://www.gnu.org/licenses/">https://www.gnu.org/licenses/</link>.
sr: Задужбина за слободан софтвер може с времена на време објављивати нове, измењене верзије ГНУ-ове лиценце за слободну документацију. Такве нове верзије ће бити сличне по духу садашњој верзији, али се могу разликовати у детаљима како би се решили нови проблеми или недоумице. Погледајте <link xlink:href="https://www.gnu.org/licenses/">https://www.gnu.org/licenses/</link>.

note: (itstool) path: appendix/para
en: Each version of the License is given a distinguishing version number. If the Document specifies that a particular numbered version of this License "or any later version" applies to it, you have the option of following the terms and conditions either of that specified version or of any later version that has been published (not as a draft) by the Free Software Foundation. If the Document does not specify a version number of this License, you may choose any version ever published (not as a draft) by the Free Software Foundation.
sr: Свакој верзији Лиценце даје се препознатљив број верзије. Ако Документ прецизира да се на њега примењује одређена нумерисана верзија ове Лиценце „или било која каснија верзија“, имате могућност да пратите одредбе и услове било те наведене верзије или било које касније верзије коју је објавила (не као нацрт) Задужбина за слободан софтвер. Ако Документ не наводи број верзије ове Лиценце, можете изабрати било коју верзију коју је икада објавила (не као нацрт) Задужбина за слободан софтвер.

note: (itstool) path: appendix/bridgehead (itstool) id: index-in.docbook#HowToUse
en: ADDENDUM: How to use this License for your documents
sr: ДОДАТАК: Како користити ову Лиценцу за ваше документе

note: (itstool) path: appendix/para
en: To use this License in a document you have written, include a copy of the License in the document and put the following copyright and license notices just after the title page:
sr: Да бисте користили ову Лиценцу у документу који сте написали, укључите примерак Лиценце у документ и ставите следећа обавештења о ауторским правима и лиценци одмах након насловне стране:

note: (itstool) path: blockquote/para
en: Copyright (C) YEAR YOUR NAME.
sr: Copyright (C) ГОДИНА ВАШЕ ИМЕ.

note: (itstool) path: blockquote/para
en: Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License".
sr: Дозвољено је умножавање, дељење и/или мењање овог документа под условима ГНУ-ове Слободне документационе лиценце, верзије 1.2 или било које новије верзије коју објави Задужбина слободног софтвера; без непоменљивих одељака, без текста на предњој страни и без текста на задњој страни. Примерак лиценце је укључен у одељку под насловом „GNU Free Documentation License“.

note: (itstool) path: appendix/para
en: If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts, replace the "with...Texts." line with this:
sr: Ако имате непоменљиве одељке, текст на предњој страни и текст на задњој страни, замените ред „with...Texts.“ овим:

note: (itstool) path: blockquote/para
en: with the Invariant Sections being LIST THEIR TITLES, with the Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST.
sr: са непоменљивим одељцима који су НАВЕДИТЕ ЊИХОВЕ НАСЛОВЕ, са текстом на предњој страни који је СПИСАК, и са текстом на задњој страни који је СПИСАК.

note: (itstool) path: appendix/para
en: If you have Invariant Sections without Cover Texts, or some other combination of the three, merge those two alternatives to suit the situation.
sr: Ако имате непоменљиве одељке без текста на корицама, или неку другу комбинацију ова три, спојите те две могућности како би одговарале ситуацији.

note: (itstool) path: appendix/para
en: If your document contains nontrivial examples of program code, we recommend releasing these examples in parallel under your choice of free software license, such as the GNU General Public License, to permit their use in free software.
sr: Ако ваш документ садржи нетривијалне примере програмског кода, препоручујемо да ове примере објавите упоредо под слободном софтверском лиценцом по вашем избору, као што је ГНУ-ова општа јавна лиценца, како бисте омогућили њихово коришћење у слободном софтверу.
