b6885972ee
Only set Unicode key code if the event corresponds to a character key and set
it to (newly added) WXK_NONE for the other ones to avoid nonsensical values in
it for e.g. "Home" key presses.
Also set non-Unicode key to WXK_NONE for the characters that can't be
represented in the current locale. This is consistent with wxGTK and avoids
conflicts between special key values and Unicode keys.
Clearly document the above behaviour.
Notice that implementing the correct behaviour in wxMSW involved untangling
previously interwoven WM_KEY{DOWN,UP} and WM_CHAR messages handlers. Clearly
separate them now as they get different input (key codes for the former,
characters for the latter) and especially don't try to convert from both kinds
of input using a single wxCharCodeMSWToWX() function. As this function doesn't
need to distinguish between keys and characters any more it can simply return
the converted value in all cases instead of returning 0 sometimes to indicate
a character value instead of a key. Simplify the code using this function
accordingly.
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@65522 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
403 lines
11 KiB
C++
403 lines
11 KiB
C++
/////////////////////////////////////////////////////////////////////////////
|
|
// Name: keyboard.cpp
|
|
// Purpose: Keyboard wxWidgets sample
|
|
// Author: Vadim Zeitlin
|
|
// Modified by: Marcin Wojdyr
|
|
// Created: 07.04.02
|
|
// RCS-ID: $Id$
|
|
// Copyright: (c) 2002 Vadim Zeitlin
|
|
// Licence: wxWindows licence
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
#include "wx/wxprec.h"
|
|
|
|
#ifdef __BORLANDC__
|
|
#pragma hdrstop
|
|
#endif
|
|
#ifndef WX_PRECOMP
|
|
#include "wx/wx.h"
|
|
#endif
|
|
|
|
#ifndef __WXMSW__
|
|
#include "../sample.xpm"
|
|
#endif
|
|
|
|
// Define a new frame type: this is going to be our main frame
|
|
class MyFrame : public wxFrame
|
|
{
|
|
public:
|
|
MyFrame(const wxString& title);
|
|
|
|
private:
|
|
// event handlers
|
|
void OnQuit(wxCommandEvent& WXUNUSED(event)) { Close(true); }
|
|
void OnAbout(wxCommandEvent& event);
|
|
|
|
void OnTestAccelA(wxCommandEvent& WXUNUSED(event))
|
|
{ m_logText->AppendText("Test accelerator \"A\" used.\n"); }
|
|
void OnTestAccelCtrlA(wxCommandEvent& WXUNUSED(event))
|
|
{ m_logText->AppendText("Test accelerator \"Ctrl-A\" used.\n"); }
|
|
void OnTestAccelEsc(wxCommandEvent& WXUNUSED(event))
|
|
{ m_logText->AppendText("Test accelerator \"Esc\" used.\n"); }
|
|
|
|
void OnClear(wxCommandEvent& WXUNUSED(event)) { m_logText->Clear(); }
|
|
void OnSkip(wxCommandEvent& event) { m_skip = event.IsChecked(); }
|
|
|
|
void OnKeyDown(wxKeyEvent& event) { LogEvent("KeyDown", event); }
|
|
void OnKeyUp(wxKeyEvent& event) { LogEvent("KeyUp", event); }
|
|
void OnChar(wxKeyEvent& event) { LogEvent("Char", event); }
|
|
void OnPaintInputWin(wxPaintEvent& event);
|
|
|
|
void LogEvent(const wxString& name, wxKeyEvent& event);
|
|
|
|
wxTextCtrl *m_logText;
|
|
wxWindow *m_inputWin;
|
|
bool m_skip;
|
|
};
|
|
|
|
|
|
// Define a new application type, each program should derive a class from wxApp
|
|
class MyApp : public wxApp
|
|
{
|
|
public:
|
|
// 'Main program' equivalent: the program execution "starts" here
|
|
virtual bool OnInit()
|
|
{
|
|
// create the main application window
|
|
new MyFrame("Keyboard wxWidgets App");
|
|
|
|
// If we returned false here, the application would exit immediately.
|
|
return true;
|
|
}
|
|
};
|
|
|
|
// Create a new application object: this macro will allow wxWidgets to create
|
|
// the application object during program execution (it's better than using a
|
|
// static object for many reasons) and also declares the accessor function
|
|
// wxGetApp() which will return the reference of the right type (i.e. MyApp and
|
|
// not wxApp)
|
|
IMPLEMENT_APP(MyApp)
|
|
|
|
|
|
// ============================================================================
|
|
// implementation
|
|
// ============================================================================
|
|
|
|
// frame constructor
|
|
MyFrame::MyFrame(const wxString& title)
|
|
: wxFrame(NULL, wxID_ANY, title),
|
|
m_inputWin(NULL),
|
|
m_skip(true)
|
|
{
|
|
SetIcon(wxICON(sample));
|
|
|
|
// IDs for menu items
|
|
enum
|
|
{
|
|
QuitID = wxID_EXIT,
|
|
ClearID = wxID_CLEAR,
|
|
SkipID = 100,
|
|
TestAccelA,
|
|
TestAccelCtrlA,
|
|
TestAccelEsc
|
|
};
|
|
|
|
// create a menu bar
|
|
wxMenu *menuFile = new wxMenu;
|
|
|
|
menuFile->Append(ClearID, "&Clear log\tCtrl-L");
|
|
menuFile->AppendSeparator();
|
|
|
|
menuFile->Append(TestAccelA, "Test accelerator &1\tA");
|
|
menuFile->Append(TestAccelCtrlA, "Test accelerator &2\tCtrl-A");
|
|
menuFile->Append(TestAccelEsc, "Test accelerator &3\tEsc");
|
|
menuFile->AppendSeparator();
|
|
|
|
menuFile->AppendCheckItem(SkipID, "Call event.&Skip()\tCtrl-S");
|
|
menuFile->Check(SkipID, true);
|
|
menuFile->AppendSeparator();
|
|
|
|
menuFile->Append(QuitID, "E&xit\tAlt-X", "Quit this program");
|
|
|
|
// the "About" item should be in the help menu
|
|
wxMenu *menuHelp = new wxMenu;
|
|
menuHelp->Append(wxID_ABOUT, "&About...\tF1", "Show about dialog");
|
|
|
|
// now append the freshly created menu to the menu bar...
|
|
wxMenuBar *menuBar = new wxMenuBar();
|
|
menuBar->Append(menuFile, "&File");
|
|
menuBar->Append(menuHelp, "&Help");
|
|
|
|
// ... and attach this menu bar to the frame
|
|
SetMenuBar(menuBar);
|
|
|
|
m_inputWin = new wxWindow(this, wxID_ANY, wxDefaultPosition, wxSize(-1, 50),
|
|
wxRAISED_BORDER),
|
|
m_inputWin->SetBackgroundColour(*wxBLUE);
|
|
|
|
wxTextCtrl *headerText = new wxTextCtrl(this, wxID_ANY, "",
|
|
wxDefaultPosition, wxDefaultSize,
|
|
wxTE_READONLY);
|
|
headerText->SetValue(
|
|
" event key KeyCode mod UnicodeKey "
|
|
" RawKeyCode RawKeyFlags");
|
|
|
|
|
|
m_logText = new wxTextCtrl(this, wxID_ANY, "",
|
|
wxDefaultPosition, wxDefaultSize,
|
|
wxTE_MULTILINE|wxTE_READONLY|wxHSCROLL);
|
|
|
|
// set monospace font to have output in nice columns
|
|
wxFont font(10, wxFONTFAMILY_TELETYPE,
|
|
wxFONTSTYLE_NORMAL, wxFONTWEIGHT_NORMAL);
|
|
headerText->SetFont(font);
|
|
m_logText->SetFont(font);
|
|
|
|
// layout
|
|
wxBoxSizer *sizer = new wxBoxSizer(wxVERTICAL);
|
|
sizer->Add(m_inputWin, wxSizerFlags().Expand());
|
|
sizer->Add(headerText, wxSizerFlags().Expand());
|
|
sizer->Add(m_logText, wxSizerFlags(1).Expand());
|
|
SetSizerAndFit(sizer);
|
|
|
|
// set size and position on screen
|
|
SetSize(700, 340);
|
|
CentreOnScreen();
|
|
|
|
// connect menu event handlers
|
|
|
|
Connect(QuitID, wxEVT_COMMAND_MENU_SELECTED,
|
|
wxCommandEventHandler(MyFrame::OnQuit));
|
|
|
|
Connect(wxID_ABOUT, wxEVT_COMMAND_MENU_SELECTED,
|
|
wxCommandEventHandler(MyFrame::OnAbout));
|
|
|
|
Connect(ClearID, wxEVT_COMMAND_MENU_SELECTED,
|
|
wxCommandEventHandler(MyFrame::OnClear));
|
|
|
|
Connect(SkipID, wxEVT_COMMAND_MENU_SELECTED,
|
|
wxCommandEventHandler(MyFrame::OnSkip));
|
|
|
|
Connect(TestAccelA, wxEVT_COMMAND_MENU_SELECTED,
|
|
wxCommandEventHandler(MyFrame::OnTestAccelA));
|
|
|
|
Connect(TestAccelCtrlA, wxEVT_COMMAND_MENU_SELECTED,
|
|
wxCommandEventHandler(MyFrame::OnTestAccelCtrlA));
|
|
|
|
Connect(TestAccelEsc, wxEVT_COMMAND_MENU_SELECTED,
|
|
wxCommandEventHandler(MyFrame::OnTestAccelEsc));
|
|
|
|
// connect event handlers for the blue input window
|
|
m_inputWin->Connect(wxEVT_KEY_DOWN, wxKeyEventHandler(MyFrame::OnKeyDown),
|
|
NULL, this);
|
|
m_inputWin->Connect(wxEVT_KEY_UP, wxKeyEventHandler(MyFrame::OnKeyUp),
|
|
NULL, this);
|
|
m_inputWin->Connect(wxEVT_CHAR, wxKeyEventHandler(MyFrame::OnChar),
|
|
NULL, this);
|
|
m_inputWin->Connect(wxEVT_PAINT,
|
|
wxPaintEventHandler(MyFrame::OnPaintInputWin),
|
|
NULL, this);
|
|
|
|
// and show itself (the frames, unlike simple controls, are not shown when
|
|
// created initially)
|
|
Show(true);
|
|
}
|
|
|
|
// event handlers
|
|
|
|
void MyFrame::OnAbout(wxCommandEvent& WXUNUSED(event))
|
|
{
|
|
wxMessageBox("Demonstrates keyboard event processing in wxWidgets\n"
|
|
"(c) 2002 Vadim Zeitlin\n"
|
|
"(c) 2008 Marcin Wojdyr",
|
|
"About wxWidgets Keyboard Sample",
|
|
wxOK | wxICON_INFORMATION, this);
|
|
}
|
|
|
|
void MyFrame::OnPaintInputWin(wxPaintEvent& WXUNUSED(event))
|
|
{
|
|
wxPaintDC dc(m_inputWin);
|
|
dc.SetTextForeground(*wxWHITE);
|
|
wxFont font(*wxSWISS_FONT);
|
|
font.SetWeight(wxFONTWEIGHT_BOLD);
|
|
font.SetPointSize(font.GetPointSize() + 2);
|
|
dc.SetFont(font);
|
|
|
|
dc.DrawLabel("Press keys here",
|
|
m_inputWin->GetClientRect(), wxALIGN_CENTER);
|
|
}
|
|
|
|
|
|
// helper function that returns textual description of wx virtual keycode
|
|
const char* GetVirtualKeyCodeName(int keycode)
|
|
{
|
|
switch ( keycode )
|
|
{
|
|
#define WXK_(x) \
|
|
case WXK_##x: return #x;
|
|
|
|
WXK_(BACK)
|
|
WXK_(TAB)
|
|
WXK_(RETURN)
|
|
WXK_(ESCAPE)
|
|
WXK_(SPACE)
|
|
WXK_(DELETE)
|
|
WXK_(START)
|
|
WXK_(LBUTTON)
|
|
WXK_(RBUTTON)
|
|
WXK_(CANCEL)
|
|
WXK_(MBUTTON)
|
|
WXK_(CLEAR)
|
|
WXK_(SHIFT)
|
|
WXK_(ALT)
|
|
WXK_(CONTROL)
|
|
WXK_(MENU)
|
|
WXK_(PAUSE)
|
|
WXK_(CAPITAL)
|
|
WXK_(END)
|
|
WXK_(HOME)
|
|
WXK_(LEFT)
|
|
WXK_(UP)
|
|
WXK_(RIGHT)
|
|
WXK_(DOWN)
|
|
WXK_(SELECT)
|
|
WXK_(PRINT)
|
|
WXK_(EXECUTE)
|
|
WXK_(SNAPSHOT)
|
|
WXK_(INSERT)
|
|
WXK_(HELP)
|
|
WXK_(NUMPAD0)
|
|
WXK_(NUMPAD1)
|
|
WXK_(NUMPAD2)
|
|
WXK_(NUMPAD3)
|
|
WXK_(NUMPAD4)
|
|
WXK_(NUMPAD5)
|
|
WXK_(NUMPAD6)
|
|
WXK_(NUMPAD7)
|
|
WXK_(NUMPAD8)
|
|
WXK_(NUMPAD9)
|
|
WXK_(MULTIPLY)
|
|
WXK_(ADD)
|
|
WXK_(SEPARATOR)
|
|
WXK_(SUBTRACT)
|
|
WXK_(DECIMAL)
|
|
WXK_(DIVIDE)
|
|
WXK_(F1)
|
|
WXK_(F2)
|
|
WXK_(F3)
|
|
WXK_(F4)
|
|
WXK_(F5)
|
|
WXK_(F6)
|
|
WXK_(F7)
|
|
WXK_(F8)
|
|
WXK_(F9)
|
|
WXK_(F10)
|
|
WXK_(F11)
|
|
WXK_(F12)
|
|
WXK_(F13)
|
|
WXK_(F14)
|
|
WXK_(F15)
|
|
WXK_(F16)
|
|
WXK_(F17)
|
|
WXK_(F18)
|
|
WXK_(F19)
|
|
WXK_(F20)
|
|
WXK_(F21)
|
|
WXK_(F22)
|
|
WXK_(F23)
|
|
WXK_(F24)
|
|
WXK_(NUMLOCK)
|
|
WXK_(SCROLL)
|
|
WXK_(PAGEUP)
|
|
WXK_(PAGEDOWN)
|
|
WXK_(NUMPAD_SPACE)
|
|
WXK_(NUMPAD_TAB)
|
|
WXK_(NUMPAD_ENTER)
|
|
WXK_(NUMPAD_F1)
|
|
WXK_(NUMPAD_F2)
|
|
WXK_(NUMPAD_F3)
|
|
WXK_(NUMPAD_F4)
|
|
WXK_(NUMPAD_HOME)
|
|
WXK_(NUMPAD_LEFT)
|
|
WXK_(NUMPAD_UP)
|
|
WXK_(NUMPAD_RIGHT)
|
|
WXK_(NUMPAD_DOWN)
|
|
WXK_(NUMPAD_PAGEUP)
|
|
WXK_(NUMPAD_PAGEDOWN)
|
|
WXK_(NUMPAD_END)
|
|
WXK_(NUMPAD_BEGIN)
|
|
WXK_(NUMPAD_INSERT)
|
|
WXK_(NUMPAD_DELETE)
|
|
WXK_(NUMPAD_EQUAL)
|
|
WXK_(NUMPAD_MULTIPLY)
|
|
WXK_(NUMPAD_ADD)
|
|
WXK_(NUMPAD_SEPARATOR)
|
|
WXK_(NUMPAD_SUBTRACT)
|
|
WXK_(NUMPAD_DECIMAL)
|
|
WXK_(NUMPAD_DIVIDE)
|
|
#undef WXK_
|
|
default:
|
|
return NULL;
|
|
}
|
|
}
|
|
|
|
// helper function that returns textual description of key in the event
|
|
wxString GetKeyName(const wxKeyEvent &event)
|
|
{
|
|
int keycode = event.GetKeyCode();
|
|
const char* virt = GetVirtualKeyCodeName(keycode);
|
|
if ( virt )
|
|
return virt;
|
|
if ( keycode > 0 && keycode < 32 )
|
|
return wxString::Format("Ctrl-%c", (unsigned char)('A' + keycode - 1));
|
|
if ( keycode >= 32 && keycode < 128 )
|
|
return wxString::Format("'%c'", (unsigned char)keycode);
|
|
#if wxUSE_UNICODE
|
|
return wxString::Format("'%c'", event.GetUnicodeKey());
|
|
#else
|
|
return "unknown";
|
|
#endif
|
|
}
|
|
|
|
|
|
void MyFrame::LogEvent(const wxString& name, wxKeyEvent& event)
|
|
{
|
|
wxString msg;
|
|
// event key_name KeyCode modifiers Unicode raw_code raw_flags
|
|
msg.Printf("%7s %15s %5d %c%c%c%c"
|
|
#if wxUSE_UNICODE
|
|
"%5d (U+%04x)"
|
|
#else
|
|
" none "
|
|
#endif
|
|
#ifdef wxHAS_RAW_KEY_CODES
|
|
" %7lu 0x%08lx"
|
|
#else
|
|
" not-set not-set"
|
|
#endif
|
|
"\n",
|
|
name,
|
|
GetKeyName(event),
|
|
event.GetKeyCode(),
|
|
event.ControlDown() ? 'C' : '-',
|
|
event.AltDown() ? 'A' : '-',
|
|
event.ShiftDown() ? 'S' : '-',
|
|
event.MetaDown() ? 'M' : '-'
|
|
#if wxUSE_UNICODE
|
|
, event.GetUnicodeKey()
|
|
, event.GetUnicodeKey()
|
|
#endif
|
|
#ifdef wxHAS_RAW_KEY_CODES
|
|
, (unsigned long) event.GetRawKeyCode()
|
|
, (unsigned long) event.GetRawKeyFlags()
|
|
#endif
|
|
);
|
|
|
|
m_logText->AppendText(msg);
|
|
|
|
if ( m_skip )
|
|
event.Skip();
|
|
}
|
|
|
|
|