Klasse CD2DTextLayout

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Een wrapper voor IDWriteTextLayout.

Syntaxis

class CD2DTextLayout : public CD2DResource;

Leden

Openbare constructors

Naam	Description
CD2DTextLayout::CD2DTextLayout	Maakt een CD2DTextLayout-object.
CD2DTextLayout::~CD2DTextLayout	De destructor. Wordt aangeroepen wanneer een D2D-tekstindelingsobject wordt vernietigd.

Openbare methoden

Naam	Description
CD2DTextLayout::Create	Hiermee maakt u een CD2DTextLayout. (Overschrijft CD2DResource::Create.)
CD2DTextLayout::D estroy	Vernietigt een CD2DTextLayout-object. (Overschrijft CD2DResource::D estroy.)
CD2DTextLayout::Get	Hiermee wordt de interface IDWriteTextLayout geretourneerd
CD2DTextLayout::GetFontFamilyName	Hiermee kopieert u de naam van de lettertypefamilie van de tekst op de opgegeven positie.
CD2DTextLayout::GetLocaleName	Hiermee haalt u de landinstellingsnaam van de tekst op de opgegeven positie op.
CD2DTextLayout::IsValid	Controleert de geldigheid van resources (overschrijft CD2DResource::IsValid.)
CD2DTextLayout::ReCreate	Hiermee maakt u een CD2DTextLayout opnieuw. (Overschrijft CD2DResource::ReCreate.)
CD2DTextLayout::SetFontFamilyName	Hiermee stelt u de naam van de lettertypefamilie null in voor tekst binnen een opgegeven tekstbereik
CD2DTextLayout::SetLocaleName	Hiermee stelt u de landinstellingennaam voor tekst in een opgegeven tekstbereik in

Openbare operators

Naam	Description
CD2DTextLayout::operator IDWriteTextLayout*	Hiermee wordt de interface IDWriteTextLayout geretourneerd

Beveiligde gegevensleden

Naam	Description
CD2DTextLayout::m_pTextLayout	Een aanwijzer naar een IDWriteTextLayout.

Overnamehiërarchie

CObject

CD2DResource

CD2DTextLayout

Requirements

Header: afxrendertarget.h

CD2DTextLayout::~CD2DTextLayout

De destructor. Wordt aangeroepen wanneer een D2D-tekstindelingsobject wordt vernietigd.

virtual ~CD2DTextLayout();

CD2DTextLayout::CD2DTextLayout

Maakt een CD2DTextLayout-object.

CD2DTextLayout(
    CRenderTarget* pParentTarget,
    const CString& strText,
    CD2DTextFormat& textFormat,
    const CD2DSizeF& sizeMax,
    BOOL bAutoDestroy = TRUE);

Parameterwaarden

pParentTarget
Een aanwijzer naar het renderdoel.

strText
Een CString-object met de tekenreeks waaruit een nieuw CD2DTextLayout-object moet worden gemaakt.

Textformat
Een CString-object dat de indeling bevat die moet worden toegepast op de tekenreeks.

sizeMax
De grootte van het indelingsvak.

bAutoDestroy
Geeft aan dat het object wordt vernietigd door eigenaar (pParentTarget).

CD2DTextLayout::Create

Hiermee maakt u een CD2DTextLayout.

virtual HRESULT Create(CRenderTarget* */);

Retourwaarde

Als de methode slaagt, wordt S_OK geretourneerd. Anders wordt een HRESULT-foutcode geretourneerd.

CD2DTextLayout::D estroy

Vernietigt een CD2DTextLayout-object.

virtual void Destroy();

CD2DTextLayout::Get

Hiermee wordt de interface IDWriteTextLayout geretourneerd

IDWriteTextLayout* Get();

Retourwaarde

Wijs een IDWriteTextLayout-interface of NULL aan als het object nog niet is geïnitialiseerd.

CD2DTextLayout::GetFontFamilyName

Hiermee kopieert u de naam van de lettertypefamilie van de tekst op de opgegeven positie.

CString GetFontFamilyName(
    UINT32 currentPosition,
    DWRITE_TEXT_RANGE* textRange = NULL) const;

Parameterwaarden

currentPosition
De positie van de tekst die moet worden onderzocht.

Textrange
Het tekstbereik met dezelfde opmaak als de tekst op de positie die is opgegeven door currentPosition. Dit betekent dat de uitvoering de exacte opmaak heeft als de opgegeven positie, inclusief maar niet beperkt tot de naam van de lettertypefamilie.

Retourwaarde

CString-object dat de naam van de huidige lettertypefamilie bevat.

CD2DTextLayout::GetLocaleName

Hiermee haalt u de landinstellingsnaam van de tekst op de opgegeven positie op.

CString GetLocaleName(
    UINT32 currentPosition,
    DWRITE_TEXT_RANGE* textRange = NULL) const;

Parameterwaarden

currentPosition
De positie van de tekst die moet worden gecontroleerd.

Textrange
Het tekstbereik met dezelfde opmaak als de tekst op de positie die is opgegeven door currentPosition. Dit betekent dat de uitvoering de exacte opmaak heeft als de opgegeven positie, inclusief maar niet beperkt tot de landinstellingsnaam.

Retourwaarde

CString-object dat de naam van de huidige landinstelling bevat.

CD2DTextLayout::IsValid

Controleert de geldigheid van resources

virtual BOOL IsValid() const;

Retourwaarde

WAAR als de resource geldig is; anders ONWAAR.

CD2DTextLayout::m_pTextLayout

Een aanwijzer naar een IDWriteTextLayout.

IDWriteTextLayout* m_pTextLayout;

CD2DTextLayout::operator IDWriteTextLayout*

Hiermee wordt de interface IDWriteTextLayout geretourneerd

operator IDWriteTextLayout*();

Retourwaarde

Wijs een IDWriteTextLayout-interface of NULL aan als het object nog niet is geïnitialiseerd.

CD2DTextLayout::ReCreate

Hiermee maakt u een CD2DTextLayout opnieuw.

virtual HRESULT ReCreate(CRenderTarget* */);

Retourwaarde

Als de methode slaagt, wordt S_OK geretourneerd. Anders wordt een HRESULT-foutcode geretourneerd.

CD2DTextLayout::SetFontFamilyName

Hiermee stelt u de naam van de lettertypefamilie null in voor tekst binnen een opgegeven tekstbereik

BOOL SetFontFamilyName(
    LPCWSTR pwzFontFamilyName,
    DWRITE_TEXT_RANGE textRange);

Parameterwaarden

pwzFontFamilyName
De naam van de lettertypefamilie die van toepassing is op de hele tekenreeks binnen het bereik dat is opgegeven door textRange

Textrange
Tekstbereik waarop deze wijziging van toepassing is

Retourwaarde

Als de methode slaagt, wordt TRUE geretourneerd. Anders wordt ONWAAR geretourneerd

CD2DTextLayout::SetLocaleName

Hiermee stelt u de landinstellingennaam voor tekst in een opgegeven tekstbereik in

BOOL SetLocaleName(
    LPCWSTR pwzLocaleName,
    DWRITE_TEXT_RANGE textRange);

Parameterwaarden

pwzLocaleName
Een tekenreeks voor landinstellingen die is beëindigd met null

Textrange
Tekstbereik waarop deze wijziging van toepassing is

Retourwaarde

Als de methode slaagt, wordt TRUE geretourneerd. Anders wordt ONWAAR geretourneerd

Zie ook

Klassen