Share via


CRenderTarget-klasse

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 ID2D1RenderTarget.

Syntaxis

class CRenderTarget : public CObject;

Leden

Openbare constructors

Naam Description
CRenderTarget::CRenderTarget Maakt een CRenderTarget-object.
CRenderTarget::~CRenderTarget De destructor. Aangeroepen wanneer een renderdoelobject wordt vernietigd.

Openbare methoden

Naam Description
CRenderTarget::Attach Bestaande renderdoelinterface koppelen aan het object
CRenderTarget::BeginDraw Hiermee wordt een tekening gestart op dit renderdoel.
CRenderTarget::Clear Hiermee wordt het tekengebied gewist naar de opgegeven kleur.
CRenderTarget::COLORREF_TO_D2DCOLOR Converteert GDI-kleur- en alfawaarden naar het D2D1_COLOR_F-object.
CRenderTarget::CreateCompatibleRenderTarget Hiermee maakt u een nieuw bitmapweergavedoel voor gebruik tijdens een tussenliggende offscreen-tekening die compatibel is met het huidige renderdoel.
CRenderTarget::D estroy Hiermee verwijdert u een of meer resources
CRenderTarget::D etach De doelinterface van het object loskoppelen
CRenderTarget::D rawBitmap Hiermee tekent u de opgemaakte tekst die wordt beschreven door het opgegeven IDWriteTextLayout-object.
CRenderTarget::D rawEllipse Hiermee tekent u de omtrek van het opgegeven beletselteken met behulp van de opgegeven lijnstijl.
CRenderTarget::D rawGeometry Hiermee tekent u de omtrek van de opgegeven geometrie met behulp van de opgegeven lijnstijl.
CRenderTarget::D rawGlyphRun Hiermee tekent u de opgegeven glyphs.
CRenderTarget::D rawLine Hiermee tekent u een lijn tussen de opgegeven punten met behulp van de opgegeven lijnstijl.
CRenderTarget::D rawRectangle Hiermee tekent u het overzicht van een rechthoek met de opgegeven dimensies en lijnstijl.
CRenderTarget::D rawRoundedRectangle Hiermee tekent u het overzicht van de opgegeven afgeronde rechthoek met behulp van de opgegeven lijnstijl.
CRenderTarget::D rawText Hiermee tekent u de opgegeven tekst met behulp van de indelingsgegevens van een IDWriteTextFormat-object.
CRenderTarget::D rawTextLayout Hiermee tekent u de opgemaakte tekst die wordt beschreven door het opgegeven IDWriteTextLayout-object.
CRenderTarget::EndDraw Hiermee worden tekenbewerkingen op het renderdoel beëindigd en wordt de huidige foutstatus en de bijbehorende tags aangegeven.
CRenderTarget::FillEllipse Schildert het interieur van het opgegeven beletselteken.
CRenderTarget::FillGeometry Schildert het interieur van de opgegeven geometrie.
CRenderTarget::FillMesh Schildert het interieur van de opgegeven mesh.
CRenderTarget::FillOpacityMask Past het dekkingsmasker dat wordt beschreven door de opgegeven bitmap toe op een borstel en gebruikt die borstel om een gebied van het renderdoel te schilderen.
CRenderTarget::FillRectangle Schildert het interieur van de opgegeven rechthoek.
CRenderTarget::FillRoundedRectangle Schildert het interieur van de opgegeven afgeronde rechthoek.
CRenderTarget::Flush Hiermee worden alle tekenopdrachten uitgevoerd die in behandeling zijn.
CRenderTarget::GetAntialiasMode Hiermee haalt u de huidige antialiasingmodus op voor niet-teksttekeningsbewerkingen.
CRenderTarget::GetDpi Retourneert de dots per inch van het renderdoel (DPI)
CRenderTarget::GetMaximumBitmapSize Hiermee haalt u de maximale grootte, in apparaatafhankelijke eenheden (pixels), op van een bitmapdimensie die wordt ondersteund door het renderdoel
CRenderTarget::Get PixelFormat Haalt de pixelindeling en de alfamodus van het renderdoel op
CRenderTarget::Get PixelSize Retourneert de grootte van het renderdoel in pixels van het apparaat
CRenderTarget::GetRenderTarget Retourneert ID2D1RenderTarget-interface
CRenderTarget::GetSize Retourneert de grootte van het renderdoel in apparaatonafhankelijke pixels
CRenderTarget::GetTags Hiermee haalt u het label op voor volgende tekenbewerkingen.
CRenderTarget::GetTextAntialiasMode Hiermee haalt u de huidige antialiasingmodus op voor tekst- en glyph-tekenbewerkingen.
CRenderTarget::GetTextRenderingParams Hiermee haalt u de huidige opties voor tekstweergave van het renderdoel op.
CRenderTarget::GetTransform Hiermee past u de opgegeven transformatie toe op het renderdoel en vervangt u de bestaande transformatie. Alle volgende tekenbewerkingen vinden plaats in de getransformeerde ruimte.
CRenderTarget::IsSupported Geeft aan of het renderdoel de opgegeven eigenschappen ondersteunt
CRenderTarget::IsValid Controleert de geldigheid van resources
CRenderTarget::P opAxisAlignedClip Hiermee verwijdert u de laatste uitgelijnde clip uit het renderdoel. Nadat deze methode is aangeroepen, wordt de clip niet meer toegepast op volgende tekenbewerkingen.
CRenderTarget::P opLayer Stopt met het omleiden van tekenbewerkingen naar de laag die is opgegeven door de laatste PushLayer-aanroep.
CRenderTarget::P ushAxisAlignedClip Hiermee verwijdert u de laatste uitgelijnde clip uit het renderdoel. Nadat deze methode is aangeroepen, wordt de clip niet meer toegepast op volgende tekenbewerkingen.
CRenderTarget::P ushLayer Hiermee voegt u de opgegeven laag toe aan het renderdoel, zodat alle volgende tekenbewerkingen worden ontvangen totdat PopLayer wordt aangeroepen.
CRenderTarget::RestoreDrawingState Hiermee stelt u de tekenstatus van het renderdoel in op die van de opgegeven ID2D1DrawingStateBlock.
CRenderTarget::SaveDrawingState Hiermee wordt de huidige tekenstatus opgeslagen in het opgegeven ID2D1DrawingStateBlock.
CRenderTarget::SetAntialiasMode Hiermee stelt u de antialiasingmodus van het renderdoel in. De antialiasingmodus is van toepassing op alle volgende tekenbewerkingen, met uitzondering van tekst- en glyph-tekenbewerkingen.
CRenderTarget::SetDpi Hiermee stelt u de dots per inch (DPI) van het renderdoel in.
CRenderTarget::SetTags Hiermee geeft u een label op voor volgende tekenbewerkingen.
CRenderTarget::SetTextAntialiasMode Hiermee geeft u de antialiasingmodus op die moet worden gebruikt voor volgende tekst- en glyph-tekenbewerkingen.
CRenderTarget::SetTextRenderingParams Hiermee geeft u opties voor tekstweergave op die moeten worden toegepast op alle volgende tekst- en glyph-tekenbewerkingen.
CRenderTarget::SetTransform Overbelast. Hiermee past u de opgegeven transformatie toe op het renderdoel en vervangt u de bestaande transformatie. Alle volgende tekenbewerkingen vinden plaats in de getransformeerde ruimte.

