Klasa CRenderTarget

Artykuł
10/12/2023

Otoka id2D1RenderTarget.

Składnia

class CRenderTarget : public CObject;

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko	opis
CRenderTarget::CRenderTarget	Tworzy obiekt CRenderTarget.
CRenderTarget::~CRenderTarget	Destruktora. Wywoływana, gdy obiekt docelowy renderowania jest niszczony.

Metody publiczne

Nazwa/nazwisko	opis
CRenderTarget::Attach	Dołącza istniejący interfejs docelowy renderowania do obiektu
CRenderTarget::BeginDraw	Inicjuje rysunek na tym obiekcie docelowym renderowania.
CRenderTarget::Clear	Czyści obszar rysunku do określonego koloru.
CRenderTarget::COLORREF_TO_D2DCOLOR	Konwertuje wartości koloru GDI i alfa na obiekt D2D1_COLOR_F.
CRenderTarget::CreateCompatibleRenderTarget	Tworzy nowy obiekt docelowy renderowania mapy bitowej do użycia podczas pośredniego rysunku poza ekranem, który jest zgodny z bieżącym obiektem docelowym renderowania .
CRenderTarget::D estroy	Usuwa co najmniej jeden zasób
CRenderTarget::D etach	Odłącza interfejs docelowy renderowania od obiektu
CRenderTarget::D rawBitmap	Rysuje sformatowany tekst opisany przez określony obiekt IDWriteTextLayout.
CRenderTarget::D rawEllipse	Rysuje kontur określonego wielokropka przy użyciu określonego stylu pociągnięcia.
CRenderTarget::D rawGeometry	Rysuje kontur określonej geometrii przy użyciu określonego stylu pociągnięcia.
CRenderTarget::D rawGlyphRun	Rysuje określone glify.
CRenderTarget::D rawLine	Rysuje linię między określonymi punktami przy użyciu określonego stylu pociągnięcia.
CRenderTarget::D rawRectangle	Rysuje kontur prostokąta, który ma określone wymiary i styl pociągnięcia.
CRenderTarget::D rawRoundedRectangle	Rysuje kontur określonego zaokrąglonego prostokąta przy użyciu określonego stylu pociągnięcia.
CRenderTarget::D rawText	Rysuje określony tekst przy użyciu informacji o formacie dostarczonym przez obiekt IDWriteTextFormat.
CRenderTarget::D rawTextLayout	Rysuje sformatowany tekst opisany przez określony obiekt IDWriteTextLayout.
CRenderTarget::EndDraw	Kończy operacje rysowania na obiekcie docelowym renderowania i wskazuje bieżący stan błędu i skojarzone tagi.
CRenderTarget::FillEllipse	Maluje wnętrze określonego wielokropka.
CRenderTarget::FillGeometry	Maluje wnętrze określonej geometrii.
CRenderTarget::FillMesh	Maluje wnętrze określonej siatki.
CRenderTarget::FillOpacityMask	Stosuje maskę nieprzezroczystości opisaną przez określoną mapę bitową do pędzla i używa tego pędzla do malowania regionu docelowego renderowania.
CRenderTarget::FillRectangle	Maluje wnętrze określonego prostokąta.
CRenderTarget::FillRoundedRectangle	Maluje wnętrze określonego zaokrąglonego prostokąta.
CRenderTarget::Flush	Wykonuje wszystkie oczekujące polecenia rysunku.
CRenderTarget::GetAntialiasMode	Pobiera bieżący tryb antyaliasingowy dla operacji rysunku nietekstowego.
CRenderTarget::GetDpi	Zwraca kropki obiektu docelowego renderowania na cal (DPI)
CRenderTarget::GetMaximumBitmapSize	Pobiera maksymalny rozmiar w jednostkach zależnych od urządzenia (pikseli) dowolnego wymiaru mapy bitowej obsługiwanego przez obiekt docelowy renderowania
CRenderTarget::GetPixelFormat	Pobiera format pikseli i tryb alfa obiektu docelowego renderowania
CRenderTarget::GetPixelSize	Zwraca rozmiar obiektu docelowego renderowania w pikselach urządzenia
CRenderTarget::GetRenderTarget	Zwraca interfejs ID2D1RenderTarget
CRenderTarget::GetSize	Zwraca rozmiar obiektu docelowego renderowania w pikselach niezależnych od urządzenia
CRenderTarget::GetTags	Pobiera etykietę dla kolejnych operacji rysowania.
CRenderTarget::GetTextAntialiasMode	Pobiera bieżący tryb antyaliasingowy dla operacji rysowania tekstu i glyph.
CRenderTarget::GetTextRenderingParams	Pobiera bieżące opcje renderowania tekstu elementu docelowego renderowania.
CRenderTarget::GetTransform	Stosuje określone przekształcenie do obiektu docelowego renderowania, zastępując istniejącą transformację. Wszystkie kolejne operacje rysowania są wykonywane w przekształconej przestrzeni.
CRenderTarget::IsSupported	Wskazuje, czy obiekt docelowy renderowania obsługuje określone właściwości
CRenderTarget::IsValid	Sprawdza poprawność zasobów
CRenderTarget::P opAxisAlignedClip	Usuwa ostatni klip wyrównany do osi z obiektu docelowego renderowania. Po wywołaniu tej metody klip nie jest już stosowany do kolejnych operacji rysunku.
CRenderTarget::P opLayer	Zatrzymuje przekierowywanie operacji rysowania do warstwy określonej przez ostatnie wywołanie elementu PushLayer.
CRenderTarget::P ushAxisAlignedClip	Usuwa ostatni klip wyrównany do osi z obiektu docelowego renderowania. Po wywołaniu tej metody klip nie jest już stosowany do kolejnych operacji rysunku.
CRenderTarget::P ushLayer	Dodaje określoną warstwę do obiektu docelowego renderowania, aby odbierała wszystkie kolejne operacje rysowania do momentu wywołania elementu PopLayer.
CRenderTarget::RestoreDrawingState	Ustawia stan rysunku obiektu docelowego renderowania na określony identyfikator ID2D1DrawingStateBlock.
CRenderTarget::SaveDrawingState	Zapisuje bieżący stan rysunku w określonym identyfikatorze ID2D1DrawingStateBlock.
CRenderTarget::SetAntialiasMode	Ustawia tryb antyaliasingowy obiektu docelowego renderowania. Tryb antyaliasingowy ma zastosowanie do wszystkich kolejnych operacji rysowania, z wyłączeniem operacji rysowania tekstu i glyph.
CRenderTarget::SetDpi	Ustawia kropki na cal (DPI) obiektu docelowego renderowania.
CRenderTarget::SetTags	Określa etykietę dla kolejnych operacji rysowania.
CRenderTarget::SetTextAntialiasMode	Określa tryb antyaliasingu do użycia dla kolejnych operacji rysowania tekstu i glyph.
CRenderTarget::SetTextRenderingParams	Określa opcje renderowania tekstu, które mają być stosowane do wszystkich kolejnych operacji rysowania tekstu i glyph.
CRenderTarget::SetTransform	Przeciążone. Stosuje określone przekształcenie do obiektu docelowego renderowania, zastępując istniejącą transformację. Wszystkie kolejne operacje rysowania są wykonywane w przekształconej przestrzeni.

