summaryrefslogtreecommitdiffstats
path: root/src/VBox/Main/include/QMTranslator.h
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--src/VBox/Main/include/QMTranslator.h60
1 files changed, 60 insertions, 0 deletions
diff --git a/src/VBox/Main/include/QMTranslator.h b/src/VBox/Main/include/QMTranslator.h
new file mode 100644
index 00000000..01bbc299
--- /dev/null
+++ b/src/VBox/Main/include/QMTranslator.h
@@ -0,0 +1,60 @@
+/* $Id: QMTranslator.h $ */
+/** @file
+ * VirtualBox API translation handling class
+ */
+
+/*
+ * Copyright (C) 2014-2020 Oracle Corporation
+ *
+ * This file is part of VirtualBox Open Source Edition (OSE), as
+ * available from http://www.virtualbox.org. This file is free software;
+ * you can redistribute it and/or modify it under the terms of the GNU
+ * General Public License (GPL) as published by the Free Software
+ * Foundation, in version 2 as it comes in the "COPYING" file of the
+ * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+ * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ */
+
+#ifndef MAIN_INCLUDED_QMTranslator_h
+#define MAIN_INCLUDED_QMTranslator_h
+#ifndef RT_WITHOUT_PRAGMA_ONCE
+# pragma once
+#endif
+
+class QMTranslator_Impl;
+
+class QMTranslator
+{
+public:
+ QMTranslator();
+ virtual ~QMTranslator();
+
+ /* Gets translation from loaded QM file
+ *
+ * @param context QM context to look for translation
+ * @param source Source string in one-byte encoding
+ * @param disamb Disambiguationg comment, empty by default
+ *
+ * @returns Pointer to a translation in UTF-8 encoding, empty string on failure */
+
+ const char *translate(const char *pszContext, const char *pszSource, const char *pszDisamb = "") const throw();
+
+ /* Loads and parses QM file
+ *
+ * @param filename The name of the file to load
+ *
+ * @returns VINF_SUCCESS if successful */
+ int load(const char *pszFilename) throw();
+
+private:
+ /* QMTranslator implementation.
+ * To separate all the code from the interface */
+ QMTranslator_Impl *_impl;
+
+ /* If copying is required, please define the following operators */
+ void operator=(QMTranslator &);
+ QMTranslator(const QMTranslator &);
+};
+
+#endif /* !MAIN_INCLUDED_QMTranslator_h */
+/* vi: set tabstop=4 shiftwidth=4 expandtab: */