Beveiligde methoden

Naam Description
CRenderTarget::VerifyResource Controleert de geldigheid van het CD2DResource-object; maakt het object als het nog niet bestaat.

Openbare operators

Naam Description
CRenderTarget::operator ID2D1RenderTarget* Retourneert ID2D1RenderTarget-interface

Beveiligde gegevensleden

Naam Description
CRenderTarget::m_lstResources Een lijst met aanwijzers naar CD2DResource-objecten.
CRenderTarget::m_pRenderTarget Een aanwijzer naar een ID2D1RenderTarget-object.
CRenderTarget::m_pTextFormatDefault Een aanwijzer naar CD2DTextFormat-object dat een standaardtekstindeling bevat.

Overnamehiërarchie

CObject

CRenderTarget

Requirements

Header: afxrendertarget.h

CRenderTarget::~CRenderTarget

De destructor. Aangeroepen wanneer een renderdoelobject wordt vernietigd.

virtual ~CRenderTarget();

CRenderTarget::Attach

Bestaande renderdoelinterface koppelen aan het object

void Attach(ID2D1RenderTarget* pRenderTarget);

Parameterwaarden

pRenderTarget
Bestaande renderdoelinterface. Kan niet NULL zijn

CRenderTarget::BeginDraw

Hiermee wordt een tekening gestart op dit renderdoel.

void BeginDraw();

CRenderTarget::Clear

Hiermee wordt het tekengebied gewist naar de opgegeven kleur.

void Clear(D2D1_COLOR_F color);

Parameterwaarden

kleur
De kleur waarop het tekengebied is gewist.

CRenderTarget::COLORREF_TO_D2DCOLOR

Converteert GDI-kleur- en alfawaarden naar het D2D1_COLOR_F-object.

static D2D1_COLOR_F COLORREF_TO_D2DCOLOR(
    COLORREF color,
    int nAlpha = 255);

Parameterwaarden

kleur
RGB-waarde.

nAlpha

Retourwaarde

D2D1_COLOR_F waarde.

CRenderTarget::CreateCompatibleRenderTarget