Metody chronione

Nazwa/nazwisko	opis
CRenderTarget::VerifyResource	Weryfikuje ważność obiektu CD2DResource; tworzy obiekt, jeśli jeszcze nie istnieje.

Operatory publiczne

Nazwa/nazwisko	opis
CRenderTarget::operator ID2D1RenderTarget*	Zwraca interfejs ID2D1RenderTarget

Chronione składowe danych

Nazwa/nazwisko	opis
CRenderTarget::m_lstResources	Lista wskaźników do obiektów CD2DResource.
CRenderTarget::m_pRenderTarget	Wskaźnik do obiektu ID2D1RenderTarget.
CRenderTarget::m_pTextFormatDefault	Wskaźnik do obiektu CD2DTextFormat, który zawiera domyślny format tekstu.

Hierarchia dziedziczenia

Obiekt CObject

CRenderTarget

Wymagania

Nagłówek: afxrendertarget.h

CRenderTarget::~CRenderTarget

Destruktora. Wywoływana, gdy obiekt docelowy renderowania jest niszczony.

virtual ~CRenderTarget();

CRenderTarget::Attach

Dołącza istniejący interfejs docelowy renderowania do obiektu

void Attach(ID2D1RenderTarget* pRenderTarget);

Parametry

pRenderTarget
Istniejący interfejs docelowy renderowania. Nie można mieć wartości NULL

CRenderTarget::BeginDraw

Inicjuje rysunek na tym obiekcie docelowym renderowania.

void BeginDraw();

CRenderTarget::Clear

Czyści obszar rysunku do określonego koloru.

void Clear(D2D1_COLOR_F color);

Parametry

Kolor
Kolor, do którego jest czyszczone pole rysunku.

CRenderTarget::COLORREF_TO_D2DCOLOR

Konwertuje wartości koloru GDI i alfa na obiekt D2D1_COLOR_F.

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

Parametry

Kolor
Wartość RGB.

nAlpha

Wartość zwracana

D2D1_COLOR_F wartość.

CRenderTarget::CreateCompatibleRenderTarget

Tworzy nowy obiekt docelowy renderowania mapy bitowej do użycia podczas pośredniego rysunku poza ekranem, który jest zgodny z bieżącym obiektem docelowym renderowania .

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);

Parametry

bitmapTarget
Gdy ta metoda zwraca, zawiera adres wskaźnika do nowego obiektu docelowego renderowania mapy bitowej. Ten parametr jest przekazywany jako niezainicjowany.

sizeDesired
Żądany rozmiar nowego elementu docelowego renderowania w pikselach niezależnych od urządzenia, jeśli powinien być inny niż oryginalny element docelowy renderowania lub wartość NULL. Aby uzyskać więcej informacji, zobacz sekcję: Uwagi.

sizePixelDesired
Żądany rozmiar nowego elementu docelowego renderowania w pikselach, jeśli powinien być inny niż oryginalny element docelowy renderowania lub wartość NULL. Aby uzyskać więcej informacji, zobacz sekcję: Uwagi.

desiredFormat
Żądany format pikseli i tryb alfa nowego obiektu docelowego renderowania lub wartość NULL. Jeśli format pikseli jest ustawiony na DXGI_FORMAT_UNKNOWN lub jeśli ten parametr ma wartość null, nowy obiekt docelowy renderowania używa tego samego formatu pikseli co oryginalny element docelowy renderowania. Jeśli tryb alfa jest D2D1_ALPHA_MODE_UNKNOWN lub ten parametr ma wartość NULL, tryb alfa nowego elementu docelowego renderowania domyślnie D2D1_ALPHA_MODE_PREMULTIPLIED. Aby uzyskać informacje o obsługiwanych formatach pikseli, zobacz Obsługiwane formaty pikseli i tryby alfa.

Opcje
Wartość określająca, czy nowy element docelowy renderowania musi być zgodny z GDI.

Wartość zwracana

Jeśli metoda powiedzie się, zwraca wartość TRUE. W przeciwnym razie zwraca wartość FALSE.

CRenderTarget::CRenderTarget

Tworzy obiekt CRenderTarget.

CRenderTarget();

CRenderTarget::D estroy

Usuwa co najmniej jeden zasób

BOOL Destroy(BOOL bDeleteResources = TRUE);

Parametry

bDeleteResources
Jeśli wartość bDeleteResources ma wartość TRUE, wszystkie zasoby znajdujące się w m_lstResources zostaną automatycznie zniszczone.

Wartość zwracana

Jeśli metoda powiedzie się, zwraca wartość TRUE. W przeciwnym razie zwraca wartość FALSE

CRenderTarget::D etach

Odłącza interfejs docelowy renderowania od obiektu

ID2D1RenderTarget* Detach ();

Wartość zwracana

Wskaźnik do odłączonego interfejsu docelowego renderowania.

CRenderTarget::D rawBitmap

Rysuje sformatowany tekst opisany przez określony obiekt IDWriteTextLayout.

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);

Parametry

Mapa pBit
Mapa bitowa do renderowania.

rectDest
Rozmiar i położenie w pikselach niezależnych od urządzenia w przestrzeni współrzędnej obiektu docelowego renderowania obszaru, do którego jest rysowana mapa bitowa. Jeśli prostokąt nie jest dobrze uporządkowany, nic nie jest rysowane, ale obiekt docelowy renderowania nie wprowadza stanu błędu.

Nieprzezroczystość
Wartość z zakresu od 0,0f do 1,0f włącznie, która określa wartość nieprzezroczystości, która ma być stosowana do mapy bitowej; ta wartość jest mnożona względem wartości alfa zawartości mapy bitowej.

interpolacjaMode
Tryb interpolacji do użycia, jeśli mapa bitowa jest skalowana lub obracana przez operację rysunku.

pRectSrc
Rozmiar i położenie w pikselach niezależnych od urządzenia w przestrzeni współrzędnej mapy bitowej obszaru w mapie bitowej do rysowania.

