Partilhar via


Classe CRenderTarget

Observação

A biblioteca Microsoft Foundation Classes (MFC) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

Um wrapper para ID2D1RenderTarget.

Sintaxe

class CRenderTarget : public CObject;

Membros

Construtores Públicos

Nome Description
CRenderTarget::CRenderTarget Constrói um objeto CRenderTarget.
CRenderTarget::~CRenderTarget O destruidor. É chamado quando um objeto de renderização está a ser destruído.

Métodos Públicos

Nome Description
CRenderTarget::Anexar Anexa a interface de render target existente ao objeto
CRenderTarget::BeginDraw Inicia o desenho neste alvo de renderização.
CRenderTarget::Limpar Limpa a área de desenho para a cor especificada.
CRenderTarget::COLORREF_TO_D2DCOLOR Converte os valores de cor e alfa do GDI para o objeto D2D1_COLOR_F.
CRenderTarget::CreateCompatibleRenderTarget Cria um novo alvo de renderização bitmap para uso durante desenhos intermédios fora do ecrã, compatível com o alvo de renderização atual.
AlvoCrítico: :D estroy Elimina um ou mais recursos
CRenderTarget::D etach Desliga a interface de renderização do alvo do objeto
CRenderTarget::D rawBitmap Desenha o texto formatado descrito pelo objeto IDWriteTextLayout especificado.
CRenderTarget::D rawEllipse Desenha o contorno da elipse especificada usando o estilo de traço especificado.
CRenderTarget::D rawGeometry Desenha o contorno da geometria especificada usando o estilo de traço especificado.
CRenderTarget::D rawGlyphRun Desenha os glifos especificados.
CRenderTarget::D rawLine Traça uma linha entre os pontos especificados usando o estilo de traço especificado.
CRenderTarget::D rawRetângulo Desenha o contorno de um retângulo com as dimensões e o estilo de traço especificados.
CRenderTarget::D rawRoundedRectangleT Desenha o contorno do retângulo arredondado especificado usando o estilo de traço especificado.
CRenderTarget::D rawText Desenha o texto especificado usando a informação de formato fornecida por um objeto IDWriteTextFormat.
CRenderTarget::D rawTextLayout Desenha o texto formatado descrito pelo objeto IDWriteTextLayout especificado.
CRenderTarget::EndDraw Termina as operações de desenho no alvo de renderização e indica o estado atual do erro e as etiquetas associadas.
CRenderTarget::FillEllipse Pinta o interior da elipse especificada.
CRenderTarget::FillGeometry Pinta o interior da geometria especificada.
CRenderTarget::FillMesh Pinta o interior da malha especificada.
CRenderTarget::Máscara de OpacidadeDe Preenchimento Aplica a máscara de opacidade descrita pelo bitmap especificado a um pincel e usa esse pincel para pintar uma região do alvo de renderização.
CRenderTarget::FillRectangle Pinta o interior do retângulo especificado.
CRenderTarget::RetânguloDeArredondado Preenchido Pinta o interior do retângulo arredondado especificado.
CRenderTarget::Flush Executa todos os comandos de desenho pendentes.
CRenderTarget::GetAntialiasMode Recupera o modo de anti-aliasing atual para operações de desenho não textuais.
CRenderTarget::GetDpi Devolve os pontos por polegada (DPI) do alvo de renderização
CRenderTarget::GetMaximumBitmapSize Obtém o tamanho máximo, em unidades dependentes do dispositivo (píxeis), de qualquer dimensão bitmap suportada pelo alvo de renderização
CRenderTarget::GetPixelFormat Recupera o formato de píxeis e o modo alfa do alvo de renderização
CRenderTarget::ObténTamanhoPixelPixel Devolve o tamanho do alvo de renderização em pixels do dispositivo
CRenderTarget::GetRenderTarget Devolve a interface ID2D1RenderTarget
CRenderTarget::GetSize Devolve o tamanho do alvo de renderização em píxeis independentes do dispositivo
CRenderTarget::GetTags Recebe a etiqueta para operações de desenho subsequentes.
CRenderTarget::GetTextAntialiasMode Recebe o modo de antialiasing atual para operações de desenho de texto e glifos.
CRenderTarget::GetTextRenderingParams Recupera as opções atuais de renderização de texto do alvo de renderização.
CRenderTarget::GetTransform Aplica a transformação especificada ao alvo de renderização, substituindo a transformação existente. Todas as operações de desenho subsequentes ocorrem no espaço transformado.
CRenderTarget::IsSupported Indica se o alvo de renderização suporta as propriedades especificadas
CRenderTarget::IsValid Verifica a validade dos recursos
CRenderTarget::P opAxisAlignedClip Remove o último clip alinhado ao eixo do alvo de renderização. Após este método ser chamado, o clip deixa de ser aplicado às operações de desenho subsequentes.
CRenderTarget::P opLayer Deixa de redirecionar as operações de desenho para a camada especificada pela última chamada PushLayer.
CRenderTarget::P ushAxisAlignedClip Remove o último clip alinhado ao eixo do alvo de renderização. Após este método ser chamado, o clip deixa de ser aplicado às operações de desenho subsequentes.
CRenderTarget::P ushLayer Adiciona a camada especificada ao alvo de renderização para que receba todas as operações de desenho subsequentes até que o PopLayer seja chamado.
CRenderTarget::RestoreDrawingState Define o estado de desenho do alvo de renderização para o ID2D1DrawingStateBlock especificado.
CRenderTarget::SaveDrawingState Guarda o estado atual do desenho no ID2D1DrawingStateBlock especificado.
CRenderTarget::SetAntialiasMode Define o modo de antialiasing do alvo de renderização. O modo de antialiasing aplica-se a todas as operações de desenho subsequentes, excluindo as operações de desenho de texto e glifos.
CRenderTarget::SetDpi Define os pontos por polegada (DPI) do alvo de renderização.
CRenderTarget::SetTags Especifica uma etiqueta para operações de desenho subsequentes.
CRenderTarget::SetTextAntialiasMode Especifica o modo de antialiasing a usar para operações subsequentes de desenho de texto e glifos.
CRenderTarget::SetTextRenderingParams Especifica opções de renderização de texto a serem aplicadas a todas as operações subsequentes de desenho de texto e glifos.
CRenderTarget::SetTransform Sobrecarregado. Aplica a transformação especificada ao alvo de renderização, substituindo a transformação existente. Todas as operações de desenho subsequentes ocorrem no espaço transformado.

Métodos Protegidos

Nome Description
CRenderTarget::VerifyResource Verifica a validade do objeto CD2DResource; cria o objeto se este ainda não existisse.

Operadores Públicos

Nome Description
CRenderTarget::operator ID2D1RenderTarget* Devolve a interface ID2D1RenderTarget

Membros de Dados Protegidos

Nome Description
CRenderTarget::m_lstResources Uma lista de apontadores para objetos CD2DResource.
CRenderTarget::m_pRenderTarget Um ponteiro para um objeto ID2D1RenderTarget.
CRenderTarget::m_pTextFormatDefault Um apontador para o objeto CD2DTextFormat que contém um formato de texto predefinido.

Hierarquia de herança

CObject

CRenderTarget

Requerimentos

Cabeçalho: afxrendertarget.h

CRenderTarget::~CRenderTarget

O destruidor. É chamado quando um objeto de renderização está a ser destruído.

virtual ~CRenderTarget();

CRenderTarget::Anexar

Anexa a interface de render target existente ao objeto

void Attach(ID2D1RenderTarget* pRenderTarget);

Parâmetros

pRenderTarget
Interface de renderização já existente. Não pode ser NULL

CRenderTarget::BeginDraw

Inicia o desenho neste alvo de renderização.

void BeginDraw();

CRenderTarget::Limpar

Limpa a área de desenho para a cor especificada.

void Clear(D2D1_COLOR_F color);

Parâmetros

cor
A cor para a qual a área de desenho é limpa.

CRenderTarget::COLORREF_TO_D2DCOLOR

Converte os valores de cor e alfa do GDI para o objeto D2D1_COLOR_F.

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

Parâmetros

cor
Valor RGB.

nAlpha

Valor de retorno

D2D1_COLOR_F valor.

CRenderTarget::CreateCompatibleRenderTarget