Hiermee maakt u een nieuw bitmapweergavedoel voor gebruik tijdens een tussenliggende offscreen-tekening die compatibel is met het huidige renderdoel.

BOOL CreateCompatibleRenderTarget(
    CBitmapRenderTarget& bitmapTarget,
    CD2DSizeF sizeDesired = CD2DSizeF(0., 0.),
    CD2DSizeU sizePixelDesired = CD2DSizeU(0, 0),
    D2D1_PIXEL_FORMAT* desiredFormat = NULL,
    D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS options = D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS_NONE);

Parameterwaarden

bitmapTarget
Wanneer deze methode wordt geretourneerd, bevat het adres van een aanwijzer naar een nieuw bitmapweergavedoel. Deze parameter wordt niet-geïnitialiseerd doorgegeven.

gewenste grootte
De gewenste grootte van het nieuwe renderdoel in apparaatonafhankelijke pixels als deze anders moet zijn dan het oorspronkelijke renderdoel, of NULL. Zie de sectie Opmerkingen voor meer informatie.

size PixelDesired
De gewenste grootte van het nieuwe renderdoel in pixels als dit anders moet zijn dan het oorspronkelijke renderdoel, of NULL. Zie de sectie Opmerkingen voor meer informatie.

desiredFormat
De gewenste pixelindeling en alfamodus van het nieuwe renderdoel of NULL. Als de pixelindeling is ingesteld op DXGI_FORMAT_UNKNOWN of als deze parameter null is, gebruikt het nieuwe renderdoel dezelfde pixelindeling als het oorspronkelijke renderdoel. Als de alfamodus is D2D1_ALPHA_MODE_UNKNOWN of deze parameter NULL is, wordt de alfamodus van het nieuwe renderdoel standaard ingesteld op D2D1_ALPHA_MODE_PREMULTIPLIED. Zie Ondersteunde pixelindelingen en alfamodi voor meer informatie over ondersteunde pixelindelingen.

Opties
Een waarde die aangeeft of het nieuwe renderdoel compatibel moet zijn met GDI.

Retourwaarde

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

CRenderTarget::CRenderTarget

Maakt een CRenderTarget-object.

CRenderTarget();

CRenderTarget::D estroy

Hiermee verwijdert u een of meer resources

BOOL Destroy(BOOL bDeleteResources = TRUE);

Parameterwaarden

bDeleteResources
Als bDeleteResources TRUE is, worden alle resources in m_lstResources automatisch vernietigd.

Retourwaarde

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

CRenderTarget::D etach

De doelinterface van het object loskoppelen

ID2D1RenderTarget* Detach ();

Retourwaarde

Aanwijzer om de doelinterface te ontkoppelen.

CRenderTarget::D rawBitmap

Hiermee tekent u de opgemaakte tekst die wordt beschreven door het opgegeven IDWriteTextLayout-object.

void DrawBitmap(
    CD2DBitmap* pBitmap,
    const CD2DRectF& rectDest,
    float fOpacity = 1.0,
    D2D1_BITMAP_INTERPOLATION_MODE interpolationMode = D2D1_BITMAP_INTERPOLATION_MODE_LINEAR,
    const CD2DRectF* pRectSrc = NULL);

Parameterwaarden

pBitmap
De bitmap die moet worden weergegeven.

rectDest
De grootte en positie, in apparaatonafhankelijke pixels in de coördinaatruimte van het renderdoel, van het gebied waarnaar de bitmap wordt getekend. Als de rechthoek niet goed is gerangschikt, wordt er niets getekend, maar het renderdoel voert geen foutstatus in.

fOpacity
Een waarde tussen 0,0f en 1,0f, inclusief, die een ondoorzichtigheidswaarde aangeeft die moet worden toegepast op de bitmap; deze waarde wordt vermenigvuldigd met de alfawaarden van de inhoud van de bitmap.

interpolationMode
De interpolatiemodus die moet worden gebruikt als de bitmap wordt geschaald of gedraaid door de tekenbewerking.

pRectSrc
De grootte en positie, in apparaatonafhankelijke pixels in de coördinaatruimte van de bitmap, van het gebied binnen de bitmap om te tekenen.

CRenderTarget::D rawEllipse

Hiermee tekent u de omtrek van het opgegeven beletselteken met behulp van de opgegeven lijnstijl.

void DrawEllipse(
    const CD2DEllipse& ellipse,
    CD2DBrush* pBrush,
    FLOAT fStrokeWidth = 1.0,
    ID2D1StrokeStyle* strokeStyle = NULL);

Parameterwaarden

Ellips
De positie en straal van het beletselteken om te tekenen, in apparaatonafhankelijke pixels.

pBrush
De kwast die wordt gebruikt om de omtrek van het beletselteken te schilderen.