CRenderTarget::D rawEllipse

Rysuje kontur określonego wielokropka przy użyciu określonego stylu pociągnięcia.

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

Parametry

elipsa
Położenie i promień wielokropka do rysowania w pikselach niezależnych od urządzenia.

pBrush
Szczotka używana do malowania konturu wielokropka.

fStrokeWidth
Grubość pociągnięcia wielokropka. Pociągnięcie jest wyśrodkowane na kontur elipsy.

strokeStyle
Styl pociągnięcia do zastosowania do konturu wielokropka lub NULL w celu malowania solidnego pociągnięcia.

CRenderTarget::D rawGeometry

Rysuje kontur określonej geometrii przy użyciu określonego stylu pociągnięcia.

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

Parametry

pGeometry
Geometria do rysowania.

pBrush
Szczotka używana do malowania pociągnięcia geometrii.

fStrokeWidth
Grubość pociągnięcia geometrii. Pociągnięcie jest wyśrodkowane na konturie geometrii.

strokeStyle
Styl pociągnięcia, który ma być stosowany do konturu geometrii, lub null, aby malować solidny pociągnięcie.

CRenderTarget::D rawGlyphRun

Rysuje określone glify.

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

Parametry

ptBaseLineOrigin
Początek w pikselach niezależnych od urządzenia linii bazowej glifów.

glyphRun
Glify do renderowania.

pForegroundBrush
Szczotka używana do malowania określonych glifów.

measuringMode
Wartość wskazująca, jak są używane metryki glifów do mierzenia tekstu podczas jego formatowania. Wartość domyślna to DWRITE_MEASURING_MODE_NATURAL.

CRenderTarget::D rawLine

Rysuje linię między określonymi punktami przy użyciu określonego stylu pociągnięcia.

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

Parametry

ptFrom
Punkt początkowy linii w pikselach niezależnych od urządzenia.

ptTo
Punkt końcowy linii w pikselach niezależnych od urządzenia.

pBrush
Szczotka używana do malowania pociągnięcia linii.

fStrokeWidth
Wartość większa lub równa 0,0f, która określa szerokość pociągnięcia. Jeśli ten parametr nie zostanie określony, wartość domyślna to 1.0f. Pociągnięcie jest wyśrodkowane na linii.

strokeStyle
Styl pociągnięcia do malowania lub null do malowania linii stałej.

CRenderTarget::D rawRectangle

Rysuje kontur prostokąta, który ma określone wymiary i styl pociągnięcia.

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

Parametry

prostokąt
Wymiary prostokąta do rysowania w pikselach niezależnych od urządzenia

pBrush
Szczotka używana do malowania pociągnięcia prostokąta

fStrokeWidth
Wartość większa lub równa 0,0f, która określa szerokość pociągnięcia prostokąta. Pociągnięcie jest wyśrodkowane na obrysie prostokąta.

strokeStyle
Styl pociągnięcia do malowania lub null do malowania solidnego pociągnięcia.

CRenderTarget::D rawRoundedRectangle

Rysuje kontur określonego zaokrąglonego prostokąta przy użyciu określonego stylu pociągnięcia.

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

Parametry

rectRounded
Wymiary zaokrąglonego prostokąta do rysowania w pikselach niezależnych od urządzenia.

pBrush
Szczotka używana do malowania konturu zaokrąglonego prostokąta.

fStrokeWidth
Szerokość zaokrąglonego pociągnięcia prostokąta. Pociągnięcie jest wyśrodkowane na obramowanie zaokrąglonego prostokąta. Wartość domyślna to 1.0f.

strokeStyle
Styl pociągnięcia zaokrąglonego prostokąta lub null do malowania solidnego pociągnięcia. Wartość domyślna to NULL.

CRenderTarget::D rawText

Rysuje określony tekst przy użyciu informacji o formacie dostarczonym przez obiekt IDWriteTextFormat.

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);

Parametry

strText
Wskaźnik do tablicy znaków Unicode do rysowania.

prostokąt
Rozmiar i położenie obszaru, w którym jest rysowany tekst.

pForegroundBrush
Pędzl używany do malowania tekstu.

textFormat
Obiekt, który opisuje formatowanie szczegółów tekstu do rysowania, takich jak czcionka, rozmiar czcionki i kierunek przepływu.