Cria um novo alvo de renderização bitmap para uso durante desenhos intermédios fora do ecrã, compatível com o alvo de renderização atual.

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

Parâmetros

bitmapTarget
Quando este método retorna, contém o endereço de um ponteiro para um novo alvo de renderização bitmap. Este parâmetro é passado sem inicializar.

tamanhoDesejado
O tamanho desejado do novo alvo de renderização em píxeis independentes do dispositivo, caso seja diferente do alvo de renderização original, ou NULL. Para obter mais informações, consulte a seção Observações.

tamanhoPixelDesejado
O tamanho desejado do novo alvo de renderização em pixels se for diferente do alvo original, ou NULL. Para obter mais informações, consulte a seção Observações.

desiredFormato
O formato de píxel desejado e o modo alfa do novo alvo de renderização, ou NULL. Se o formato de píxel estiver definido para DXGI_FORMAT_UNKNOWN ou se este parâmetro for nulo, o novo alvo de renderização usa o mesmo formato de píxel do alvo original. Se o modo alfa for D2D1_ALPHA_MODE_UNKNOWN ou este parâmetro for NULL, o modo alfa do novo destino de renderização passa por defeito a D2D1_ALPHA_MODE_PREMULTIPLIED. Para informações sobre formatos de píxeis suportados, consulte Formatos de Píxeis Suportados e Modos Alfa.

Opções
Um valor que especifica se o novo destino de renderização deve ser compatível com o GDI.

Valor de retorno

Se o método tiver sucesso, devolve VERDADEIRO. Caso contrário, devolve FALSE.

CRenderTarget::CRenderTarget

Constrói um objeto CRenderTarget.

CRenderTarget();

AlvoCrítico: :D estroy

Elimina um ou mais recursos

BOOL Destroy(BOOL bDeleteResources = TRUE);

Parâmetros

bDeleteResources
Se o bDeleteResources for VERDADEIRO, todos os recursos localizados no m_lstResources serão automaticamente destruídos.

Valor de retorno

Se o método tiver sucesso, devolve VERDADEIRO. Caso contrário, devolve FALSE

CRenderTarget::D etach

Desliga a interface de renderização do alvo do objeto

ID2D1RenderTarget* Detach ();

Valor de retorno

Apontador para a interface de renderização de destino separada.

CRenderTarget::D rawBitmap

Desenha o texto formatado descrito pelo objeto IDWriteTextLayout especificado.

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

Parâmetros

pBitmap
O bitmap para renderizar.

rectDest
O tamanho e a posição, em píxeis independentes do dispositivo no espaço coordenado do alvo de renderização, da área para onde o bitmap é desenhado. Se o retângulo não estiver bem ordenado, nada é desenhado, mas o alvo de renderização não entra num estado de erro.

fOpacidade
Um valor entre 0,0f e 1,0f, inclusive, que especifica um valor de opacidade a aplicar ao bitmap; Este valor é multiplicado pelos valores alfa do conteúdo do bitmap.

interpolationMode
O modo de interpolação a usar se o bitmap for escalado ou rodado pela operação de desenho.

pRectSrc
O tamanho e a posição, em píxeis independentes do dispositivo no espaço de coordenadas do bitmap, da área dentro do bitmap a desenhar.

CRenderTarget::D rawEllipse

Desenha o contorno da elipse especificada usando o estilo de traço especificado.

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

Parâmetros

Elipse
A posição e o raio da elipse a desenhar, em píxeis independentes do dispositivo.

pBrush
O pincel usado para pintar o contorno da elipse.

fStrokeWidth
A espessura do traço da elipse. O traço está centrado no contorno da elipse.

Estilo stroke
O estilo de traço para aplicar no contorno da elipse, ou NULL para pintar um traço sólido.

CRenderTarget::D rawGeometry

Desenha o contorno da geometria especificada usando o estilo de traço especificado.

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

Parâmetros

pGeometria
A geometria a desenhar.

pBrush
O pincel usado para pintar o traço da geometria.

fStrokeWidth
A espessura do traço da geometria. O traço está centrado no contorno da geometria.

Estilo stroke
O estilo de traço para aplicar ao contorno da geometria, ou NULL para pintar um traço sólido.

CRenderTarget::D rawGlyphRun

Desenha os glifos especificados.

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