fStrokeWidth
De dikte van de lijn van het beletselteken. De lijn is gecentreerd op het beletselteken.

strokeStyle
De stijl van de lijn die moet worden toegepast op de omtrek van het beletselteken of NULL om een ononderbroken lijn te schilderen.

CRenderTarget::D rawGeometry

Hiermee tekent u de omtrek van de opgegeven geometrie met behulp van de opgegeven lijnstijl.

void DrawGeometry(
    CD2DGeometry* pGeometry,
    CD2DBrush* pBrush,
    FLOAT fStrokeWidth = 1.0,
    ID2D1StrokeStyle* strokeStyle = NULL);

Parameterwaarden

pGeometry
De geometrie die moet worden getekend.

pBrush
De kwast die wordt gebruikt om de meetlijn van de geometrie te schilderen.

fStrokeWidth
De dikte van de geometriestreek. De lijn is gecentreerd op het omtrek van de geometrie.

strokeStyle
De stijl van de lijn die moet worden toegepast op het kader van de geometrie of NULL om een ononderbroken lijn te schilderen.

CRenderTarget::D rawGlyphRun

Hiermee tekent u de opgegeven glyphs.

void DrawGlyphRun(
    const CD2DPointF& ptBaseLineOrigin,
    const DWRITE_GLYPH_RUN& glyphRun,
    CD2DBrush* pForegroundBrush,
    DWRITE_MEASURING_MODE measuringMode = DWRITE_MEASURING_MODE_NATURAL);

Parameterwaarden

ptBaseLineOrigin
De oorsprong, in apparaatonafhankelijke pixels, van de basislijn van de glyphs.

glyphRun
De te renderen glyphs.

pForegroundBrush
De borstel die wordt gebruikt om de opgegeven glyphs te schilderen.

measuringMode
Een waarde die aangeeft hoe glyph-metrische gegevens worden gebruikt om tekst te meten wanneer deze is opgemaakt. De standaardwaarde is DWRITE_MEASURING_MODE_NATURAL.

CRenderTarget::D rawLine

Hiermee tekent u een lijn tussen de opgegeven punten met behulp van de opgegeven lijnstijl.

void DrawLine(
    const CD2DPointF& ptFrom,
    const CD2DPointF& ptTo,
    CD2DBrush* pBrush,
    FLOAT fStrokeWidth = 1.0,
    ID2D1StrokeStyle* strokeStyle = NULL);

Parameterwaarden

ptFrom
Het beginpunt van de lijn, in apparaatonafhankelijke pixels.

ptTo
Het eindpunt van de lijn, in apparaatonafhankelijke pixels.

pBrush
Het penseel dat wordt gebruikt om de lijnstreek te schilderen.

fStrokeWidth
Een waarde groter dan of gelijk aan 0,0f die de breedte van de lijn aangeeft. Als deze parameter niet is opgegeven, wordt deze standaard ingesteld op 1.0f. De lijn is gecentreerd op de lijn.

strokeStyle
De stijl van lijn om te schilderen of NULL om een ononderbroken lijn te schilderen.

CRenderTarget::D rawRectangle

Hiermee tekent u het overzicht van een rechthoek met de opgegeven dimensies en lijnstijl.

void DrawRectangle(
    const CD2DRectF& rectangle,
    CD2DBrush* pBrush,
    FLOAT fStrokeWidth = 1.0,
    ID2D1StrokeStyle* strokeStyle = NULL);

Parameterwaarden

Rechthoek
De afmetingen van de rechthoek om te tekenen, in apparaatonafhankelijke pixels

pBrush
Het penseel dat wordt gebruikt om de lijn van de rechthoek te schilderen

fStrokeWidth
Een waarde groter dan of gelijk aan 0,0f die de breedte van de lijn van de rechthoek aangeeft. De lijn is gecentreerd op het kader van de rechthoek.

strokeStyle
De stijl van pennenstreken om te schilderen of NULL om een ononderbroken lijn te schilderen.

CRenderTarget::D rawRoundedRectangle

Hiermee tekent u het overzicht van de opgegeven afgeronde rechthoek met behulp van de opgegeven lijnstijl.

void DrawRoundedRectangle(
    const CD2DRoundedRect& rectRounded,
    CD2DBrush* pBrush,
    FLOAT fStrokeWidth = 1.0,
    ID2D1StrokeStyle* strokeStyle = NULL);

Parameterwaarden

rectRounded
De afmetingen van de afgeronde rechthoek om te tekenen, in apparaatonafhankelijke pixels.

pBrush
Het penseel dat wordt gebruikt om de omtrek van de afgeronde rechthoek te schilderen.

fStrokeWidth
De breedte van de afgeronde rechthoek. De lijn is gecentreerd op de omtrek van de afgeronde rechthoek. De standaardwaarde is 1,0f.

