IXRTextBlock::GetFontWeight (Compact 2013)

3/28/2014

This method retrieves the top-level font weight for this text block.

Syntax

virtual HRESULT STDMETHODCALLTYPE GetFontWeight(
    XRFontWeight* pFontWeight
) = 0;

Parameters

  • pFontWeight
    [out] Pointer to an XRFontWeight enumerated type that indicates the top-level font weight for this text block.

Return Value

Returns an HRESULT that indicates success or failure.

Remarks

The value of pFontWeight can apply only to fonts that already exist in a font family. It does not programmatically create alternative weights, except when a family contains a regular weight and no bold weight. In this case, XAML for Windows Embedded will simulate a bold weight by increasing the width of the strokes by using a 2D graphic algorithm.

Note

The value of the pFontWeight might not be used for the font weight during rendering, because of font fallback. For example, if the font weight XRFontWeight_ExtraBlack is specified, but XRFontWeight_Bold is the closest font weight available, the value of pFontWeight is still XRFontWeight_ExtraBlack.

If you specified a different font weight value for a <Run> element in the source XAML for your application, it overrides this top-level setting.

.NET Framework Equivalent

System.Windows.Controls.TextBlock.FontWeight

Requirements

Header

XamlRuntime.h

sysgen

SYSGEN_XAML_RUNTIME

See Also

Reference

IXRTextBlock
IXRTextBlock::SetFontWeight