Opcje
Wartość wskazująca, czy tekst powinien zostać przyciągnięty do granic pikseli i czy tekst powinien zostać przycięty do prostokąta układu. Wartość domyślna to D2D1_DRAW_TEXT_OPTIONS_NONE, która wskazuje, że tekst powinien zostać przycięty do granic pikseli i nie powinien być przycięty do prostokąta układu.

measuringMode
Wartość wskazująca, jak są używane metryki glifów do mierzenia tekstu podczas jego formatowania. Wartość domyślna to DWRITE_MEASURING_MODE_NATURAL.

CRenderTarget::D rawTextLayout

Rysuje sformatowany tekst opisany przez określony obiekt IDWriteTextLayout.

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

Parametry

ptOrigin
Punkt opisany w pikselach niezależnych od urządzenia, w którym rysowany jest lewy górny róg tekstu opisanego przez textLayout.

textLayout
Sformatowany tekst do rysowania. Wszystkie efekty rysowania, które nie dziedziczą z identyfikatora ID2D1Resource, są ignorowane. Jeśli istnieją efekty rysowania dziedziczone z id2D1Resource, które nie są szczotkami, ta metoda kończy się niepowodzeniem, a obiekt docelowy renderowania jest umieszczany w stanie błędu.

pBrushForeground
Pędzl używany do malowania dowolnego tekstu w textLayout, który nie ma jeszcze skojarzonego z nim pędzla jako efektu rysunku (określonego przez metodę IDWriteTextLayout::SetDrawingEffect).

CRenderTarget::EndDraw

Kończy operacje rysowania na obiekcie docelowym renderowania i wskazuje bieżący stan błędu i skojarzone tagi.

HRESULT EndDraw();

Wartość zwracana

Jeśli metoda powiedzie się, zwraca S_OK. W przeciwnym razie zwraca kod błędu HRESULT.

CRenderTarget::FillEllipse

Maluje wnętrze określonego wielokropka.

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

Parametry

elipsa
Położenie i promień w pikselach niezależnych od urządzenia wielokropka do malowania.

pBrush
Szczotka używana do malowania wnętrza wielokropka.

CRenderTarget::FillGeometry

Maluje wnętrze określonej geometrii.

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

Parametry

pGeometry
Geometria do malowania.

pBrush
Szczotka używana do malowania wnętrza geometrii.

pOpacityBrush
Maska nieprzezroczystości do zastosowania do geometrii; Wartość NULL dla maski nieprzezroczystości. Jeśli określono maskę nieprzezroczystości (parametr opacityBrush), szczotka musi być identyfikatorem ID2D1BitmapBrush, który ma tryby x-i y-extend ustawione na D2D1_EXTEND_MODE_CLAMP. Aby uzyskać więcej informacji, zobacz sekcję: Uwagi.

CRenderTarget::FillMesh

Maluje wnętrze określonej siatki.

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

Parametry

pMesh
Siatka do malowania.

pBrush
Szczotka używana do malowania siatki.

CRenderTarget::FillOpacityMask

Stosuje maskę nieprzezroczystości opisaną przez określoną mapę bitową do pędzla i używa tego pędzla do malowania regionu docelowego renderowania.

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

Parametry

Maska o nieprzezroczystości
Położenie i promień w pikselach niezależnych od urządzenia wielokropka do malowania.

pBrush
Pędzl używany do malowania regionu docelowego renderowania określonego przez destinationRectangle.

zawartość
Typ zawartości zawiera maska nieprzezroczystości. Wartość służy do określania przestrzeni kolorów, w której jest mieszana maska nieprzezroczystości.

rectDest
Obszar docelowy renderowania do malowania w pikselach niezależnych od urządzenia.

rectSrc
Region mapy bitowej do użycia jako maska nieprzezroczystości w pikselach niezależnych od urządzenia.

CRenderTarget::FillRectangle

Maluje wnętrze określonego prostokąta.

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

Parametry

prostokąt
Wymiar prostokąta do malowania w pikselach niezależnych od urządzenia.

pBrush
Pędzl używany do malowania wnętrza prostokąta.

CRenderTarget::FillRoundedRectangle

Maluje wnętrze określonego zaokrąglonego prostokąta.

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

Parametry

rectRounded
Wymiary zaokrąglonego prostokąta do malowania w pikselach niezależnych od urządzenia.

pBrush
Szczotka używana do malowania wnętrza zaokrąglonego prostokąta.

CRenderTarget::Flush

Wykonuje wszystkie oczekujące polecenia rysunku.

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

