File indexing completed on 2024-05-12 04:37:36

 /*
     SPDX-FileCopyrightText: 2009 Vladimir Prus <ghost@cs.msu.su>
 
     SPDX-License-Identifier: LGPL-2.0-or-later
 */
 
 #ifndef KDEVPLATFORM_IFRAMESTACKMODEL_H
 #define KDEVPLATFORM_IFRAMESTACKMODEL_H
 
 #include "idebugsession.h"
 
 #include <QUrl>
 
 #include <QAbstractItemModel>
 #include <QString>
 
 namespace KDevelop {
 class IFrameStackModelPrivate;
 
 class KDEVPLATFORMDEBUGGER_EXPORT IFrameStackModel : public QAbstractItemModel
 {
     Q_OBJECT
 
 public:
     /** Stack frame */
     struct FrameItem {
         int nr;
         QString name;
         QUrl file;
         /* If -1, it means that file is not necessary a source file,
            but possibly a solib name.  */
         int line;
     };
 
     explicit IFrameStackModel(IDebugSession *session);
     ~IFrameStackModel() override;
 
     IDebugSession* session() const;
 
     /** Sets the current thread to the specified number,
        and sets the current frame to 0.
        Note that nothing prevents us from introducing
        setCurrentThreadAndFrame, but for all the cases when we
        switch to a different thread we want frame 0.  */
     virtual void setCurrentThread(int threadNumber) = 0;
     virtual void setCurrentThread(const QModelIndex &index) = 0;
     virtual int currentThread() const = 0;
     virtual QModelIndex currentThreadIndex() const = 0;
 
     /** Return the frame we wish to operate on.  This is always
        in context of the current thread.  This may be -1 if
        no frame is selected. This should only the be the case
        if the thread has no stack as such -- e.g. because it's
        running, or because it's exited.  */
     virtual int currentFrame() const = 0;
     virtual QModelIndex currentFrameIndex() const = 0;
     virtual void setCurrentFrame(int frame) = 0;
 
     virtual FrameItem frame(const QModelIndex &index) = 0;
 
     virtual void fetchThreads() = 0;
     virtual void fetchFrames(int threadNumber, int from, int to) = 0;
     virtual void fetchMoreFrames() = 0;
 
 Q_SIGNALS:
     /* FIXME: It might make for a more concise interface if those
        two were removed, and the clients react to thread_or_frame_changed
        event and compare the current thread/frame in the framestack model
        with the one they are displaying.  */
     void currentThreadChanged(int thread);
     void currentFrameChanged(int frame);
 
 private:
     virtual void handleEvent(IDebugSession::event_t event) = 0;
 
 private:
     friend class IDebugSession;
     const QScopedPointer<class IFrameStackModelPrivate> d_ptr;
     Q_DECLARE_PRIVATE(IFrameStackModel)
 };
 
 }
 
 Q_DECLARE_TYPEINFO(KDevelop::IFrameStackModel::FrameItem, Q_MOVABLE_TYPE);
 
 #endif