1 /*************************************************************************
2  *
3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4  *
5  * Copyright 2000, 2010 Oracle and/or its affiliates.
6  *
7  * OpenOffice.org - a multi-platform office productivity suite
8  *
9  * This file is part of OpenOffice.org.
10  *
11  * OpenOffice.org is free software: you can redistribute it and/or modify
12  * it under the terms of the GNU Lesser General Public License version 3
13  * only, as published by the Free Software Foundation.
14  *
15  * OpenOffice.org is distributed in the hope that it will be useful,
16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
18  * GNU Lesser General Public License version 3 for more details
19  * (a copy is included in the LICENSE file that accompanied this code).
20  *
21  * You should have received a copy of the GNU Lesser General Public License
22  * version 3 along with OpenOffice.org.  If not, see
23  * <http://www.openoffice.org/license.html>
24  * for a copy of the LGPLv3 License.
25  *
26  ************************************************************************/
27 
28 // MARKER(update_precomp.py): autogen include statement, do not remove
29 #include "precompiled_framework.hxx"
30 #include <accelerators/keymapping.hxx>
31 
32 //_______________________________________________
33 // own includes
34 
35 #include <macros/generic.hxx>
36 
37 //_______________________________________________
38 // interface includes
39 #include <com/sun/star/awt/Key.hpp>
40 
41 //_______________________________________________
42 // other includes
43 
44 //_______________________________________________
45 // namespace
46 
47 namespace framework
48 {
49 
50 //_______________________________________________
51 // helper
52 
53 KeyMapping::KeyIdentifierInfo KeyMapping::KeyIdentifierMap[] =
54 {
55     {css::awt::Key::NUM0          , "KEY_0"          },
56     {css::awt::Key::NUM1          , "KEY_1"          },
57     {css::awt::Key::NUM2          , "KEY_2"          },
58     {css::awt::Key::NUM3          , "KEY_3"          },
59     {css::awt::Key::NUM4          , "KEY_4"          },
60     {css::awt::Key::NUM5          , "KEY_5"          },
61     {css::awt::Key::NUM6          , "KEY_6"          },
62     {css::awt::Key::NUM7          , "KEY_7"          },
63     {css::awt::Key::NUM8          , "KEY_8"          },
64     {css::awt::Key::NUM9          , "KEY_9"          },
65     {css::awt::Key::A             , "KEY_A"          },
66     {css::awt::Key::B             , "KEY_B"          },
67     {css::awt::Key::C             , "KEY_C"          },
68     {css::awt::Key::D             , "KEY_D"          },
69     {css::awt::Key::E             , "KEY_E"          },
70     {css::awt::Key::F             , "KEY_F"          },
71     {css::awt::Key::G             , "KEY_G"          },
72     {css::awt::Key::H             , "KEY_H"          },
73     {css::awt::Key::I             , "KEY_I"          },
74     {css::awt::Key::J             , "KEY_J"          },
75     {css::awt::Key::K             , "KEY_K"          },
76     {css::awt::Key::L             , "KEY_L"          },
77     {css::awt::Key::M             , "KEY_M"          },
78     {css::awt::Key::N             , "KEY_N"          },
79     {css::awt::Key::O             , "KEY_O"          },
80     {css::awt::Key::P             , "KEY_P"          },
81     {css::awt::Key::Q             , "KEY_Q"          },
82     {css::awt::Key::R             , "KEY_R"          },
83     {css::awt::Key::S             , "KEY_S"          },
84     {css::awt::Key::T             , "KEY_T"          },
85     {css::awt::Key::U             , "KEY_U"          },
86     {css::awt::Key::V             , "KEY_V"          },
87     {css::awt::Key::W             , "KEY_W"          },
88     {css::awt::Key::X             , "KEY_X"          },
89     {css::awt::Key::Y             , "KEY_Y"          },
90     {css::awt::Key::Z             , "KEY_Z"          },
91     {css::awt::Key::F1            , "KEY_F1"         },
92     {css::awt::Key::F2            , "KEY_F2"         },
93     {css::awt::Key::F3            , "KEY_F3"         },
94     {css::awt::Key::F4            , "KEY_F4"         },
95     {css::awt::Key::F5            , "KEY_F5"         },
96     {css::awt::Key::F6            , "KEY_F6"         },
97     {css::awt::Key::F7            , "KEY_F7"         },
98     {css::awt::Key::F8            , "KEY_F8"         },
99     {css::awt::Key::F9            , "KEY_F9"         },
100     {css::awt::Key::F10           , "KEY_F10"        },
101     {css::awt::Key::F11           , "KEY_F11"        },
102     {css::awt::Key::F12           , "KEY_F12"        },
103     {css::awt::Key::F13           , "KEY_F13"        },
104     {css::awt::Key::F14           , "KEY_F14"        },
105     {css::awt::Key::F15           , "KEY_F15"        },
106     {css::awt::Key::F16           , "KEY_F16"        },
107     {css::awt::Key::F17           , "KEY_F17"        },
108     {css::awt::Key::F18           , "KEY_F18"        },
109     {css::awt::Key::F19           , "KEY_F19"        },
110     {css::awt::Key::F20           , "KEY_F20"        },
111     {css::awt::Key::F21           , "KEY_F21"        },
112     {css::awt::Key::F22           , "KEY_F22"        },
113     {css::awt::Key::F23           , "KEY_F23"        },
114     {css::awt::Key::F24           , "KEY_F24"        },
115     {css::awt::Key::F25           , "KEY_F25"        },
116     {css::awt::Key::F26           , "KEY_F26"        },
117     {css::awt::Key::DOWN          , "KEY_DOWN"       },
118     {css::awt::Key::UP            , "KEY_UP"         },
119     {css::awt::Key::LEFT          , "KEY_LEFT"       },
120     {css::awt::Key::RIGHT         , "KEY_RIGHT"      },
121     {css::awt::Key::HOME          , "KEY_HOME"       },
122     {css::awt::Key::END           , "KEY_END"        },
123     {css::awt::Key::PAGEUP        , "KEY_PAGEUP"     },
124     {css::awt::Key::PAGEDOWN      , "KEY_PAGEDOWN"   },
125     {css::awt::Key::RETURN        , "KEY_RETURN"     },
126     {css::awt::Key::ESCAPE        , "KEY_ESCAPE"     },
127     {css::awt::Key::TAB           , "KEY_TAB"        },
128     {css::awt::Key::BACKSPACE     , "KEY_BACKSPACE"  },
129     {css::awt::Key::SPACE         , "KEY_SPACE"      },
130     {css::awt::Key::INSERT        , "KEY_INSERT"     },
131     {css::awt::Key::DELETE        , "KEY_DELETE"     },
132     {css::awt::Key::ADD           , "KEY_ADD"        },
133     {css::awt::Key::SUBTRACT      , "KEY_SUBTRACT"   },
134     {css::awt::Key::MULTIPLY      , "KEY_MULTIPLY"   },
135     {css::awt::Key::DIVIDE        , "KEY_DIVIDE"     },
136     {css::awt::Key::POINT         , "KEY_POINT"      },
137     {css::awt::Key::COMMA         , "KEY_COMMA"      },
138     {css::awt::Key::LESS          , "KEY_LESS"       },
139     {css::awt::Key::GREATER       , "KEY_GREATER"    },
140     {css::awt::Key::EQUAL         , "KEY_EQUAL"      },
141     {css::awt::Key::OPEN          , "KEY_OPEN"       },
142     {css::awt::Key::CUT           , "KEY_CUT"        },
143     {css::awt::Key::COPY          , "KEY_COPY"       },
144     {css::awt::Key::PASTE         , "KEY_PASTE"      },
145     {css::awt::Key::UNDO          , "KEY_UNDO"       },
146     {css::awt::Key::REPEAT        , "KEY_REPEAT"     },
147     {css::awt::Key::FIND          , "KEY_FIND"       },
148     {css::awt::Key::PROPERTIES    , "KEY_PROPERTIES" },
149     {css::awt::Key::FRONT         , "KEY_FRONT"      },
150     {css::awt::Key::CONTEXTMENU   , "KEY_CONTEXTMENU"},
151     {css::awt::Key::HELP          , "KEY_HELP"       },
152     {css::awt::Key::MENU          , "KEY_MENU"       },
153     {css::awt::Key::HANGUL_HANJA  , "KEY_HANGUL_HANJA"},
154     {css::awt::Key::DECIMAL       , "KEY_DECIMAL"    },
155     {css::awt::Key::TILDE         , "KEY_TILDE"      },
156     {css::awt::Key::QUOTELEFT     , "KEY_QUOTELEFT"  },
157 	{0                            , ""               } // mark the end of this array!
158 };
159 
160 //-----------------------------------------------
161 KeyMapping::KeyMapping()
162 {
163     sal_Int32 i = 0;
164     while(KeyIdentifierMap[i].Code != 0)
165     {
166         ::rtl::OUString sIdentifier = ::rtl::OUString::createFromAscii(KeyIdentifierMap[i].Identifier);
167         sal_Int16       nCode       = KeyIdentifierMap[i].Code;
168 
169         m_lIdentifierHash[sIdentifier] = nCode      ;
170         m_lCodeHash      [nCode]       = sIdentifier;
171 
172         ++i;
173     }
174 }
175 
176 //-----------------------------------------------
177 KeyMapping::~KeyMapping()
178 {
179 }
180 
181 //-----------------------------------------------
182 sal_uInt16 KeyMapping::mapIdentifierToCode(const ::rtl::OUString& sIdentifier)
183     throw(css::lang::IllegalArgumentException)
184 {
185     Identifier2CodeHash::const_iterator pIt = m_lIdentifierHash.find(sIdentifier);
186     if (pIt != m_lIdentifierHash.end())
187         return pIt->second;
188 
189     // Its not well known identifier - but may be a pure key code formated as string ...
190     // Check and convert it!
191     sal_uInt16 nCode = 0;
192     if (!KeyMapping::impl_st_interpretIdentifierAsPureKeyCode(sIdentifier, nCode))
193         throw css::lang::IllegalArgumentException(
194                 DECLARE_ASCII("Cant map given identifier to a valid key code value."),
195                 css::uno::Reference< css::uno::XInterface >(),
196                 0);
197 
198     return (sal_uInt16)nCode;
199 }
200 
201 //-----------------------------------------------
202 ::rtl::OUString KeyMapping::mapCodeToIdentifier(sal_uInt16 nCode)
203 {
204     Code2IdentifierHash::const_iterator pIt = m_lCodeHash.find(nCode);
205     if (pIt != m_lCodeHash.end())
206         return pIt->second;
207 
208     // If we have no well known identifier - use the pure code value!
209     return ::rtl::OUString::valueOf((sal_Int32)nCode);
210 }
211 
212 //-----------------------------------------------
213 sal_Bool KeyMapping::impl_st_interpretIdentifierAsPureKeyCode(const ::rtl::OUString& sIdentifier,
214                                                                     sal_uInt16&      rCode      )
215 {
216     sal_Int32 nCode = sIdentifier.toInt32();
217     if (nCode > 0)
218     {
219         rCode = (sal_uInt16)nCode;
220         return sal_True;
221     }
222 
223     // 0 is normaly an error of the called method toInt32() ...
224     // But we must be aware, that the identifier is "0"!
225     rCode = 0;
226     return sIdentifier.equalsAscii("0");
227 }
228 
229 } // namespace framework
230