Parametry

tag1
Zawiera tag operacji rysowania, które spowodowały błędy lub 0, jeśli nie wystąpiły żadne błędy. Ten parametr jest przekazywany jako niezainicjowany.

tag2
Zawiera tag operacji rysowania, które spowodowały błędy lub 0, jeśli nie wystąpiły żadne błędy. Ten parametr jest przekazywany jako niezainicjowany.

CRenderTarget::GetAntialiasMode

Pobiera bieżący tryb antyaliasingowy dla operacji rysunku nietekstowego.

D2D1_ANTIALIAS_MODE GetAntialiasMode() const;

Wartość zwracana

Bieżący tryb antyaliasingowy dla operacji rysunku nietekstowego.

CRenderTarget::GetDpi

Zwraca kropki obiektu docelowego renderowania na cal (DPI)

CD2DSizeF GetDpi() const;

Wartość zwracana

Kropki obiektu docelowego renderowania na cal (DPI).

CRenderTarget::GetMaximumBitmapSize

Pobiera maksymalny rozmiar w jednostkach zależnych od urządzenia (pikseli) dowolnego wymiaru mapy bitowej obsługiwanego przez obiekt docelowy renderowania

UINT32 GetMaximumBitmapSize() const;

Wartość zwracana

Maksymalny rozmiar w pikselach każdego wymiaru mapy bitowej obsługiwanego przez obiekt docelowy renderowania

CRenderTarget::GetPixelFormat

Pobiera format pikseli i tryb alfa obiektu docelowego renderowania

D2D1_PIXEL_FORMAT GetPixelFormat() const;

Wartość zwracana

Format pikseli i tryb alfa elementu docelowego renderowania

CRenderTarget::GetPixelSize

Zwraca rozmiar obiektu docelowego renderowania w pikselach urządzenia

CD2DSizeU GetPixelSize() const;

Wartość zwracana

Rozmiar obiektu docelowego renderowania w pikselach urządzenia

CRenderTarget::GetRenderTarget

Zwraca interfejs ID2D1RenderTarget

ID2D1RenderTarget* GetRenderTarget();

Wartość zwracana

Wskaźnik do interfejsu ID2D1RenderTarget lub NULL, jeśli obiekt nie został jeszcze zainicjowany.

CRenderTarget::GetSize

Zwraca rozmiar obiektu docelowego renderowania w pikselach niezależnych od urządzenia

CD2DSizeF GetSize() const;

Wartość zwracana

Bieżący rozmiar elementu docelowego renderowania w pikselach niezależnych od urządzenia

CRenderTarget::GetTags

Pobiera etykietę dla kolejnych operacji rysowania.

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

Parametry

tag1
Zawiera pierwszą etykietę dla kolejnych operacji rysowania. Ten parametr jest przekazywany jako niezainicjowany. Jeśli określono wartość NULL, dla tego parametru nie jest pobierana żadna wartość.

tag2
Zawiera drugą etykietę dla kolejnych operacji rysowania. Ten parametr jest przekazywany jako niezainicjowany. Jeśli określono wartość NULL, dla tego parametru nie jest pobierana żadna wartość.

CRenderTarget::GetTextAntialiasMode

Pobiera bieżący tryb antyaliasingowy dla operacji rysowania tekstu i glyph.

D2D1_TEXT_ANTIALIAS_MODE GetTextAntialiasMode() const;

Wartość zwracana

Bieżący tryb antyaliasingowy dla operacji rysowania tekstu i glifów.

CRenderTarget::GetTextRenderingParams

Pobiera bieżące opcje renderowania tekstu elementu docelowego renderowania.

void GetTextRenderingParams(IDWriteRenderingParams** textRenderingParams);

Parametry

textRenderingParams
Gdy ta metoda zwraca, textRenderingParamscontains adres wskaźnika do bieżących opcji renderowania tekstu elementu docelowego renderowania.

CRenderTarget::GetTransform

Pobiera bieżącą transformację elementu docelowego renderowania.

void GetTransform(D2D1_MATRIX_3X2_F* transform);

Parametry

przekształcać
Gdy ta funkcja zwraca, zawiera bieżącą transformację obiektu docelowego renderowania. Ten parametr jest przekazywany jako niezainicjowany.

CRenderTarget::IsSupported

Wskazuje, czy obiekt docelowy renderowania obsługuje określone właściwości

BOOL IsSupported(const D2D1_RENDER_TARGET_PROPERTIES& renderTargetProperties) const;

