HTML code for sharing source code

HTML Copy To Clipboarddone!

<div class="highlight" style="background: #f8f8f8"><pre style="line-height: 125%"><div id="lc1">&lt;?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot;?&gt;
</div><div id="lc2">&lt;book id=&quot;writing_simple_plugin_in_20_minutes&quot; xmlns=&quot;http://docbook.org/ns/docbook&quot; version=&quot;5.0&quot; xml:lang=&quot;en&quot;&gt;
</div><div id="lc3">	&lt;bookinfo&gt;
</div><div id="lc4">		&lt;title&gt;Пишем простой плагин за 20 минут&lt;/title&gt;
</div><div id="lc5">	&lt;/bookinfo&gt;
</div><div id="lc6">	&lt;sect1 id=&quot;intro&quot;&gt;
</div><div id="lc7">		&lt;title&gt;Введение&lt;/title&gt;
</div><div id="lc8">		&lt;para&gt;Из этого руководства вы узнаете, как написать простенький плагин (назовём его Auscrie — от &quot;Auto Screenshoter&quot;) для LeechCraft, проилюстрировав, таким образом, базовые концепции написания плагинов. Наш плагин сможет снимать скриншот окна LeechCraft и либо сохранять его на диск, либо постить на imagebin. Процесс будет осуществляться с помощью кнопки на панели инструментов.&lt;/para&gt;
</div><div id="lc9">		&lt;para&gt;Вы узнаете:
</div><div id="lc10">			&lt;itemizedlist&gt;
</div><div id="lc11">				&lt;listitem&gt;как создавать &quot;пустые&quot; плагины и собирать их;&lt;/listitem&gt;
</div><div id="lc12">				&lt;listitem&gt;как добавлять интерфейс пользователя, созданный с помощью Qt Designer;&lt;/listitem&gt;
</div><div id="lc13">				&lt;listitem&gt;о предпочтительных путях взаимодействия с сетью и HTTP в LeechCraft;&lt;/listitem&gt;
</div><div id="lc14">				&lt;listitem&gt;как использовать сообщения LeechCraft для оповещения пользователя о событиях, произошедших в вашем плагине.&lt;/listitem&gt;
</div><div id="lc15">			&lt;/itemizedlist&gt;
</div><div id="lc16">		&lt;/para&gt;
</div><div id="lc17">	&lt;/sect1&gt;
</div><div id="lc18">	&lt;sect1 id=&quot;understanding_plugins&quot;&gt;
</div><div id="lc19">		&lt;title&gt;Understanding plugins&lt;/title&gt;
</div><div id="lc20">		&lt;para&gt;Плагины, написанные на C++, являются всего лишь динамическими библиотеками, из которых экспортируется главный экземпляр плагина. Экспорт осуществляется с помощью Q_EXPORT_PLUGIN2. Плагин должен содержать реализацию интерфейса IInfo (для чего используется заголовочный файл &lt;filename&gt;/src/interfaces/iinfo.h&lt;/filename&gt; в корне репозитория), чтобы распознаваться как плагин для LeechCraft.&lt;/para&gt;
</div><div id="lc21">		&lt;para&gt;Чтобы узнать больше о написании плагинов для приложений на C++/Qt, обратитесь к руководству &quot;Как создавать плагины Qt&quot;.&lt;/para&gt;
</div><div id="lc22">		&lt;para&gt;Также можете обратиться к общему обзору LeechCraft, чтобы узнать больше о его архитектуре и плагинах.&lt;/para&gt;
</div><div id="lc23">	&lt;/sect1&gt;
</div><div id="lc24">	&lt;sect1 id=&quot;paths&quot;&gt;
</div><div id="lc25">		&lt;title&gt;Пути&lt;/title&gt;
</div><div id="lc26">		&lt;para&gt;Для удобства, будем работать прямо в директории с исходниками, &lt;filename&gt;/src/plugins/auscrie&lt;/filename&gt;. Обычно плагины разрабатываются отдельно от дерева сорцов (обратитесь к документации о трудовом процессе, чтобы узнать больше), но единственным отличием является то, что вам придётся соответствующим образом поменять пути. Например, при запуске CMake нужно будет убедиться, что &lt;parameter&gt;CMAKE_MODULE_PATH&lt;/parameter&gt; указывает на директорию, содержащую &lt;filename&gt;FindLeechCraft.cmake&lt;/filename&gt;. Переменные CMake устанавливаются с помощью опции командной строки &lt;option&gt;-D&lt;/option&gt;, например:&lt;screen&gt;&lt;command&gt;cmake -DCMAKE_MODULE_PATH=&lt;replaceable&gt;/some/path/to/LeechCraft/SDK&lt;/replaceable&gt;&lt;/command&gt;&lt;/screen&gt;&lt;/para&gt;
</div><div id="lc27">		&lt;para&gt;Это руководство ориентировано на *NIX. За деталями касательно сборки под Windows обратитесь к соответствующему руководству.&lt;/para&gt;
</div><div id="lc28">	&lt;/sect1&gt;
</div><div id="lc29">	&lt;sect1 id=&quot;general_skeleton&quot;&gt;
</div><div id="lc30">		&lt;title&gt;Каркас&lt;/title&gt;
</div><div id="lc31">		&lt;para&gt;В репозитории LeechCraft есть удобный Python-скрипт, &lt;filename&gt;/tools/scripts/genplugin.py&lt;/filename&gt;, генерирующий базовый &lt;filename&gt;CMakeLists.txt&lt;/filename&gt; и файлы с объявлениями/определениями экземпляра плагина. Запускается он следующим образом:&lt;/para&gt;
</div><div id="lc32">		&lt;screen&gt;&lt;command&gt;genplugin.py -a &quot;&lt;replaceable&gt;Plugin Author&lt;/replaceable&gt;&quot; -p &lt;replaceable&gt;PluginNameWithoutSpaces&lt;/replaceable&gt; -i &lt;replaceable&gt;Comma,Separated,List,Of,Base,Interfaces&lt;/replaceable&gt;&lt;/command&gt;&lt;/screen&gt;
</div><div id="lc33">		&lt;para&gt;При запуске с опцией &lt;option&gt;-h&lt;/option&gt; будет выдана краткая справка.&lt;/para&gt;
</div><div id="lc34">		&lt;para&gt;Итак, создаём директорию &lt;filename&gt;/src/plugins/auscrie&lt;/filename&gt;, переходим в неё и запускаем скрипт (заметьте, что в вашем случае путь к genplugin.py может быть другим):&lt;/para&gt;
</div><div id="lc35">		&lt;screen&gt;&lt;command&gt;../../../tools/scripts/genplugin.py -a &quot;Your Name&quot; -p Auscrie -i IToolBarEmbedder&lt;/command&gt;&lt;/screen&gt;
</div><div id="lc36">		&lt;para&gt;Наследование от &lt;interfacename&gt;IToolBarEmbedder&lt;/interfacename&gt; (&lt;filename&gt;/src/interfaces/itoolbarembedder.h&lt;/filename&gt;) необходимо для того, чтобы поместить кнопку на панель инструментов.&lt;/para&gt;
</div><div id="lc37">		&lt;para&gt;Этот скрипт сгенерирует базовые файлы, но их будет достаточно для минимального работающего (точнее, загружающегося) плагина. Попробуем-ка собрать и запустить его! Для этого создадим директорию для сборки, запустим в ней &lt;command&gt;cmake&lt;/command&gt;, потом &lt;command&gt;make&lt;/command&gt;, чтобы собрать плагин, а затем &lt;command&gt;make install&lt;/command&gt; от root, чтобы установить его. Из директории с исходниками выполните:&lt;/para&gt;
</div><div id="lc38">		&lt;screen&gt;
</div><div id="lc39">		&lt;command&gt;mkdir build&lt;/command&gt;
</div><div id="lc40">		&lt;command&gt;cd build&lt;/command&gt;
</div><div id="lc41">		&lt;command&gt;cmake ../&lt;/command&gt;
</div><div id="lc42">		&lt;command&gt;make&lt;/command&gt;
</div><div id="lc43">		&lt;command&gt;sudo make install&lt;/command&gt;
</div><div id="lc44">		&lt;/screen&gt;
</div><div id="lc45">		&lt;para&gt;Здесь использована сборка вне дерева исходников. Вообще это предпочтительный способ, т.к. можно легко очистить дерево исходников, просто удалив директорию сборки, или содержать несколько сборок с разными конфигурациями.&lt;/para&gt;
</div><div id="lc46">		&lt;para&gt;Теперь запустим LeechCraft, откроем диалог Настройки и выберем вкладку Плагины. В списке должен присутствовать наш плагин. Если это не так, проверьте логи (&lt;filename&gt;~/.leechcraft/warning.log&lt;/filename&gt;) и свяжитесь с нами.&lt;/para&gt;
</div><div id="lc47">	&lt;/sect1&gt;
</div><div id="lc48">	&lt;sect1 id=&quot;basic_stuff&quot;&gt;
</div><div id="lc49">		&lt;title&gt;Базовые вещи&lt;/title&gt;
</div><div id="lc50">		&lt;para&gt;Итак, у нас уже есть базовый плагин. Заполним-ка пробелы.&lt;/para&gt;
</div><div id="lc51">		&lt;para&gt;Во-первых, нужно вписать в &lt;function&gt;GetInfo&lt;/function&gt; какое-то описание типа &quot;Простой плагин для снятия скриншотов&quot;.&lt;/para&gt;
</div><div id="lc52">		&lt;para&gt;Теперь нужно создать объект QAction, который будет снимать скриншот. Для начала объявим некоторые внутренние переменные и методы:
</div><div id="lc53">			&lt;itemizedlist&gt;
</div><div id="lc54">				&lt;listitem&gt;&lt;varname&gt;Proxy_&lt;/varname&gt; типа &lt;classname&gt;ICoreProxy_ptr&lt;/classname&gt;, которая будет содержать указатель на прокси-объект ядра, передаваемый функции &lt;function&gt;Init&lt;/function&gt;. Он нужен нам, т.к. через этот объект осуществляется всё взаимодействие с ядром;&lt;/listitem&gt;
</div><div id="lc55">				&lt;listitem&gt;&lt;classname&gt;QAction&lt;/classname&gt; *&lt;varname&gt;ShotAction_&lt;/varname&gt;, который будет инициировать снятие скриншота;&lt;/listitem&gt;
</div><div id="lc56">				&lt;listitem&gt;слот &lt;function&gt;makeScreenshot&lt;/function&gt;, который будет запускаться по событию.&lt;/listitem&gt;
</div><div id="lc57">			&lt;/itemizedlist&gt;
</div><div id="lc58">		&lt;/para&gt;
</div><div id="lc59">		&lt;para&gt;Эту инициализацию лучше производить в функции Init, так что давайте допишем туда вот такой код для нашего экшена:&lt;/para&gt;
</div><div id="lc60">		&lt;programlisting language=&quot;c++&quot;&gt;
</div><div id="lc61">&lt;![CDATA[
</div><div id="lc62">Proxy_ = proxy;
</div><div id="lc63">
</div><div id="lc64">Dialog_ = new ShooterDialog (Proxy_-&gt;GetMainWindow ());
</div><div id="lc65">
</div><div id="lc66">ShotAction_ = new QAction (Proxy_-&gt;GetIcon (&quot;screenshot&quot;),
</div><div id="lc67">        tr (&quot;Make a screenshot&quot;),
</div><div id="lc68">        this);
</div><div id="lc69">connect (ShotAction_,
</div><div id="lc70">        SIGNAL (triggered ()),
</div><div id="lc71">        this,
</div><div id="lc72">        SLOT (makeScreenshot ()));
</div><div id="lc73">]]&gt;
</div><div id="lc74">		&lt;/programlisting&gt;
</div><div id="lc75">		&lt;para&gt;&lt;classname&gt;ICoreProxy_ptr&lt;/classname&gt; используется для получения правильной иконки из текущей темы.Когда вы будете разрабатывать свои собственные плагины, вам придётся таскать иконки с собой, пока не попадёте в официальный репозиторий. Прокси также используется для получения указателя на главное окно. О &lt;classname&gt;ShooterDialog&lt;/classname&gt; мы поговорим позже.&lt;/para&gt;
</div><div id="lc76">		&lt;para&gt;Теперь давайте заполним заглушку &lt;function&gt;GetActions&lt;/function&gt;, чтобы она возвращала &lt;varname&gt;ShotAction_&lt;/varname&gt;. &lt;function&gt;GetActions&lt;/function&gt; будет выглядеть примерно так:&lt;/para&gt;
</div><div id="lc77">		&lt;programlisting language=&quot;c++&quot;&gt;
</div><div id="lc78">&lt;![CDATA[
</div><div id="lc79">QList&lt;QAction*&gt; Plugin::GetActions () const
</div><div id="lc80">{
</div><div id="lc81">    QList&lt;QAction*&gt; result;
</div><div id="lc82">    result &lt;&lt; ShotAction_;
</div><div id="lc83">    return result;
</div><div id="lc84">}
</div><div id="lc85">]]&gt;
</div><div id="lc86">		&lt;/programlisting&gt;
</div><div id="lc87">		&lt;para&gt;Если сейчас скомпилировать и установить плагин, мы увидим иконку скриншоттера на панели инструментов, но она пока что ничего не делает.&lt;/para&gt;
</div><div id="lc88">	&lt;/sect1&gt;
</div><div id="lc89">	&lt;sect1 id=&quot;initiating_screenshooting&quot;&gt;
</div><div id="lc90">		&lt;title&gt;Инициация получения скриншота&lt;/tite&gt;
</div><div id="lc91">		&lt;para&gt;В слоте мы запустим простой диалог, запрашивающий опции скриншота. Когда пользователь нажимает ОК, мы отключаем экшн (мы включим его, когда скриншот будет готов) и стартуем таймер в соответствии с таймаутом, заданным пользователем в диалоге:&lt;/para&gt;
</div><div id="lc92">		&lt;programlisting language=&quot;c++&quot;&gt;
</div><div id="lc93">&lt;![CDATA[
</div><div id="lc94">void Plugin::makeScreenshot ()
</div><div id="lc95">{
</div><div id="lc96">    if (Dialog_-&gt;exec () != QDialog::Accepted)
</div><div id="lc97">        return;
</div><div id="lc98">
</div><div id="lc99">    ShotAction_-&gt;setEnabled (false);
</div><div id="lc100">    QTimer::singleShot (Dialog_-&gt;GetTimeout () * 1000,
</div><div id="lc101">            this,
</div><div id="lc102">            SLOT (shoot ()));
</div><div id="lc103">}
</div><div id="lc104">]]&gt;
</div><div id="lc105">		&lt;/programlisting&gt;
</div><div id="lc106">		&lt;para&gt;Мы создали Dialog_ в Init() для того, чтобы хранить его между вызовами makeScreenshot(). То, что диалог доступен из любой функции, имеет свои преимущества: например, нет никакой нужды в хранении параметров скриншота, вроде формата или качества, так как мы можем запросить их в любой момент&lt;/para&gt;
</div><div id="lc107">		&lt;para&gt;Написание диалога является довольно простой задачей для любого, кто когда-либо использовал Qt Designer, так что я не стану рассматривать это здесь. Впрочем, стоит рассказать о том, как добавлять формы в проекты, работающие с CMake. Нужно определить переменную, которая будет содержать список форм (в нашем случае это &lt;varname&gt;FORMS&lt;/varname&gt;), добавить &lt;filename&gt;.h&lt;/filename&gt;- и &lt;filename&gt;.cpp&lt;/filename&gt;-файлы в список заголовочных файлов и исходников, вызвать функцию &lt;function&gt;QT4_WRAP_UI&lt;/function&gt; для запуска на формах команды &lt;command&gt;uic&lt;/command&gt;, а затем добавить результаты в список зависимостей плагина. Таким образом, середина &lt;function&gt;CMakeLists.txt&lt;/function&gt; будет выглядеть так:&lt;/para&gt;
</div><div id="lc108">		&lt;programlisting language=&quot;cmake&quot;&gt;
</div><div id="lc109">&lt;![CDATA[
</div><div id="lc110">SET (SRCS
</div><div id="lc111">    auscrie.cpp
</div><div id="lc112">    shooterdialog.cpp
</div><div id="lc113">    )
</div><div id="lc114">SET (HEADERS
</div><div id="lc115">    auscrie.h
</div><div id="lc116">    shooterdialog.h
</div><div id="lc117">    )
</div><div id="lc118">SET (FORMS
</div><div id="lc119">    shooterdialog.ui
</div><div id="lc120">    )
</div><div id="lc121">QT4_WRAP_CPP (MOC_SRCS ${HEADERS})
</div><div id="lc122">QT4_WRAP_UI (UIS_H ${FORMS})
</div><div id="lc123">
</div><div id="lc124">ADD_LIBRARY (leechcraft_auscrie SHARED
</div><div id="lc125">    ${COMPILED_TRANSLATIONS}
</div><div id="lc126">    ${SRCS}                                                                                                                                                                                                                      
</div><div id="lc127">    ${MOC_SRCS}
</div><div id="lc128">    ${UIS_H}
</div><div id="lc129">    )
</div><div id="lc130">]]&gt;
</div><div id="lc131">		&lt;/programlisting&gt;
</div><div id="lc132">	&lt;/sect1&gt;
</div><div id="lc133">	&lt;sect1 id=&quot;shooting_is_fun&quot;&gt;
</div><div id="lc134">		&lt;title&gt;Скриншоты — это весело.&lt;/title&gt;
</div><div id="lc135">		&lt;para&gt;Давайте наконец взглянем на слот &lt;function&gt;shoot&lt;/function&gt;.&lt;/para&gt;
</div><div id="lc136">		&lt;para&gt;Для получения доступа к окну мы используем объект &lt;varname&gt;Proxy_&lt;/varname&gt;, с помощью которого ранее получали доступ к главному окну. Не забудьте подключить заголовочный файл &lt;classname&gt;QMainWindow&lt;/classname&gt;, иначе приведение типов из &lt;classname&gt;QMainWindow&lt;/classname&gt;* в &lt;classname&gt;QWidget&lt;/classname&gt;* не сработает.&lt;/para&gt;
</div><div id="lc137">		&lt;programlisting language=&quot;c++&quot;&gt;
</div><div id="lc138">&lt;![CDATA[
</div><div id="lc139">void Plugin::shoot ()
</div><div id="lc140">{
</div><div id="lc141">    ShotAction_-&gt;setEnabled (true);
</div><div id="lc142">
</div><div id="lc143">    QWidget *mw = Proxy_-&gt;GetMainWindow ();
</div><div id="lc144">    QPixmap pm = QPixmap::grabWidget (mw);
</div><div id="lc145">
</div><div id="lc146">    const char *fmt = qPrintable (Dialog_-&gt;GetFormat ());
</div><div id="lc147">    int quality = Dialog_-&gt;GetQuality ();
</div><div id="lc148">]]&gt;
</div><div id="lc149">		&lt;/programlisting&gt;
</div><div id="lc150">		&lt;para&gt;После этого у нас есть два варианта: либо сохранить файл на диск, либо отправить его на pastebin. Первый немного проще:&lt;/para&gt;
</div><div id="lc151">		&lt;programlisting language=&quot;c++&quot;&gt;
</div><div id="lc152">&lt;![CDATA[
</div><div id="lc153">    switch (Dialog_-&gt;GetAction ())
</div><div id="lc154">    {
</div><div id="lc155">        case ShooterDialog::ASave:
</div><div id="lc156">        {
</div><div id="lc157">            QString path = Proxy_-&gt;GetSettingsManager ()-&gt;
</div><div id="lc158">                    Property (&quot;PluginsStorage/Auscrie/SavePath&quot;,
</div><div id="lc159">                            QDir::currentPath () + &quot;01.&quot; + Dialog_-&gt;GetFormat ())
</div><div id="lc160">                    .toString ();
</div><div id="lc161">
</div><div id="lc162">            QString filename = QFileDialog::getSaveFileName (mw,
</div><div id="lc163">                    tr (&quot;Save as&quot;),
</div><div id="lc164">                    path,
</div><div id="lc165">                    tr (&quot;%1 files (*.%1);;All files (*.*)&quot;)
</div><div id="lc166">                        .arg (Dialog_-&gt;GetFormat ()));
</div><div id="lc167">
</div><div id="lc168">            if (!filename.isEmpty ())
</div><div id="lc169">            {
</div><div id="lc170">                pm.save (filename, fmt, quality);
</div><div id="lc171">                Proxy_-&gt;GetSettingsManager ()-&gt;
</div><div id="lc172">                setProperty (&quot;PluginsStorage/Auscrie/SavePath&quot;,
</div><div id="lc173">                        filename);
</div><div id="lc174">            }
</div><div id="lc175">        }
</div><div id="lc176">        break;
</div><div id="lc177">]]&gt;
</div><div id="lc178">		&lt;/programlisting&gt;
</div><div id="lc179">		&lt;para&gt;Здесь использован менеджер настроек из ядра, который, вобщем-то, является обёрткой вокруг &lt;classname&gt;QSettings&lt;/classname&gt;. Клавиши, начинающиеся с &lt;emphasis&gt;PluginsStorage&lt;/emphasis&gt;, могут быть использованы плагинами, ядро не будет использовать их в своих собственных задачах. Использование менеджера настороек ядра нормально для хранения пары настроек, но если вам нужно больше, особенно если вам нужен отдельный диалог, лучше добавить его в ваш плагин.&lt;/para&gt;
</div><div id="lc180">		&lt;para&gt;Если пользовать выбрал загрузку изображения на imagebin, следует вызвать отдельную функцию, Post(), которая обо всём позаботится:&lt;/para&gt;
</div><div id="lc181">		&lt;programlisting language=&quot;c++&quot;&gt;
</div><div id="lc182">&lt;![CDATA[
</div><div id="lc183">        case ShooterDialog::AUpload:
</div><div id="lc184">        {
</div><div id="lc185">            QBuffer buf;
</div><div id="lc186">            pm.save (&amp;buf,
</div><div id="lc187">                    fmt,
</div><div id="lc188">                    quality);
</div><div id="lc189">            Post (buf.data ());
</div><div id="lc190">        }
</div><div id="lc191">		break;
</div><div id="lc192">    }
</div><div id="lc193">}
</div><div id="lc194">]]&gt;
</div><div id="lc195">		&lt;/programlisting&gt;
</div><div id="lc196">		&lt;para&gt;Теперь нам также следует добавить в &lt;filename&gt;CMakeLists.txt&lt;/filename&gt; следующие строки (прямо перед &lt;code&gt;INCLUDE (${QT_USE_FILE})&lt;/code&gt;):&lt;/para&gt;
</div><div id="lc197">		&lt;programlisting language=&quot;cmake&quot;&gt;
</div><div id="lc198">&lt;![CDATA[
</div><div id="lc199">SET (QT_USE_QTNETWORK TRUE)
</div><div id="lc200">]]&gt;
</div><div id="lc201">		&lt;/programlisting&gt;
</div><div id="lc202">		&lt;para&gt;Это даст нашему плагину возможность работать с сетью, делая видимыми включения из модуля QtNetwork и линкуя плагин с библиотекой QtNetwork. Нам она определённо понадобится, т.к. плагин использует QtNetwork (например, &lt;classname&gt;QNetworkAccessManager&lt;/classname&gt; и &lt;classname&gt;QNetworkReply&lt;/classname&gt;) для постинга скриншотов.&lt;/para&gt;
</div><div id="lc203">		&lt;para&gt;Так как сейчас нас не интересует имплементация загрузки скриншота на imagebin, мы перенесём этот код в отдельный класс &lt;classname&gt;Poster&lt;/classname&gt;, и наша функция &lt;function&gt;Post&lt;/function&gt; будет выглядеть очень просто:&lt;/para&gt;
</div><div id="lc204">		&lt;programlisting language=&quot;c++&quot;&gt;
</div><div id="lc205">&lt;![CDATA[
</div><div id="lc206">void Plugin::Post (const QByteArray&amp; data)
</div><div id="lc207">{
</div><div id="lc208">    Poster *p = new Poster (data,
</div><div id="lc209">            Dialog_-&gt;GetFormat (),
</div><div id="lc210">            Proxy_-&gt;GetNetworkAccessManager ());
</div><div id="lc211">    connect (p,
</div><div id="lc212">            SIGNAL (finished (QNetworkReply*)),
</div><div id="lc213">            this,
</div><div id="lc214">            SLOT (handleFinished (QNetworkReply*)));
</div><div id="lc215">    connect (p,
</div><div id="lc216">            SIGNAL (error (QNetworkReply*)),
</div><div id="lc217">            this,
</div><div id="lc218">            SLOT (handleError (QNetworkReply*)));
</div><div id="lc219">}
</div><div id="lc220">]]&gt;
</div><div id="lc221">		&lt;/programlisting&gt;
</div><div id="lc222">		&lt;para&gt;Здесь мы ещё раз использовали &lt;varname&gt;Proxy_&lt;/varname&gt;, на этот раз — для получения общего для всего приложения экземпляра &lt;classname&gt;QNetworkAccessManager&lt;/classname&gt; с методом &lt;function&gt;GetNetworkAccessManager&lt;/function&gt;. Использовать общий экземпляр &lt;classname&gt;QNetworkAccessManager&lt;/classname&gt; всегда лучше, так как это позволяет получать доступ к общему кэшу и базе cookie, а также предоставляет возможность оптимизировать запросы путём повтороного использования соединений, например.&lt;/para&gt;
</div><div id="lc223">		&lt;para&gt;Следует также отметить, что в случае, когда вам нужно просто скачать файл (в данном плагине это не нужно, но это довольно часто возникающая задача), достаточно просто сгенерировать соответствующий сигнал, не заботясь о доступе к сети, менеджерах, ответах и прочем. Этот подход детально обсуждается в документе Обзор.&lt;/para&gt;
</div><div id="lc224">		&lt;para&gt;Считается нормальным создание &lt;classname&gt;Poster&lt;/classname&gt; в куче, не заботясь об освобождении памяти. Она будет освобождена соответствующими слотами.&lt;/para&gt;
</div><div id="lc225">		&lt;para&gt;Мы подключаемся к сигналам класса &lt;classname&gt;Poster&lt;/classname&gt; — 
</div><div id="lc226">			&lt;funcsynopsis&gt;
</div><div id="lc227">				&lt;funcprototype&gt;
</div><div id="lc228">					&lt;funcdef&gt;&lt;function&gt;finished&lt;/function&gt;&lt;/funcdef&gt;
</div><div id="lc229">					&lt;paramdef&gt;QNetworkReply *&lt;parameter&gt;reply&lt;/parameter&gt;&lt;/paramdef&gt;
</div><div id="lc230">				&lt;/funcprototype&gt;
</div><div id="lc231">			&lt;/funcsynopsis&gt;
</div><div id="lc232">			и
</div><div id="lc233">			&lt;funcsynopsis&gt;
</div><div id="lc234">				&lt;funcprototype&gt;
</div><div id="lc235">					&lt;funcdef&gt;&lt;function&gt;error&lt;/function&gt;&lt;/funcdef&gt;
</div><div id="lc236">					&lt;paramdef&gt;QNetworkReply *&lt;parameter&gt;reply&lt;/parameter&gt;&lt;/paramdef&gt;
</div><div id="lc237">				&lt;/funcprototype&gt;
</div><div id="lc238">			&lt;/funcsynopsis&gt;
</div><div id="lc239">			— для того, чтобы получать извещения о том, что загрузка завершилась (а также чтобы узнать о возможных ошибках). &lt;classname&gt;Poster&lt;/classname&gt; генерирует сигнал с параметром — &lt;classname&gt;QNetworkReply&lt;/classname&gt;, который изначально излучил соответствующий сигнал.&lt;/para&gt;
</div><div id="lc240">		&lt;para&gt;Взглянем на 
</div><div id="lc241">			&lt;funcsynopsis&gt;
</div><div id="lc242">				&lt;funcprototype&gt;
</div><div id="lc243">					&lt;funcdef&gt;&lt;function&gt;handleFinished&lt;/function&gt;&lt;/funcdef&gt;
</div><div id="lc244">					&lt;paramdef&gt;QNetworkReply *&lt;parameter&gt;reply&lt;/parameter&gt;&lt;/paramdef&gt;
</div><div id="lc245">				&lt;/funcprototype&gt;
</div><div id="lc246">			&lt;/funcsynopsis&gt;
</div><div id="lc247">			(кстати, не забудьте объявить все представленные члены в определении класса):&lt;/para&gt;
</div><div id="lc248">		&lt;programlisting language=&quot;c++&quot;&gt;
</div><div id="lc249">&lt;![CDATA[
</div><div id="lc250">void Plugin::handleFinished (QNetworkReply *reply)
</div><div id="lc251">{
</div><div id="lc252">    sender ()-&gt;deleteLater ();
</div><div id="lc253">
</div><div id="lc254">    QString result = reply-&gt;readAll ();
</div><div id="lc255">
</div><div id="lc256">    QRegExp re (&quot;&lt;p&gt;You can find this at &lt;a href=&#39;([^&lt;]+)&#39;&gt;([^&lt;]+)&lt;/a&gt;&lt;/p&gt;&quot;);
</div><div id="lc257">    if (!re.exactMatch (result))
</div><div id="lc258">    {
</div><div id="lc259">        Entity e = Util::MakeNotification (&quot;Auscrie&quot;,
</div><div id="lc260">                tr (&quot;Page parse failed&quot;),
</div><div id="lc261">                PWarning_);
</div><div id="lc262">        emit gotEntity (e);
</div><div id="lc263">        return;
</div><div id="lc264">    }
</div><div id="lc265">
</div><div id="lc266">    QString pasteUrl = re.cap (1);
</div><div id="lc267">
</div><div id="lc268">    Entity e = Util::MakeNotification (&quot;Auscrie&quot;,
</div><div id="lc269">            tr (&quot;Image pasted: %1, the URL was copied to the clipboard&quot;)
</div><div id="lc270">                .arg (pasteUrl),
</div><div id="lc271">            PInfo_);
</div><div id="lc272">
</div><div id="lc273">    QApplication::clipboard ()-&gt;setText (pasteUrl, QClipboard::Clipboard);
</div><div id="lc274">    QApplication::clipboard ()-&gt;setText (pasteUrl, QClipboard::Selection);
</div><div id="lc275">    
</div><div id="lc276">    emit gotEntity (e);
</div><div id="lc277">}
</div><div id="lc278">]]&gt;
</div><div id="lc279">		&lt;/programlisting&gt;
</div><div id="lc280">		&lt;para&gt;В первую очередь мы указываем посылающему объекту (экземпляру &lt;classname&gt;Poster&lt;/classname&gt;, созданному ранее) удалить себя, как только управление будет возвращено циклу обработки событий. Мы не можем просто написать что-то вроде &lt;code&gt;delete sender ();&lt;/code&gt;, потому что объекты не могут быть удалены из их же обработчиков сигналов.&lt;/para&gt;
</div><div id="lc281">		&lt;para&gt;После этого мы с помощью &lt;function&gt;readAll&lt;/function&gt; получаем страницу, которую вернул сервер, и пытаемся извлечь ссылку на наше свежезагруженное изображение с помощью довольно простого регулярного выражения. Если сделать это не удаётся, мы генерируем уведомление об ошибке с приоритетом Warning и прерываем обработку. Заметьте также, что в сигналах классов и слотов, использующих структуры данных LeechCraft, вы должны использовать полностью определённые имена со всеми пространствами имён, например
</div><div id="lc282">			&lt;funcsynopsis&gt;
</div><div id="lc283">				&lt;funcprototype&gt;
</div><div id="lc284">					&lt;funcdef&gt;void &lt;function&gt;gotEntity&lt;/function&gt;&lt;/funcdef&gt;
</div><div id="lc285">					&lt;paramdef&gt;const LeechCraft::Entity&amp;amp; &lt;parameter&gt;entity&lt;/parameter&gt;&lt;/paramdef&gt;
</div><div id="lc286">				&lt;/funcprototype&gt;
</div><div id="lc287">			&lt;/funcsynopsis&gt;
</div><div id="lc288">			В противном случае система метаобъектов Qt не распознает их.&lt;/para&gt;
</div><div id="lc289">		&lt;para&gt;Здесь также используется система сообщений LeechCraft. С её помощью можно отправлять пользователю оповещения о событиях, происходящих в плагине, вроде ошибок или всяких информационных сообщений. Для создания оповещения используется функция &lt;function&gt;LeechCraft::Util::MakeNotification&lt;/function&gt;, которая может быть добавлена с помощью &lt;code&gt;&lt;![CDATA[#include &lt;plugininterface/util.h&gt;]]&gt;&lt;/code&gt;. Эта функция принимает три параметра: заголовок, тело и приоритет оповещения. Более детально оповещения и сообщения LeechCraft обсуждаются в документе Обзор.&lt;/para&gt;
</div><div id="lc290">	&lt;/sect1&gt;
</div><div id="lc291">	&lt;sect1 id=&quot;conclusion&quot;&gt;
</div><div id="lc292">		&lt;title&gt;Заключение&lt;/title&gt;
</div><div id="lc293">		&lt;para&gt;Вобщем-то, это всё. Теперь у нас есть работающий, полезный плагин. Конечно же, есть вещи, которые стоило бы добавить: например, можно было бы хранить историю всех запощенных скриншотов или показывать красивенький прогрессбар, демонстрирующий загрузку изображения. Также вам наверняка захочется добавить поддержку локализаций, но нашей целью здесь было привыкнуть к концепции плагинов LeechCraft.&lt;/para&gt;
</div><div id="lc294">	&lt;/sect1&gt;
</div><div id="lc295">&lt;/book&gt;
</div></pre></div>
<p style="padding: 0; margin: 2em 0 1em 0; font-size: 0.8em; color: #666;"><span style="padding: 0 1em; background-color: #f5f5f5;"> Colored with <a style="color: #333" href="http://dumpz.org">dumpz.org</a></span></p>

BBCODE Copy To Clipboarddone!

<?xml version="1.0" encoding="utf-8"?>
<book id="writing_simple_plugin_in_20_minutes" xmlns="http://docbook.org/ns/docbook" version="5.0" xml:lang="en">
	<bookinfo>
		<title>Пишем простой плагин за 20 минут</title>
	</bookinfo>
	<sect1 id="intro">
		<title>Введение</title>
		<para>Из этого руководства вы узнаете, как написать простенький плагин (назовём его Auscrie — от "Auto Screenshoter") для LeechCraft, проилюстрировав, таким образом, базовые концепции написания плагинов. Наш плагин сможет снимать скриншот окна LeechCraft и либо сохранять его на диск, либо постить на imagebin. Процесс будет осуществляться с помощью кнопки на панели инструментов.</para>
		<para>Вы узнаете:
			<itemizedlist>
				<listitem>как создавать "пустые" плагины и собирать их;</listitem>
				<listitem>как добавлять интерфейс пользователя, созданный с помощью Qt Designer;</listitem>
				<listitem>о предпочтительных путях взаимодействия с сетью и HTTP в LeechCraft;</listitem>
				<listitem>как использовать сообщения LeechCraft для оповещения пользователя о событиях, произошедших в вашем плагине.</listitem>
			</itemizedlist>
		</para>
	</sect1>
	<sect1 id="understanding_plugins">
		<title>Understanding plugins</title>
		<para>Плагины, написанные на C++, являются всего лишь динамическими библиотеками, из которых экспортируется главный экземпляр плагина. Экспорт осуществляется с помощью Q_EXPORT_PLUGIN2. Плагин должен содержать реализацию интерфейса IInfo (для чего используется заголовочный файл <filename>/src/interfaces/iinfo.h</filename> в корне репозитория), чтобы распознаваться как плагин для LeechCraft.</para>
		<para>Чтобы узнать больше о написании плагинов для приложений на C++/Qt, обратитесь к руководству "Как создавать плагины Qt".</para>
		<para>Также можете обратиться к общему обзору LeechCraft, чтобы узнать больше о его архитектуре и плагинах.</para>
	</sect1>
	<sect1 id="paths">
		<title>Пути</title>
		<para>Для удобства, будем работать прямо в директории с исходниками, <filename>/src/plugins/auscrie</filename>. Обычно плагины разрабатываются отдельно от дерева сорцов (обратитесь к документации о трудовом процессе, чтобы узнать больше), но единственным отличием является то, что вам придётся соответствующим образом поменять пути. Например, при запуске CMake нужно будет убедиться, что <parameter>CMAKE_MODULE_PATH</parameter> указывает на директорию, содержащую <filename>FindLeechCraft.cmake</filename>. Переменные CMake устанавливаются с помощью опции командной строки <option>-D</option>, например:<screen><command>cmake -DCMAKE_MODULE_PATH=<replaceable>/some/path/to/LeechCraft/SDK</replaceable></command></screen></para>
		<para>Это руководство ориентировано на *NIX. За деталями касательно сборки под Windows обратитесь к соответствующему руководству.</para>
	</sect1>
	<sect1 id="general_skeleton">
		<title>Каркас</title>
		<para>В репозитории LeechCraft есть удобный Python-скрипт, <filename>/tools/scripts/genplugin.py</filename>, генерирующий базовый <filename>CMakeLists.txt</filename> и файлы с объявлениями/определениями экземпляра плагина. Запускается он следующим образом:</para>
		<screen><command>genplugin.py -a "<replaceable>Plugin Author</replaceable>" -p <replaceable>PluginNameWithoutSpaces</replaceable> -i <replaceable>Comma,Separated,List,Of,Base,Interfaces</replaceable></command></screen>
		<para>При запуске с опцией <option>-h</option> будет выдана краткая справка.</para>
		<para>Итак, создаём директорию <filename>/src/plugins/auscrie</filename>, переходим в неё и запускаем скрипт (заметьте, что в вашем случае путь к genplugin.py может быть другим):</para>
		<screen><command>../../../tools/scripts/genplugin.py -a "Your Name" -p Auscrie -i IToolBarEmbedder</command></screen>
		<para>Наследование от <interfacename>IToolBarEmbedder</interfacename> (<filename>/src/interfaces/itoolbarembedder.h</filename>) необходимо для того, чтобы поместить кнопку на панель инструментов.</para>
		<para>Этот скрипт сгенерирует базовые файлы, но их будет достаточно для минимального работающего (точнее, загружающегося) плагина. Попробуем-ка собрать и запустить его! Для этого создадим директорию для сборки, запустим в ней <command>cmake</command>, потом <command>make</command>, чтобы собрать плагин, а затем <command>make install</command> от root, чтобы установить его. Из директории с исходниками выполните:</para>
		<screen>
		<command>mkdir build</command>
		<command>cd build</command>
		<command>cmake ../</command>
		<command>make</command>
		<command>sudo make install</command>
		</screen>
		<para>Здесь использована сборка вне дерева исходников. Вообще это предпочтительный способ, т.к. можно легко очистить дерево исходников, просто удалив директорию сборки, или содержать несколько сборок с разными конфигурациями.</para>
		<para>Теперь запустим LeechCraft, откроем диалог Настройки и выберем вкладку Плагины. В списке должен присутствовать наш плагин. Если это не так, проверьте логи (<filename>~/.leechcraft/warning.log</filename>) и свяжитесь с нами.</para>
	</sect1>
	<sect1 id="basic_stuff">
		<title>Базовые вещи</title>
		<para>Итак, у нас уже есть базовый плагин. Заполним-ка пробелы.</para>
		<para>Во-первых, нужно вписать в <function>GetInfo</function> какое-то описание типа "Простой плагин для снятия скриншотов".</para>
		<para>Теперь нужно создать объект QAction, который будет снимать скриншот. Для начала объявим некоторые внутренние переменные и методы:
			<itemizedlist>
				<listitem><varname>Proxy_</varname> типа <classname>ICoreProxy_ptr</classname>, которая будет содержать указатель на прокси-объект ядра, передаваемый функции <function>Init</function>. Он нужен нам, т.к. через этот объект осуществляется всё взаимодействие с ядром;</listitem>
				<listitem><classname>QAction</classname> *<varname>ShotAction_</varname>, который будет инициировать снятие скриншота;</listitem>
				<listitem>слот <function>makeScreenshot</function>, который будет запускаться по событию.</listitem>
			</itemizedlist>
		</para>
		<para>Эту инициализацию лучше производить в функции Init, так что давайте допишем туда вот такой код для нашего экшена:</para>
		<programlisting language="c++">
<![CDATA[
Proxy_ = proxy;

Dialog_ = new ShooterDialog (Proxy_->GetMainWindow ());

ShotAction_ = new QAction (Proxy_->GetIcon ("screenshot"),
        tr ("Make a screenshot"),
        this);
connect (ShotAction_,
        SIGNAL (triggered ()),
        this,
        SLOT (makeScreenshot ()));
]]>
		</programlisting>
		<para><classname>ICoreProxy_ptr</classname> используется для получения правильной иконки из текущей темы.Когда вы будете разрабатывать свои собственные плагины, вам придётся таскать иконки с собой, пока не попадёте в официальный репозиторий. Прокси также используется для получения указателя на главное окно. О <classname>ShooterDialog</classname> мы поговорим позже.</para>
		<para>Теперь давайте заполним заглушку <function>GetActions</function>, чтобы она возвращала <varname>ShotAction_</varname>. <function>GetActions</function> будет выглядеть примерно так:</para>
		<programlisting language="c++">
<![CDATA[
QList<QAction*> Plugin::GetActions () const
{
    QList<QAction*> result;
    result << ShotAction_;
    return result;
}
]]>
		</programlisting>
		<para>Если сейчас скомпилировать и установить плагин, мы увидим иконку скриншоттера на панели инструментов, но она пока что ничего не делает.</para>
	</sect1>
	<sect1 id="initiating_screenshooting">
		<title>Инициация получения скриншота</tite>
		<para>В слоте мы запустим простой диалог, запрашивающий опции скриншота. Когда пользователь нажимает ОК, мы отключаем экшн (мы включим его, когда скриншот будет готов) и стартуем таймер в соответствии с таймаутом, заданным пользователем в диалоге:</para>
		<programlisting language="c++">
<![CDATA[
void Plugin::makeScreenshot ()
{
    if (Dialog_->exec () != QDialog::Accepted)
        return;

ShotAction_->setEnabled (false);
    QTimer::singleShot (Dialog_->GetTimeout () * 1000,
            this,
            SLOT (shoot ()));
}
]]>
		</programlisting>
		<para>Мы создали Dialog_ в Init() для того, чтобы хранить его между вызовами makeScreenshot(). То, что диалог доступен из любой функции, имеет свои преимущества: например, нет никакой нужды в хранении параметров скриншота, вроде формата или качества, так как мы можем запросить их в любой момент</para>
		<para>Написание диалога является довольно простой задачей для любого, кто когда-либо использовал Qt Designer, так что я не стану рассматривать это здесь. Впрочем, стоит рассказать о том, как добавлять формы в проекты, работающие с CMake. Нужно определить переменную, которая будет содержать список форм (в нашем случае это <varname>FORMS</varname>), добавить <filename>.h</filename>- и <filename>.cpp</filename>-файлы в список заголовочных файлов и исходников, вызвать функцию <function>QT4_WRAP_UI</function> для запуска на формах команды <command>uic</command>, а затем добавить результаты в список зависимостей плагина. Таким образом, середина <function>CMakeLists.txt</function> будет выглядеть так:</para>
		<programlisting language="cmake">
<![CDATA[
SET (SRCS
    auscrie.cpp
    shooterdialog.cpp
    )
SET (HEADERS
    auscrie.h
    shooterdialog.h
    )
SET (FORMS
    shooterdialog.ui
    )
QT4_WRAP_CPP (MOC_SRCS ${HEADERS})
QT4_WRAP_UI (UIS_H ${FORMS})

ADD_LIBRARY (leechcraft_auscrie SHARED
    ${COMPILED_TRANSLATIONS}
    ${SRCS}                                                                                                                                                                                                                      
    ${MOC_SRCS}
    ${UIS_H}
    )
]]>
		</programlisting>
	</sect1>
	<sect1 id="shooting_is_fun">
		<title>Скриншоты — это весело.</title>
		<para>Давайте наконец взглянем на слот <function>shoot</function>.</para>
		<para>Для получения доступа к окну мы используем объект <varname>Proxy_</varname>, с помощью которого ранее получали доступ к главному окну. Не забудьте подключить заголовочный файл <classname>QMainWindow</classname>, иначе приведение типов из <classname>QMainWindow</classname>* в <classname>QWidget</classname>* не сработает.</para>
		<programlisting language="c++">
<![CDATA[
void Plugin::shoot ()
{
    ShotAction_->setEnabled (true);

QWidget *mw = Proxy_->GetMainWindow ();
    QPixmap pm = QPixmap::grabWidget (mw);

const char *fmt = qPrintable (Dialog_->GetFormat ());
    int quality = Dialog_->GetQuality ();
]]>
		</programlisting>
		<para>После этого у нас есть два варианта: либо сохранить файл на диск, либо отправить его на pastebin. Первый немного проще:</para>
		<programlisting language="c++">
<![CDATA[
    switch (Dialog_->GetAction ())
    {
        case ShooterDialog::ASave:
        {
            QString path = Proxy_->GetSettingsManager ()->
                    Property ("PluginsStorage/Auscrie/SavePath",
                            QDir::currentPath () + "01." + Dialog_->GetFormat ())
                    .toString ();

QString filename = QFileDialog::getSaveFileName (mw,
                    tr ("Save as"),
                    path,
                    tr ("%1 files (*.%1);;All files (*.*)")
                        .arg (Dialog_->GetFormat ()));

if (!filename.isEmpty ())
            {
                pm.save (filename, fmt, quality);
                Proxy_->GetSettingsManager ()->
                setProperty ("PluginsStorage/Auscrie/SavePath",
                        filename);
            }
        }
        break;
]]>
		</programlisting>
		<para>Здесь использован менеджер настроек из ядра, который, вобщем-то, является обёрткой вокруг <classname>QSettings</classname>. Клавиши, начинающиеся с <emphasis>PluginsStorage</emphasis>, могут быть использованы плагинами, ядро не будет использовать их в своих собственных задачах. Использование менеджера настороек ядра нормально для хранения пары настроек, но если вам нужно больше, особенно если вам нужен отдельный диалог, лучше добавить его в ваш плагин.</para>
		<para>Если пользовать выбрал загрузку изображения на imagebin, следует вызвать отдельную функцию, Post(), которая обо всём позаботится:</para>
		<programlisting language="c++">
<![CDATA[
        case ShooterDialog::AUpload:
        {
            QBuffer buf;
            pm.save (&buf,
                    fmt,
                    quality);
            Post (buf.data ());
        }
		break;
    }
}
]]>
		</programlisting>
		<para>Теперь нам также следует добавить в <filename>CMakeLists.txt</filename> следующие строки (прямо перед <code>INCLUDE (${QT_USE_FILE})</code>):</para>
		<programlisting language="cmake">
<![CDATA[
SET (QT_USE_QTNETWORK TRUE)
]]>
		</programlisting>
		<para>Это даст нашему плагину возможность работать с сетью, делая видимыми включения из модуля QtNetwork и линкуя плагин с библиотекой QtNetwork. Нам она определённо понадобится, т.к. плагин использует QtNetwork (например, <classname>QNetworkAccessManager</classname> и <classname>QNetworkReply</classname>) для постинга скриншотов.</para>
		<para>Так как сейчас нас не интересует имплементация загрузки скриншота на imagebin, мы перенесём этот код в отдельный класс <classname>Poster</classname>, и наша функция <function>Post</function> будет выглядеть очень просто:</para>
		<programlisting language="c++">
<![CDATA[
void Plugin::Post (const QByteArray& data)
{
    Poster *p = new Poster (data,
            Dialog_->GetFormat (),
            Proxy_->GetNetworkAccessManager ());
    connect (p,
            SIGNAL (finished (QNetworkReply*)),
            this,
            SLOT (handleFinished (QNetworkReply*)));
    connect (p,
            SIGNAL (error (QNetworkReply*)),
            this,
            SLOT (handleError (QNetworkReply*)));
}
]]>
		</programlisting>
		<para>Здесь мы ещё раз использовали <varname>Proxy_</varname>, на этот раз — для получения общего для всего приложения экземпляра <classname>QNetworkAccessManager</classname> с методом <function>GetNetworkAccessManager</function>. Использовать общий экземпляр <classname>QNetworkAccessManager</classname> всегда лучше, так как это позволяет получать доступ к общему кэшу и базе cookie, а также предоставляет возможность оптимизировать запросы путём повтороного использования соединений, например.</para>
		<para>Следует также отметить, что в случае, когда вам нужно просто скачать файл (в данном плагине это не нужно, но это довольно часто возникающая задача), достаточно просто сгенерировать соответствующий сигнал, не заботясь о доступе к сети, менеджерах, ответах и прочем. Этот подход детально обсуждается в документе Обзор.</para>
		<para>Считается нормальным создание <classname>Poster</classname> в куче, не заботясь об освобождении памяти. Она будет освобождена соответствующими слотами.</para>
		<para>Мы подключаемся к сигналам класса <classname>Poster</classname> — 
			<funcsynopsis>
				<funcprototype>
					<funcdef><function>finished</function></funcdef>
					<paramdef>QNetworkReply *<parameter>reply</parameter></paramdef>
				</funcprototype>
			</funcsynopsis>
			и
			<funcsynopsis>
				<funcprototype>
					<funcdef><function>error</function></funcdef>
					<paramdef>QNetworkReply *<parameter>reply</parameter></paramdef>
				</funcprototype>
			</funcsynopsis>
			— для того, чтобы получать извещения о том, что загрузка завершилась (а также чтобы узнать о возможных ошибках). <classname>Poster</classname> генерирует сигнал с параметром — <classname>QNetworkReply</classname>, который изначально излучил соответствующий сигнал.</para>
		<para>Взглянем на 
			<funcsynopsis>
				<funcprototype>
					<funcdef><function>handleFinished</function></funcdef>
					<paramdef>QNetworkReply *<parameter>reply</parameter></paramdef>
				</funcprototype>
			</funcsynopsis>
			(кстати, не забудьте объявить все представленные члены в определении класса):</para>
		<programlisting language="c++">
<![CDATA[
void Plugin::handleFinished (QNetworkReply *reply)
{
    sender ()->deleteLater ();

QString result = reply->readAll ();

QRegExp re ("<p>You can find this at <a href='([^<]+)'>([^<]+)</a></p>");
    if (!re.exactMatch (result))
    {
        Entity e = Util::MakeNotification ("Auscrie",
                tr ("Page parse failed"),
                PWarning_);
        emit gotEntity (e);
        return;
    }

QString pasteUrl = re.cap (1);

Entity e = Util::MakeNotification ("Auscrie",
            tr ("Image pasted: %1, the URL was copied to the clipboard")
                .arg (pasteUrl),
            PInfo_);

QApplication::clipboard ()->setText (pasteUrl, QClipboard::Clipboard);
    QApplication::clipboard ()->setText (pasteUrl, QClipboard::Selection);
    
    emit gotEntity (e);
}
]]>
		</programlisting>
		<para>В первую очередь мы указываем посылающему объекту (экземпляру <classname>Poster</classname>, созданному ранее) удалить себя, как только управление будет возвращено циклу обработки событий. Мы не можем просто написать что-то вроде <code>delete sender ();</code>, потому что объекты не могут быть удалены из их же обработчиков сигналов.</para>
		<para>После этого мы с помощью <function>readAll</function> получаем страницу, которую вернул сервер, и пытаемся извлечь ссылку на наше свежезагруженное изображение с помощью довольно простого регулярного выражения. Если сделать это не удаётся, мы генерируем уведомление об ошибке с приоритетом Warning и прерываем обработку. Заметьте также, что в сигналах классов и слотов, использующих структуры данных LeechCraft, вы должны использовать полностью определённые имена со всеми пространствами имён, например
			<funcsynopsis>
				<funcprototype>
					<funcdef>void <function>gotEntity</function></funcdef>
					<paramdef>const LeechCraft::Entity&amp; <parameter>entity</parameter></paramdef>
				</funcprototype>
			</funcsynopsis>
			В противном случае система метаобъектов Qt не распознает их.</para>
		<para>Здесь также используется система сообщений LeechCraft. С её помощью можно отправлять пользователю оповещения о событиях, происходящих в плагине, вроде ошибок или всяких информационных сообщений. Для создания оповещения используется функция <function>LeechCraft::Util::MakeNotification</function>, которая может быть добавлена с помощью <code><![CDATA[#include <plugininterface/util.h>]]></code>. Эта функция принимает три параметра: заголовок, тело и приоритет оповещения. Более детально оповещения и сообщения LeechCraft обсуждаются в документе Обзор.</para>
	</sect1>
	<sect1 id="conclusion">
		<title>Заключение</title>
		<para>Вобщем-то, это всё. Теперь у нас есть работающий, полезный плагин. Конечно же, есть вещи, которые стоило бы добавить: например, можно было бы хранить историю всех запощенных скриншотов или показывать красивенький прогрессбар, демонстрирующий загрузку изображения. Также вам наверняка захочется добавить поддержку локализаций, но нашей целью здесь было привыкнуть к концепции плагинов LeechCraft.</para>
	</sect1>
</book>

--------------------------------------
Colored with http://dumpz.org

Light HTML Copy To Clipboarddone!

That method generates HTML with CSS classes. Hence you'll need the style sheet file

<div class="highlight"><pre><div id="lc1">&lt;?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot;?&gt;
</div><div id="lc2">&lt;book id=&quot;writing_simple_plugin_in_20_minutes&quot; xmlns=&quot;http://docbook.org/ns/docbook&quot; version=&quot;5.0&quot; xml:lang=&quot;en&quot;&gt;
</div><div id="lc3">	&lt;bookinfo&gt;
</div><div id="lc4">		&lt;title&gt;Пишем простой плагин за 20 минут&lt;/title&gt;
</div><div id="lc5">	&lt;/bookinfo&gt;
</div><div id="lc6">	&lt;sect1 id=&quot;intro&quot;&gt;
</div><div id="lc7">		&lt;title&gt;Введение&lt;/title&gt;
</div><div id="lc8">		&lt;para&gt;Из этого руководства вы узнаете, как написать простенький плагин (назовём его Auscrie — от &quot;Auto Screenshoter&quot;) для LeechCraft, проилюстрировав, таким образом, базовые концепции написания плагинов. Наш плагин сможет снимать скриншот окна LeechCraft и либо сохранять его на диск, либо постить на imagebin. Процесс будет осуществляться с помощью кнопки на панели инструментов.&lt;/para&gt;
</div><div id="lc9">		&lt;para&gt;Вы узнаете:
</div><div id="lc10">			&lt;itemizedlist&gt;
</div><div id="lc11">				&lt;listitem&gt;как создавать &quot;пустые&quot; плагины и собирать их;&lt;/listitem&gt;
</div><div id="lc12">				&lt;listitem&gt;как добавлять интерфейс пользователя, созданный с помощью Qt Designer;&lt;/listitem&gt;
</div><div id="lc13">				&lt;listitem&gt;о предпочтительных путях взаимодействия с сетью и HTTP в LeechCraft;&lt;/listitem&gt;
</div><div id="lc14">				&lt;listitem&gt;как использовать сообщения LeechCraft для оповещения пользователя о событиях, произошедших в вашем плагине.&lt;/listitem&gt;
</div><div id="lc15">			&lt;/itemizedlist&gt;
</div><div id="lc16">		&lt;/para&gt;
</div><div id="lc17">	&lt;/sect1&gt;
</div><div id="lc18">	&lt;sect1 id=&quot;understanding_plugins&quot;&gt;
</div><div id="lc19">		&lt;title&gt;Understanding plugins&lt;/title&gt;
</div><div id="lc20">		&lt;para&gt;Плагины, написанные на C++, являются всего лишь динамическими библиотеками, из которых экспортируется главный экземпляр плагина. Экспорт осуществляется с помощью Q_EXPORT_PLUGIN2. Плагин должен содержать реализацию интерфейса IInfo (для чего используется заголовочный файл &lt;filename&gt;/src/interfaces/iinfo.h&lt;/filename&gt; в корне репозитория), чтобы распознаваться как плагин для LeechCraft.&lt;/para&gt;
</div><div id="lc21">		&lt;para&gt;Чтобы узнать больше о написании плагинов для приложений на C++/Qt, обратитесь к руководству &quot;Как создавать плагины Qt&quot;.&lt;/para&gt;
</div><div id="lc22">		&lt;para&gt;Также можете обратиться к общему обзору LeechCraft, чтобы узнать больше о его архитектуре и плагинах.&lt;/para&gt;
</div><div id="lc23">	&lt;/sect1&gt;
</div><div id="lc24">	&lt;sect1 id=&quot;paths&quot;&gt;
</div><div id="lc25">		&lt;title&gt;Пути&lt;/title&gt;
</div><div id="lc26">		&lt;para&gt;Для удобства, будем работать прямо в директории с исходниками, &lt;filename&gt;/src/plugins/auscrie&lt;/filename&gt;. Обычно плагины разрабатываются отдельно от дерева сорцов (обратитесь к документации о трудовом процессе, чтобы узнать больше), но единственным отличием является то, что вам придётся соответствующим образом поменять пути. Например, при запуске CMake нужно будет убедиться, что &lt;parameter&gt;CMAKE_MODULE_PATH&lt;/parameter&gt; указывает на директорию, содержащую &lt;filename&gt;FindLeechCraft.cmake&lt;/filename&gt;. Переменные CMake устанавливаются с помощью опции командной строки &lt;option&gt;-D&lt;/option&gt;, например:&lt;screen&gt;&lt;command&gt;cmake -DCMAKE_MODULE_PATH=&lt;replaceable&gt;/some/path/to/LeechCraft/SDK&lt;/replaceable&gt;&lt;/command&gt;&lt;/screen&gt;&lt;/para&gt;
</div><div id="lc27">		&lt;para&gt;Это руководство ориентировано на *NIX. За деталями касательно сборки под Windows обратитесь к соответствующему руководству.&lt;/para&gt;
</div><div id="lc28">	&lt;/sect1&gt;
</div><div id="lc29">	&lt;sect1 id=&quot;general_skeleton&quot;&gt;
</div><div id="lc30">		&lt;title&gt;Каркас&lt;/title&gt;
</div><div id="lc31">		&lt;para&gt;В репозитории LeechCraft есть удобный Python-скрипт, &lt;filename&gt;/tools/scripts/genplugin.py&lt;/filename&gt;, генерирующий базовый &lt;filename&gt;CMakeLists.txt&lt;/filename&gt; и файлы с объявлениями/определениями экземпляра плагина. Запускается он следующим образом:&lt;/para&gt;
</div><div id="lc32">		&lt;screen&gt;&lt;command&gt;genplugin.py -a &quot;&lt;replaceable&gt;Plugin Author&lt;/replaceable&gt;&quot; -p &lt;replaceable&gt;PluginNameWithoutSpaces&lt;/replaceable&gt; -i &lt;replaceable&gt;Comma,Separated,List,Of,Base,Interfaces&lt;/replaceable&gt;&lt;/command&gt;&lt;/screen&gt;
</div><div id="lc33">		&lt;para&gt;При запуске с опцией &lt;option&gt;-h&lt;/option&gt; будет выдана краткая справка.&lt;/para&gt;
</div><div id="lc34">		&lt;para&gt;Итак, создаём директорию &lt;filename&gt;/src/plugins/auscrie&lt;/filename&gt;, переходим в неё и запускаем скрипт (заметьте, что в вашем случае путь к genplugin.py может быть другим):&lt;/para&gt;
</div><div id="lc35">		&lt;screen&gt;&lt;command&gt;../../../tools/scripts/genplugin.py -a &quot;Your Name&quot; -p Auscrie -i IToolBarEmbedder&lt;/command&gt;&lt;/screen&gt;
</div><div id="lc36">		&lt;para&gt;Наследование от &lt;interfacename&gt;IToolBarEmbedder&lt;/interfacename&gt; (&lt;filename&gt;/src/interfaces/itoolbarembedder.h&lt;/filename&gt;) необходимо для того, чтобы поместить кнопку на панель инструментов.&lt;/para&gt;
</div><div id="lc37">		&lt;para&gt;Этот скрипт сгенерирует базовые файлы, но их будет достаточно для минимального работающего (точнее, загружающегося) плагина. Попробуем-ка собрать и запустить его! Для этого создадим директорию для сборки, запустим в ней &lt;command&gt;cmake&lt;/command&gt;, потом &lt;command&gt;make&lt;/command&gt;, чтобы собрать плагин, а затем &lt;command&gt;make install&lt;/command&gt; от root, чтобы установить его. Из директории с исходниками выполните:&lt;/para&gt;
</div><div id="lc38">		&lt;screen&gt;
</div><div id="lc39">		&lt;command&gt;mkdir build&lt;/command&gt;
</div><div id="lc40">		&lt;command&gt;cd build&lt;/command&gt;
</div><div id="lc41">		&lt;command&gt;cmake ../&lt;/command&gt;
</div><div id="lc42">		&lt;command&gt;make&lt;/command&gt;
</div><div id="lc43">		&lt;command&gt;sudo make install&lt;/command&gt;
</div><div id="lc44">		&lt;/screen&gt;
</div><div id="lc45">		&lt;para&gt;Здесь использована сборка вне дерева исходников. Вообще это предпочтительный способ, т.к. можно легко очистить дерево исходников, просто удалив директорию сборки, или содержать несколько сборок с разными конфигурациями.&lt;/para&gt;
</div><div id="lc46">		&lt;para&gt;Теперь запустим LeechCraft, откроем диалог Настройки и выберем вкладку Плагины. В списке должен присутствовать наш плагин. Если это не так, проверьте логи (&lt;filename&gt;~/.leechcraft/warning.log&lt;/filename&gt;) и свяжитесь с нами.&lt;/para&gt;
</div><div id="lc47">	&lt;/sect1&gt;
</div><div id="lc48">	&lt;sect1 id=&quot;basic_stuff&quot;&gt;
</div><div id="lc49">		&lt;title&gt;Базовые вещи&lt;/title&gt;
</div><div id="lc50">		&lt;para&gt;Итак, у нас уже есть базовый плагин. Заполним-ка пробелы.&lt;/para&gt;
</div><div id="lc51">		&lt;para&gt;Во-первых, нужно вписать в &lt;function&gt;GetInfo&lt;/function&gt; какое-то описание типа &quot;Простой плагин для снятия скриншотов&quot;.&lt;/para&gt;
</div><div id="lc52">		&lt;para&gt;Теперь нужно создать объект QAction, который будет снимать скриншот. Для начала объявим некоторые внутренние переменные и методы:
</div><div id="lc53">			&lt;itemizedlist&gt;
</div><div id="lc54">				&lt;listitem&gt;&lt;varname&gt;Proxy_&lt;/varname&gt; типа &lt;classname&gt;ICoreProxy_ptr&lt;/classname&gt;, которая будет содержать указатель на прокси-объект ядра, передаваемый функции &lt;function&gt;Init&lt;/function&gt;. Он нужен нам, т.к. через этот объект осуществляется всё взаимодействие с ядром;&lt;/listitem&gt;
</div><div id="lc55">				&lt;listitem&gt;&lt;classname&gt;QAction&lt;/classname&gt; *&lt;varname&gt;ShotAction_&lt;/varname&gt;, который будет инициировать снятие скриншота;&lt;/listitem&gt;
</div><div id="lc56">				&lt;listitem&gt;слот &lt;function&gt;makeScreenshot&lt;/function&gt;, который будет запускаться по событию.&lt;/listitem&gt;
</div><div id="lc57">			&lt;/itemizedlist&gt;
</div><div id="lc58">		&lt;/para&gt;
</div><div id="lc59">		&lt;para&gt;Эту инициализацию лучше производить в функции Init, так что давайте допишем туда вот такой код для нашего экшена:&lt;/para&gt;
</div><div id="lc60">		&lt;programlisting language=&quot;c++&quot;&gt;
</div><div id="lc61">&lt;![CDATA[
</div><div id="lc62">Proxy_ = proxy;
</div><div id="lc63">
</div><div id="lc64">Dialog_ = new ShooterDialog (Proxy_-&gt;GetMainWindow ());
</div><div id="lc65">
</div><div id="lc66">ShotAction_ = new QAction (Proxy_-&gt;GetIcon (&quot;screenshot&quot;),
</div><div id="lc67">        tr (&quot;Make a screenshot&quot;),
</div><div id="lc68">        this);
</div><div id="lc69">connect (ShotAction_,
</div><div id="lc70">        SIGNAL (triggered ()),
</div><div id="lc71">        this,
</div><div id="lc72">        SLOT (makeScreenshot ()));
</div><div id="lc73">]]&gt;
</div><div id="lc74">		&lt;/programlisting&gt;
</div><div id="lc75">		&lt;para&gt;&lt;classname&gt;ICoreProxy_ptr&lt;/classname&gt; используется для получения правильной иконки из текущей темы.Когда вы будете разрабатывать свои собственные плагины, вам придётся таскать иконки с собой, пока не попадёте в официальный репозиторий. Прокси также используется для получения указателя на главное окно. О &lt;classname&gt;ShooterDialog&lt;/classname&gt; мы поговорим позже.&lt;/para&gt;
</div><div id="lc76">		&lt;para&gt;Теперь давайте заполним заглушку &lt;function&gt;GetActions&lt;/function&gt;, чтобы она возвращала &lt;varname&gt;ShotAction_&lt;/varname&gt;. &lt;function&gt;GetActions&lt;/function&gt; будет выглядеть примерно так:&lt;/para&gt;
</div><div id="lc77">		&lt;programlisting language=&quot;c++&quot;&gt;
</div><div id="lc78">&lt;![CDATA[
</div><div id="lc79">QList&lt;QAction*&gt; Plugin::GetActions () const
</div><div id="lc80">{
</div><div id="lc81">    QList&lt;QAction*&gt; result;
</div><div id="lc82">    result &lt;&lt; ShotAction_;
</div><div id="lc83">    return result;
</div><div id="lc84">}
</div><div id="lc85">]]&gt;
</div><div id="lc86">		&lt;/programlisting&gt;
</div><div id="lc87">		&lt;para&gt;Если сейчас скомпилировать и установить плагин, мы увидим иконку скриншоттера на панели инструментов, но она пока что ничего не делает.&lt;/para&gt;
</div><div id="lc88">	&lt;/sect1&gt;
</div><div id="lc89">	&lt;sect1 id=&quot;initiating_screenshooting&quot;&gt;
</div><div id="lc90">		&lt;title&gt;Инициация получения скриншота&lt;/tite&gt;
</div><div id="lc91">		&lt;para&gt;В слоте мы запустим простой диалог, запрашивающий опции скриншота. Когда пользователь нажимает ОК, мы отключаем экшн (мы включим его, когда скриншот будет готов) и стартуем таймер в соответствии с таймаутом, заданным пользователем в диалоге:&lt;/para&gt;
</div><div id="lc92">		&lt;programlisting language=&quot;c++&quot;&gt;
</div><div id="lc93">&lt;![CDATA[
</div><div id="lc94">void Plugin::makeScreenshot ()
</div><div id="lc95">{
</div><div id="lc96">    if (Dialog_-&gt;exec () != QDialog::Accepted)
</div><div id="lc97">        return;
</div><div id="lc98">
</div><div id="lc99">    ShotAction_-&gt;setEnabled (false);
</div><div id="lc100">    QTimer::singleShot (Dialog_-&gt;GetTimeout () * 1000,
</div><div id="lc101">            this,
</div><div id="lc102">            SLOT (shoot ()));
</div><div id="lc103">}
</div><div id="lc104">]]&gt;
</div><div id="lc105">		&lt;/programlisting&gt;
</div><div id="lc106">		&lt;para&gt;Мы создали Dialog_ в Init() для того, чтобы хранить его между вызовами makeScreenshot(). То, что диалог доступен из любой функции, имеет свои преимущества: например, нет никакой нужды в хранении параметров скриншота, вроде формата или качества, так как мы можем запросить их в любой момент&lt;/para&gt;
</div><div id="lc107">		&lt;para&gt;Написание диалога является довольно простой задачей для любого, кто когда-либо использовал Qt Designer, так что я не стану рассматривать это здесь. Впрочем, стоит рассказать о том, как добавлять формы в проекты, работающие с CMake. Нужно определить переменную, которая будет содержать список форм (в нашем случае это &lt;varname&gt;FORMS&lt;/varname&gt;), добавить &lt;filename&gt;.h&lt;/filename&gt;- и &lt;filename&gt;.cpp&lt;/filename&gt;-файлы в список заголовочных файлов и исходников, вызвать функцию &lt;function&gt;QT4_WRAP_UI&lt;/function&gt; для запуска на формах команды &lt;command&gt;uic&lt;/command&gt;, а затем добавить результаты в список зависимостей плагина. Таким образом, середина &lt;function&gt;CMakeLists.txt&lt;/function&gt; будет выглядеть так:&lt;/para&gt;
</div><div id="lc108">		&lt;programlisting language=&quot;cmake&quot;&gt;
</div><div id="lc109">&lt;![CDATA[
</div><div id="lc110">SET (SRCS
</div><div id="lc111">    auscrie.cpp
</div><div id="lc112">    shooterdialog.cpp
</div><div id="lc113">    )
</div><div id="lc114">SET (HEADERS
</div><div id="lc115">    auscrie.h
</div><div id="lc116">    shooterdialog.h
</div><div id="lc117">    )
</div><div id="lc118">SET (FORMS
</div><div id="lc119">    shooterdialog.ui
</div><div id="lc120">    )
</div><div id="lc121">QT4_WRAP_CPP (MOC_SRCS ${HEADERS})
</div><div id="lc122">QT4_WRAP_UI (UIS_H ${FORMS})
</div><div id="lc123">
</div><div id="lc124">ADD_LIBRARY (leechcraft_auscrie SHARED
</div><div id="lc125">    ${COMPILED_TRANSLATIONS}
</div><div id="lc126">    ${SRCS}                                                                                                                                                                                                                      
</div><div id="lc127">    ${MOC_SRCS}
</div><div id="lc128">    ${UIS_H}
</div><div id="lc129">    )
</div><div id="lc130">]]&gt;
</div><div id="lc131">		&lt;/programlisting&gt;
</div><div id="lc132">	&lt;/sect1&gt;
</div><div id="lc133">	&lt;sect1 id=&quot;shooting_is_fun&quot;&gt;
</div><div id="lc134">		&lt;title&gt;Скриншоты — это весело.&lt;/title&gt;
</div><div id="lc135">		&lt;para&gt;Давайте наконец взглянем на слот &lt;function&gt;shoot&lt;/function&gt;.&lt;/para&gt;
</div><div id="lc136">		&lt;para&gt;Для получения доступа к окну мы используем объект &lt;varname&gt;Proxy_&lt;/varname&gt;, с помощью которого ранее получали доступ к главному окну. Не забудьте подключить заголовочный файл &lt;classname&gt;QMainWindow&lt;/classname&gt;, иначе приведение типов из &lt;classname&gt;QMainWindow&lt;/classname&gt;* в &lt;classname&gt;QWidget&lt;/classname&gt;* не сработает.&lt;/para&gt;
</div><div id="lc137">		&lt;programlisting language=&quot;c++&quot;&gt;
</div><div id="lc138">&lt;![CDATA[
</div><div id="lc139">void Plugin::shoot ()
</div><div id="lc140">{
</div><div id="lc141">    ShotAction_-&gt;setEnabled (true);
</div><div id="lc142">
</div><div id="lc143">    QWidget *mw = Proxy_-&gt;GetMainWindow ();
</div><div id="lc144">    QPixmap pm = QPixmap::grabWidget (mw);
</div><div id="lc145">
</div><div id="lc146">    const char *fmt = qPrintable (Dialog_-&gt;GetFormat ());
</div><div id="lc147">    int quality = Dialog_-&gt;GetQuality ();
</div><div id="lc148">]]&gt;
</div><div id="lc149">		&lt;/programlisting&gt;
</div><div id="lc150">		&lt;para&gt;После этого у нас есть два варианта: либо сохранить файл на диск, либо отправить его на pastebin. Первый немного проще:&lt;/para&gt;
</div><div id="lc151">		&lt;programlisting language=&quot;c++&quot;&gt;
</div><div id="lc152">&lt;![CDATA[
</div><div id="lc153">    switch (Dialog_-&gt;GetAction ())
</div><div id="lc154">    {
</div><div id="lc155">        case ShooterDialog::ASave:
</div><div id="lc156">        {
</div><div id="lc157">            QString path = Proxy_-&gt;GetSettingsManager ()-&gt;
</div><div id="lc158">                    Property (&quot;PluginsStorage/Auscrie/SavePath&quot;,
</div><div id="lc159">                            QDir::currentPath () + &quot;01.&quot; + Dialog_-&gt;GetFormat ())
</div><div id="lc160">                    .toString ();
</div><div id="lc161">
</div><div id="lc162">            QString filename = QFileDialog::getSaveFileName (mw,
</div><div id="lc163">                    tr (&quot;Save as&quot;),
</div><div id="lc164">                    path,
</div><div id="lc165">                    tr (&quot;%1 files (*.%1);;All files (*.*)&quot;)
</div><div id="lc166">                        .arg (Dialog_-&gt;GetFormat ()));
</div><div id="lc167">
</div><div id="lc168">            if (!filename.isEmpty ())
</div><div id="lc169">            {
</div><div id="lc170">                pm.save (filename, fmt, quality);
</div><div id="lc171">                Proxy_-&gt;GetSettingsManager ()-&gt;
</div><div id="lc172">                setProperty (&quot;PluginsStorage/Auscrie/SavePath&quot;,
</div><div id="lc173">                        filename);
</div><div id="lc174">            }
</div><div id="lc175">        }
</div><div id="lc176">        break;
</div><div id="lc177">]]&gt;
</div><div id="lc178">		&lt;/programlisting&gt;
</div><div id="lc179">		&lt;para&gt;Здесь использован менеджер настроек из ядра, который, вобщем-то, является обёрткой вокруг &lt;classname&gt;QSettings&lt;/classname&gt;. Клавиши, начинающиеся с &lt;emphasis&gt;PluginsStorage&lt;/emphasis&gt;, могут быть использованы плагинами, ядро не будет использовать их в своих собственных задачах. Использование менеджера настороек ядра нормально для хранения пары настроек, но если вам нужно больше, особенно если вам нужен отдельный диалог, лучше добавить его в ваш плагин.&lt;/para&gt;
</div><div id="lc180">		&lt;para&gt;Если пользовать выбрал загрузку изображения на imagebin, следует вызвать отдельную функцию, Post(), которая обо всём позаботится:&lt;/para&gt;
</div><div id="lc181">		&lt;programlisting language=&quot;c++&quot;&gt;
</div><div id="lc182">&lt;![CDATA[
</div><div id="lc183">        case ShooterDialog::AUpload:
</div><div id="lc184">        {
</div><div id="lc185">            QBuffer buf;
</div><div id="lc186">            pm.save (&amp;buf,
</div><div id="lc187">                    fmt,
</div><div id="lc188">                    quality);
</div><div id="lc189">            Post (buf.data ());
</div><div id="lc190">        }
</div><div id="lc191">		break;
</div><div id="lc192">    }
</div><div id="lc193">}
</div><div id="lc194">]]&gt;
</div><div id="lc195">		&lt;/programlisting&gt;
</div><div id="lc196">		&lt;para&gt;Теперь нам также следует добавить в &lt;filename&gt;CMakeLists.txt&lt;/filename&gt; следующие строки (прямо перед &lt;code&gt;INCLUDE (${QT_USE_FILE})&lt;/code&gt;):&lt;/para&gt;
</div><div id="lc197">		&lt;programlisting language=&quot;cmake&quot;&gt;
</div><div id="lc198">&lt;![CDATA[
</div><div id="lc199">SET (QT_USE_QTNETWORK TRUE)
</div><div id="lc200">]]&gt;
</div><div id="lc201">		&lt;/programlisting&gt;
</div><div id="lc202">		&lt;para&gt;Это даст нашему плагину возможность работать с сетью, делая видимыми включения из модуля QtNetwork и линкуя плагин с библиотекой QtNetwork. Нам она определённо понадобится, т.к. плагин использует QtNetwork (например, &lt;classname&gt;QNetworkAccessManager&lt;/classname&gt; и &lt;classname&gt;QNetworkReply&lt;/classname&gt;) для постинга скриншотов.&lt;/para&gt;
</div><div id="lc203">		&lt;para&gt;Так как сейчас нас не интересует имплементация загрузки скриншота на imagebin, мы перенесём этот код в отдельный класс &lt;classname&gt;Poster&lt;/classname&gt;, и наша функция &lt;function&gt;Post&lt;/function&gt; будет выглядеть очень просто:&lt;/para&gt;
</div><div id="lc204">		&lt;programlisting language=&quot;c++&quot;&gt;
</div><div id="lc205">&lt;![CDATA[
</div><div id="lc206">void Plugin::Post (const QByteArray&amp; data)
</div><div id="lc207">{
</div><div id="lc208">    Poster *p = new Poster (data,
</div><div id="lc209">            Dialog_-&gt;GetFormat (),
</div><div id="lc210">            Proxy_-&gt;GetNetworkAccessManager ());
</div><div id="lc211">    connect (p,
</div><div id="lc212">            SIGNAL (finished (QNetworkReply*)),
</div><div id="lc213">            this,
</div><div id="lc214">            SLOT (handleFinished (QNetworkReply*)));
</div><div id="lc215">    connect (p,
</div><div id="lc216">            SIGNAL (error (QNetworkReply*)),
</div><div id="lc217">            this,
</div><div id="lc218">            SLOT (handleError (QNetworkReply*)));
</div><div id="lc219">}
</div><div id="lc220">]]&gt;
</div><div id="lc221">		&lt;/programlisting&gt;
</div><div id="lc222">		&lt;para&gt;Здесь мы ещё раз использовали &lt;varname&gt;Proxy_&lt;/varname&gt;, на этот раз — для получения общего для всего приложения экземпляра &lt;classname&gt;QNetworkAccessManager&lt;/classname&gt; с методом &lt;function&gt;GetNetworkAccessManager&lt;/function&gt;. Использовать общий экземпляр &lt;classname&gt;QNetworkAccessManager&lt;/classname&gt; всегда лучше, так как это позволяет получать доступ к общему кэшу и базе cookie, а также предоставляет возможность оптимизировать запросы путём повтороного использования соединений, например.&lt;/para&gt;
</div><div id="lc223">		&lt;para&gt;Следует также отметить, что в случае, когда вам нужно просто скачать файл (в данном плагине это не нужно, но это довольно часто возникающая задача), достаточно просто сгенерировать соответствующий сигнал, не заботясь о доступе к сети, менеджерах, ответах и прочем. Этот подход детально обсуждается в документе Обзор.&lt;/para&gt;
</div><div id="lc224">		&lt;para&gt;Считается нормальным создание &lt;classname&gt;Poster&lt;/classname&gt; в куче, не заботясь об освобождении памяти. Она будет освобождена соответствующими слотами.&lt;/para&gt;
</div><div id="lc225">		&lt;para&gt;Мы подключаемся к сигналам класса &lt;classname&gt;Poster&lt;/classname&gt; — 
</div><div id="lc226">			&lt;funcsynopsis&gt;
</div><div id="lc227">				&lt;funcprototype&gt;
</div><div id="lc228">					&lt;funcdef&gt;&lt;function&gt;finished&lt;/function&gt;&lt;/funcdef&gt;
</div><div id="lc229">					&lt;paramdef&gt;QNetworkReply *&lt;parameter&gt;reply&lt;/parameter&gt;&lt;/paramdef&gt;
</div><div id="lc230">				&lt;/funcprototype&gt;
</div><div id="lc231">			&lt;/funcsynopsis&gt;
</div><div id="lc232">			и
</div><div id="lc233">			&lt;funcsynopsis&gt;
</div><div id="lc234">				&lt;funcprototype&gt;
</div><div id="lc235">					&lt;funcdef&gt;&lt;function&gt;error&lt;/function&gt;&lt;/funcdef&gt;
</div><div id="lc236">					&lt;paramdef&gt;QNetworkReply *&lt;parameter&gt;reply&lt;/parameter&gt;&lt;/paramdef&gt;
</div><div id="lc237">				&lt;/funcprototype&gt;
</div><div id="lc238">			&lt;/funcsynopsis&gt;
</div><div id="lc239">			— для того, чтобы получать извещения о том, что загрузка завершилась (а также чтобы узнать о возможных ошибках). &lt;classname&gt;Poster&lt;/classname&gt; генерирует сигнал с параметром — &lt;classname&gt;QNetworkReply&lt;/classname&gt;, который изначально излучил соответствующий сигнал.&lt;/para&gt;
</div><div id="lc240">		&lt;para&gt;Взглянем на 
</div><div id="lc241">			&lt;funcsynopsis&gt;
</div><div id="lc242">				&lt;funcprototype&gt;
</div><div id="lc243">					&lt;funcdef&gt;&lt;function&gt;handleFinished&lt;/function&gt;&lt;/funcdef&gt;
</div><div id="lc244">					&lt;paramdef&gt;QNetworkReply *&lt;parameter&gt;reply&lt;/parameter&gt;&lt;/paramdef&gt;
</div><div id="lc245">				&lt;/funcprototype&gt;
</div><div id="lc246">			&lt;/funcsynopsis&gt;
</div><div id="lc247">			(кстати, не забудьте объявить все представленные члены в определении класса):&lt;/para&gt;
</div><div id="lc248">		&lt;programlisting language=&quot;c++&quot;&gt;
</div><div id="lc249">&lt;![CDATA[
</div><div id="lc250">void Plugin::handleFinished (QNetworkReply *reply)
</div><div id="lc251">{
</div><div id="lc252">    sender ()-&gt;deleteLater ();
</div><div id="lc253">
</div><div id="lc254">    QString result = reply-&gt;readAll ();
</div><div id="lc255">
</div><div id="lc256">    QRegExp re (&quot;&lt;p&gt;You can find this at &lt;a href=&#39;([^&lt;]+)&#39;&gt;([^&lt;]+)&lt;/a&gt;&lt;/p&gt;&quot;);
</div><div id="lc257">    if (!re.exactMatch (result))
</div><div id="lc258">    {
</div><div id="lc259">        Entity e = Util::MakeNotification (&quot;Auscrie&quot;,
</div><div id="lc260">                tr (&quot;Page parse failed&quot;),
</div><div id="lc261">                PWarning_);
</div><div id="lc262">        emit gotEntity (e);
</div><div id="lc263">        return;
</div><div id="lc264">    }
</div><div id="lc265">
</div><div id="lc266">    QString pasteUrl = re.cap (1);
</div><div id="lc267">
</div><div id="lc268">    Entity e = Util::MakeNotification (&quot;Auscrie&quot;,
</div><div id="lc269">            tr (&quot;Image pasted: %1, the URL was copied to the clipboard&quot;)
</div><div id="lc270">                .arg (pasteUrl),
</div><div id="lc271">            PInfo_);
</div><div id="lc272">
</div><div id="lc273">    QApplication::clipboard ()-&gt;setText (pasteUrl, QClipboard::Clipboard);
</div><div id="lc274">    QApplication::clipboard ()-&gt;setText (pasteUrl, QClipboard::Selection);
</div><div id="lc275">    
</div><div id="lc276">    emit gotEntity (e);
</div><div id="lc277">}
</div><div id="lc278">]]&gt;
</div><div id="lc279">		&lt;/programlisting&gt;
</div><div id="lc280">		&lt;para&gt;В первую очередь мы указываем посылающему объекту (экземпляру &lt;classname&gt;Poster&lt;/classname&gt;, созданному ранее) удалить себя, как только управление будет возвращено циклу обработки событий. Мы не можем просто написать что-то вроде &lt;code&gt;delete sender ();&lt;/code&gt;, потому что объекты не могут быть удалены из их же обработчиков сигналов.&lt;/para&gt;
</div><div id="lc281">		&lt;para&gt;После этого мы с помощью &lt;function&gt;readAll&lt;/function&gt; получаем страницу, которую вернул сервер, и пытаемся извлечь ссылку на наше свежезагруженное изображение с помощью довольно простого регулярного выражения. Если сделать это не удаётся, мы генерируем уведомление об ошибке с приоритетом Warning и прерываем обработку. Заметьте также, что в сигналах классов и слотов, использующих структуры данных LeechCraft, вы должны использовать полностью определённые имена со всеми пространствами имён, например
</div><div id="lc282">			&lt;funcsynopsis&gt;
</div><div id="lc283">				&lt;funcprototype&gt;
</div><div id="lc284">					&lt;funcdef&gt;void &lt;function&gt;gotEntity&lt;/function&gt;&lt;/funcdef&gt;
</div><div id="lc285">					&lt;paramdef&gt;const LeechCraft::Entity&amp;amp; &lt;parameter&gt;entity&lt;/parameter&gt;&lt;/paramdef&gt;
</div><div id="lc286">				&lt;/funcprototype&gt;
</div><div id="lc287">			&lt;/funcsynopsis&gt;
</div><div id="lc288">			В противном случае система метаобъектов Qt не распознает их.&lt;/para&gt;
</div><div id="lc289">		&lt;para&gt;Здесь также используется система сообщений LeechCraft. С её помощью можно отправлять пользователю оповещения о событиях, происходящих в плагине, вроде ошибок или всяких информационных сообщений. Для создания оповещения используется функция &lt;function&gt;LeechCraft::Util::MakeNotification&lt;/function&gt;, которая может быть добавлена с помощью &lt;code&gt;&lt;![CDATA[#include &lt;plugininterface/util.h&gt;]]&gt;&lt;/code&gt;. Эта функция принимает три параметра: заголовок, тело и приоритет оповещения. Более детально оповещения и сообщения LeechCraft обсуждаются в документе Обзор.&lt;/para&gt;
</div><div id="lc290">	&lt;/sect1&gt;
</div><div id="lc291">	&lt;sect1 id=&quot;conclusion&quot;&gt;
</div><div id="lc292">		&lt;title&gt;Заключение&lt;/title&gt;
</div><div id="lc293">		&lt;para&gt;Вобщем-то, это всё. Теперь у нас есть работающий, полезный плагин. Конечно же, есть вещи, которые стоило бы добавить: например, можно было бы хранить историю всех запощенных скриншотов или показывать красивенький прогрессбар, демонстрирующий загрузку изображения. Также вам наверняка захочется добавить поддержку локализаций, но нашей целью здесь было привыкнуть к концепции плагинов LeechCraft.&lt;/para&gt;
</div><div id="lc294">	&lt;/sect1&gt;
</div><div id="lc295">&lt;/book&gt;
</div></pre></div>
<p style="padding: 0; margin: 2em 0 1em 0; font-size: 0.8em; color: #666;"><span style="padding: 0 1em; background-color: #f5f5f5;"> Colored with <a style="color: #333" href="http://dumpz.org">dumpz.org</a></span></p>

Habrahabr.ru HTML Copy To Clipboarddone!

Use that HTML for publications on habrahabr.ru

<blockquote><code>&lt;?xml&nbsp;version=&quot;1.0&quot;&nbsp;encoding=&quot;utf-8&quot;?&gt;
&lt;book&nbsp;id=&quot;writing_simple_plugin_in_20_minutes&quot;&nbsp;xmlns=&quot;http://docbook.org/ns/docbook&quot;&nbsp;version=&quot;5.0&quot;&nbsp;xml:lang=&quot;en&quot;&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&lt;bookinfo&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;title&gt;Пишем&nbsp;простой&nbsp;плагин&nbsp;за&nbsp;20&nbsp;минут&lt;/title&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&lt;/bookinfo&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&lt;sect1&nbsp;id=&quot;intro&quot;&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;title&gt;Введение&lt;/title&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;Из&nbsp;этого&nbsp;руководства&nbsp;вы&nbsp;узнаете,&nbsp;как&nbsp;написать&nbsp;простенький&nbsp;плагин&nbsp;(назовём&nbsp;его&nbsp;Auscrie&nbsp;—&nbsp;от&nbsp;&quot;Auto&nbsp;Screenshoter&quot;)&nbsp;для&nbsp;LeechCraft,&nbsp;проилюстрировав,&nbsp;таким&nbsp;образом,&nbsp;базовые&nbsp;концепции&nbsp;написания&nbsp;плагинов.&nbsp;Наш&nbsp;плагин&nbsp;сможет&nbsp;снимать&nbsp;скриншот&nbsp;окна&nbsp;LeechCraft&nbsp;и&nbsp;либо&nbsp;сохранять&nbsp;его&nbsp;на&nbsp;диск,&nbsp;либо&nbsp;постить&nbsp;на&nbsp;imagebin.&nbsp;Процесс&nbsp;будет&nbsp;осуществляться&nbsp;с&nbsp;помощью&nbsp;кнопки&nbsp;на&nbsp;панели&nbsp;инструментов.&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;Вы&nbsp;узнаете:
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;itemizedlist&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;listitem&gt;как&nbsp;создавать&nbsp;&quot;пустые&quot;&nbsp;плагины&nbsp;и&nbsp;собирать&nbsp;их;&lt;/listitem&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;listitem&gt;как&nbsp;добавлять&nbsp;интерфейс&nbsp;пользователя,&nbsp;созданный&nbsp;с&nbsp;помощью&nbsp;Qt&nbsp;Designer;&lt;/listitem&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;listitem&gt;о&nbsp;предпочтительных&nbsp;путях&nbsp;взаимодействия&nbsp;с&nbsp;сетью&nbsp;и&nbsp;HTTP&nbsp;в&nbsp;LeechCraft;&lt;/listitem&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;listitem&gt;как&nbsp;использовать&nbsp;сообщения&nbsp;LeechCraft&nbsp;для&nbsp;оповещения&nbsp;пользователя&nbsp;о&nbsp;событиях,&nbsp;произошедших&nbsp;в&nbsp;вашем&nbsp;плагине.&lt;/listitem&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;/itemizedlist&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&lt;/sect1&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&lt;sect1&nbsp;id=&quot;understanding_plugins&quot;&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;title&gt;Understanding&nbsp;plugins&lt;/title&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;Плагины,&nbsp;написанные&nbsp;на&nbsp;C++,&nbsp;являются&nbsp;всего&nbsp;лишь&nbsp;динамическими&nbsp;библиотеками,&nbsp;из&nbsp;которых&nbsp;экспортируется&nbsp;главный&nbsp;экземпляр&nbsp;плагина.&nbsp;Экспорт&nbsp;осуществляется&nbsp;с&nbsp;помощью&nbsp;Q_EXPORT_PLUGIN2.&nbsp;Плагин&nbsp;должен&nbsp;содержать&nbsp;реализацию&nbsp;интерфейса&nbsp;IInfo&nbsp;(для&nbsp;чего&nbsp;используется&nbsp;заголовочный&nbsp;файл&nbsp;&lt;filename&gt;/src/interfaces/iinfo.h&lt;/filename&gt;&nbsp;в&nbsp;корне&nbsp;репозитория),&nbsp;чтобы&nbsp;распознаваться&nbsp;как&nbsp;плагин&nbsp;для&nbsp;LeechCraft.&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;Чтобы&nbsp;узнать&nbsp;больше&nbsp;о&nbsp;написании&nbsp;плагинов&nbsp;для&nbsp;приложений&nbsp;на&nbsp;C++/Qt,&nbsp;обратитесь&nbsp;к&nbsp;руководству&nbsp;&quot;Как&nbsp;создавать&nbsp;плагины&nbsp;Qt&quot;.&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;Также&nbsp;можете&nbsp;обратиться&nbsp;к&nbsp;общему&nbsp;обзору&nbsp;LeechCraft,&nbsp;чтобы&nbsp;узнать&nbsp;больше&nbsp;о&nbsp;его&nbsp;архитектуре&nbsp;и&nbsp;плагинах.&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&lt;/sect1&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&lt;sect1&nbsp;id=&quot;paths&quot;&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;title&gt;Пути&lt;/title&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;Для&nbsp;удобства,&nbsp;будем&nbsp;работать&nbsp;прямо&nbsp;в&nbsp;директории&nbsp;с&nbsp;исходниками,&nbsp;&lt;filename&gt;/src/plugins/auscrie&lt;/filename&gt;.&nbsp;Обычно&nbsp;плагины&nbsp;разрабатываются&nbsp;отдельно&nbsp;от&nbsp;дерева&nbsp;сорцов&nbsp;(обратитесь&nbsp;к&nbsp;документации&nbsp;о&nbsp;трудовом&nbsp;процессе,&nbsp;чтобы&nbsp;узнать&nbsp;больше),&nbsp;но&nbsp;единственным&nbsp;отличием&nbsp;является&nbsp;то,&nbsp;что&nbsp;вам&nbsp;придётся&nbsp;соответствующим&nbsp;образом&nbsp;поменять&nbsp;пути.&nbsp;Например,&nbsp;при&nbsp;запуске&nbsp;CMake&nbsp;нужно&nbsp;будет&nbsp;убедиться,&nbsp;что&nbsp;&lt;parameter&gt;CMAKE_MODULE_PATH&lt;/parameter&gt;&nbsp;указывает&nbsp;на&nbsp;директорию,&nbsp;содержащую&nbsp;&lt;filename&gt;FindLeechCraft.cmake&lt;/filename&gt;.&nbsp;Переменные&nbsp;CMake&nbsp;устанавливаются&nbsp;с&nbsp;помощью&nbsp;опции&nbsp;командной&nbsp;строки&nbsp;&lt;option&gt;-D&lt;/option&gt;,&nbsp;например:&lt;screen&gt;&lt;command&gt;cmake&nbsp;-DCMAKE_MODULE_PATH=&lt;replaceable&gt;/some/path/to/LeechCraft/SDK&lt;/replaceable&gt;&lt;/command&gt;&lt;/screen&gt;&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;Это&nbsp;руководство&nbsp;ориентировано&nbsp;на&nbsp;*NIX.&nbsp;За&nbsp;деталями&nbsp;касательно&nbsp;сборки&nbsp;под&nbsp;Windows&nbsp;обратитесь&nbsp;к&nbsp;соответствующему&nbsp;руководству.&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&lt;/sect1&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&lt;sect1&nbsp;id=&quot;general_skeleton&quot;&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;title&gt;Каркас&lt;/title&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;В&nbsp;репозитории&nbsp;LeechCraft&nbsp;есть&nbsp;удобный&nbsp;Python-скрипт,&nbsp;&lt;filename&gt;/tools/scripts/genplugin.py&lt;/filename&gt;,&nbsp;генерирующий&nbsp;базовый&nbsp;&lt;filename&gt;CMakeLists.txt&lt;/filename&gt;&nbsp;и&nbsp;файлы&nbsp;с&nbsp;объявлениями/определениями&nbsp;экземпляра&nbsp;плагина.&nbsp;Запускается&nbsp;он&nbsp;следующим&nbsp;образом:&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;screen&gt;&lt;command&gt;genplugin.py&nbsp;-a&nbsp;&quot;&lt;replaceable&gt;Plugin&nbsp;Author&lt;/replaceable&gt;&quot;&nbsp;-p&nbsp;&lt;replaceable&gt;PluginNameWithoutSpaces&lt;/replaceable&gt;&nbsp;-i&nbsp;&lt;replaceable&gt;Comma,Separated,List,Of,Base,Interfaces&lt;/replaceable&gt;&lt;/command&gt;&lt;/screen&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;При&nbsp;запуске&nbsp;с&nbsp;опцией&nbsp;&lt;option&gt;-h&lt;/option&gt;&nbsp;будет&nbsp;выдана&nbsp;краткая&nbsp;справка.&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;Итак,&nbsp;создаём&nbsp;директорию&nbsp;&lt;filename&gt;/src/plugins/auscrie&lt;/filename&gt;,&nbsp;переходим&nbsp;в&nbsp;неё&nbsp;и&nbsp;запускаем&nbsp;скрипт&nbsp;(заметьте,&nbsp;что&nbsp;в&nbsp;вашем&nbsp;случае&nbsp;путь&nbsp;к&nbsp;genplugin.py&nbsp;может&nbsp;быть&nbsp;другим):&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;screen&gt;&lt;command&gt;../../../tools/scripts/genplugin.py&nbsp;-a&nbsp;&quot;Your&nbsp;Name&quot;&nbsp;-p&nbsp;Auscrie&nbsp;-i&nbsp;IToolBarEmbedder&lt;/command&gt;&lt;/screen&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;Наследование&nbsp;от&nbsp;&lt;interfacename&gt;IToolBarEmbedder&lt;/interfacename&gt;&nbsp;(&lt;filename&gt;/src/interfaces/itoolbarembedder.h&lt;/filename&gt;)&nbsp;необходимо&nbsp;для&nbsp;того,&nbsp;чтобы&nbsp;поместить&nbsp;кнопку&nbsp;на&nbsp;панель&nbsp;инструментов.&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;Этот&nbsp;скрипт&nbsp;сгенерирует&nbsp;базовые&nbsp;файлы,&nbsp;но&nbsp;их&nbsp;будет&nbsp;достаточно&nbsp;для&nbsp;минимального&nbsp;работающего&nbsp;(точнее,&nbsp;загружающегося)&nbsp;плагина.&nbsp;Попробуем-ка&nbsp;собрать&nbsp;и&nbsp;запустить&nbsp;его!&nbsp;Для&nbsp;этого&nbsp;создадим&nbsp;директорию&nbsp;для&nbsp;сборки,&nbsp;запустим&nbsp;в&nbsp;ней&nbsp;&lt;command&gt;cmake&lt;/command&gt;,&nbsp;потом&nbsp;&lt;command&gt;make&lt;/command&gt;,&nbsp;чтобы&nbsp;собрать&nbsp;плагин,&nbsp;а&nbsp;затем&nbsp;&lt;command&gt;make&nbsp;install&lt;/command&gt;&nbsp;от&nbsp;root,&nbsp;чтобы&nbsp;установить&nbsp;его.&nbsp;Из&nbsp;директории&nbsp;с&nbsp;исходниками&nbsp;выполните:&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;screen&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;command&gt;mkdir&nbsp;build&lt;/command&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;command&gt;cd&nbsp;build&lt;/command&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;command&gt;cmake&nbsp;../&lt;/command&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;command&gt;make&lt;/command&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;command&gt;sudo&nbsp;make&nbsp;install&lt;/command&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;/screen&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;Здесь&nbsp;использована&nbsp;сборка&nbsp;вне&nbsp;дерева&nbsp;исходников.&nbsp;Вообще&nbsp;это&nbsp;предпочтительный&nbsp;способ,&nbsp;т.к.&nbsp;можно&nbsp;легко&nbsp;очистить&nbsp;дерево&nbsp;исходников,&nbsp;просто&nbsp;удалив&nbsp;директорию&nbsp;сборки,&nbsp;или&nbsp;содержать&nbsp;несколько&nbsp;сборок&nbsp;с&nbsp;разными&nbsp;конфигурациями.&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;Теперь&nbsp;запустим&nbsp;LeechCraft,&nbsp;откроем&nbsp;диалог&nbsp;Настройки&nbsp;и&nbsp;выберем&nbsp;вкладку&nbsp;Плагины.&nbsp;В&nbsp;списке&nbsp;должен&nbsp;присутствовать&nbsp;наш&nbsp;плагин.&nbsp;Если&nbsp;это&nbsp;не&nbsp;так,&nbsp;проверьте&nbsp;логи&nbsp;(&lt;filename&gt;~/.leechcraft/warning.log&lt;/filename&gt;)&nbsp;и&nbsp;свяжитесь&nbsp;с&nbsp;нами.&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&lt;/sect1&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&lt;sect1&nbsp;id=&quot;basic_stuff&quot;&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;title&gt;Базовые&nbsp;вещи&lt;/title&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;Итак,&nbsp;у&nbsp;нас&nbsp;уже&nbsp;есть&nbsp;базовый&nbsp;плагин.&nbsp;Заполним-ка&nbsp;пробелы.&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;Во-первых,&nbsp;нужно&nbsp;вписать&nbsp;в&nbsp;&lt;function&gt;GetInfo&lt;/function&gt;&nbsp;какое-то&nbsp;описание&nbsp;типа&nbsp;&quot;Простой&nbsp;плагин&nbsp;для&nbsp;снятия&nbsp;скриншотов&quot;.&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;Теперь&nbsp;нужно&nbsp;создать&nbsp;объект&nbsp;QAction,&nbsp;который&nbsp;будет&nbsp;снимать&nbsp;скриншот.&nbsp;Для&nbsp;начала&nbsp;объявим&nbsp;некоторые&nbsp;внутренние&nbsp;переменные&nbsp;и&nbsp;методы:
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;itemizedlist&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;listitem&gt;&lt;varname&gt;Proxy_&lt;/varname&gt;&nbsp;типа&nbsp;&lt;classname&gt;ICoreProxy_ptr&lt;/classname&gt;,&nbsp;которая&nbsp;будет&nbsp;содержать&nbsp;указатель&nbsp;на&nbsp;прокси-объект&nbsp;ядра,&nbsp;передаваемый&nbsp;функции&nbsp;&lt;function&gt;Init&lt;/function&gt;.&nbsp;Он&nbsp;нужен&nbsp;нам,&nbsp;т.к.&nbsp;через&nbsp;этот&nbsp;объект&nbsp;осуществляется&nbsp;всё&nbsp;взаимодействие&nbsp;с&nbsp;ядром;&lt;/listitem&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;listitem&gt;&lt;classname&gt;QAction&lt;/classname&gt;&nbsp;*&lt;varname&gt;ShotAction_&lt;/varname&gt;,&nbsp;который&nbsp;будет&nbsp;инициировать&nbsp;снятие&nbsp;скриншота;&lt;/listitem&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;listitem&gt;слот&nbsp;&lt;function&gt;makeScreenshot&lt;/function&gt;,&nbsp;который&nbsp;будет&nbsp;запускаться&nbsp;по&nbsp;событию.&lt;/listitem&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;/itemizedlist&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;Эту&nbsp;инициализацию&nbsp;лучше&nbsp;производить&nbsp;в&nbsp;функции&nbsp;Init,&nbsp;так&nbsp;что&nbsp;давайте&nbsp;допишем&nbsp;туда&nbsp;вот&nbsp;такой&nbsp;код&nbsp;для&nbsp;нашего&nbsp;экшена:&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;programlisting&nbsp;language=&quot;c++&quot;&gt;
&lt;![CDATA[
Proxy_&nbsp;=&nbsp;proxy;

Dialog_&nbsp;=&nbsp;new&nbsp;ShooterDialog&nbsp;(Proxy_-&gt;GetMainWindow&nbsp;());

ShotAction_&nbsp;=&nbsp;new&nbsp;QAction&nbsp;(Proxy_-&gt;GetIcon&nbsp;(&quot;screenshot&quot;),
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;tr&nbsp;(&quot;Make&nbsp;a&nbsp;screenshot&quot;),
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;this);
connect&nbsp;(ShotAction_,
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;SIGNAL&nbsp;(triggered&nbsp;()),
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;this,
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;SLOT&nbsp;(makeScreenshot&nbsp;()));
]]&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;/programlisting&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;&lt;classname&gt;ICoreProxy_ptr&lt;/classname&gt;&nbsp;используется&nbsp;для&nbsp;получения&nbsp;правильной&nbsp;иконки&nbsp;из&nbsp;текущей&nbsp;темы.Когда&nbsp;вы&nbsp;будете&nbsp;разрабатывать&nbsp;свои&nbsp;собственные&nbsp;плагины,&nbsp;вам&nbsp;придётся&nbsp;таскать&nbsp;иконки&nbsp;с&nbsp;собой,&nbsp;пока&nbsp;не&nbsp;попадёте&nbsp;в&nbsp;официальный&nbsp;репозиторий.&nbsp;Прокси&nbsp;также&nbsp;используется&nbsp;для&nbsp;получения&nbsp;указателя&nbsp;на&nbsp;главное&nbsp;окно.&nbsp;О&nbsp;&lt;classname&gt;ShooterDialog&lt;/classname&gt;&nbsp;мы&nbsp;поговорим&nbsp;позже.&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;Теперь&nbsp;давайте&nbsp;заполним&nbsp;заглушку&nbsp;&lt;function&gt;GetActions&lt;/function&gt;,&nbsp;чтобы&nbsp;она&nbsp;возвращала&nbsp;&lt;varname&gt;ShotAction_&lt;/varname&gt;.&nbsp;&lt;function&gt;GetActions&lt;/function&gt;&nbsp;будет&nbsp;выглядеть&nbsp;примерно&nbsp;так:&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;programlisting&nbsp;language=&quot;c++&quot;&gt;
&lt;![CDATA[
QList&lt;QAction*&gt;&nbsp;Plugin::GetActions&nbsp;()&nbsp;const
{
&nbsp;&nbsp;&nbsp;&nbsp;QList&lt;QAction*&gt;&nbsp;result;
&nbsp;&nbsp;&nbsp;&nbsp;result&nbsp;&lt;&lt;&nbsp;ShotAction_;
&nbsp;&nbsp;&nbsp;&nbsp;return&nbsp;result;
}
]]&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;/programlisting&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;Если&nbsp;сейчас&nbsp;скомпилировать&nbsp;и&nbsp;установить&nbsp;плагин,&nbsp;мы&nbsp;увидим&nbsp;иконку&nbsp;скриншоттера&nbsp;на&nbsp;панели&nbsp;инструментов,&nbsp;но&nbsp;она&nbsp;пока&nbsp;что&nbsp;ничего&nbsp;не&nbsp;делает.&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&lt;/sect1&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&lt;sect1&nbsp;id=&quot;initiating_screenshooting&quot;&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;title&gt;Инициация&nbsp;получения&nbsp;скриншота&lt;/tite&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;В&nbsp;слоте&nbsp;мы&nbsp;запустим&nbsp;простой&nbsp;диалог,&nbsp;запрашивающий&nbsp;опции&nbsp;скриншота.&nbsp;Когда&nbsp;пользователь&nbsp;нажимает&nbsp;ОК,&nbsp;мы&nbsp;отключаем&nbsp;экшн&nbsp;(мы&nbsp;включим&nbsp;его,&nbsp;когда&nbsp;скриншот&nbsp;будет&nbsp;готов)&nbsp;и&nbsp;стартуем&nbsp;таймер&nbsp;в&nbsp;соответствии&nbsp;с&nbsp;таймаутом,&nbsp;заданным&nbsp;пользователем&nbsp;в&nbsp;диалоге:&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;programlisting&nbsp;language=&quot;c++&quot;&gt;
&lt;![CDATA[
void&nbsp;Plugin::makeScreenshot&nbsp;()
{
&nbsp;&nbsp;&nbsp;&nbsp;if&nbsp;(Dialog_-&gt;exec&nbsp;()&nbsp;!=&nbsp;QDialog::Accepted)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return;

&nbsp;&nbsp;&nbsp;&nbsp;ShotAction_-&gt;setEnabled&nbsp;(false);
&nbsp;&nbsp;&nbsp;&nbsp;QTimer::singleShot&nbsp;(Dialog_-&gt;GetTimeout&nbsp;()&nbsp;*&nbsp;1000,
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;this,
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;SLOT&nbsp;(shoot&nbsp;()));
}
]]&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;/programlisting&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;Мы&nbsp;создали&nbsp;Dialog_&nbsp;в&nbsp;Init()&nbsp;для&nbsp;того,&nbsp;чтобы&nbsp;хранить&nbsp;его&nbsp;между&nbsp;вызовами&nbsp;makeScreenshot().&nbsp;То,&nbsp;что&nbsp;диалог&nbsp;доступен&nbsp;из&nbsp;любой&nbsp;функции,&nbsp;имеет&nbsp;свои&nbsp;преимущества:&nbsp;например,&nbsp;нет&nbsp;никакой&nbsp;нужды&nbsp;в&nbsp;хранении&nbsp;параметров&nbsp;скриншота,&nbsp;вроде&nbsp;формата&nbsp;или&nbsp;качества,&nbsp;так&nbsp;как&nbsp;мы&nbsp;можем&nbsp;запросить&nbsp;их&nbsp;в&nbsp;любой&nbsp;момент&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;Написание&nbsp;диалога&nbsp;является&nbsp;довольно&nbsp;простой&nbsp;задачей&nbsp;для&nbsp;любого,&nbsp;кто&nbsp;когда-либо&nbsp;использовал&nbsp;Qt&nbsp;Designer,&nbsp;так&nbsp;что&nbsp;я&nbsp;не&nbsp;стану&nbsp;рассматривать&nbsp;это&nbsp;здесь.&nbsp;Впрочем,&nbsp;стоит&nbsp;рассказать&nbsp;о&nbsp;том,&nbsp;как&nbsp;добавлять&nbsp;формы&nbsp;в&nbsp;проекты,&nbsp;работающие&nbsp;с&nbsp;CMake.&nbsp;Нужно&nbsp;определить&nbsp;переменную,&nbsp;которая&nbsp;будет&nbsp;содержать&nbsp;список&nbsp;форм&nbsp;(в&nbsp;нашем&nbsp;случае&nbsp;это&nbsp;&lt;varname&gt;FORMS&lt;/varname&gt;),&nbsp;добавить&nbsp;&lt;filename&gt;.h&lt;/filename&gt;-&nbsp;и&nbsp;&lt;filename&gt;.cpp&lt;/filename&gt;-файлы&nbsp;в&nbsp;список&nbsp;заголовочных&nbsp;файлов&nbsp;и&nbsp;исходников,&nbsp;вызвать&nbsp;функцию&nbsp;&lt;function&gt;QT4_WRAP_UI&lt;/function&gt;&nbsp;для&nbsp;запуска&nbsp;на&nbsp;формах&nbsp;команды&nbsp;&lt;command&gt;uic&lt;/command&gt;,&nbsp;а&nbsp;затем&nbsp;добавить&nbsp;результаты&nbsp;в&nbsp;список&nbsp;зависимостей&nbsp;плагина.&nbsp;Таким&nbsp;образом,&nbsp;середина&nbsp;&lt;function&gt;CMakeLists.txt&lt;/function&gt;&nbsp;будет&nbsp;выглядеть&nbsp;так:&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;programlisting&nbsp;language=&quot;cmake&quot;&gt;
&lt;![CDATA[
SET&nbsp;(SRCS
&nbsp;&nbsp;&nbsp;&nbsp;auscrie.cpp
&nbsp;&nbsp;&nbsp;&nbsp;shooterdialog.cpp
&nbsp;&nbsp;&nbsp;&nbsp;)
SET&nbsp;(HEADERS
&nbsp;&nbsp;&nbsp;&nbsp;auscrie.h
&nbsp;&nbsp;&nbsp;&nbsp;shooterdialog.h
&nbsp;&nbsp;&nbsp;&nbsp;)
SET&nbsp;(FORMS
&nbsp;&nbsp;&nbsp;&nbsp;shooterdialog.ui
&nbsp;&nbsp;&nbsp;&nbsp;)
QT4_WRAP_CPP&nbsp;(MOC_SRCS&nbsp;${HEADERS})
QT4_WRAP_UI&nbsp;(UIS_H&nbsp;${FORMS})

ADD_LIBRARY&nbsp;(leechcraft_auscrie&nbsp;SHARED
&nbsp;&nbsp;&nbsp;&nbsp;${COMPILED_TRANSLATIONS}
&nbsp;&nbsp;&nbsp;&nbsp;${SRCS}&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;${MOC_SRCS}
&nbsp;&nbsp;&nbsp;&nbsp;${UIS_H}
&nbsp;&nbsp;&nbsp;&nbsp;)
]]&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;/programlisting&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&lt;/sect1&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&lt;sect1&nbsp;id=&quot;shooting_is_fun&quot;&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;title&gt;Скриншоты&nbsp;—&nbsp;это&nbsp;весело.&lt;/title&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;Давайте&nbsp;наконец&nbsp;взглянем&nbsp;на&nbsp;слот&nbsp;&lt;function&gt;shoot&lt;/function&gt;.&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;Для&nbsp;получения&nbsp;доступа&nbsp;к&nbsp;окну&nbsp;мы&nbsp;используем&nbsp;объект&nbsp;&lt;varname&gt;Proxy_&lt;/varname&gt;,&nbsp;с&nbsp;помощью&nbsp;которого&nbsp;ранее&nbsp;получали&nbsp;доступ&nbsp;к&nbsp;главному&nbsp;окну.&nbsp;Не&nbsp;забудьте&nbsp;подключить&nbsp;заголовочный&nbsp;файл&nbsp;&lt;classname&gt;QMainWindow&lt;/classname&gt;,&nbsp;иначе&nbsp;приведение&nbsp;типов&nbsp;из&nbsp;&lt;classname&gt;QMainWindow&lt;/classname&gt;*&nbsp;в&nbsp;&lt;classname&gt;QWidget&lt;/classname&gt;*&nbsp;не&nbsp;сработает.&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;programlisting&nbsp;language=&quot;c++&quot;&gt;
&lt;![CDATA[
void&nbsp;Plugin::shoot&nbsp;()
{
&nbsp;&nbsp;&nbsp;&nbsp;ShotAction_-&gt;setEnabled&nbsp;(true);

&nbsp;&nbsp;&nbsp;&nbsp;QWidget&nbsp;*mw&nbsp;=&nbsp;Proxy_-&gt;GetMainWindow&nbsp;();
&nbsp;&nbsp;&nbsp;&nbsp;QPixmap&nbsp;pm&nbsp;=&nbsp;QPixmap::grabWidget&nbsp;(mw);

&nbsp;&nbsp;&nbsp;&nbsp;const&nbsp;char&nbsp;*fmt&nbsp;=&nbsp;qPrintable&nbsp;(Dialog_-&gt;GetFormat&nbsp;());
&nbsp;&nbsp;&nbsp;&nbsp;int&nbsp;quality&nbsp;=&nbsp;Dialog_-&gt;GetQuality&nbsp;();
]]&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;/programlisting&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;После&nbsp;этого&nbsp;у&nbsp;нас&nbsp;есть&nbsp;два&nbsp;варианта:&nbsp;либо&nbsp;сохранить&nbsp;файл&nbsp;на&nbsp;диск,&nbsp;либо&nbsp;отправить&nbsp;его&nbsp;на&nbsp;pastebin.&nbsp;Первый&nbsp;немного&nbsp;проще:&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;programlisting&nbsp;language=&quot;c++&quot;&gt;
&lt;![CDATA[
&nbsp;&nbsp;&nbsp;&nbsp;switch&nbsp;(Dialog_-&gt;GetAction&nbsp;())
&nbsp;&nbsp;&nbsp;&nbsp;{
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;case&nbsp;ShooterDialog::ASave:
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;QString&nbsp;path&nbsp;=&nbsp;Proxy_-&gt;GetSettingsManager&nbsp;()-&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Property&nbsp;(&quot;PluginsStorage/Auscrie/SavePath&quot;,
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;QDir::currentPath&nbsp;()&nbsp;+&nbsp;&quot;01.&quot;&nbsp;+&nbsp;Dialog_-&gt;GetFormat&nbsp;())
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;.toString&nbsp;();

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;QString&nbsp;filename&nbsp;=&nbsp;QFileDialog::getSaveFileName&nbsp;(mw,
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;tr&nbsp;(&quot;Save&nbsp;as&quot;),
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;path,
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;tr&nbsp;(&quot;%1&nbsp;files&nbsp;(*.%1);;All&nbsp;files&nbsp;(*.*)&quot;)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;.arg&nbsp;(Dialog_-&gt;GetFormat&nbsp;()));

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if&nbsp;(!filename.isEmpty&nbsp;())
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;pm.save&nbsp;(filename,&nbsp;fmt,&nbsp;quality);
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Proxy_-&gt;GetSettingsManager&nbsp;()-&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;setProperty&nbsp;(&quot;PluginsStorage/Auscrie/SavePath&quot;,
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;filename);
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;break;
]]&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;/programlisting&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;Здесь&nbsp;использован&nbsp;менеджер&nbsp;настроек&nbsp;из&nbsp;ядра,&nbsp;который,&nbsp;вобщем-то,&nbsp;является&nbsp;обёрткой&nbsp;вокруг&nbsp;&lt;classname&gt;QSettings&lt;/classname&gt;.&nbsp;Клавиши,&nbsp;начинающиеся&nbsp;с&nbsp;&lt;emphasis&gt;PluginsStorage&lt;/emphasis&gt;,&nbsp;могут&nbsp;быть&nbsp;использованы&nbsp;плагинами,&nbsp;ядро&nbsp;не&nbsp;будет&nbsp;использовать&nbsp;их&nbsp;в&nbsp;своих&nbsp;собственных&nbsp;задачах.&nbsp;Использование&nbsp;менеджера&nbsp;настороек&nbsp;ядра&nbsp;нормально&nbsp;для&nbsp;хранения&nbsp;пары&nbsp;настроек,&nbsp;но&nbsp;если&nbsp;вам&nbsp;нужно&nbsp;больше,&nbsp;особенно&nbsp;если&nbsp;вам&nbsp;нужен&nbsp;отдельный&nbsp;диалог,&nbsp;лучше&nbsp;добавить&nbsp;его&nbsp;в&nbsp;ваш&nbsp;плагин.&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;Если&nbsp;пользовать&nbsp;выбрал&nbsp;загрузку&nbsp;изображения&nbsp;на&nbsp;imagebin,&nbsp;следует&nbsp;вызвать&nbsp;отдельную&nbsp;функцию,&nbsp;Post(),&nbsp;которая&nbsp;обо&nbsp;всём&nbsp;позаботится:&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;programlisting&nbsp;language=&quot;c++&quot;&gt;
&lt;![CDATA[
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;case&nbsp;ShooterDialog::AUpload:
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;QBuffer&nbsp;buf;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;pm.save&nbsp;(&amp;buf,
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;fmt,
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;quality);
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Post&nbsp;(buf.data&nbsp;());
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;break;
&nbsp;&nbsp;&nbsp;&nbsp;}
}
]]&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;/programlisting&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;Теперь&nbsp;нам&nbsp;также&nbsp;следует&nbsp;добавить&nbsp;в&nbsp;&lt;filename&gt;CMakeLists.txt&lt;/filename&gt;&nbsp;следующие&nbsp;строки&nbsp;(прямо&nbsp;перед&nbsp;&lt;code&gt;INCLUDE&nbsp;(${QT_USE_FILE})&lt;/code&gt;):&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;programlisting&nbsp;language=&quot;cmake&quot;&gt;
&lt;![CDATA[
SET&nbsp;(QT_USE_QTNETWORK&nbsp;TRUE)
]]&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;/programlisting&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;Это&nbsp;даст&nbsp;нашему&nbsp;плагину&nbsp;возможность&nbsp;работать&nbsp;с&nbsp;сетью,&nbsp;делая&nbsp;видимыми&nbsp;включения&nbsp;из&nbsp;модуля&nbsp;QtNetwork&nbsp;и&nbsp;линкуя&nbsp;плагин&nbsp;с&nbsp;библиотекой&nbsp;QtNetwork.&nbsp;Нам&nbsp;она&nbsp;определённо&nbsp;понадобится,&nbsp;т.к.&nbsp;плагин&nbsp;использует&nbsp;QtNetwork&nbsp;(например,&nbsp;&lt;classname&gt;QNetworkAccessManager&lt;/classname&gt;&nbsp;и&nbsp;&lt;classname&gt;QNetworkReply&lt;/classname&gt;)&nbsp;для&nbsp;постинга&nbsp;скриншотов.&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;Так&nbsp;как&nbsp;сейчас&nbsp;нас&nbsp;не&nbsp;интересует&nbsp;имплементация&nbsp;загрузки&nbsp;скриншота&nbsp;на&nbsp;imagebin,&nbsp;мы&nbsp;перенесём&nbsp;этот&nbsp;код&nbsp;в&nbsp;отдельный&nbsp;класс&nbsp;&lt;classname&gt;Poster&lt;/classname&gt;,&nbsp;и&nbsp;наша&nbsp;функция&nbsp;&lt;function&gt;Post&lt;/function&gt;&nbsp;будет&nbsp;выглядеть&nbsp;очень&nbsp;просто:&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;programlisting&nbsp;language=&quot;c++&quot;&gt;
&lt;![CDATA[
void&nbsp;Plugin::Post&nbsp;(const&nbsp;QByteArray&amp;&nbsp;data)
{
&nbsp;&nbsp;&nbsp;&nbsp;Poster&nbsp;*p&nbsp;=&nbsp;new&nbsp;Poster&nbsp;(data,
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Dialog_-&gt;GetFormat&nbsp;(),
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Proxy_-&gt;GetNetworkAccessManager&nbsp;());
&nbsp;&nbsp;&nbsp;&nbsp;connect&nbsp;(p,
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;SIGNAL&nbsp;(finished&nbsp;(QNetworkReply*)),
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;this,
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;SLOT&nbsp;(handleFinished&nbsp;(QNetworkReply*)));
&nbsp;&nbsp;&nbsp;&nbsp;connect&nbsp;(p,
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;SIGNAL&nbsp;(error&nbsp;(QNetworkReply*)),
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;this,
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;SLOT&nbsp;(handleError&nbsp;(QNetworkReply*)));
}
]]&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;/programlisting&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;Здесь&nbsp;мы&nbsp;ещё&nbsp;раз&nbsp;использовали&nbsp;&lt;varname&gt;Proxy_&lt;/varname&gt;,&nbsp;на&nbsp;этот&nbsp;раз&nbsp;—&nbsp;для&nbsp;получения&nbsp;общего&nbsp;для&nbsp;всего&nbsp;приложения&nbsp;экземпляра&nbsp;&lt;classname&gt;QNetworkAccessManager&lt;/classname&gt;&nbsp;с&nbsp;методом&nbsp;&lt;function&gt;GetNetworkAccessManager&lt;/function&gt;.&nbsp;Использовать&nbsp;общий&nbsp;экземпляр&nbsp;&lt;classname&gt;QNetworkAccessManager&lt;/classname&gt;&nbsp;всегда&nbsp;лучше,&nbsp;так&nbsp;как&nbsp;это&nbsp;позволяет&nbsp;получать&nbsp;доступ&nbsp;к&nbsp;общему&nbsp;кэшу&nbsp;и&nbsp;базе&nbsp;cookie,&nbsp;а&nbsp;также&nbsp;предоставляет&nbsp;возможность&nbsp;оптимизировать&nbsp;запросы&nbsp;путём&nbsp;повтороного&nbsp;использования&nbsp;соединений,&nbsp;например.&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;Следует&nbsp;также&nbsp;отметить,&nbsp;что&nbsp;в&nbsp;случае,&nbsp;когда&nbsp;вам&nbsp;нужно&nbsp;просто&nbsp;скачать&nbsp;файл&nbsp;(в&nbsp;данном&nbsp;плагине&nbsp;это&nbsp;не&nbsp;нужно,&nbsp;но&nbsp;это&nbsp;довольно&nbsp;часто&nbsp;возникающая&nbsp;задача),&nbsp;достаточно&nbsp;просто&nbsp;сгенерировать&nbsp;соответствующий&nbsp;сигнал,&nbsp;не&nbsp;заботясь&nbsp;о&nbsp;доступе&nbsp;к&nbsp;сети,&nbsp;менеджерах,&nbsp;ответах&nbsp;и&nbsp;прочем.&nbsp;Этот&nbsp;подход&nbsp;детально&nbsp;обсуждается&nbsp;в&nbsp;документе&nbsp;Обзор.&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;Считается&nbsp;нормальным&nbsp;создание&nbsp;&lt;classname&gt;Poster&lt;/classname&gt;&nbsp;в&nbsp;куче,&nbsp;не&nbsp;заботясь&nbsp;об&nbsp;освобождении&nbsp;памяти.&nbsp;Она&nbsp;будет&nbsp;освобождена&nbsp;соответствующими&nbsp;слотами.&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;Мы&nbsp;подключаемся&nbsp;к&nbsp;сигналам&nbsp;класса&nbsp;&lt;classname&gt;Poster&lt;/classname&gt;&nbsp;—&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;funcsynopsis&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;funcprototype&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;funcdef&gt;&lt;function&gt;finished&lt;/function&gt;&lt;/funcdef&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;paramdef&gt;QNetworkReply&nbsp;*&lt;parameter&gt;reply&lt;/parameter&gt;&lt;/paramdef&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;/funcprototype&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;/funcsynopsis&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;и
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;funcsynopsis&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;funcprototype&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;funcdef&gt;&lt;function&gt;error&lt;/function&gt;&lt;/funcdef&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;paramdef&gt;QNetworkReply&nbsp;*&lt;parameter&gt;reply&lt;/parameter&gt;&lt;/paramdef&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;/funcprototype&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;/funcsynopsis&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;—&nbsp;для&nbsp;того,&nbsp;чтобы&nbsp;получать&nbsp;извещения&nbsp;о&nbsp;том,&nbsp;что&nbsp;загрузка&nbsp;завершилась&nbsp;(а&nbsp;также&nbsp;чтобы&nbsp;узнать&nbsp;о&nbsp;возможных&nbsp;ошибках).&nbsp;&lt;classname&gt;Poster&lt;/classname&gt;&nbsp;генерирует&nbsp;сигнал&nbsp;с&nbsp;параметром&nbsp;—&nbsp;&lt;classname&gt;QNetworkReply&lt;/classname&gt;,&nbsp;который&nbsp;изначально&nbsp;излучил&nbsp;соответствующий&nbsp;сигнал.&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;Взглянем&nbsp;на&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;funcsynopsis&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;funcprototype&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;funcdef&gt;&lt;function&gt;handleFinished&lt;/function&gt;&lt;/funcdef&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;paramdef&gt;QNetworkReply&nbsp;*&lt;parameter&gt;reply&lt;/parameter&gt;&lt;/paramdef&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;/funcprototype&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;/funcsynopsis&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;(кстати,&nbsp;не&nbsp;забудьте&nbsp;объявить&nbsp;все&nbsp;представленные&nbsp;члены&nbsp;в&nbsp;определении&nbsp;класса):&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;programlisting&nbsp;language=&quot;c++&quot;&gt;
&lt;![CDATA[
void&nbsp;Plugin::handleFinished&nbsp;(QNetworkReply&nbsp;*reply)
{
&nbsp;&nbsp;&nbsp;&nbsp;sender&nbsp;()-&gt;deleteLater&nbsp;();

&nbsp;&nbsp;&nbsp;&nbsp;QString&nbsp;result&nbsp;=&nbsp;reply-&gt;readAll&nbsp;();

&nbsp;&nbsp;&nbsp;&nbsp;QRegExp&nbsp;re&nbsp;(&quot;&lt;p&gt;You&nbsp;can&nbsp;find&nbsp;this&nbsp;at&nbsp;&lt;a&nbsp;href=&#39;([^&lt;]+)&#39;&gt;([^&lt;]+)&lt;/a&gt;&lt;/p&gt;&quot;);
&nbsp;&nbsp;&nbsp;&nbsp;if&nbsp;(!re.exactMatch&nbsp;(result))
&nbsp;&nbsp;&nbsp;&nbsp;{
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Entity&nbsp;e&nbsp;=&nbsp;Util::MakeNotification&nbsp;(&quot;Auscrie&quot;,
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;tr&nbsp;(&quot;Page&nbsp;parse&nbsp;failed&quot;),
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;PWarning_);
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;emit&nbsp;gotEntity&nbsp;(e);
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return;
&nbsp;&nbsp;&nbsp;&nbsp;}

&nbsp;&nbsp;&nbsp;&nbsp;QString&nbsp;pasteUrl&nbsp;=&nbsp;re.cap&nbsp;(1);

&nbsp;&nbsp;&nbsp;&nbsp;Entity&nbsp;e&nbsp;=&nbsp;Util::MakeNotification&nbsp;(&quot;Auscrie&quot;,
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;tr&nbsp;(&quot;Image&nbsp;pasted:&nbsp;%1,&nbsp;the&nbsp;URL&nbsp;was&nbsp;copied&nbsp;to&nbsp;the&nbsp;clipboard&quot;)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;.arg&nbsp;(pasteUrl),
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;PInfo_);

&nbsp;&nbsp;&nbsp;&nbsp;QApplication::clipboard&nbsp;()-&gt;setText&nbsp;(pasteUrl,&nbsp;QClipboard::Clipboard);
&nbsp;&nbsp;&nbsp;&nbsp;QApplication::clipboard&nbsp;()-&gt;setText&nbsp;(pasteUrl,&nbsp;QClipboard::Selection);
&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;emit&nbsp;gotEntity&nbsp;(e);
}
]]&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;/programlisting&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;В&nbsp;первую&nbsp;очередь&nbsp;мы&nbsp;указываем&nbsp;посылающему&nbsp;объекту&nbsp;(экземпляру&nbsp;&lt;classname&gt;Poster&lt;/classname&gt;,&nbsp;созданному&nbsp;ранее)&nbsp;удалить&nbsp;себя,&nbsp;как&nbsp;только&nbsp;управление&nbsp;будет&nbsp;возвращено&nbsp;циклу&nbsp;обработки&nbsp;событий.&nbsp;Мы&nbsp;не&nbsp;можем&nbsp;просто&nbsp;написать&nbsp;что-то&nbsp;вроде&nbsp;&lt;code&gt;delete&nbsp;sender&nbsp;();&lt;/code&gt;,&nbsp;потому&nbsp;что&nbsp;объекты&nbsp;не&nbsp;могут&nbsp;быть&nbsp;удалены&nbsp;из&nbsp;их&nbsp;же&nbsp;обработчиков&nbsp;сигналов.&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;После&nbsp;этого&nbsp;мы&nbsp;с&nbsp;помощью&nbsp;&lt;function&gt;readAll&lt;/function&gt;&nbsp;получаем&nbsp;страницу,&nbsp;которую&nbsp;вернул&nbsp;сервер,&nbsp;и&nbsp;пытаемся&nbsp;извлечь&nbsp;ссылку&nbsp;на&nbsp;наше&nbsp;свежезагруженное&nbsp;изображение&nbsp;с&nbsp;помощью&nbsp;довольно&nbsp;простого&nbsp;регулярного&nbsp;выражения.&nbsp;Если&nbsp;сделать&nbsp;это&nbsp;не&nbsp;удаётся,&nbsp;мы&nbsp;генерируем&nbsp;уведомление&nbsp;об&nbsp;ошибке&nbsp;с&nbsp;приоритетом&nbsp;Warning&nbsp;и&nbsp;прерываем&nbsp;обработку.&nbsp;Заметьте&nbsp;также,&nbsp;что&nbsp;в&nbsp;сигналах&nbsp;классов&nbsp;и&nbsp;слотов,&nbsp;использующих&nbsp;структуры&nbsp;данных&nbsp;LeechCraft,&nbsp;вы&nbsp;должны&nbsp;использовать&nbsp;полностью&nbsp;определённые&nbsp;имена&nbsp;со&nbsp;всеми&nbsp;пространствами&nbsp;имён,&nbsp;например
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;funcsynopsis&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;funcprototype&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;funcdef&gt;void&nbsp;&lt;function&gt;gotEntity&lt;/function&gt;&lt;/funcdef&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;paramdef&gt;const&nbsp;LeechCraft::Entity&amp;amp;&nbsp;&lt;parameter&gt;entity&lt;/parameter&gt;&lt;/paramdef&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;/funcprototype&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;/funcsynopsis&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;В&nbsp;противном&nbsp;случае&nbsp;система&nbsp;метаобъектов&nbsp;Qt&nbsp;не&nbsp;распознает&nbsp;их.&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;Здесь&nbsp;также&nbsp;используется&nbsp;система&nbsp;сообщений&nbsp;LeechCraft.&nbsp;С&nbsp;её&nbsp;помощью&nbsp;можно&nbsp;отправлять&nbsp;пользователю&nbsp;оповещения&nbsp;о&nbsp;событиях,&nbsp;происходящих&nbsp;в&nbsp;плагине,&nbsp;вроде&nbsp;ошибок&nbsp;или&nbsp;всяких&nbsp;информационных&nbsp;сообщений.&nbsp;Для&nbsp;создания&nbsp;оповещения&nbsp;используется&nbsp;функция&nbsp;&lt;function&gt;LeechCraft::Util::MakeNotification&lt;/function&gt;,&nbsp;которая&nbsp;может&nbsp;быть&nbsp;добавлена&nbsp;с&nbsp;помощью&nbsp;&lt;code&gt;&lt;![CDATA[#include&nbsp;&lt;plugininterface/util.h&gt;]]&gt;&lt;/code&gt;.&nbsp;Эта&nbsp;функция&nbsp;принимает&nbsp;три&nbsp;параметра:&nbsp;заголовок,&nbsp;тело&nbsp;и&nbsp;приоритет&nbsp;оповещения.&nbsp;Более&nbsp;детально&nbsp;оповещения&nbsp;и&nbsp;сообщения&nbsp;LeechCraft&nbsp;обсуждаются&nbsp;в&nbsp;документе&nbsp;Обзор.&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&lt;/sect1&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&lt;sect1&nbsp;id=&quot;conclusion&quot;&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;title&gt;Заключение&lt;/title&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;para&gt;Вобщем-то,&nbsp;это&nbsp;всё.&nbsp;Теперь&nbsp;у&nbsp;нас&nbsp;есть&nbsp;работающий,&nbsp;полезный&nbsp;плагин.&nbsp;Конечно&nbsp;же,&nbsp;есть&nbsp;вещи,&nbsp;которые&nbsp;стоило&nbsp;бы&nbsp;добавить:&nbsp;например,&nbsp;можно&nbsp;было&nbsp;бы&nbsp;хранить&nbsp;историю&nbsp;всех&nbsp;запощенных&nbsp;скриншотов&nbsp;или&nbsp;показывать&nbsp;красивенький&nbsp;прогрессбар,&nbsp;демонстрирующий&nbsp;загрузку&nbsp;изображения.&nbsp;Также&nbsp;вам&nbsp;наверняка&nbsp;захочется&nbsp;добавить&nbsp;поддержку&nbsp;локализаций,&nbsp;но&nbsp;нашей&nbsp;целью&nbsp;здесь&nbsp;было&nbsp;привыкнуть&nbsp;к&nbsp;концепции&nbsp;плагинов&nbsp;LeechCraft.&lt;/para&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&lt;/sect1&gt;
&lt;/book&gt;
</code></blockquote><p><font color="gray">Colored with <a href="http://dumpz.org">dumpz.org</a></p>