Add new wxCommandLinkButton class.

A command link button wraps a native MSW control under recent Windows versions
and is implemented generically as a simple bitmap button elsewhere.

In the future, GTK implementation should allow using a different font for the
button label and its note.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@65327 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

include/wx/commandlinkbutton.h

@@ -0,0 +1,168 @@
+/////////////////////////////////////////////////////////////////////////////
+// Name:        wx/commandlinkbutton.h
+// Purpose:     wxCommandLinkButtonBase and wxGenericCommandLinkButton classes
+// Author:      Rickard Westerlund
+// Created:     2010-06-11
+// RCS-ID:      $Id$
+// Copyright:   (c) 2010 wxWidgets team
+// Licence:     wxWindows licence
+/////////////////////////////////////////////////////////////////////////////
+
+#ifndef _WX_COMMANDLINKBUTTON_H_
+#define _WX_COMMANDLINKBUTTON_H_
+
+#include "wx/defs.h"
+
+#if wxUSE_COMMANDLINKBUTTON
+
+// ----------------------------------------------------------------------------
+// Command link button common base class
+// ----------------------------------------------------------------------------
+
+// This class has separate "main label" (title-like string) and (possibly
+// multiline) "note" which can be set and queried separately but can also be
+// set both at once by joining them with a new line and setting them as a
+// label and queried by breaking the label into the parts before the first new
+// line and after it.
+
+class WXDLLIMPEXP_ADV wxCommandLinkButtonBase : public wxButton
+{
+public:
+    wxCommandLinkButtonBase() : wxButton() { }
+
+    wxCommandLinkButtonBase(wxWindow *parent,
+                            wxWindowID id,
+                            const wxString& mainLabel = wxEmptyString,
+                            const wxString& note = wxEmptyString,
+                            const wxPoint& pos = wxDefaultPosition,
+                            const wxSize& size = wxDefaultSize,
+                            long style = 0,
+                            const wxValidator& validator =
+                                wxDefaultValidator,
+                            const wxString& name = wxButtonNameStr)
+        : wxButton(parent,
+                   id,
+                   mainLabel + '\n' + note,
+                   pos,
+                   size,
+                   style,
+                   validator,
+                   name)
+        { }
+
+    virtual void SetMainLabelAndNote(const wxString& mainLabel,
+                                     const wxString& note) = 0;
+
+    virtual void SetMainLabel(const wxString& mainLabel)
+    {
+        SetMainLabelAndNote(mainLabel, GetNote());
+    }
+
+    virtual void SetNote(const wxString& note)
+    {
+        SetMainLabelAndNote(GetMainLabel(), note);
+    }
+
+    virtual wxString GetMainLabel() const
+    {
+        return GetLabel().BeforeFirst('\n');
+    }
+
+    virtual wxString GetNote() const
+    {
+        return GetLabel().AfterFirst('\n');
+    }
+
+protected:
+    virtual bool HasNativeBitmap() const { return false; }
+
+private:
+    wxDECLARE_NO_COPY_CLASS(wxCommandLinkButtonBase);
+};
+
+// ----------------------------------------------------------------------------
+// Generic command link button
+// ----------------------------------------------------------------------------
+
+// Trivial generic implementation simply using a multiline label to show both
+// the main label and the note.
+
+class WXDLLIMPEXP_ADV wxGenericCommandLinkButton
+                      : public wxCommandLinkButtonBase
+{
+public:
+    wxGenericCommandLinkButton() : wxCommandLinkButtonBase() { }
+
+
+    wxGenericCommandLinkButton(wxWindow *parent,
+                               wxWindowID id,
+                               const wxString& mainLabel = wxEmptyString,
+                               const wxString& note = wxEmptyString,
+                               const wxPoint& pos = wxDefaultPosition,
+                               const wxSize& size = wxDefaultSize,
+                               long style = 0,
+                               const wxValidator& validator = wxDefaultValidator,
+                               const wxString& name = wxButtonNameStr)
+        : wxCommandLinkButtonBase()
+    {
+        Create(parent, id, mainLabel, note, pos, size, style, validator, name);
+    }
+
+    bool Create(wxWindow *parent,
+                wxWindowID id,
+                const wxString& mainLabel = wxEmptyString,
+                const wxString& note = wxEmptyString,
+                const wxPoint& pos = wxDefaultPosition,
+                const wxSize& size = wxDefaultSize,
+                long style = 0,
+                const wxValidator& validator = wxDefaultValidator,
+                const wxString& name = wxButtonNameStr);
+
+    virtual void SetMainLabelAndNote(const wxString& mainLabel,
+                                     const wxString& note)
+    {
+        wxButton::SetLabel(mainLabel + '\n' + note);
+    }
+
+private:
+    void SetDefaultBitmap();
+
+    wxDECLARE_NO_COPY_CLASS(wxGenericCommandLinkButton);
+};
+
+#if defined(__WXMSW__)
+    #include "wx/msw/commandlinkbutton.h"
+#else
+    class WXDLLIMPEXP_ADV wxCommandLinkButton : public wxGenericCommandLinkButton
+    {
+    public:
+        wxCommandLinkButton() : wxGenericCommandLinkButton() { }
+
+        wxCommandLinkButton(wxWindow *parent,
+                            wxWindowID id,
+                            const wxString& mainLabel = wxEmptyString,
+                            const wxString& note = wxEmptyString,
+                            const wxPoint& pos = wxDefaultPosition,
+                            const wxSize& size = wxDefaultSize,
+                            long style = 0,
+                            const wxValidator& validator = wxDefaultValidator,
+                            const wxString& name = wxButtonNameStr)
+            : wxGenericCommandLinkButton(parent,
+                                         id,
+                                         mainLabel,
+                                         note,
+                                         pos,
+                                         size,
+                                         style,
+                                         validator,
+                                         name)
+            { }
+
+    private:
+        wxDECLARE_DYNAMIC_CLASS_NO_COPY(wxCommandLinkButton);
+    };
+#endif // __WXMSW__/!__WXMSW__
+
+#endif // wxUSE_COMMANDLINKBUTTON
+
+#endif // _WX_COMMANDLINKBUTTON_H_