strokeStyle
De stijl van de afgeronde rechthoek of NULL om een ononderbroken lijn te schilderen. De standaardwaarde is NULL.

CRenderTarget::D rawText

Hiermee tekent u de opgegeven tekst met behulp van de indelingsgegevens van een IDWriteTextFormat-object.

void DrawText(
    const CString& strText,
    const CD2DRectF& rectangle,
    CD2DBrush* pForegroundBrush,
    CD2DTextFormat* textFormat = NULL,
    D2D1_DRAW_TEXT_OPTIONS options = D2D1_DRAW_TEXT_OPTIONS_NONE,
    DWRITE_MEASURING_MODE measuringMode = DWRITE_MEASURING_MODE_NATURAL);

Parameterwaarden

strText
Een aanwijzer naar een matrix met Unicode-tekens die u wilt tekenen.

Rechthoek
De grootte en positie van het gebied waarin de tekst wordt getekend.

pForegroundBrush
De kwast die wordt gebruikt om de tekst te schilderen.

Textformat
Een object waarin de opmaakdetails van de tekst worden beschreven die moeten worden getekend, zoals het lettertype, de tekengrootte en de stroomrichting.

Opties
Een waarde die aangeeft of de tekst moet worden uitgelijnd op pixelgrenzen en of de tekst moet worden geknipt naar de rechthoek van de indeling. De standaardwaarde is D2D1_DRAW_TEXT_OPTIONS_NONE, wat aangeeft dat tekst moet worden uitgelijnd op pixelgrenzen en dat deze niet mag worden geknipt naar de rechthoek van de indeling.

measuringMode
Een waarde die aangeeft hoe glyph-metrische gegevens worden gebruikt om tekst te meten wanneer deze is opgemaakt. De standaardwaarde is DWRITE_MEASURING_MODE_NATURAL.

CRenderTarget::D rawTextLayout

Hiermee tekent u de opgemaakte tekst die wordt beschreven door het opgegeven IDWriteTextLayout-object.

void DrawTextLayout(
    const CD2DPointF& ptOrigin,
    CD2DTextLayout* textLayout,
    CD2DBrush* pBrushForeground,
    D2D1_DRAW_TEXT_OPTIONS options = D2D1_DRAW_TEXT_OPTIONS_NONE);

Parameterwaarden

ptOrigin
Het punt, beschreven in apparaatonafhankelijke pixels, waar de linkerbovenhoek van de tekst die wordt beschreven door textLayout wordt getekend.

textLayout
De opgemaakte tekst die moet worden getekend. Tekeneffecten die niet overnemen van ID2D1Resource, worden genegeerd. Als er tekeneffecten zijn die overnemen van ID2D1Resource die geen borstels zijn, mislukt deze methode en krijgt het renderdoel een foutstatus.

pBrushVoorgrond
Het penseel dat wordt gebruikt voor het schilderen van tekst in textLayout waaraan nog geen penseel is gekoppeld als tekeneffect (opgegeven door de methode IDWriteTextLayout::SetDrawingEffect).

Opties
Een waarde die aangeeft of de tekst moet worden uitgelijnd op pixelgrenzen en of de tekst moet worden geknipt naar de rechthoek van de indeling. De standaardwaarde is D2D1_DRAW_TEXT_OPTIONS_NONE, wat aangeeft dat tekst moet worden uitgelijnd op pixelgrenzen en dat deze niet mag worden geknipt naar de rechthoek van de indeling.

CRenderTarget::EndDraw

Hiermee worden tekenbewerkingen op het renderdoel beëindigd en wordt de huidige foutstatus en de bijbehorende tags aangegeven.

HRESULT EndDraw();

Retourwaarde

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

CRenderTarget::FillEllipse

Schildert het interieur van het opgegeven beletselteken.

void FillEllipse(
    const CD2DEllipse& ellipse,
    CD2DBrush* pBrush);

Parameterwaarden

Ellips
De positie en radius, in apparaatonafhankelijke pixels, van het beletselteken om te schilderen.

pBrush
De borstel die wordt gebruikt om het interieur van het beletselteken te schilderen.

CRenderTarget::FillGeometry

Schildert het interieur van de opgegeven geometrie.

void FillGeometry(
    CD2DGeometry* pGeometry,
    CD2DBrush* pBrush,
    CD2DBrush* pOpacityBrush = NULL);

Parameterwaarden

pGeometry
De geometrie om te schilderen.

pBrush
De kwast die gebruikt werd om het interieur van de geometrie te schilderen.