Parametry

renderTargetProperties
Właściwości elementu docelowego renderowania do przetestowania

Wartość zwracana

WARTOŚĆ TRUE, jeśli określone właściwości obiektu docelowego renderowania są obsługiwane przez ten element docelowy renderowania; w przeciwnym razie, FAŁSZ

CRenderTarget::IsValid

Sprawdza poprawność zasobów

BOOL IsValid() const;

Wartość zwracana

Wartość TRUE, jeśli zasób jest prawidłowy; w przeciwnym razie FAŁSZ.

CRenderTarget::m_lstResources

Lista wskaźników do obiektów CD2DResource.

CObList m_lstResources;

CRenderTarget::m_pRenderTarget

Wskaźnik do obiektu ID2D1RenderTarget.

ID2D1RenderTarget* m_pRenderTarget;

CRenderTarget::m_pTextFormatDefault

Wskaźnik do obiektu CD2DTextFormat, który zawiera domyślny format tekstu.

CD2DTextFormat* m_pTextFormatDefault;

CRenderTarget::operator ID2D1RenderTarget*

Zwraca interfejs ID2D1RenderTarget

operator ID2D1RenderTarget*();

Wartość zwracana

Wskaźnik do interfejsu ID2D1RenderTarget lub NULL, jeśli obiekt nie został jeszcze zainicjowany.

CRenderTarget::P opAxisAlignedClip

Usuwa ostatni klip wyrównany do osi z obiektu docelowego renderowania. Po wywołaniu tej metody klip nie jest już stosowany do kolejnych operacji rysunku.

void PopAxisAlignedClip();

CRenderTarget::P opLayer

Zatrzymuje przekierowywanie operacji rysowania do warstwy określonej przez ostatnie wywołanie elementu PushLayer.

void PopLayer();

CRenderTarget::P ushAxisAlignedClip

Usuwa ostatni klip wyrównany do osi z obiektu docelowego renderowania. Po wywołaniu tej metody klip nie jest już stosowany do kolejnych operacji rysunku.

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

Parametry

retClip
Rozmiar i położenie obszaru wycinków w pikselach niezależnych od urządzenia.

tryb
Tryb antyaliasingowy, który jest używany do rysowania krawędzi prostokątów klipów, które mają granice subpixel, i do mieszania klipu z zawartością sceny. Połączenie jest wykonywane raz po wywołaniu metody PopAxisAlignedClip i nie ma zastosowania do każdego elementu pierwotnego w warstwie.

CRenderTarget::P ushLayer

Dodaje określoną warstwę do obiektu docelowego renderowania, aby odbierała wszystkie kolejne operacje rysowania do momentu wywołania elementu PopLayer.

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

Parametry

layerParameters
Granice zawartości, maska geometryczna, nieprzezroczystość, maska nieprzezroczystości i opcje antyalializacji dla warstwy.

warstwa
Warstwa, która odbiera kolejne operacje rysowania.

CRenderTarget::RestoreDrawingState

Ustawia stan rysunku obiektu docelowego renderowania na określony identyfikator ID2D1DrawingStateBlock.

void RestoreDrawingState(ID2D1DrawingStateBlock& drawingStateBlock);

Parametry

drawingStateBlock
Nowy stan rysunku obiektu docelowego renderowania.

CRenderTarget::SaveDrawingState

Zapisuje bieżący stan rysunku w określonym identyfikatorze ID2D1DrawingStateBlock.

void SaveDrawingState(ID2D1DrawingStateBlock& drawingStateBlock) const;

Parametry

drawingStateBlock
Gdy ta metoda zwraca, zawiera bieżący stan rysunku obiektu docelowego renderowania. Ten parametr musi zostać zainicjowany przed przekazaniem go do metody .

CRenderTarget::SetAntialiasMode

Ustawia tryb antyaliasingowy obiektu docelowego renderowania. Tryb antyaliasingowy ma zastosowanie do wszystkich kolejnych operacji rysowania, z wyłączeniem operacji rysowania tekstu i glyph.

void SetAntialiasMode(D2D1_ANTIALIAS_MODE antialiasMode);

Parametry

antialiasMode
Tryb antyaliasingowy dla przyszłych operacji rysowania.

CRenderTarget::SetDpi

Ustawia kropki na cal (DPI) obiektu docelowego renderowania.

void SetDpi(const CD2DSizeF& sizeDPI);

Parametry

sizeDPI
Wartość większa lub równa zero, która określa poziomą/pionową wartość docelową renderowania.

CRenderTarget::SetTags

Określa etykietę dla kolejnych operacji rysowania.

void SetTags(
    D2D1_TAG tag1,
    D2D1_TAG tag2);

Parametry

tag1
Etykieta, która ma być stosowana do kolejnych operacji rysowania.

tag2
Etykieta, która ma być stosowana do kolejnych operacji rysowania.

CRenderTarget::SetTextAntialiasMode

Określa tryb antyaliasingu do użycia dla kolejnych operacji rysowania tekstu i glyph.

void SetTextAntialiasMode(D2D1_TEXT_ANTIALIAS_MODE textAntialiasMode);

Parametry

textAntialiasMode
Tryb antyaliasingowy do użycia na potrzeby kolejnych operacji rysowania tekstu i glyph.

CRenderTarget::SetTextRenderingParams

Określa opcje renderowania tekstu, które mają być stosowane do wszystkich kolejnych operacji rysowania tekstu i glyph.

void SetTextRenderingParams(IDWriteRenderingParams* textRenderingParams = NULL);

Parametry

textRenderingParams
Opcje renderowania tekstu, które mają być stosowane do wszystkich kolejnych operacji rysowania tekstu i glyph; Wartość NULL w celu wyczyszczenia opcji renderowania bieżącego tekstu.

CRenderTarget::SetTransform

Stosuje określone przekształcenie do obiektu docelowego renderowania, zastępując istniejącą transformację. Wszystkie kolejne operacje rysowania są wykonywane w przekształconej przestrzeni.

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

Parametry

przekształcać
Przekształcenie, które ma być stosowane do elementu docelowego renderowania.

CRenderTarget::VerifyResource

Weryfikuje ważność obiektu CD2DResource; tworzy obiekt, jeśli jeszcze nie istnieje.

BOOL VerifyResource(CD2DResource* pResource);

Parametry

pResource
Wskaźnik do obiektu CD2DResource.

Wartość zwracana

Wartość TRUE jest obiektem, jeśli jest prawidłowy; w przeciwnym razie FAŁSZ.

Zobacz też

Klasy

Udostępnij za pośrednictwem

Klasa CRenderTarget

Składnia

Elementy członkowskie

Konstruktory publiczne

Metody publiczne

Metody chronione

Operatory publiczne

Chronione składowe danych

Hierarchia dziedziczenia

Wymagania

CRenderTarget::~CRenderTarget

CRenderTarget::Attach

Parametry

CRenderTarget::BeginDraw

CRenderTarget::Clear

Parametry

CRenderTarget::COLORREF_TO_D2DCOLOR

Parametry

Wartość zwracana

CRenderTarget::CreateCompatibleRenderTarget

Parametry

Wartość zwracana

CRenderTarget::CRenderTarget

CRenderTarget::D estroy

Parametry

Wartość zwracana

CRenderTarget::D etach

Wartość zwracana

CRenderTarget::D rawBitmap

Parametry

CRenderTarget::D rawEllipse

Parametry

CRenderTarget::D rawGeometry

Parametry

CRenderTarget::D rawGlyphRun

Parametry

CRenderTarget::D rawLine

Parametry

CRenderTarget::D rawRectangle

Parametry

CRenderTarget::D rawRoundedRectangle

Parametry

CRenderTarget::D rawText

Parametry

CRenderTarget::D rawTextLayout

Parametry

CRenderTarget::EndDraw

Wartość zwracana

CRenderTarget::FillEllipse

Parametry

CRenderTarget::FillGeometry

Parametry

CRenderTarget::FillMesh

Parametry

CRenderTarget::FillOpacityMask

Parametry

CRenderTarget::FillRectangle

Parametry

CRenderTarget::FillRoundedRectangle

Parametry

CRenderTarget::Flush

Parametry

CRenderTarget::GetAntialiasMode

Wartość zwracana

CRenderTarget::GetDpi

Wartość zwracana

CRenderTarget::GetMaximumBitmapSize

Wartość zwracana

CRenderTarget::GetPixelFormat

Wartość zwracana

CRenderTarget::GetPixelSize

Wartość zwracana

CRenderTarget::GetRenderTarget

Wartość zwracana

CRenderTarget::GetSize

Wartość zwracana

CRenderTarget::GetTags

Parametry

CRenderTarget::GetTextAntialiasMode