X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=docs%2Fcontent%2Fshared-javascript-and-cpp-documentation%2Ftext-label.md;h=5986eeea29d951b08d8bce12a96321e2493149e7;hb=0031ca8312dba666109e4f7fbb62a3a5e288b7c2;hp=908fedd1c905c91d6e9cace452d8d11b19fc832b;hpb=2071317d301e9d5af326a3a2efcd2996263fbead;p=platform%2Fcore%2Fuifw%2Fdali-toolkit.git diff --git a/docs/content/shared-javascript-and-cpp-documentation/text-label.md b/docs/content/shared-javascript-and-cpp-documentation/text-label.md index 908fedd..5986eee 100644 --- a/docs/content/shared-javascript-and-cpp-documentation/text-label.md +++ b/docs/content/shared-javascript-and-cpp-documentation/text-label.md @@ -1,5 +1,5 @@ -/** - * + # Text Label {#text-label} @@ -33,7 +33,7 @@ dali.stage.add( label ); ~~~ The label must also be added to the stage, or to an actor which is on the stage. -The position of the label on-screen is dependent on the parent-origin and anchor-point properties. +The position of the label on-screen is dependent on the parentOrigin and anchorPoint properties. | | | |--|--| @@ -41,91 +41,7 @@ The position of the label on-screen is dependent on the parent-origin and anchor ### Font Selection -By default TextLabel will automatically select a suitable font from the platform. -Typically fonts do not support all scripts, for example Latin fonts often do not provide Arabic glyphs. -Therefore you should expect TextLabel to select different fonts for each script. - -Alternatively a font may be requested using either or all of FONT_FAMILY, FONT_STYLE, and POINT_SIZE properties: - -~~~{.cpp} -// C++ - -label.SetProperty( TextLabel::Property::FONT_FAMILY, "HelveticaNue" ); -label.SetProperty( TextLabel::Property::FONT_STYLE, "Regular" ); -label.SetProperty( TextLabel::Property::POINT_SIZE, 12.0f ); -~~~ - -~~~{.js} -// JavaScript - -label.fontFamily = "HelveticaNue"; -label.fontStyle = "Regular"; -label.pointSize = 12; -~~~ - -However the TextLabel will fall-back to using the default font, if the requested font does not support the required scripts. - -### Font Styles - -Setting a font size programmatically is not ideal for applications which support multiple screen resolutions etc. -A more flexible approach is to prepare various JSON stylesheets, and request a different style for each platform: - -~~~{.cpp} -// C++ -StyleManager styleManager = StyleManager::Get(); -styleManager.RequestThemeChange( "example-path/example.json" ); -~~~ - -To change the font for standard text labels, this JSON syntax can be used: - -~~~{.json} -{ - "styles": - { - "textlabel": - { - "font-family":"Arial", - "font-style":"Regular", - "point-size":8 - } - } -} -~~~ - -However the same point-size is unlikely to be suitable for all labels in an application. -To set custom sizes simply set a "style name" for each case, and then provide a style override in JSON: - -~~~{.cpp} - // C++ - - label.SetProperty( Control::Property::STYLE_NAME, "custom" ); -~~~ -~~~{.js} - // JavaScript - - label.styleName = "custom"'; -~~~ - -~~~{.json} -{ - "styles": - { - "textlabel": - { - "font-family":"Arial", - "font-style":"Regular", - "point-size":8 - }, - - "custom": - { - "point-size":10 - } - } -} -~~~ - -In the example above, standard text labels will have point-size 8, and "custom" labels will have point-size 10. +By default TextLabel will automatically select a suitable font from the platform. However, a different font could be selected. See the [Font Selection](@ref font-selection) section for more details. ### Text Alignment @@ -398,20 +314,20 @@ label1.underlineHeight = 1; Name (JavaScript) | Name (C++) | Type | Writable | Animatable ---------------------|---------------------|--------------|--------------|----------- - renderingBackend | RENDERING_BACKEND | INTEGER | ✔ | ✘ - text | TEXT | STRING | ✔ | ✘ - fontFamily | FONT_FAMILY | STRING | ✔ | ✘ - fontStyle | FONT_STYLE | STRING | ✔ | ✘ - pointSize | POINT_SIZE | FLOAT | ✔ | ✘ - multiLine | MULTI_LINE | BOOLEAN | ✔ | ✘ - horizontalAlignment | HORIZONTAL_ALIGNMENT| STRING | ✔ | ✘ - verticalAlignment | VERTICAL_ALIGNMENT | STRING | ✔ | ✘ - textColor | TEXT_COLOR | VECTOR4 | ✔ | ✘ - shadowOffset | SHADOW_OFFSET | VECTOR2 | ✔ | ✘ - shadowColor | SHADOW_COLOR | VECTOR4 | ✔ | ✘ - underlineEnabled | UNDERLINE_ENABLED | BOOLEAN | ✔ | ✘ - underlineColor | UNDERLINE_COLOR | VECTOR4 | ✔ | ✘ - underlineHeight | UNDERLINE_HEIGHT | FLOAT | ✔ | ✘ + renderingBackend | RENDERING_BACKEND | INTEGER | O | X + text | TEXT | STRING | O | X + fontFamily | FONT_FAMILY | STRING | O | X + fontStyle | FONT_STYLE | STRING | O | X + pointSize | POINT_SIZE | FLOAT | O | X + multiLine | MULTI_LINE | BOOLEAN | O | X + horizontalAlignment | HORIZONTAL_ALIGNMENT| STRING | O | X + verticalAlignment | VERTICAL_ALIGNMENT | STRING | O | X + textColor | TEXT_COLOR | VECTOR4 | O | X + shadowOffset | SHADOW_OFFSET | VECTOR2 | O | X + shadowColor | SHADOW_COLOR | VECTOR4 | O | X + underlineEnabled | UNDERLINE_ENABLED | BOOLEAN | O | X + underlineColor | UNDERLINE_COLOR | VECTOR4 | O | X + underlineHeight | UNDERLINE_HEIGHT | FLOAT | O | X