pOpacityBrush
Het dekkingsmasker dat moet worden toegepast op de geometrie; NULL voor geen dekkingsmasker. Als een dekkingsmasker (de parameter opacityBrush) is opgegeven, moet brush een ID2D1BitmapBrush zijn die de x- en y-uitbreidingsmodi heeft ingesteld op D2D1_EXTEND_MODE_CLAMP. Zie de sectie Opmerkingen voor meer informatie.

CRenderTarget::FillMesh

Schildert het interieur van de opgegeven mesh.

void FillMesh(
    CD2DMesh* pMesh,
    CD2DBrush* pBrush);

Parameterwaarden

pMesh
De mesh om te schilderen.

pBrush
De kwast die gebruikt werd om de mesh te schilderen.

CRenderTarget::FillOpacityMask

Past het dekkingsmasker dat wordt beschreven door de opgegeven bitmap toe op een borstel en gebruikt die borstel om een gebied van het renderdoel te schilderen.

void FillOpacityMask(
    CD2DBitmap* pOpacityMask,
    CD2DBrush* pBrush,
    D2D1_OPACITY_MASK_CONTENT content,
    const CD2DRectF& rectDest,
    const CD2DRectF& rectSrc);

Parameterwaarden

pOpacityMask
De positie en radius, in apparaatonafhankelijke pixels, van het beletselteken om te schilderen.

pBrush
Het penseel dat wordt gebruikt om het gebied van het renderdoel te schilderen dat is opgegeven door destinationRectangle.

inhoud
Het type inhoud dat het dekkingsmasker bevat. De waarde wordt gebruikt om de kleurruimte te bepalen waarin het dekkingsmasker wordt gemengd.

rectDest
Het gebied van het renderdoel om te schilderen, in apparaatonafhankelijke pixels.

rectSrc
Het gebied van de bitmap dat moet worden gebruikt als het dekkingsmasker, in apparaatonafhankelijke pixels.

CRenderTarget::FillRectangle

Schildert het interieur van de opgegeven rechthoek.

void FillRectangle(
    const CD2DRectF& rectangle,
    CD2DBrush* pBrush);

Parameterwaarden

Rechthoek
De dimensie van de rechthoek om te schilderen, in apparaatonafhankelijke pixels.

pBrush
De borstel die wordt gebruikt om het interieur van de rechthoek te schilderen.

CRenderTarget::FillRoundedRectangle

Schildert het interieur van de opgegeven afgeronde rechthoek.

void FillRoundedRectangle(
    const CD2DRoundedRect& rectRounded,
    CD2DBrush* pBrush);

Parameterwaarden

rectRounded
De afmetingen van de afgeronde rechthoek om te schilderen, in apparaatonafhankelijke pixels.

pBrush
De borstel die wordt gebruikt om het interieur van de afgeronde rechthoek te schilderen.

CRenderTarget::Flush

Hiermee worden alle tekenopdrachten uitgevoerd die in behandeling zijn.

void Flush(
    D2D1_TAG* tag1 = NULL,
    D2D1_TAG* tag2 = NULL);

Parameterwaarden

tag1
Bevat de tag voor tekenbewerkingen die fouten hebben veroorzaakt of 0 als er geen fouten zijn. Deze parameter wordt niet-geïnitialiseerd doorgegeven.

tag2
Bevat de tag voor tekenbewerkingen die fouten hebben veroorzaakt of 0 als er geen fouten zijn. Deze parameter wordt niet-geïnitialiseerd doorgegeven.

CRenderTarget::GetAntialiasMode

Hiermee haalt u de huidige antialiasingmodus op voor niet-teksttekeningsbewerkingen.

D2D1_ANTIALIAS_MODE GetAntialiasMode() const;

Retourwaarde

Huidige antialiasingmodus voor tekenbewerkingen zonder tekst.

CRenderTarget::GetDpi

Retourneert de dots per inch van het renderdoel (DPI)

CD2DSizeF GetDpi() const;

Retourwaarde

De dots per inch (DPI) van het renderdoel.

CRenderTarget::GetMaximumBitmapSize

Hiermee haalt u de maximale grootte, in apparaatafhankelijke eenheden (pixels), op van een bitmapdimensie die wordt ondersteund door het renderdoel

UINT32 GetMaximumBitmapSize() const;

Retourwaarde

De maximale grootte, in pixels, van een bitmapdimensie die wordt ondersteund door het renderdoel

CRenderTarget::Get PixelFormat

Haalt de pixelindeling en de alfamodus van het renderdoel op

D2D1_PIXEL_FORMAT GetPixelFormat() const;

Retourwaarde

De pixelindeling en de alfamodus van het renderdoel

CRenderTarget::Get PixelSize

Retourneert de grootte van het renderdoel in pixels van het apparaat

CD2DSizeU GetPixelSize() const;

Retourwaarde

De grootte van het renderdoel in pixels van het apparaat

CRenderTarget::GetRenderTarget

Retourneert ID2D1RenderTarget-interface

