/* This file is part of Telegram Desktop, the official desktop application for the Telegram messaging service. For license and copyright information please follow this link: https://github.com/telegramdesktop/tdesktop/blob/master/LEGAL */ #pragma once #include "history/view/history_view_object.h" #include "ui/rect_part.h" class History; struct HistoryMessageEdited; struct TextSelection; namespace base { template class enum_mask; } // namespace base namespace Storage { enum class SharedMediaType : signed char; using SharedMediaTypesMask = base::enum_mask; } // namespace Storage namespace HistoryView { enum class PointState : char; enum class CursorState : char; enum class InfoDisplayType : char; struct TextState; struct StateRequest; class Element; enum class MediaInBubbleState { None, Top, Middle, Bottom, }; class Media : public Object { public: Media(not_null parent) : _parent(parent) { } [[nodiscard]] not_null history() const; [[nodiscard]] virtual TextForMimeData selectedText( TextSelection selection) const { return TextForMimeData(); } [[nodiscard]] virtual bool isDisplayed() const; virtual void updateNeedBubbleState() { } [[nodiscard]] virtual bool hasTextForCopy() const { return false; } [[nodiscard]] virtual bool hideMessageText() const { return true; } [[nodiscard]] virtual bool allowsFastShare() const { return false; } virtual void refreshParentId(not_null realParent) { } virtual void draw( Painter &p, const QRect &r, TextSelection selection, crl::time ms) const = 0; [[nodiscard]] virtual PointState pointState(QPoint point) const; [[nodiscard]] virtual TextState textState( QPoint point, StateRequest request) const = 0; virtual void updatePressed(QPoint point) { } [[nodiscard]] virtual Storage::SharedMediaTypesMask sharedMediaTypes() const; // if we are in selecting items mode perhaps we want to // toggle selection instead of activating the pressed link [[nodiscard]] virtual bool toggleSelectionByHandlerClick( const ClickHandlerPtr &p) const = 0; // if we press and drag on this media should we drag the item [[nodiscard]] virtual bool dragItem() const { return false; } [[nodiscard]] virtual TextSelection adjustSelection( TextSelection selection, TextSelectType type) const { return selection; } [[nodiscard]] virtual uint16 fullSelectionLength() const { return 0; } [[nodiscard]] TextSelection skipSelection( TextSelection selection) const; [[nodiscard]] TextSelection unskipSelection( TextSelection selection) const; // if we press and drag this link should we drag the item [[nodiscard]] virtual bool dragItemByHandler( const ClickHandlerPtr &p) const = 0; virtual void clickHandlerActiveChanged(const ClickHandlerPtr &p, bool active) { } virtual void clickHandlerPressedChanged(const ClickHandlerPtr &p, bool pressed) { } [[nodiscard]] virtual bool uploading() const { return false; } [[nodiscard]] virtual PhotoData *getPhoto() const { return nullptr; } [[nodiscard]] virtual DocumentData *getDocument() const { return nullptr; } void playAnimation() { playAnimation(false); } void autoplayAnimation() { playAnimation(true); } virtual void stopAnimation() { } virtual void clearStickerLoopPlayed() { } virtual int checkAnimationCount() { return 0; } [[nodiscard]] virtual QSize sizeForGrouping() const { Unexpected("Grouping method call."); } virtual void drawGrouped( Painter &p, const QRect &clip, TextSelection selection, crl::time ms, const QRect &geometry, RectParts sides, RectParts corners, not_null cacheKey, not_null cache) const { Unexpected("Grouping method call."); } [[nodiscard]] virtual TextState getStateGrouped( const QRect &geometry, RectParts sides, QPoint point, StateRequest request) const; [[nodiscard]] virtual bool animating() const { return false; } [[nodiscard]] virtual TextWithEntities getCaption() const { return TextWithEntities(); } [[nodiscard]] virtual bool needsBubble() const = 0; [[nodiscard]] virtual bool customInfoLayout() const = 0; [[nodiscard]] virtual QMargins bubbleMargins() const { return QMargins(); } [[nodiscard]] virtual bool hideForwardedFrom() const { return false; } [[nodiscard]] virtual bool overrideEditedDate() const { return false; } [[nodiscard]] virtual HistoryMessageEdited *displayedEditBadge() const { Unexpected("displayedEditBadge() on non-grouped media."); } // An attach media in a web page can provide an // additional text to be displayed below the attach. // For example duration / progress for video messages. [[nodiscard]] virtual QString additionalInfoString() const { return QString(); } void setInBubbleState(MediaInBubbleState state) { _inBubbleState = state; } [[nodiscard]] MediaInBubbleState inBubbleState() const { return _inBubbleState; } [[nodiscard]] bool isBubbleTop() const { return (_inBubbleState == MediaInBubbleState::Top) || (_inBubbleState == MediaInBubbleState::None); } [[nodiscard]] bool isBubbleBottom() const { return (_inBubbleState == MediaInBubbleState::Bottom) || (_inBubbleState == MediaInBubbleState::None); } [[nodiscard]] virtual bool skipBubbleTail() const { return false; } [[nodiscard]] virtual bool hidesForwardedInfo() const { return false; } // Sometimes webpages can force the bubble to fit their size instead of // allowing message text to be as wide as possible (like wallpapers). [[nodiscard]] virtual bool enforceBubbleWidth() const { return false; } // Sometimes click on media in message is overloaded by the message: // (for example it can open a link or a game instead of opening media) // But the overloading click handler should be used only when media // is already loaded (not a photo or GIF waiting for load with auto // load being disabled - in such case media should handle the click). [[nodiscard]] virtual bool isReadyForOpen() const { return true; } virtual void unloadHeavyPart() { } // Should be called only by Data::Session. virtual void updateSharedContactUserId(UserId userId) { } virtual void parentTextUpdated() { } virtual ~Media() = default; protected: QSize countCurrentSize(int newWidth) override; Ui::Text::String createCaption(not_null item) const; virtual void playAnimation(bool autoplay) { } not_null _parent; MediaInBubbleState _inBubbleState = MediaInBubbleState::None; }; } // namespace HistoryView