Parâmetros

ptBaseLineOrigin
A origem, em píxeis independentes do dispositivo, da linha base dos glifos.

glyphRun
Os glifos a renderizar.

pForegroundBrush
O pincel usado para pintar os glifos especificados.

Modo de medição
Um valor que indica como as métricas de glifos são usadas para medir o texto quando este é formatado. O valor padrão é DWRITE_MEASURING_MODE_NATURAL.

CRenderTarget::D rawLine

Traça uma linha entre os pontos especificados usando o estilo de traço especificado.

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

Parâmetros

ptFrom
O ponto de início da linha, em píxeis independentes do dispositivo.

ptTo
O ponto final da linha, em píxeis independentes do dispositivo.

pBrush
O pincel usado para pintar o traço da linha.

fStrokeWidth
Um valor maior ou igual a 0,0f que especifica a largura do traço. Se este parâmetro não for especificado, por defeito é 1.0f. O traço está centrado na linha.

Estilo stroke
O estilo de traço para pintar, ou NULL para pintar uma linha sólida.

CRenderTarget::D rawRetângulo

Desenha o contorno de um retângulo com as dimensões e o estilo de traço especificados.

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

Parâmetros

retângulo
As dimensões do retângulo a desenhar, em píxeis independentes do dispositivo

pBrush
O pincel usado para pintar a pincelada do retângulo

fStrokeWidth
Um valor maior ou igual a 0,0f que especifica a largura do traço do retângulo. O traço está centrado no contorno do retângulo.

Estilo stroke
O estilo de traço para pintar, ou NULL para pintar um traço sólido.

CRenderTarget::D rawRoundedRectangleT

Desenha o contorno do retângulo arredondado especificado usando o estilo de traço especificado.

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

Parâmetros

rectRounded
As dimensões do retângulo arredondado a desenhar, em píxeis independentes do dispositivo.

pBrush
O pincel usado para pintar o contorno do retângulo arredondado.

fStrokeWidth
A largura do traço do retângulo arredondado. O traço está centrado no contorno do retângulo arredondado. O valor padrão é 1.0f.

Estilo stroke
O estilo do traço do retângulo arredondado, ou NULL para pintar um traço sólido. O valor padrão é NULL.

CRenderTarget::D rawText

Desenha o texto especificado usando a informação de formato fornecida por um objeto 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);

Parâmetros

strText
Um apontador para um array de caracteres Unicode para desenhar.

retângulo
O tamanho e a posição da área onde o texto é desenhado.

pForegroundBrush
O pincel usado para pintar o texto.

textFormat
Um objeto que descreve detalhes de formatação do texto a desenhar, como a fonte, o tamanho da fonte e a direção do fluxo.

Opções
Um valor que indica se o texto deve ser ajustado aos limites dos píxeis e se o texto deve ser recortado ao retângulo do layout. O valor predefinido é D2D1_DRAW_TEXT_OPTIONS_NONE, o que indica que o texto deve ser encaixado nos limites dos píxeis e não deve ser recortado ao retângulo do layout.

Modo de medição
Um valor que indica como as métricas de glifos são usadas para medir o texto quando este é formatado. O valor padrão é DWRITE_MEASURING_MODE_NATURAL.

CRenderTarget::D rawTextLayout

Desenha o texto formatado descrito pelo objeto IDWriteTextLayout especificado.

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

Parâmetros

ptOrigin
O ponto, descrito em píxeis independentes do dispositivo, onde o canto superior esquerdo do texto descrito por textLayout é desenhado.

textLayout
O texto formatado para desenhar. Quaisquer efeitos de desenho que não herdem do ID2D1Resource são ignorados. Se houver efeitos de desenho que herdam do ID2D1Resource e que não são escovas, este método falha e o alvo de renderização fica num estado de erro.

pBrushForeground
O pincel usado para pintar qualquer texto em textLayout que não tenha já um pincel associado como efeito de desenho (especificado pelo método IDWriteTextLayout::SetDrawingEffect).

Opções
Um valor que indica se o texto deve ser ajustado aos limites dos píxeis e se o texto deve ser recortado ao retângulo do layout. O valor predefinido é D2D1_DRAW_TEXT_OPTIONS_NONE, o que indica que o texto deve ser encaixado nos limites dos píxeis e não deve ser recortado ao retângulo do layout.

CRenderTarget::EndDraw

Termina as operações de desenho no alvo de renderização e indica o estado atual do erro e as etiquetas associadas.

HRESULT EndDraw();

Valor de retorno

Se o método tiver sucesso, ele devolve S_OK. Caso contrário, devolve um código de erro HRESULT.

CRenderTarget::FillEllipse

Pinta o interior da elipse especificada.

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

Parâmetros

Elipse
A posição e o raio, em píxeis independentes do dispositivo, da elipse a pintar.

pBrush
O pincel usado para pintar o interior da elipse.

CRenderTarget::FillGeometry

Pinta o interior da geometria especificada.

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

Parâmetros

pGeometria
A geometria para pintar.

pBrush
O pincel usado para pintar o interior da geometria.

pOpacityBrush
A máscara de opacidade a aplicar à geometria; NULL para não usar máscara de opacidade. Se for especificada uma máscara de opacidade (o parâmetro opacityBrush), o brush deve ser um ID2D1BitmapBrush que tenha os modos x- e y-extend definidos para D2D1_EXTEND_MODE_CLAMP. Para obter mais informações, consulte a seção Observações.

CRenderTarget::FillMesh

Pinta o interior da malha especificada.

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

Parâmetros

pMesh
A malha para pintar.

pBrush
O pincel usado para pintar a rede.

CRenderTarget::Máscara de OpacidadeDe Preenchimento

Aplica a máscara de opacidade descrita pelo bitmap especificado a um pincel e usa esse pincel para pintar uma região do alvo de renderização.

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

Parâmetros

pOpacityMask
A posição e o raio, em píxeis independentes do dispositivo, da elipse a pintar.

pBrush
O pincel usado para pintar a região do alvo de renderização especificada por destinationRectangle.

Conteúdo
O tipo de conteúdo que a máscara de opacidade contém. O valor é usado para determinar o espaço de cor em que a máscara de opacidade é misturada.

rectDest
A região do alvo de renderização a pintar, em píxeis independentes do dispositivo.

rectSrc
A região do bitmap a usar como máscara de opacidade, em píxeis independentes do dispositivo.

CRenderTarget::FillRectangle

Pinta o interior do retângulo especificado.

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

Parâmetros

retângulo
A dimensão do retângulo para pintar, em píxeis independentes do dispositivo.

pBrush
O pincel usado para pintar o interior do retângulo.

CRenderTarget::RetânguloDeArredondado Preenchido

Pinta o interior do retângulo arredondado especificado.

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

Parâmetros

rectRounded
As dimensões do retângulo arredondado para pintar, em píxeis independentes do dispositivo.

pBrush
O pincel usado para pintar o interior do retângulo arredondado.

CRenderTarget::Flush

Executa todos os comandos de desenho pendentes.

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

Parâmetros

tag1
Contém a etiqueta para operações de desenho que causaram erros ou 0 se não houvesse erros. Este parâmetro é passado sem inicializar.

tag2
Contém a etiqueta para operações de desenho que causaram erros ou 0 se não houvesse erros. Este parâmetro é passado sem inicializar.

CRenderTarget::GetAntialiasMode

Recupera o modo de anti-aliasing atual para operações de desenho não textuais.

D2D1_ANTIALIAS_MODE GetAntialiasMode() const;

Valor de retorno

Modo de antialiasing atual para operações de desenho sem texto.

CRenderTarget::GetDpi

Devolve os pontos por polegada (DPI) do alvo de renderização

CD2DSizeF GetDpi() const;

Valor de retorno

Os pontos por polegada (DPI) do alvo de renderização.

CRenderTarget::GetMaximumBitmapSize

Obtém o tamanho máximo, em unidades dependentes do dispositivo (píxeis), de qualquer dimensão bitmap suportada pelo alvo de renderização

UINT32 GetMaximumBitmapSize() const;

Valor de retorno

O tamanho máximo, em pixels, de qualquer dimensão bitmap suportada pelo alvo de renderização

CRenderTarget::GetPixelFormat

Recupera o formato de píxeis e o modo alfa do alvo de renderização

D2D1_PIXEL_FORMAT GetPixelFormat() const;

Valor de retorno

O formato de píxeis e o modo alfa do alvo de renderização

CRenderTarget::ObténTamanhoPixelPixel

Devolve o tamanho do alvo de renderização em pixels do dispositivo

CD2DSizeU GetPixelSize() const;

Valor de retorno

O tamanho do alvo de renderização em pixels do dispositivo

CRenderTarget::GetRenderTarget

Devolve a interface ID2D1RenderTarget

ID2D1RenderTarget* GetRenderTarget();

Valor de retorno

Apontar para uma interface ID2D1RenderTarget ou NULL se o objeto ainda não estiver inicializado.

CRenderTarget::GetSize

Devolve o tamanho do alvo de renderização em píxeis independentes do dispositivo

CD2DSizeF GetSize() const;

Valor de retorno

O tamanho atual do alvo de renderização em píxeis independentes do dispositivo

CRenderTarget::GetTags

Recebe a etiqueta para operações de desenho subsequentes.

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

Parâmetros

tag1
Contém a primeira etiqueta para operações de desenho subsequentes. Este parâmetro é passado sem inicializar. Se NULL for especificado, nenhum valor é recuperado para este parâmetro.

tag2
Contém a segunda etiqueta para operações de desenho subsequentes. Este parâmetro é passado sem inicializar. Se NULL for especificado, nenhum valor é recuperado para este parâmetro.

CRenderTarget::GetTextAntialiasMode

Recebe o modo de antialiasing atual para operações de desenho de texto e glifos.

D2D1_TEXT_ANTIALIAS_MODE GetTextAntialiasMode() const;

Valor de retorno

Modo de antialiasing atual para operações de desenho de texto e glifos.

CRenderTarget::GetTextRenderingParams

Recupera as opções atuais de renderização de texto do alvo de renderização.

void GetTextRenderingParams(IDWriteRenderingParams** textRenderingParams);

Parâmetros

textRenderingParams
Quando este método regressa, textRenderingParámetros contém o endereço de um ponteiro para as opções atuais de renderização do texto do destino de renderização.

CRenderTarget::GetTransform

Obtém a transformação atual do alvo de renderização.

void GetTransform(D2D1_MATRIX_3X2_F* transform);

Parâmetros

transformar
Quando este retorna, contém a transformação atual do alvo de renderização. Este parâmetro é passado sem inicializar.

CRenderTarget::IsSupported

Indica se o alvo de renderização suporta as propriedades especificadas

BOOL IsSupported(const D2D1_RENDER_TARGET_PROPERTIES& renderTargetProperties) const;

Parâmetros

renderTargetProperties
As propriedades do alvo de renderização a testar

Valor de retorno

TRUE se as propriedades especificadas do alvo de renderização forem suportadas por este alvo de renderização; caso contrário, FALSO

CRenderTarget::IsValid

Verifica a validade dos recursos

BOOL IsValid() const;

Valor de retorno

TRUE se o recurso for válido; caso contrário, FALSO.

CRenderTarget::m_lstResources

Uma lista de apontadores para objetos CD2DResource.

CObList m_lstResources;

CRenderTarget::m_pRenderTarget

Um ponteiro para um objeto ID2D1RenderTarget.

ID2D1RenderTarget* m_pRenderTarget;

CRenderTarget::m_pTextFormatDefault

Um apontador para o objeto CD2DTextFormat que contém um formato de texto predefinido.

CD2DTextFormat* m_pTextFormatDefault;

CRenderTarget::operator ID2D1RenderTarget*

Devolve a interface ID2D1RenderTarget

operator ID2D1RenderTarget*();

Valor de retorno

Apontar para uma interface ID2D1RenderTarget ou NULL se o objeto ainda não estiver inicializado.

CRenderTarget::P opAxisAlignedClip

Remove o último clip alinhado ao eixo do alvo de renderização. Após este método ser chamado, o clip deixa de ser aplicado às operações de desenho subsequentes.

void PopAxisAlignedClip();

CRenderTarget::P opLayer

Deixa de redirecionar as operações de desenho para a camada especificada pela última chamada PushLayer.

void PopLayer();

CRenderTarget::P ushAxisAlignedClip

Remove o último clip alinhado ao eixo do alvo de renderização. Após este método ser chamado, o clip deixa de ser aplicado às operações de desenho subsequentes.

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

Parâmetros

rectClip
O tamanho e a posição da área de clipping, em píxeis independentes do dispositivo.

mode
O modo de antialiasing usado para desenhar as bordas dos retângulos dos clipes que têm limites subpixels, e para misturar o clip com o conteúdo da cena. A fusão é realizada uma vez quando o método PopAxisAlignedClip é chamado, e não se aplica a cada primitiva dentro da camada.

CRenderTarget::P ushLayer

Adiciona a camada especificada ao alvo de renderização para que receba todas as operações de desenho subsequentes até que o PopLayer seja chamado.

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

Parâmetros

LayerParameters
Os limites de conteúdo, máscara geométrica, opacidade, máscara de opacidade e opções de antialiasing para a camada.

Camada
A camada que recebe operações de desenho subsequentes.

CRenderTarget::RestoreDrawingState

Define o estado de desenho do alvo de renderização para o ID2D1DrawingStateBlock especificado.

void RestoreDrawingState(ID2D1DrawingStateBlock& drawingStateBlock);

Parâmetros

desenhoEstadoBloco
O novo estado de desenho do alvo de renderização.

CRenderTarget::SaveDrawingState

Guarda o estado atual do desenho no ID2D1DrawingStateBlock especificado.

void SaveDrawingState(ID2D1DrawingStateBlock& drawingStateBlock) const;

Parâmetros

desenhoEstadoBloco
Quando este método regressa, contém o estado de desenho atual do alvo de renderização. Este parâmetro deve ser inicializado antes de o passar ao método.

CRenderTarget::SetAntialiasMode

Define o modo de antialiasing do alvo de renderização. O modo de antialiasing aplica-se a todas as operações de desenho subsequentes, excluindo as operações de desenho de texto e glifos.

void SetAntialiasMode(D2D1_ANTIALIAS_MODE antialiasMode);

Parâmetros

antialiasMode
O modo de antialiasing para futuras operações de desenho.

CRenderTarget::SetDpi

Define os pontos por polegada (DPI) do alvo de renderização.

void SetDpi(const CD2DSizeF& sizeDPI);

Parâmetros

tamanhoDPI
Um valor maior ou igual a zero que especifica o DPI horizontal/vertical do alvo de renderização.

CRenderTarget::SetTags

Especifica uma etiqueta para operações de desenho subsequentes.

void SetTags(
    D2D1_TAG tag1,
    D2D1_TAG tag2);

Parâmetros

tag1
Um rótulo para aplicar em operações de desenho subsequentes.

tag2
Um rótulo para aplicar em operações de desenho subsequentes.

CRenderTarget::SetTextAntialiasMode

Especifica o modo de antialiasing a usar para operações subsequentes de desenho de texto e glifos.

void SetTextAntialiasMode(D2D1_TEXT_ANTIALIAS_MODE textAntialiasMode);

Parâmetros

textAntialiasMode
O modo de antialiasing para usar em operações subsequentes de desenho de texto e glifos.

CRenderTarget::SetTextRenderingParams

Especifica opções de renderização de texto a serem aplicadas a todas as operações subsequentes de desenho de texto e glifos.

void SetTextRenderingParams(IDWriteRenderingParams* textRenderingParams = NULL);

Parâmetros

textRenderingParams
As opções de renderização de texto a serem aplicadas a todas as operações subsequentes de desenho de texto e glifos; NULL para limpar as opções atuais de renderização de texto.

CRenderTarget::SetTransform

Aplica a transformação especificada ao alvo de renderização, substituindo a transformação existente. Todas as operações de desenho subsequentes ocorrem no espaço transformado.

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

Parâmetros

transformar
A transformação para aplicar ao alvo de renderização.

CRenderTarget::VerifyResource

Verifica a validade do objeto CD2DResource; cria o objeto se este ainda não existisse.

BOOL VerifyResource(CD2DResource* pResource);

Parâmetros

pResource
Apontador para o objeto CD2DResource.

Valor de retorno

TRUE é objeto se for válido; caso contrário, FALSO.

Consulte também

Classes