/usr/include/FcitxQt5/FcitxQtDBusAddons/fcitxqtconnection.h is in libfcitx-qt5-dev 1.1.1-1build3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 | /***************************************************************************
 *   Copyright (C) 2012~2012 by CSSlayer                                   *
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 *   This program is distributed in the hope that it will be useful,       *
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
 *   GNU General Public License for more details.                          *
 *                                                                         *
 *   You should have received a copy of the GNU General Public License     *
 *   along with this program; if not, write to the                         *
 *   Free Software Foundation, Inc.,                                       *
 *   51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.              *
 ***************************************************************************/
#ifndef FCITXQTCONNECTION_H
#define FCITXQTCONNECTION_H
#include "fcitxqtdbusaddons_export.h"
#include <QtCore/QObject>
class QDBusConnection;
class FcitxQtConnectionPrivate;
/**
 * dbus connection to fcitx
 **/
class FCITXQTDBUSADDONS_EXPORT FcitxQtConnection : public QObject {
    Q_OBJECT
    Q_PROPERTY(bool autoReconnect READ autoReconnect WRITE setAutoReconnect)
    Q_PROPERTY(bool connected READ isConnected)
    Q_PROPERTY(QDBusConnection* connection READ connection)
    Q_PROPERTY(QString serviceName READ serviceName)
public:
    /**
     * create a new connection
     *
     * @param parent
     **/
    explicit FcitxQtConnection(QObject* parent = 0);
    /**
     * destroy the connection
     **/
    virtual ~FcitxQtConnection();
    /**
     * the connection will not start to work until you call this function
     * you may want to connect to the signal before you call this function
     **/
    void startConnection();
    void endConnection();
    /**
     * automatically reconnect if fcitx disappeared
     *
     * @param a ...
     * @return void
     **/
    void setAutoReconnect(bool a);
    /**
     * check this connection is doing automatical reconnect or not
     *
     * default value is true
     **/
    bool autoReconnect();
    /**
     * return the current dbus connection to fcitx, notice, the object return
     * by this function might be deteled if fcitx disappear, or might return 0
     * if fcitx is not running
     *
     * @return QDBusConnection*
     **/
    QDBusConnection* connection();
    /**
     * current fcitx dbus service name, can be used for create DBus proxy
     *
     * @return service name
     **/
    const QString& serviceName();
    /**
     * check its connected or not
     **/
    bool isConnected();
Q_SIGNALS:
    /**
     * this signal will be emitted upon fcitx appears
     **/
    void connected();
    /**
     * this signal will be emitted upon fcitx disappears
     *
     * it will come with connected in pair
     **/
    void disconnected();
private:
    FcitxQtConnectionPrivate * const d_ptr;
    Q_DECLARE_PRIVATE(FcitxQtConnection);
};
#endif // FCITXCONNECTION_H
 |