diff options
Diffstat (limited to 'offapi/com/sun/star/linguistic2/XConversionDictionary.idl')
-rw-r--r-- | offapi/com/sun/star/linguistic2/XConversionDictionary.idl | 223 |
1 files changed, 0 insertions, 223 deletions
diff --git a/offapi/com/sun/star/linguistic2/XConversionDictionary.idl b/offapi/com/sun/star/linguistic2/XConversionDictionary.idl deleted file mode 100644 index e84287562..000000000 --- a/offapi/com/sun/star/linguistic2/XConversionDictionary.idl +++ /dev/null @@ -1,223 +0,0 @@ -/************************************************************************* - * - * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. - * - * Copyright 2000, 2010 Oracle and/or its affiliates. - * - * OpenOffice.org - a multi-platform office productivity suite - * - * This file is part of OpenOffice.org. - * - * OpenOffice.org is free software: you can redistribute it and/or modify - * it under the terms of the GNU Lesser General Public License version 3 - * only, as published by the Free Software Foundation. - * - * OpenOffice.org is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU Lesser General Public License version 3 for more details - * (a copy is included in the LICENSE file that accompanied this code). - * - * You should have received a copy of the GNU Lesser General Public License - * version 3 along with OpenOffice.org. If not, see - * <http://www.openoffice.org/license.html> - * for a copy of the LGPLv3 License. - * - ************************************************************************/ -#ifndef __com_sun_star_linguistic2_XConversionDictionary_idl__ -#define __com_sun_star_linguistic2_XConversionDictionary_idl__ - - -#include <com/sun/star/uno/XInterface.idl> -#include <com/sun/star/lang/Locale.idl> -#include <com/sun/star/linguistic2/ConversionDictionaryType.idl> -#include <com/sun/star/linguistic2/ConversionDirection.idl> -#include <com/sun/star/lang/IllegalArgumentException.idl> -#include <com/sun/star/container/ElementExistException.idl> -#include <com/sun/star/container/NoSuchElementException.idl> - - -//============================================================================= - -module com { module sun { module star { module linguistic2 { - -//============================================================================= -/** Allows the user to access a conversion dictionary. - - <p>The dictionary consists of entries (pairs) of the form - ( aLeftText, aRightText ). - Those pairs can be added and removed. Also it can be looked - for all entries where the left text or the right text matches - a given text. Thus it can be used for conversions in both - directions.</p> - - <p>Restrictions to what has to be the left and right text are usually - given by specific services implementing this interface.</p> - - @see com::sun::star::linguistic2::ConversionDictionary - @see com::sun::star::linguistic2::HangulHanjaConversionDictionary - - @since OOo 1.1.2 -*/ -published interface XConversionDictionary : com::sun::star::uno::XInterface -{ - //------------------------------------------------------------------------- - /** - @returns - the name of the dictionary. - */ - string getName(); - - //------------------------------------------------------------------------- - /** - @returns - the language supported by the dictionary. - - @see com::sun::star::lang::Locale - */ - com::sun::star::lang::Locale getLocale(); - - //------------------------------------------------------------------------- - /** - @returns - the conversion type supported by the dictionary. - - @see com::sun::star::linguistic2::ConversionDictionaryType - */ - short getConversionType(); - - //------------------------------------------------------------------------- - /** specifies whether the dictionary should be used or not . - - @param bAcvtivate - <TRUE/> if the dictionary should be used, <FALSE/> otherwise. - - */ - void setActive( [in] boolean bActivate ); - - //------------------------------------------------------------------------- - /** - @returns - <TRUE/> if the dictionary is active, <FALSE/> otherwise. - */ - boolean isActive(); - - //------------------------------------------------------------------------- - /** removes all entries from the dictionary. - */ - void clear(); - - //------------------------------------------------------------------------- - /** searches for entries or conversions that match the given text. - - <p>The exact string to be looked for is the substring from the - aText parameter that starts at position nStartPos and has the - length nLength.</p> - - @returns - the list of conversions found for the supplied text. - If no nothing was found, it is empty. - - @param aText - the text where the substring to be looked for will be taken from. - Depending on the conversion direction parameter it specifies - either the left text or the right text to look for. - @param nStartPos - the starting pos of the substring to be looked for. - @param nLength - the length of the substring to be looked for. - - @param eConversionDirection - specifies the direction of the conversion to look for. - It is one of - <type scope="com::sun::star::linguistic2">ConversionDirection</type>. - - @param nTextConversionOptions - Combination of <type scope="com::sun::star::i18n">TextConversionOption</type> - values. - - @throws com::sun::star::lang::IllegalArgumentException - if the locale is not supported by the dictionary or if - nTextConversionOptions is invalid for the given locale. - */ - sequence< string > getConversions( - [in] string aText, - [in] long nStartPos, - [in] long nLength, - [in] com::sun::star::linguistic2::ConversionDirection eDirection, - [in] long nTextConversionOptions ) - raises( com::sun::star::lang::IllegalArgumentException ); - - //------------------------------------------------------------------------- - /** is used to add a conversion pair to the dictionary. - - @param aLeftText - the left text of the pair to be added. - - @param aRightText - the right text of the pair to be added. - - @throws com::sun::star::lang::IllegalArgumentException - if the arguments are invalid. - For example if the specifications defined by the service - implementing this object are not met. - - @throws com::sun::star::container::ElementExistException - if such an entry already exists. - */ - void addEntry( - [in] string aLeftText, - [in] string aRightText ) - raises( com::sun::star::lang::IllegalArgumentException, - com::sun::star::container::ElementExistException); - - //------------------------------------------------------------------------- - /** removes a conversion pair from the dictionary. - - @param aLeftText - the left text of the pair to be removed. - - @param aRightText - the right text of the pair to be removed. - - @throws com::sun::star::container::NoSuchElementException - if there is no such entry. - */ - void removeEntry( - [in] string aLeftText, - [in] string aRightText ) - raises( com::sun::star::container::NoSuchElementException ); - - //------------------------------------------------------------------------- - /** returns the maximum number of characters used as left or right text - in entries. - - @param eDirection - specifies if the left text or the right text of entries will - be used. - - @see com::sun::star::linguistic2::ConversionDirection - */ - short getMaxCharCount( - [in] com::sun::star::linguistic2::ConversionDirection eDirection ); - - //------------------------------------------------------------------------- - /** - @returns - a list of all left or right parts of the dictionaries entries. - @param eDirection - specifies if all left or all right parts of the entries - should be returned. - */ - - sequence< string > getConversionEntries( - [in] com::sun::star::linguistic2::ConversionDirection eDirection ); - -}; - -//============================================================================= - -}; }; }; }; - -#endif - |