Wiki Navigation
- Loading...
Overview
The standardKeyboard control displays a Virtual Keyboard for entering text via a remote in MediaPortal.
Description
The keyboard xml skin file (stdKeyboard.xml ) must appear in the skin xml file directory. The default values in this skin xml file may be modified to the skin designers liking. The keyboard skin is defined only once for the whole skin implementation. It is not possible to have multiple keyboard designs for a single skin (although the std and sms keyboards may look different).
The default standard keyboard control specification is shown below under XML Examples. The image below under Screenshot(s) shows a skinned keyboard example.
Changelog
Change | Date | Version |
---|---|---|
2010/10/05 | 1.1.0 to 1.2.0 | |
XML Example(s)
<control> <description>standard keyboard</description> <type>standardKeyboard</type> <id>1</id> <keyboardPosX>64</keyboardPosX> <keyboardPosY>250</keyboardPosY> <keyWidth>34</keyWidth> <keyHeight>54</keyHeight> <keyHSpacing>0</keyHSpacing> <keyVSpacing>2</keyVSpacing> <modeKeySpacing>4</modeKeySpacing> <modeKeyWidth>110</modeKeyWidth> <searchModeKeyWidth>130</searchModeKeyWidth> <label></label> <labelAlign>center</labelAlign> <labelOffX>0</labelOffX> <labelOffY>2</labelOffY> <labelFont>font10</labelFont> <labelColor>FFFFFFFF</labelColor> <labelShadowAngle>0</labelShadowAngle> <labelShadowDistance>0</labelShadowDistance> <labelShadowColor>FF000000</labelShadowColor> <labelBoxPosX>0</labelBoxPosX> <labelBoxPosY>0</labelBoxPosY> <labelBoxWidth>200</labelBoxWidth> <labelBoxHeight>30</labelBoxHeight> <labelBoxTexture>-</labelBoxTexture> <showLabelAsInitialText>no</showLabelAsInitialText> <inputTextBoxPosX>64</inputTextBoxPosX> <inputTextBoxPosY>218</inputTextBoxPosY> <inputTextBoxWidth>-1</inputTextBoxWidth> <inputTextBoxHeight>30</inputTextBoxHeight> <inputTextAlign>left</inputTextAlign> <inputTextOffX>18</inputTextOffX> <inputTextOffY>2</inputTextOffY> <inputTextFont>font10</inputTextFont> <inputTextBoxTexture>white.bmp</inputTextBoxTexture> <inputTextColor>FF000000</inputTextColor> <inputTextShadowAngle>0</inputTextShadowAngle> <inputTextShadowDistance>0</inputTextShadowDistance> <inputTextShadowColor>FF000000</inputTextShadowColor> <charKeyFont>font14</charKeyFont> <namedKeyFont>font10</namedKeyFont> <keyTextShadowAngle>0</keyTextShadowAngle> <keyTextShadowDistance>0</keyTextShadowDistance> <keyTextShadowColor>FF000000</keyTextShadowColor> <keyTextureFocus>keyNF.bmp</keyTextureFocus> <keyTextureNoFocus>keyNF.bmp</keyTextureNoFocus> <keyHighlightColor>FF00FF00</keyHighlightColor> <keyPressedColor>FF808080</keyPressedColor> <keyDisabledColor>FFFFFFFF</keyDisabledColor> <keyFontColor>FF000000</keyFontColor> <keySelFontColor>FF000000</keySelFontColor> <keyDisabledFontColor>FF808080</keyDisabledFontColor> </control>
Labels
Plugins have an option to display a 'label' similar to header text in a dialog. Skins have two options how to display these labels:
Inside the Input Box
Display the the label INSIDE the input box by using <showLabelAsInitialText>yes. In this case the <inputTextColor> and other input box tags apply. The following screenshot displays an example using Default skin in World Weather/Lite when adding a location:
Note: the cursor will not display inside the input box when this method is used
Outside the Input Box
Display the label separately (outside the input box) by using <showLabelAsInitialText>no. In this case use <labelBoxPosX> and <labelBoxPosY>to position the label, and other label tags to skin the text:
Controlling Visibility for SMS Style Input
In MediaPortal 1.2 RC and later, it is also possible for skinners to use input mode GUI property: #VirtualKeyboard.SMSStyleInput
Property holds string value "true" when SMS input is active and "false" when in standard input mode.
Below is one possibility to utilize it.
<control> <type>image</type> <id>0</id> <posX>1025</posX> <posY>193</posY> <width>40</width> <height>40</height> <texture>keyboard_sms.png</texture> <visible>string.contains(#VirtualKeyboard.SMSStyleInput,true)</visible> <colordiffuse>88ffffff</colordiffuse> </control> <control> <type>image</type> <id>0</id> <posX>990</posX> <posY>195</posY> <width>80</width> <height>40</height> <texture>keyboard_std.png</texture> <visible>string.contains(#VirtualKeyboard.SMSStyleInput,false)</visible> <colordiffuse>88ffffff</colordiffuse> </control>
.
This page has no comments.