X-Git-Url: http://review.tizen.org/git/?p=platform%2Fcore%2Fuifw%2Fdali-toolkit.git;a=blobdiff_plain;f=docs%2Fcontent%2Fshared-javascript-and-cpp-documentation%2Ftext-label.md;h=5986eeea29d951b08d8bce12a96321e2493149e7;hp=b6719eda3751ef43ec594079f91859aed3fb7667;hb=f3da11c2818c6d17706fbb2417f21b602b3190f5;hpb=9d994cff127d932aa64385aba479b015563f9929 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 b6719ed..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