mirror of
https://github.com/wxWidgets/wxWidgets.git
synced 2026-08-18 09:30:13 +08:00
Vadim Zeitlin
cf9c120dba
Stop modifying m_labelOrig directly in wxStaticText implementations, as the base class needs to be aware of these changes and this function will give it an opportunity to react to them. No real changes yet.
139 lines
4.4 KiB
C++
139 lines
4.4 KiB
C++
/////////////////////////////////////////////////////////////////////////////
|
|
// Name: wx/stattext.h
|
|
// Purpose: wxStaticText base header
|
|
// Author: Julian Smart
|
|
// Created:
|
|
// Copyright: (c) Julian Smart
|
|
// Licence: wxWindows licence
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
#ifndef _WX_STATTEXT_H_BASE_
|
|
#define _WX_STATTEXT_H_BASE_
|
|
|
|
#include "wx/defs.h"
|
|
|
|
#if wxUSE_STATTEXT
|
|
|
|
#include "wx/control.h"
|
|
|
|
/*
|
|
* wxStaticText flags
|
|
*/
|
|
#define wxST_NO_AUTORESIZE 0x0001
|
|
#define wxST_WRAP 0x0002
|
|
#define wxST_ELLIPSIZE_START 0x0004
|
|
#define wxST_ELLIPSIZE_MIDDLE 0x0008
|
|
#define wxST_ELLIPSIZE_END 0x0010
|
|
|
|
#define wxST_ELLIPSIZE_MASK \
|
|
(wxST_ELLIPSIZE_START | wxST_ELLIPSIZE_MIDDLE | wxST_ELLIPSIZE_END)
|
|
|
|
extern WXDLLIMPEXP_DATA_CORE(const char) wxStaticTextNameStr[];
|
|
|
|
class WXDLLIMPEXP_CORE wxStaticTextBase : public wxControl
|
|
{
|
|
public:
|
|
wxStaticTextBase() = default;
|
|
|
|
// wrap the text of the control so that no line is longer than the given
|
|
// width (if possible: this function won't break words)
|
|
// This function will modify the value returned by GetLabel()!
|
|
void Wrap(int width);
|
|
|
|
// overridden base virtuals
|
|
virtual wxSize
|
|
GetMinSizeFromKnownDirection(int direction,
|
|
int size,
|
|
int availableOtherDir) override;
|
|
|
|
virtual bool AcceptsFocus() const override { return false; }
|
|
virtual bool HasTransparentBackground() override { return true; }
|
|
|
|
virtual void SetWindowStyleFlag(long style) override;
|
|
|
|
bool IsEllipsized() const
|
|
{
|
|
return (GetWindowStyle() & wxST_ELLIPSIZE_MASK) != 0;
|
|
}
|
|
|
|
protected: // functions required for wxST_ELLIPSIZE_* support
|
|
|
|
// choose the default border for this window
|
|
virtual wxBorder GetDefaultBorder() const override { return wxBORDER_NONE; }
|
|
|
|
// Calls Ellipsize() on the real label if necessary. Unlike GetLabelText(),
|
|
// keeps the mnemonics instead of removing them.
|
|
virtual wxString GetEllipsizedLabel() const;
|
|
|
|
// Replaces parts of the string with ellipsis according to the ellipsize
|
|
// style. Shouldn't be called if we don't have any.
|
|
wxString Ellipsize(const wxString& label) const;
|
|
|
|
|
|
// Note that even though ports with native support for ellipsization
|
|
// (currently only wxGTK) don't need this stuff, we still need to define it
|
|
// as it's used by wxGenericStaticText.
|
|
|
|
// Must be called when the size or font changes to redo the ellipsization
|
|
// for the new size. Calls WXSetVisibleLabel() to actually update the
|
|
// display.
|
|
void UpdateLabel();
|
|
|
|
// This helper function must be called to update m_labelOrig instead of
|
|
// doing it directly.
|
|
//
|
|
// It returns false if the label didn't change.
|
|
bool UpdateLabelOrig(const wxString& label);
|
|
|
|
|
|
// If m_currentWrap is non-zero, contains the label value before wrapping it.
|
|
// This is used to allow re-wrapping it at different widths. Note that
|
|
// wxControlBase::m_labelOrig is changed when Wrap() is called and so can't
|
|
// be used.
|
|
wxString m_unwrappedLabel;
|
|
|
|
// The width at which the label is currently wrapped or 0 if not wrapped.
|
|
int m_currentWrap = 0;
|
|
|
|
|
|
// These functions are platform-specific and must be implemented in the
|
|
// platform-specific code. They must not use or update m_labelOrig.
|
|
|
|
// Returns the label currently displayed inside the control, with mnemonics
|
|
// if any.
|
|
virtual wxString WXGetVisibleLabel() const = 0;
|
|
|
|
// Sets the real label currently displayed inside the control, _without_
|
|
// invalidating the size. The text passed is always markup-free but may
|
|
// contain the mnemonic characters.
|
|
virtual void WXSetVisibleLabel(const wxString& str) = 0;
|
|
|
|
// Update the current size to match the best size unless wxST_NO_AUTORESIZE
|
|
// style is explicitly used.
|
|
void AutoResizeIfNecessary();
|
|
|
|
private:
|
|
wxDECLARE_NO_COPY_CLASS(wxStaticTextBase);
|
|
};
|
|
|
|
// see wx/generic/stattextg.h for the explanation
|
|
#ifndef wxNO_PORT_STATTEXT_INCLUDE
|
|
|
|
#if defined(__WXUNIVERSAL__)
|
|
#include "wx/univ/stattext.h"
|
|
#elif defined(__WXMSW__)
|
|
#include "wx/msw/stattext.h"
|
|
#elif defined(__WXGTK__)
|
|
#include "wx/gtk/stattext.h"
|
|
#elif defined(__WXMAC__)
|
|
#include "wx/osx/stattext.h"
|
|
#elif defined(__WXQT__)
|
|
#include "wx/qt/stattext.h"
|
|
#endif
|
|
|
|
#endif // !wxNO_PORT_STATTEXT_INCLUDE
|
|
|
|
#endif // wxUSE_STATTEXT
|
|
|
|
#endif // _WX_STATTEXT_H_BASE_
|