ID2D1RenderTarget* GetRenderTarget();

Retourwaarde

Aanwijzer naar een ID2D1RenderTarget-interface of NULL als het object nog niet is geïnitialiseerd.

CRenderTarget::GetSize

Retourneert de grootte van het renderdoel in apparaatonafhankelijke pixels

CD2DSizeF GetSize() const;

Retourwaarde

De huidige grootte van het renderdoel in apparaatonafhankelijke pixels

CRenderTarget::GetTags

Hiermee haalt u het label op voor volgende tekenbewerkingen.

void GetTags(
    D2D1_TAG* tag1 = NULL,
    D2D1_TAG* tag2 = NULL) const;

Parameterwaarden

tag1
Bevat het eerste label voor volgende tekenbewerkingen. Deze parameter wordt niet-geïnitialiseerd doorgegeven. Als NULL is opgegeven, wordt er geen waarde opgehaald voor deze parameter.

tag2
Bevat het tweede label voor volgende tekenbewerkingen. Deze parameter wordt niet-geïnitialiseerd doorgegeven. Als NULL is opgegeven, wordt er geen waarde opgehaald voor deze parameter.

CRenderTarget::GetTextAntialiasMode

Hiermee haalt u de huidige antialiasingmodus op voor tekst- en glyph-tekenbewerkingen.

D2D1_TEXT_ANTIALIAS_MODE GetTextAntialiasMode() const;

Retourwaarde

Huidige antialiasingmodus voor tekst- en glyph-tekenbewerkingen.

CRenderTarget::GetTextRenderingParams

Hiermee haalt u de huidige opties voor tekstweergave van het renderdoel op.

void GetTextRenderingParams(IDWriteRenderingParams** textRenderingParams);

Parameterwaarden

textRenderingParams
Wanneer deze methode wordt geretourneerd, bevat textRenderingParams het adres van een aanwijzer naar de huidige weergaveopties van het renderdoel.

CRenderTarget::GetTransform

Hiermee haalt u de huidige transformatie van het renderdoel op.

void GetTransform(D2D1_MATRIX_3X2_F* transform);

Parameterwaarden

transformeren
Wanneer dit wordt geretourneerd, bevat deze de huidige transformatie van het renderdoel. Deze parameter wordt niet-geïnitialiseerd doorgegeven.

CRenderTarget::IsSupported

Geeft aan of het renderdoel de opgegeven eigenschappen ondersteunt

BOOL IsSupported(const D2D1_RENDER_TARGET_PROPERTIES& renderTargetProperties) const;

Parameterwaarden

renderTargetProperties
De doeleigenschappen weergeven die moeten worden getest

Retourwaarde

TRUE als de opgegeven eigenschappen van het renderdoel worden ondersteund door dit renderdoel; anders, ONWAAR

CRenderTarget::IsValid

Controleert de geldigheid van resources

BOOL IsValid() const;

Retourwaarde

WAAR als de resource geldig is; anders ONWAAR.

CRenderTarget::m_lstResources

Een lijst met aanwijzers naar CD2DResource-objecten.

CObList m_lstResources;

CRenderTarget::m_pRenderTarget

Een aanwijzer naar een ID2D1RenderTarget-object.

ID2D1RenderTarget* m_pRenderTarget;

CRenderTarget::m_pTextFormatDefault

Een aanwijzer naar CD2DTextFormat-object dat een standaardtekstindeling bevat.

CD2DTextFormat* m_pTextFormatDefault;

CRenderTarget::operator ID2D1RenderTarget*

Retourneert ID2D1RenderTarget-interface

operator ID2D1RenderTarget*();

Retourwaarde

Aanwijzer naar een ID2D1RenderTarget-interface of NULL als het object nog niet is geïnitialiseerd.

CRenderTarget::P opAxisAlignedClip

Hiermee verwijdert u de laatste uitgelijnde clip uit het renderdoel. Nadat deze methode is aangeroepen, wordt de clip niet meer toegepast op volgende tekenbewerkingen.

void PopAxisAlignedClip();

CRenderTarget::P opLayer

Stopt met het omleiden van tekenbewerkingen naar de laag die is opgegeven door de laatste PushLayer-aanroep.

void PopLayer();

CRenderTarget::P ushAxisAlignedClip

Hiermee verwijdert u de laatste uitgelijnde clip uit het renderdoel. Nadat deze methode is aangeroepen, wordt de clip niet meer toegepast op volgende tekenbewerkingen.

void PushAxisAlignedClip(
    const CD2DRectF& rectClip,
    D2D1_ANTIALIAS_MODE mode = D2D1_ANTIALIAS_MODE_PER_PRIMITIVE);

Parameterwaarden

rectClip
De grootte en positie van het knipgebied, in apparaatonafhankelijke pixels.

mode
De antialiasingmodus die wordt gebruikt voor het tekenen van de randen van cliprechthoeken met sub pixelgrenzen en om de clip te combineren met de inhoud van de scène. De blending wordt eenmaal uitgevoerd wanneer de methode PopAxisAlignedClip wordt aangeroepen en is niet van toepassing op elke primitieve binnen de laag.

CRenderTarget::P ushLayer

Hiermee voegt u de opgegeven laag toe aan het renderdoel, zodat alle volgende tekenbewerkingen worden ontvangen totdat PopLayer wordt aangeroepen.

void PushLayer(
    const D2D1_LAYER_PARAMETERS& layerParameters,
    CD2DLayer& layer);

Parameterwaarden

layerParameters
De inhoudsgrenzen, geometrisch masker, dekking, dekkingsmasker en antialiasingopties voor de laag.

Laag
De laag die volgende tekenbewerkingen ontvangt.

CRenderTarget::RestoreDrawingState

Hiermee stelt u de tekenstatus van het renderdoel in op die van de opgegeven ID2D1DrawingStateBlock.

void RestoreDrawingState(ID2D1DrawingStateBlock& drawingStateBlock);

Parameterwaarden

drawingStateBlock
De nieuwe tekenstatus van het renderdoel.

CRenderTarget::SaveDrawingState

Hiermee wordt de huidige tekenstatus opgeslagen in het opgegeven ID2D1DrawingStateBlock.

void SaveDrawingState(ID2D1DrawingStateBlock& drawingStateBlock) const;

Parameterwaarden

drawingStateBlock
Wanneer deze methode wordt geretourneerd, bevat deze de huidige tekenstatus van het renderdoel. Deze parameter moet worden geïnitialiseerd voordat deze wordt doorgegeven aan de methode.

CRenderTarget::SetAntialiasMode

Hiermee stelt u de antialiasingmodus van het renderdoel in. De antialiasingmodus is van toepassing op alle volgende tekenbewerkingen, met uitzondering van tekst- en glyph-tekenbewerkingen.

void SetAntialiasMode(D2D1_ANTIALIAS_MODE antialiasMode);

Parameterwaarden

antialiasMode
De antialiasingmodus voor toekomstige tekenbewerkingen.

CRenderTarget::SetDpi

Hiermee stelt u de dots per inch (DPI) van het renderdoel in.

void SetDpi(const CD2DSizeF& sizeDPI);

Parameterwaarden

sizeDPI
Een waarde groter dan of gelijk aan nul die de horizontale/verticale DPI van het renderdoel aangeeft.

CRenderTarget::SetTags

Hiermee geeft u een label op voor volgende tekenbewerkingen.

void SetTags(
    D2D1_TAG tag1,
    D2D1_TAG tag2);

Parameterwaarden

tag1
Een label dat moet worden toegepast op volgende tekenbewerkingen.

tag2
Een label dat moet worden toegepast op volgende tekenbewerkingen.

CRenderTarget::SetTextAntialiasMode

Hiermee geeft u de antialiasingmodus op die moet worden gebruikt voor volgende tekst- en glyph-tekenbewerkingen.

void SetTextAntialiasMode(D2D1_TEXT_ANTIALIAS_MODE textAntialiasMode);

Parameterwaarden

textAntialiasMode
De antialiasingmodus die moet worden gebruikt voor volgende tekst- en glyph-tekenbewerkingen.

CRenderTarget::SetTextRenderingParams

Hiermee geeft u opties voor tekstweergave op die moeten worden toegepast op alle volgende tekst- en glyph-tekenbewerkingen.

void SetTextRenderingParams(IDWriteRenderingParams* textRenderingParams = NULL);

Parameterwaarden

textRenderingParams
De opties voor tekstweergave die moeten worden toegepast op alle volgende tekst- en glyph-tekenbewerkingen; NULL om de huidige opties voor tekstweergave te wissen.

CRenderTarget::SetTransform

Hiermee past u de opgegeven transformatie toe op het renderdoel en vervangt u de bestaande transformatie. Alle volgende tekenbewerkingen vinden plaats in de getransformeerde ruimte.

void SetTransform(const D2D1_MATRIX_3X2_F* transform);
void SetTransform(const D2D1_MATRIX_3X2_F& transform);

Parameterwaarden

transformeren
De transformatie die moet worden toegepast op het renderdoel.

CRenderTarget::VerifyResource

Controleert de geldigheid van het CD2DResource-object; maakt het object als het nog niet bestaat.

BOOL VerifyResource(CD2DResource* pResource);

Parameterwaarden

pResource
Aanwijzer naar CD2DResource-object.

Retourwaarde

TRUE is object indien geldig; anders ONWAAR.

Zie ook

Klassen