<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <!--Rendered using the Haskell Html Library v0.2--> <HTML ><HEAD ><META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=UTF-8" ><TITLE >Graphics.Rendering.Pango.Markup</TITLE ><LINK HREF="haddock.css" REL="stylesheet" TYPE="text/css" ><SCRIPT SRC="haddock-util.js" TYPE="text/javascript" ></SCRIPT ><SCRIPT TYPE="text/javascript" >window.onload = function () {setSynopsis("mini_Graphics-Rendering-Pango-Markup.html")};</SCRIPT ></HEAD ><BODY ><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0" ><TR ><TD CLASS="topbar" ><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0" ><TR ><TD ><IMG SRC="haskell_icon.gif" WIDTH="16" HEIGHT="16" ALT=" " ></TD ><TD CLASS="title" >pango-0.11.2: Binding to the Pango text rendering engine.</TD ><TD CLASS="topbut" ><A HREF="src/Graphics-Rendering-Pango-Markup.html" >Source code</A ></TD ><TD CLASS="topbut" ><A HREF="index.html" >Contents</A ></TD ><TD CLASS="topbut" ><A HREF="doc-index.html" >Index</A ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="modulebar" ><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0" ><TR ><TD ><FONT SIZE="6" >Graphics.Rendering.Pango.Markup</FONT ></TD ><TD ALIGN="right" ><TABLE CLASS="narrow" CELLSPACING="0" CELLPADDING="0" ><TR ><TD CLASS="infohead" >Portability</TD ><TD CLASS="infoval" >portable (depends on GHC)</TD ></TR ><TR ><TD CLASS="infohead" >Stability</TD ><TD CLASS="infoval" >provisional</TD ></TR ><TR ><TD CLASS="infohead" >Maintainer</TD ><TD CLASS="infoval" >gtk2hs-users@lists.sourceforge.net</TD ></TR ></TABLE ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="section1" >Description</TD ></TR ><TR ><TD CLASS="doc" ><P >This module defines some helper functions for generating texts with embedded attributes. Note that there is no need to use these functions. In particular, if you set markup in labels that are subject to internationalization, it can be of advantage to write out the markup instead of using the functions in this module. </P ><P >In order to display a string that may contain markup characters, use Graphics.UI.Gtk.Pango.Layout.escapeMarkup. </P ><P >When you write markup directly, you can make use of the following convenience tags: </P ><DL ><DT ><TT >b</TT ></DT ><DD > Bold </DD ><DT ><TT >big</TT ></DT ><DD > Makes font relatively larger </DD ><DT ><TT >i</TT ></DT ><DD > Italic </DD ><DT ><TT >s</TT ></DT ><DD > Strikethrough </DD ><DT ><TT >sub</TT ></DT ><DD > Subscript </DD ><DT ><TT >sup</TT ></DT ><DD > Superscript </DD ><DT ><TT >small</TT ></DT ><DD > Makes font relatively smaller </DD ><DT ><TT >tt</TT ></DT ><DD > Monospace font </DD ><DT ><TT >u</TT ></DT ><DD > Underline </DD ></DL ><P >The full markup language can be found at <http: </P ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="section1" >Synopsis</TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="body" ><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0" ><TR ><TD CLASS="decl" ><SPAN CLASS="keyword" >type</SPAN > <A HREF="#t%3AMarkup" >Markup</A > = <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString" >String</A ></TD ></TR ><TR ><TD CLASS="s8" ></TD ></TR ><TR ><TD CLASS="decl" ><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0" ><TR ><TD CLASS="decl" ><SPAN CLASS="keyword" >data</SPAN > <A HREF="#t%3ASpanAttribute" >SpanAttribute</A > </TD ></TR ><TR ><TD CLASS="body" ><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0" ><TR ><TD CLASS="decl" >= <A HREF="#v%3AFontDescr" >FontDescr</A > <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString" >String</A ></TD ></TR ><TR ><TD CLASS="decl" >| <A HREF="#v%3AFontFamily" >FontFamily</A > <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString" >String</A ></TD ></TR ><TR ><TD CLASS="decl" >| <A HREF="#v%3AFontSize" >FontSize</A > <A HREF="Graphics-Rendering-Pango-Enums.html#t%3ASize" >Size</A ></TD ></TR ><TR ><TD CLASS="decl" >| <A HREF="#v%3AFontStyle" >FontStyle</A > <A HREF="Graphics-Rendering-Pango-Enums.html#t%3AFontStyle" >FontStyle</A ></TD ></TR ><TR ><TD CLASS="decl" >| <A HREF="#v%3AFontWeight" >FontWeight</A > <A HREF="Graphics-Rendering-Pango-Enums.html#t%3AWeight" >Weight</A ></TD ></TR ><TR ><TD CLASS="decl" >| <A HREF="#v%3AFontVariant" >FontVariant</A > <A HREF="Graphics-Rendering-Pango-Enums.html#t%3AVariant" >Variant</A ></TD ></TR ><TR ><TD CLASS="decl" >| <A HREF="#v%3AFontStretch" >FontStretch</A > <A HREF="Graphics-Rendering-Pango-Enums.html#t%3AStretch" >Stretch</A ></TD ></TR ><TR ><TD CLASS="decl" >| <A HREF="#v%3AFontForeground" >FontForeground</A > <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString" >String</A ></TD ></TR ><TR ><TD CLASS="decl" >| <A HREF="#v%3AFontBackground" >FontBackground</A > <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString" >String</A ></TD ></TR ><TR ><TD CLASS="decl" >| <A HREF="#v%3AFontUnderline" >FontUnderline</A > <A HREF="Graphics-Rendering-Pango-Enums.html#t%3AUnderline" >Underline</A ></TD ></TR ><TR ><TD CLASS="decl" >| <A HREF="#v%3AFontRise" >FontRise</A > <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Prelude.html#t%3ADouble" >Double</A ></TD ></TR ><TR ><TD CLASS="decl" >| <A HREF="#v%3AFontLang" >FontLang</A > <A HREF="Graphics-Rendering-Pango-Enums.html#t%3ALanguage" >Language</A ></TD ></TR ><TR ><TD CLASS="decl" >| <A HREF="#v%3AFontGravity" >FontGravity</A > <A HREF="Graphics-Rendering-Pango-Enums.html#t%3APangoGravity" >PangoGravity</A ></TD ></TR ><TR ><TD CLASS="decl" >| <A HREF="#v%3AFontGravityHint" >FontGravityHint</A > <A HREF="Graphics-Rendering-Pango-Enums.html#t%3APangoGravityHint" >PangoGravityHint</A ></TD ></TR ></TABLE ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="s8" ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="#v%3AmarkSpan" >markSpan</A > :: [<A HREF="Graphics-Rendering-Pango-Markup.html#t%3ASpanAttribute" >SpanAttribute</A >] -> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString" >String</A > -> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString" >String</A ></TD ></TR ><TR ><TD CLASS="s8" ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="#v%3AparseMarkup" >parseMarkup</A > :: <A HREF="Graphics-Rendering-Pango-Markup.html#t%3AMarkup" >Markup</A > -> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AChar" >Char</A > -> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO" >IO</A > ([[<A HREF="Graphics-Rendering-Pango-Enums.html#t%3APangoAttribute" >PangoAttribute</A >]], <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AChar" >Char</A >, <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString" >String</A >)</TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="section1" >Documentation</TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="topdecl" ><TABLE CLASS="declbar" ><TR ><TD CLASS="declname" ><SPAN CLASS="keyword" >type</SPAN > <A NAME="t:Markup" ><A NAME="t%3AMarkup" ></A ></A ><B >Markup</B > = <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString" >String</A ></TD ><TD CLASS="declbut" ><A HREF="src/Graphics-Rendering-Pango-Structs.html#Markup" >Source</A ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="doc" ><P >Define a synonym for text with embedded markup commands. </P ><UL ><LI > Markup strings are just simple strings. But it's easier to tell if a method expects text with or without markup. </LI ></UL ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="topdecl" ><TABLE CLASS="declbar" ><TR ><TD CLASS="declname" ><SPAN CLASS="keyword" >data</SPAN > <A NAME="t:SpanAttribute" ><A NAME="t%3ASpanAttribute" ></A ></A ><B >SpanAttribute</B > </TD ><TD CLASS="declbut" ><A HREF="src/Graphics-Rendering-Pango-Markup.html#SpanAttribute" >Source</A ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="body" ><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0" ><TR ><TD CLASS="ndoc" >These are all the attributes the <TT ><A HREF="Graphics-Rendering-Pango-Markup.html#v%3AmarkSpan" >markSpan</A ></TT > function can express. </TD ></TR ><TR ><TD CLASS="section4" >Constructors</TD ></TR ><TR ><TD CLASS="body" ><TABLE CLASS="vanilla" CELLSPACING="1" CELLPADDING="0" ><TR ><TD CLASS="arg" ><A NAME="v:FontDescr" ><A NAME="v%3AFontDescr" ></A ></A ><B >FontDescr</B > <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString" >String</A ></TD ><TD CLASS="rdoc" ><P >Choose a font by textual description. </P ><UL ><LI > Takes a string to completely describe the font, example: <TT >FontDescr</TT > "Sans Italic 12" </LI ></UL ></TD ></TR ><TR ><TD CLASS="arg" ><A NAME="v:FontFamily" ><A NAME="v%3AFontFamily" ></A ></A ><B >FontFamily</B > <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString" >String</A ></TD ><TD CLASS="rdoc" ><P >Specify the family of font to use. </P ><UL ><LI > Example: <TT >FontFamily</TT > "Sans" </LI ></UL ></TD ></TR ><TR ><TD CLASS="arg" ><A NAME="v:FontSize" ><A NAME="v%3AFontSize" ></A ></A ><B >FontSize</B > <A HREF="Graphics-Rendering-Pango-Enums.html#t%3ASize" >Size</A ></TD ><TD CLASS="rdoc" ><P >Change the size of the current font. </P ><UL ><LI > The constuctor takes the size in points (pt) or a predefined sizes. Setting the absolute size 12.5pt can be achieved by passing <TT ><A HREF="Graphics-Rendering-Pango-Markup.html#v%3AFontSize" >FontSize</A ></TT > (SizePoint 12.5) to <TT ><A HREF="Graphics-Rendering-Pango-Markup.html#v%3AmarkSpan" >markSpan</A ></TT >. Next to predefined absolute sizes such as <TT ><A HREF="Graphics-Rendering-Pango-Enums.html#v%3ASizeSmall" >SizeSmall</A ></TT > the size can be changed by asking for the next larger or smaller front with <TT ><A HREF="Graphics-Rendering-Pango-Enums.html#v%3ASizeLarger" >SizeLarger</A ></TT > and <TT ><A HREF="Graphics-Rendering-Pango-Enums.html#v%3ASizeSmaller" >SizeSmaller</A ></TT >, respectively. </LI ></UL ></TD ></TR ><TR ><TD CLASS="arg" ><A NAME="v:FontStyle" ><A NAME="v%3AFontStyle" ></A ></A ><B >FontStyle</B > <A HREF="Graphics-Rendering-Pango-Enums.html#t%3AFontStyle" >FontStyle</A ></TD ><TD CLASS="rdoc" >Change the slant of the current font. </TD ></TR ><TR ><TD CLASS="arg" ><A NAME="v:FontWeight" ><A NAME="v%3AFontWeight" ></A ></A ><B >FontWeight</B > <A HREF="Graphics-Rendering-Pango-Enums.html#t%3AWeight" >Weight</A ></TD ><TD CLASS="rdoc" ><P >Change the thickness of the current font. </P ><UL ><LI > The constructor takes one of the six predefined weights. Most likely to be supported: <TT ><A HREF="Graphics-Rendering-Pango-Enums.html#v%3AWeightBold" >WeightBold</A ></TT >. </LI ></UL ></TD ></TR ><TR ><TD CLASS="arg" ><A NAME="v:FontVariant" ><A NAME="v%3AFontVariant" ></A ></A ><B >FontVariant</B > <A HREF="Graphics-Rendering-Pango-Enums.html#t%3AVariant" >Variant</A ></TD ><TD CLASS="rdoc" ><P >Choosing an alternative rendering for lower case letters. </P ><UL ><LI > The argument <TT ><A HREF="Graphics-Rendering-Pango-Enums.html#v%3AVariantSmallCaps" >VariantSmallCaps</A ></TT > will display lower case letters as smaller upper case letters, if this option is available. </LI ></UL ></TD ></TR ><TR ><TD CLASS="arg" ><A NAME="v:FontStretch" ><A NAME="v%3AFontStretch" ></A ></A ><B >FontStretch</B > <A HREF="Graphics-Rendering-Pango-Enums.html#t%3AStretch" >Stretch</A ></TD ><TD CLASS="rdoc" ><P >Choose a different width. </P ><UL ><LI > Takes one of nine font widths, e.g. Pango.WidthExpanded. </LI ></UL ></TD ></TR ><TR ><TD CLASS="arg" ><A NAME="v:FontForeground" ><A NAME="v%3AFontForeground" ></A ></A ><B >FontForeground</B > <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString" >String</A ></TD ><TD CLASS="rdoc" ><P >Foreground color. </P ><UL ><LI > This constructor and <TT ><A HREF="Graphics-Rendering-Pango-Markup.html#v%3AFontBackground" >FontBackground</A ></TT > take both a description of the color to be used for rendering. The name is either a hex code of the form "#RRGGBB" or an X11 color name like "dark olive green". </LI ></UL ></TD ></TR ><TR ><TD CLASS="arg" ><A NAME="v:FontBackground" ><A NAME="v%3AFontBackground" ></A ></A ><B >FontBackground</B > <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString" >String</A ></TD ><TD CLASS="rdoc" >Background color. </TD ></TR ><TR ><TD CLASS="arg" ><A NAME="v:FontUnderline" ><A NAME="v%3AFontUnderline" ></A ></A ><B >FontUnderline</B > <A HREF="Graphics-Rendering-Pango-Enums.html#t%3AUnderline" >Underline</A ></TD ><TD CLASS="rdoc" >Specify underlining of text. </TD ></TR ><TR ><TD CLASS="arg" ><A NAME="v:FontRise" ><A NAME="v%3AFontRise" ></A ></A ><B >FontRise</B > <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Prelude.html#t%3ADouble" >Double</A ></TD ><TD CLASS="rdoc" ><P >Specify a vertical displacement. </P ><UL ><LI > Takes the vertical displacement in em (the width of the 'm' character in the current font). </LI ></UL ></TD ></TR ><TR ><TD CLASS="arg" ><A NAME="v:FontLang" ><A NAME="v%3AFontLang" ></A ></A ><B >FontLang</B > <A HREF="Graphics-Rendering-Pango-Enums.html#t%3ALanguage" >Language</A ></TD ><TD CLASS="rdoc" ><P >Give a hint about the language to be displayed. </P ><UL ><LI > This hint might help the system rendering a particular piece of text with different fonts that are more suitable for the given language. </LI ></UL ></TD ></TR ><TR ><TD CLASS="arg" ><A NAME="v:FontGravity" ><A NAME="v%3AFontGravity" ></A ></A ><B >FontGravity</B > <A HREF="Graphics-Rendering-Pango-Enums.html#t%3APangoGravity" >PangoGravity</A ></TD ><TD CLASS="rdoc" >Gravity of text, use for ratation. </TD ></TR ><TR ><TD CLASS="arg" ><A NAME="v:FontGravityHint" ><A NAME="v%3AFontGravityHint" ></A ></A ><B >FontGravityHint</B > <A HREF="Graphics-Rendering-Pango-Enums.html#t%3APangoGravityHint" >PangoGravityHint</A ></TD ><TD CLASS="rdoc" >Intensity of gravity. </TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="section4" ><IMG SRC="minus.gif" CLASS="coll" ONCLICK="toggle(this,'i:SpanAttribute')" ALT="show/hide" > Instances</TD ></TR ><TR ><TD CLASS="body" ><DIV ID="i:SpanAttribute" STYLE="display:block;" ><TABLE CLASS="vanilla" CELLSPACING="1" CELLPADDING="0" ><TR ><TD CLASS="decl" ><A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Text-Show.html#t%3AShow" >Show</A > <A HREF="Graphics-Rendering-Pango-Markup.html#t%3ASpanAttribute" >SpanAttribute</A ></TD ></TR ></TABLE ></DIV ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="topdecl" ><TABLE CLASS="declbar" ><TR ><TD CLASS="declname" ><A NAME="v:markSpan" ><A NAME="v%3AmarkSpan" ></A ></A ><B >markSpan</B > :: [<A HREF="Graphics-Rendering-Pango-Markup.html#t%3ASpanAttribute" >SpanAttribute</A >] -> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString" >String</A > -> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString" >String</A ></TD ><TD CLASS="declbut" ><A HREF="src/Graphics-Rendering-Pango-Markup.html#markSpan" >Source</A ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="doc" >Create the most generic span attribute. </TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="topdecl" ><TABLE CLASS="declbar" ><TR ><TD CLASS="declname" ><A NAME="v:parseMarkup" ><A NAME="v%3AparseMarkup" ></A ></A ><B >parseMarkup</B ></TD ><TD CLASS="declbut" ><A HREF="src/Graphics-Rendering-Pango-Attributes.html#parseMarkup" >Source</A ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="body" ><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0" ><TR ><TD CLASS="arg" >:: <A HREF="Graphics-Rendering-Pango-Markup.html#t%3AMarkup" >Markup</A ></TD ><TD CLASS="rdoc" >the string containing markup </TD ></TR ><TR ><TD CLASS="arg" >-> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AChar" >Char</A ></TD ><TD CLASS="rdoc" ><TT >accelMarker</TT > - the character that prefixes an accelerator </TD ></TR ><TR ><TD CLASS="arg" >-> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO" >IO</A > ([[<A HREF="Graphics-Rendering-Pango-Enums.html#t%3APangoAttribute" >PangoAttribute</A >]], <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AChar" >Char</A >, <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString" >String</A >)</TD ><TD CLASS="rdoc" >list of attributes, the accelerator character found and the input string without markup </TD ></TR ><TR ><TD CLASS="ndoc" COLSPAN="2" ><P >Parse the marked-up text (see Graphics.Rendering.Pango.Markup.Markup format) to create a plain-text string and an attribute list. </P ><UL ><LI > The attribute list is a list of lists of attribute. Each list describes the attributes for the same span. </LI ><LI > If <TT >accelMarker</TT > is not <TT >'\0'</TT > (a zero character), the given character will mark the character following it as an accelerator. For example, <TT >accelMarker</TT > might be an ampersand or underscore. All characters marked as an accelerator will receive a <TT ><A HREF="Graphics-Rendering-Pango-Enums.html#v%3AUnderlineLow" >UnderlineLow</A ></TT > attribute, and the first character so marked will be returned as <TT >accelChar</TT >. If no accelerator character is found, the <TT >accelMarker</TT > character itself is returned. Two <TT >accelMarker</TT > characters following each other produce a single literal <TT >accelMarker</TT > character. </LI ><LI > If a parsing error occurs a <TT ><A HREF="/usr/share/doc/ghc/html/libraries/glib-0.11.2/System-Glib-GError.html#t%3AGError" >GError</A ></TT > is thrown. </LI ></UL ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="botbar" >Produced by <A HREF="http://www.haskell.org/haddock/" >Haddock</A > version 2.6.1</TD ></TR ></TABLE ></BODY ></HTML >