1*cdf0e10cSrcweir/************************************************************************* 2*cdf0e10cSrcweir * 3*cdf0e10cSrcweir * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 4*cdf0e10cSrcweir * 5*cdf0e10cSrcweir * Copyright 2000, 2010 Oracle and/or its affiliates. 6*cdf0e10cSrcweir * 7*cdf0e10cSrcweir * OpenOffice.org - a multi-platform office productivity suite 8*cdf0e10cSrcweir * 9*cdf0e10cSrcweir * This file is part of OpenOffice.org. 10*cdf0e10cSrcweir * 11*cdf0e10cSrcweir * OpenOffice.org is free software: you can redistribute it and/or modify 12*cdf0e10cSrcweir * it under the terms of the GNU Lesser General Public License version 3 13*cdf0e10cSrcweir * only, as published by the Free Software Foundation. 14*cdf0e10cSrcweir * 15*cdf0e10cSrcweir * OpenOffice.org is distributed in the hope that it will be useful, 16*cdf0e10cSrcweir * but WITHOUT ANY WARRANTY; without even the implied warranty of 17*cdf0e10cSrcweir * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 18*cdf0e10cSrcweir * GNU Lesser General Public License version 3 for more details 19*cdf0e10cSrcweir * (a copy is included in the LICENSE file that accompanied this code). 20*cdf0e10cSrcweir * 21*cdf0e10cSrcweir * You should have received a copy of the GNU Lesser General Public License 22*cdf0e10cSrcweir * version 3 along with OpenOffice.org. If not, see 23*cdf0e10cSrcweir * <http://www.openoffice.org/license.html> 24*cdf0e10cSrcweir * for a copy of the LGPLv3 License. 25*cdf0e10cSrcweir * 26*cdf0e10cSrcweir ************************************************************************/ 27*cdf0e10cSrcweir#ifndef __com_sun_star_lang_Locale_idl__ 28*cdf0e10cSrcweir#define __com_sun_star_lang_Locale_idl__ 29*cdf0e10cSrcweir 30*cdf0e10cSrcweir#include <com/sun/star/uno/XInterface.idl> 31*cdf0e10cSrcweir 32*cdf0e10cSrcweir 33*cdf0e10cSrcweir//============================================================================= 34*cdf0e10cSrcweir 35*cdf0e10cSrcweirmodule com { module sun { module star { module lang { 36*cdf0e10cSrcweir 37*cdf0e10cSrcweir//============================================================================= 38*cdf0e10cSrcweir 39*cdf0e10cSrcweir// DocMerge from xml: struct com::sun::star::lang::Locale 40*cdf0e10cSrcweir/** object represents a specific geographical, political, or cultural region. 41*cdf0e10cSrcweir 42*cdf0e10cSrcweir <p>An operation that requires a <code>Locale</code> to perform 43*cdf0e10cSrcweir its task is called <em>locale-sensitive</em> and uses the 44*cdf0e10cSrcweir <code>Locale</code> to tailor information for the user. For example, 45*cdf0e10cSrcweir displaying a number is a locale-sensitive operation; the number 46*cdf0e10cSrcweir should be formatted according to the customs/conventions of the 47*cdf0e10cSrcweir user's native country, region, or culture. </p> 48*cdf0e10cSrcweir 49*cdf0e10cSrcweir <p> Because a <code>Locale</code> object is just an identifier for a 50*cdf0e10cSrcweir region, no validity check is performed. If you want to see whether 51*cdf0e10cSrcweir particular resources are available for the <code>Locale</code>, use 52*cdf0e10cSrcweir the <method scope="com::sun::star::resource">XLocale::getAvailableLocales</method> method to ask for the 53*cdf0e10cSrcweir locales it supports.</p> 54*cdf0e10cSrcweir 55*cdf0e10cSrcweir <p> <strong>Note:</strong> When you ask for a resource for a 56*cdf0e10cSrcweir particular locale, you get the best available match, not necessarily 57*cdf0e10cSrcweir precisely what you asked for. For more information, see 58*cdf0e10cSrcweir <type scope="com::sun::star::resource">XResourceBundle</type>.</p> 59*cdf0e10cSrcweir 60*cdf0e10cSrcweir <p> Each implementation that performs locale-sensitive operations 61*cdf0e10cSrcweir allows you to get all the available objects of that type. Use the 62*cdf0e10cSrcweir <typed scope="com::sun::star::resource">XLocale</type> interface to set the locale. </p> 63*cdf0e10cSrcweir */ 64*cdf0e10cSrcweirpublished struct Locale 65*cdf0e10cSrcweir{ 66*cdf0e10cSrcweir // DocMerge from xml: field com::sun::star::lang::Locale::Language 67*cdf0e10cSrcweir /** specifies an <strong>ISO Language Code</strong>. 68*cdf0e10cSrcweir 69*cdf0e10cSrcweir <p>These codes are the lower-case two-letter codes as defined by 70*cdf0e10cSrcweir ISO-639. You can find a full list of these codes at a number of 71*cdf0e10cSrcweir sites, such as: <br> 72*cdf0e10cSrcweir <a href="http://www.ics.uci.edu/pub/ietf/http/related/iso639.txt"> 73*cdf0e10cSrcweir <code>http://www.ics.uci.edu/pub/ietf/http/related/iso639.txt</code></a>. 74*cdf0e10cSrcweir </p> 75*cdf0e10cSrcweir 76*cdf0e10cSrcweir <p>If this field contains an empty string, the meaning depends on the 77*cdf0e10cSrcweir context.</p> 78*cdf0e10cSrcweir */ 79*cdf0e10cSrcweir string Language; 80*cdf0e10cSrcweir 81*cdf0e10cSrcweir //------------------------------------------------------------------------- 82*cdf0e10cSrcweir 83*cdf0e10cSrcweir // DocMerge from xml: field com::sun::star::lang::Locale::Country 84*cdf0e10cSrcweir /** specifies an <strong>ISO Country Code.</strong> 85*cdf0e10cSrcweir 86*cdf0e10cSrcweir <p>These codes are the upper-case two-letter codes as 87*cdf0e10cSrcweir defined by ISO-3166. You can find a full list of these codes at a 88*cdf0e10cSrcweir number of sites, such as: <br> 89*cdf0e10cSrcweir <a href="http://www.chemie.fu-berlin.de/diverse/doc/ISO_3166.html"> 90*cdf0e10cSrcweir <code>http://www.chemie.fu-berlin.de/diverse/doc/ISO_3166.html</code></a>. 91*cdf0e10cSrcweir </p> 92*cdf0e10cSrcweir 93*cdf0e10cSrcweir <p>If this field contains an empty string, the meaning depends on the 94*cdf0e10cSrcweir context.</p> 95*cdf0e10cSrcweir */ 96*cdf0e10cSrcweir string Country; 97*cdf0e10cSrcweir 98*cdf0e10cSrcweir //------------------------------------------------------------------------- 99*cdf0e10cSrcweir 100*cdf0e10cSrcweir // DocMerge from xml: field com::sun::star::lang::Locale::Variant 101*cdf0e10cSrcweir /** contains a variant of the locale; codes are vendor and 102*cdf0e10cSrcweir browser-specific. 103*cdf0e10cSrcweir 104*cdf0e10cSrcweir <p>For example, use WIN for Windows, MAC for Macintosh, and POSIX 105*cdf0e10cSrcweir for POSIX. Wherever there are two variants, separate them with an 106*cdf0e10cSrcweir underscore, and put the most important one first. For example, a 107*cdf0e10cSrcweir traditional Spanish collation might construct a locale with parameters 108*cdf0e10cSrcweir for language, country and variant as: "es", "ES", "Traditional_WIN".</p> 109*cdf0e10cSrcweir */ 110*cdf0e10cSrcweir string Variant; 111*cdf0e10cSrcweir 112*cdf0e10cSrcweir}; 113*cdf0e10cSrcweir 114*cdf0e10cSrcweir 115*cdf0e10cSrcweir//============================================================================= 116*cdf0e10cSrcweir 117*cdf0e10cSrcweir}; }; }; }; 118*cdf0e10cSrcweir 119*cdf0e10cSrcweir/*============================================================================= 120*cdf0e10cSrcweir 121*cdf0e10cSrcweir=============================================================================*/ 122*cdf0e10cSrcweir#endif 123