Klasa CRenderTarget
Otoka id2D1RenderTarget.
Składnia
class CRenderTarget : public CObject;
Członkowie
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
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.
Interpolationmode
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
Elipsy
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).
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.
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
Elipsy
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ści
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łcić
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.
Warstwy
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łcić
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ż
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla