LanguageSelect

The LanguageSelect server control displays a language selection drop-down list on an Ektron Web page. The control lets a site visitor select a language in which to view the site. Here is what the control looks like when published on a Web page.

It lists all languages selected on the Settings > Configuration > Language settings screen. (For more information, see Determining Which Languages are Available.)

You can place this control in any location of any page on your site.

Inserting the LanguageSelect server control onto a page

Prerequisite

You must have installed the server controls. See Installing server controls into Visual Studio Toolbox.

  1. In Visual Studio, choose View > Toolbox.
  2. Click the Ektron server control tab to display the server controls.
  3. Drag the LanguageSelect server control and drop it into the desired location on the page.

    NOTE: You also can place the cursor on the page where you want the server control, then double click the server control that you want.

    <CMS:LanguageSelect ID="LanguageSelect1" runat="server" />
  4. Click on LanguageSelect in the code to display and modify the control’s properties using the Properties window of Visual Studio. The page is updated as you modify the property values.

LanguageSelect properties

The following are Ektron-specific server controla server control uses API language to interact with the CMS and Framework UI to display the output. A server control can be dragged and dropped onto a Web form and then modified. properties. For information about native .NET properties such as font, height, width and border style, use Visual Studio® help.

  • DoInitFill (Boolean)

    By default, Fill occurs during the Page_Init event. Set to false if you want to postpone the fill-action until later. In this case, Fill is automatically called during the Page Render event. You might do this if you need to set or change a property on the control in code-behind and have it render with your changes shown.

  • Hide (Boolean)

    Hides or displays the output of the control in design time and run time.

    • True. Hide the control output.
    • False. Display the control output.
  • LabelName (String)

    Lets you define the label next to the language select drop-down box.

  • Language (Integer)

    Set a language for the Language Select Box. This property shows results in design-time (in Visual Studio) and at run-time (in a browser).

  • SuppressWrapperTags (Boolean)

    Suppresses the output of the span/div tags around the control.

    • True. Suppress wrap tags.
    • False (default). Allow wrap tags.