Locale DDF File
4/8/2010
This topic shows the Device Description Framework (DDF) file for the Locale Configuration Service Provider. Open Mobile Alliance Device Management (OMA DM) DDF files and the example in this topic are used only for OMA DM provisioning. For more information, see OMA Device Management.
Note
The first line of the DDF is the namespace reference for Microsoft custom properties. For more information, see Managing Microsoft Custom Properties (OMA DM).
<MgmtTree xmlns:MSFT="https://schemas.microsoft.com/MobileDevice/DM">
<VerDTD>1.2</VerDTD>
<Node>
<NodeName>Locale</NodeName>
<Path>./Vendor/MSFT</Path>
<DFProperties>
<AccessType>
<Get />
</AccessType>
<DFFormat>
<node />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<Description></Description>
</DFProperties>
<Node>
<NodeName>Locale</NodeName>
<DFProperties>
<AccessType>
<Get />
<Replace />
</AccessType>
<DFFormat>
<int />
</DFFormat>
<Occurrence>
<ZeroOrOne />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<DFTitle>Locale:</DFTitle>
<DFType>
<MIME>text/plain</MIME>
</DFType>
<Description>Locale setting choice in regional settings. Overrides the user's choice if any. The value passed in must be the ISO 639 LCID.</Description>
</DFProperties>
</Node>
<Node>
<NodeName>Language</NodeName>
<DFProperties>
<AccessType>
<Get />
<Replace />
</AccessType>
<DFFormat>
<int />
</DFFormat>
<Occurrence>
<ZeroOrOne />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<DFTitle>Language:</DFTitle>
<DFType>
<MIME>text/plain</MIME>
</DFType>
<Description>Current language of the UI displayed on the device.This parm uses the ISO 639 language code for values. For example, US English is 1033 (0x409), German is 1031 (0x407), and French is 1036 (0x40C).
Note:The user must reboot for this change to take effect.</Description>
</DFProperties>
</Node>
<Node>
<NodeName>LOCALE_INEGCURR</NodeName>
<DFProperties>
<AccessType>
<Get />
<Replace />
</AccessType>
<DFFormat>
<int />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
</DFType>
<MSFT:MaxLength>3</MSFT:MaxLength>
<Description>Negative currency mode.</Description>
</DFProperties>
</Node>
<Node>
<NodeName>LOCALE_SMONTHOUSANDSEP</NodeName>
<DFProperties>
<AccessType>
<Get />
<Replace />
</AccessType>
<DFFormat>
<chr />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
</DFType>
<Description>Character(s) used as the monetary separator between groups of digits to the left of the decimal.</Description>
</DFProperties>
</Node>
<Node>
<NodeName>LOCALE_ICURRDIGITS</NodeName>
<DFProperties>
<AccessType>
<Get />
<Replace />
</AccessType>
<DFFormat>
<int />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
</DFType>
<MSFT:MaxLength>6</MSFT:MaxLength>
<Description>Country/region code, based on international phone codes, also referred to as IBM country/region codes.</Description>
</DFProperties>
</Node>
<Node>
<NodeName>LOCALE_SMONDECIMALSEP</NodeName>
<DFProperties>
<AccessType>
<Get />
<Replace />
</AccessType>
<DFFormat>
<chr />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
</DFType>
<Description>Character(s) used as the monetary decimal separator.</Description>
</DFProperties>
</Node>
<Node>
<NodeName>LOCALE_ICURRENCY</NodeName>
<DFProperties>
<AccessType>
<Get />
<Replace />
</AccessType>
<DFFormat>
<int />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
</DFType>
<MSFT:MaxLength>2</MSFT:MaxLength>
<Description>
Positive currency mode. The maximum number of characters allowed for this string is 2. The following table lists the possible values for this parm.
0 ¤1.1
1 1.1¤
2 ¤ 1.1
3 1.1 ¤
</Description>
</DFProperties>
</Node>
<Node>
<NodeName>SPECIAL_SCURRENCY</NodeName>
<DFProperties>
<AccessType>
<Get />
<Replace />
</AccessType>
<DFFormat>
<chr />
</DFFormat>
<Occurrence>
<ZeroOrOne />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<DFTitle>Currency symbol:</DFTitle>
<DFType>
<MIME>text/plain</MIME>
</DFType>
<Description>String used as the local monetary symbol.</Description>
</DFProperties>
</Node>
<Node>
<NodeName>LOCALE_INEGNUMBER</NodeName>
<DFProperties>
<AccessType>
<Get />
<Replace />
</AccessType>
<DFFormat>
<int />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
</DFType>
<Description>
Negative number mode. Options listed in following table
0 (1.1)
1 -1.1
2 - 1.1
3 1.1-
4 1.1 -
</Description>
</DFProperties>
</Node>
<Node>
<NodeName>LOCALE_STHOUSAND</NodeName>
<DFProperties>
<AccessType>
<Get />
<Replace />
</AccessType>
<DFFormat>
<chr />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
</DFType>
<Description>Character(s) used to separate groups of digits to the left of the decimal.</Description>
</DFProperties>
</Node>
<Node>
<NodeName>LOCALE_IDIGITS</NodeName>
<DFProperties>
<AccessType>
<Get />
<Replace />
</AccessType>
<DFFormat>
<int />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
</DFType>
<MSFT:MaxLength>3</MSFT:MaxLength>
<Description>Number of fractional digits.</Description>
</DFProperties>
</Node>
<Node>
<NodeName>LOCALE_SDECIMAL</NodeName>
<DFProperties>
<AccessType>
<Get />
<Replace />
</AccessType>
<DFFormat>
<chr />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
</DFType>
<Description>Character(s) used as the decimal separator.</Description>
</DFProperties>
</Node>
<Node>
<NodeName>LOCALE_ICALENDARTYPE</NodeName>
<DFProperties>
<AccessType>
<Get />
<Replace />
</AccessType>
<DFFormat>
<int />
</DFFormat>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
</DFType>
<Description>Current calendar type. Possible values are:
1 Gregorian (as in United States)
2 Gregorian (English strings always)
3 Era: Year of the Emperor (Japan)
4 Era: Year based on the Chinese Calendar
5 Tangun Era (Korea)</Description>
</DFProperties>
</Node>
<Node>
<NodeName>LOCALE_IMEASURE</NodeName>
<DFProperties>
<AccessType>
<Get />
<Replace />
</AccessType>
<DFFormat>
<int />
</DFFormat>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
</DFType>
<MSFT:MaxLength>2</MSFT:MaxLength>
<Description>System of measurement. This value is 0 if the metric system is used and 1 if the U.S. system is used. The maximum number of characters allowed for this string is 2.</Description>
</DFProperties>
</Node>
<Node>
<NodeName>LOCALE_IFIRSTDAYOFWEEK</NodeName>
<DFProperties>
<AccessType>
<Get />
<Replace />
</AccessType>
<DFFormat>
<int />
</DFFormat>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
</DFType>
<Description>Specification for the first day in a week. The following table lists the possible values for this parm.
0 LOCALE_SDAYNAME1
1 LOCALE_SDAYNAME2
2 LOCALE_SDAYNAME3
3 LOCALE_SDAYNAME4
4 LOCALE_SDAYNAME5
5 LOCALE_SDAYNAME6
6 LOCALE_SDAYNAME7</Description>
</DFProperties>
</Node>
<Node>
<NodeName>LOCALE_IFIRSTWEEKOFYEAR</NodeName>
<DFProperties>
<AccessType>
<Get />
<Replace />
</AccessType>
<DFFormat>
<int />
</DFFormat>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
</DFType>
<Description>Specification for the first week of the year. The following lists the possible values for this parm.
0 Week containing 1/1 is the first week of that year.
1 First full week following 1/1 is the first week of that year.
2 First week containing at least 4 days is the first week of that year.</Description>
</DFProperties>
</Node>
<Node>
<NodeName>LOCALE_IPAPERSIZE</NodeName>
<DFProperties>
<AccessType>
<Get />
<Replace />
</AccessType>
<DFFormat>
<int />
</DFFormat>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
</DFType>
<Description>
Default paper size associated with the locale.
1 DMPAPER_LETTER
5 DMPAPER_LEGAL
9 DMPAPER_A4
12 DMPAPER_B4
13 DMPAPER_B5
</Description>
</DFProperties>
</Node>
<Node>
<NodeName>LOCALE_SLONGDATE</NodeName>
<DFProperties>
<AccessType>
<Get />
<Replace />
</AccessType>
<DFFormat>
<chr />
</DFFormat>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
</DFType>
<Description>Long date formatting string for this locale. The string can consist of a combination of day, month, and year format pictures defined in the Day, Month, Year, and Era Format Pictures table in National Language Support Constants and any string of characters enclosed in single quotes. Characters in single quotes remain as given.</Description>
</DFProperties>
</Node>
<Node>
<NodeName>LOCALE_SPOSITIVESIGN</NodeName>
<DFProperties>
<AccessType>
<Get />
<Replace />
</AccessType>
<DFFormat>
<chr />
</DFFormat>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
</DFType>
<Description>String value for the positive sign.</Description>
</DFProperties>
</Node>
<Node>
<NodeName>LOCALE_SSHORTDATE</NodeName>
<DFProperties>
<AccessType>
<Get />
<Replace />
</AccessType>
<DFFormat>
<chr />
</DFFormat>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
</DFType>
<Description>Short date formatting string for this locale. The string can consist of a combination of day, month, and year format pictures defined in Day, Month, Year, and Era Format Pictures table in National Language Support Constants.</Description>
</DFProperties>
</Node>
<Node>
<NodeName>LOCALE_STIMEFORMAT</NodeName>
<DFProperties>
<AccessType>
<Get />
<Replace />
</AccessType>
<DFFormat>
<chr />
</DFFormat>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
</DFType>
<Description>Time formatting strings for this locale. The string can consist of a combination of the hour, minute, and second format pictures defined in the Hour, Minute, and Second Format Pictures table in National Language Support Constants.</Description>
</DFProperties>
</Node>
<Node>
<NodeName>LOCALE_SYEARMONTH</NodeName>
<DFProperties>
<AccessType>
<Get />
<Replace />
</AccessType>
<DFFormat>
<chr />
</DFFormat>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
</DFType>
<Description>The Year/Month formatting string for the locale. This string shows the proper format for a date string that contains only the year and the month.</Description>
</DFProperties>
</Node>
<Node>
<NodeName>LOCALE_ITIME</NodeName>
<DFProperties>
<AccessType>
<Get />
<Replace />
</AccessType>
<DFFormat>
<int />
</DFFormat>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
</DFType>
<Description>Time format specification. The maximum number of characters allowed for this string is 2. The following table lists the possible values for this parm.
0 AM / PM 12-hour format
1 24-hour format</Description>
</DFProperties>
</Node>
<Node>
<NodeName>LOCALE_STIME</NodeName>
<DFProperties>
<AccessType>
<Get />
<Replace />
</AccessType>
<DFFormat>
<chr />
</DFFormat>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
</DFType>
<Description>Character(s) for the time separator.</Description>
</DFProperties>
</Node>
<Node>
<NodeName>LOCALE_S1159</NodeName>
<DFProperties>
<AccessType>
<Get />
<Replace />
</AccessType>
<DFFormat>
<chr />
</DFFormat>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
</DFType>
<Description>String for the AM designator.</Description>
</DFProperties>
</Node>
<Node>
<NodeName>LOCALE_S2359</NodeName>
<DFProperties>
<AccessType>
<Get />
<Replace />
</AccessType>
<DFFormat>
<chr />
</DFFormat>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
</DFType>
<Description>String for the PM designator.</Description>
</DFProperties>
</Node>
<Node>
<NodeName>LOCALE_SDATE</NodeName>
<DFProperties>
<AccessType>
<Get />
<Replace />
</AccessType>
<DFFormat>
<chr />
</DFFormat>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
</DFType>
<Description>Character(s) for the date separator.</Description>
</DFProperties>
</Node>
<Node>
<NodeName>LOCALE_SGROUPING</NodeName>
<DFProperties>
<AccessType>
<Get />
<Replace />
</AccessType>
<DFFormat>
<chr />
</DFFormat>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
</DFType>
<Description>Sizes for each group of digits to the left of the decimal. An explicit size is needed for each group; semicolons separate sizes. If the last value is zero, the preceding value is repeated. To group thousands, specify 3;0. </Description>
</DFProperties>
</Node>
<Node>
<NodeName>LOCALE_SLIST</NodeName>
<DFProperties>
<AccessType>
<Get />
<Replace />
</AccessType>
<DFFormat>
<chr />
</DFFormat>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
</DFType>
<Description>Character(s) used to separate list items. For example, a comma is used in many locales.</Description>
</DFProperties>
</Node>
<Node>
<NodeName>LOCALE_SNEGATIVESIGN</NodeName>
<DFProperties>
<AccessType>
<Get />
<Replace />
</AccessType>
<DFFormat>
<chr />
</DFFormat>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
</DFType>
<Description>String value for the negative sign.</Description>
</DFProperties>
</Node>
<Node>
<NodeName>LOCALE_ILZERO</NodeName>
<DFProperties>
<AccessType>
<Get />
<Replace />
</AccessType>
<DFFormat>
<int />
</DFFormat>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
</DFType>
<Description>Specification for leading zeros in decimal fields. The maximum number of characters allowed for this string is 2. The following table lists the possible values for this parm.
0 No leading zeros
1 Leading zeros</Description>
</DFProperties>
</Node>
<Node>
<NodeName>LOCALE_SMONGROUPING</NodeName>
<DFProperties>
<AccessType>
<Get />
<Replace />
</AccessType>
<DFFormat>
<chr />
</DFFormat>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
</DFType>
<Description>Sizes for each group of monetary digits to the left of the decimal. An explicit size is needed for each group; semicolons separate sizes. If the last value is zero, the preceding value is repeated. To group thousands, specify 3;0.</Description>
</DFProperties>
</Node>
</Node>
</MgmtTree>