Edit

New-WinUserLanguageList

  • Reference
Module:
International

Instantiates a new language list object.

Syntax

New-WinUserLanguageList
   [-Language] <String>
   [<CommonParameters>]

Description

The New-WinUserLanguageList cmdlet creates a user language list object. The object settings include input method, spelling setting, text prediction setting, and handwriting input mode. For more information, see CultureInfo Class and Configurable Language and Cultural Settings.

Examples

Example 1: Create and set a language list

PS C:\> $UserLanguageList = New-WinUserLanguageList -Language "en-US"
PS C:\> $UserLanguageList.Add("fr-FR")
PS C:\> Set-WinUserLanguageList -LanguageList $UserLanguageList

The first command creates a language list that contains US English. The command stores that object in the $UserLanguageList variable.

The second command adds France French to the object in $UserLanguageList.

The final command assigns the list in $UserLanguageList to the current user account by using the Set-WinUserLanguageList cmdlet.

Parameters

-Language

Specifies a language.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Outputs

System.Collections.Generic.List<Microsoft.InternationalSettings.Commands.WinUserLanguage>

A list of WinUserLanguage objects that contain one or more languages and associated properties from the current user account's language list. For more information about the Generic.List object, see System.Collections.Generic.List(Of T).

The generic list object supports the following methods:

  • Add("BCP-47")
  • Insert(index, "BCP-47")
  • Remove(Index)

The LanguageList is a list of language objects in the current user account's list. The language list object contains the following methods:

  • Add ("BCP-47")
  • Insert (BCP-47, index)
  • Remove (BCP-47)
  • Remove (Index)

The language list object contains the following properties:

  • BCP-47 (READ). A standard language tag that is used to identify languages. For more information, see the Internet Engineering Task Force (IETF) BCP 47 RFC.
  • Autonym (LP database) (READ). The name of the language in the language itself.
  • English name (LP database) (READ). The name of the language in English.
  • Localized name (LP database) (READ). The name of the language in the current Windows display language.
  • Script (LP database) (READ). The writing system of the language.
  • Input methods (READ/WRITE). A list of input method Tablet Input Panel (TIP) strings that are enabled for this language. The enabled input methods are listed in the format Language ID: Keyboard layout ID.
  • Handwriting recognition input mode (READ/WRITE). This value is either 0 (freehand) or 1 (write each character separately).