Compartilhar via


GetDeviceCaps

Windows Mobile SupportedWindows Embedded CE Supported

9/9/2008

Essa função recupera informações sobre os recursos de um dispositivo especificado.

Syntax

int GetDeviceCaps(
  HDC hdc, 
  int nIndex
);

Parameters

  • hDC
    [no] Identificador para o contexto dispositivo.
  • nÍndice
    [no] Especifica o item para retornar.

    Este parâmetro pode ser uma dos seguinte valores.

    Valor Descrição
    ASPECTX Largura relativa de um pixel dispositivo usado para line Drawing.
    ASPECTXY Diagonal largura de pixel o dispositivo usado para line Drawing.
    ASPECTY Altura relativa de um pixel dispositivo usado para line Drawing.
    BITSPIXEL Número de adjacente bits cor para cada pixel.
    CLIPCAPS

    Sinalizador que indica os recursos recorte do dispositivo.

    Se o dispositivo pode juntar para um retângulo, ele é 1. Caso contrário, ele é 0.

    COLORRES Resolução cor real do dispositivo, em bits por pixel.

    Este índice é válido somente se o driver de dispositivo define o bit RC_PALETTE no índice de RASTERCAPS e está disponível somente se o driver for compatível com 16-bit Windows.

    CURVECAPS Valor que indica os recursos curva do dispositivo, como mostra a seguinte lista:
    CC_CHORD Dispositivo pode desenhar corda arcos.
    CC_CIRCLES Dispositivo pode desenhar círculos.
    CC_ELLIPSES Dispositivo pode desenhar elipses.
    CC_INTERIORS Dispositivo pode desenhar interiors.
    CC_NONE Dispositivo não tem suporte curvas.
    CC_PIE Dispositivo pode desenhar pizza wedges.
    CC_ROUNDRECT Dispositivo pode arredondado desenhar retângulos.
    CC_STYLED Dispositivo pode desenhar com o estilo bordas.
    CC_WIDE Dispositivo pode desenhar bordas longa.
    CC_WIDESTYLED Dispositivo pode desenhar bordas que são ampla e styled.
    DRIVERVERSION A versão driver de dispositivo.
    HORZRES Largura, em pixels, da Tela.
    HORZSIZE Largura, em milímetros, do físico Tela.
    LINECAPS Valor que indica os recursos de linha do dispositivo, como mostra a seguinte lista:
    LC_INTERIORS Dispositivo pode desenhar interiors.
    LC_MARKER Dispositivo pode desenhar um marcador.
    LC_NONE Dispositivo não tem suporte linhas.
    LC_POLYLINE Dispositivo pode desenhar uma polilinha.
    LC_POLYMARKER Dispositivo pode desenhar múltiplo marcadores.
    LC_STYLED Dispositivo pode desenhar linhas com o estilo.
    LC_WIDE Dispositivo pode desenhar linhas de largura.
    LC_WIDESTYLED Dispositivo pode desenhar linhas que são ampla e styled.
    LOGPIXELSX Número de pixels por polegada lógica ao longo de largura Tela.

    Em um sistema com múltiplo exibir monitores, esse valor é o mesmo para todos os monitores.

    LOGPIXELSY Número de pixels por polegada lógica ao longo de altura Tela.

    Em um sistema com múltiplo exibir monitores, esse valor é o mesmo para todos os monitores.

    NUMBRUSHES Número de cursores específicas do dispositivo.
    NUMCOLORS Número de entradas no tabela de cores do dispositivo, se o dispositivo tiver um intensidade da cor de não more than 8 bits por pixel.

    Para dispositivos com maiores intensidades cor, – 1 é retornada.

    NUMFONTS Número de fontes específicas do dispositivo.
    NUMPENS Número de canetas específicas do dispositivo.
    NUMRESERVED

    Número de entradas reservadas na paleta de sistema.

    Este índice é válido somente se o driver de dispositivo define o bit RC_PALETTE no índice de RASTERCAPS e está disponível somente se o driver for compatível com 16-bit Windows.

    PDEVICESIZE Reservado.
    PHYSICALHEIGHT

    Para dispositivos impressão: a altura do físico página, no dispositivo unidades.

    De exemplo, uma impressora definida para imprimir em 600 dpi em 8.5"X11" Papel tem um físico valor da altura de 6600 unidades dispositivo.

    O físico página quase sempre é maior que a área imprimível da página e nunca menor.

    Windows CE 1.0 e 1.01 não suporte este valor.

    PHYSICALOFFSETX

    Para dispositivos impressão: a distância da borda esquerda do físico página à borda esquerda da área imprimível, no dispositivo unidades.

    De exemplo, uma impressora definida para imprimir em 600 dpi em 8.5"X11" Papel, que não é possível imprimir o 0.25" mais à esquerda de papel, tem um físico horizontal deslocamento de 150 unidades dispositivo.

    Windows CE 1.0 e 1.01 não suporte este valor.

    PHYSICALOFFSETY

    Para dispositivos impressão: a distância entre a parte superior borda do físico página para o parte superior borda da área imprimível, no dispositivo unidades.

    De exemplo, uma impressora definida para imprimir em 600 dpi em 8.5"X11" Papel, que não é possível imprimir a 0.5" de nível superior de papel, tem um físico vertical deslocamento de 300 unidades dispositivo.

    Windows CE 1.0 e 1.01 não suporte este valor.

    PHYSICALWIDTH

    Para dispositivos impressão: a largura do físico página, no dispositivo unidades.

    De exemplo, uma impressora definida para imprimir em 600 dpi em 8.5"X11" Papel tem um físico valor largura das unidades dispositivo 5100.

    O físico página quase sempre é maior que a área imprimível da página e nunca menor.

    Windows CE 1.0 e 1.01 não suporte este valor.

    PLANES Número de cor planos.
    POLYGONALCAPS Valor que indica os recursos polígono do dispositivo, como mostra a seguinte lista:
    PC_INTERIORS Dispositivo pode desenhar interiors.
    PC_NONE Dispositivo não tem suporte polígonos.
    PC_POLYGON Dispositivo pode desenhar alternativo-preencher polígonos.
    PC_RECTANGLE Dispositivo pode desenhar retângulos.
    PC_SCANLINE Dispositivo pode desenhar um scanline única.
    PC_STYLED Dispositivo pode desenhar com o estilo bordas.
    PC_WIDE Dispositivo pode desenhar bordas longa.
    PC_WIDESTYLED Dispositivo pode desenhar bordas que são ampla e styled.
    PC_WINDPOLYGON Dispositivo pode desenhar Enrolamento-preencher polígonos.
    RASTERCAPS Valor que indica as capacidades de Varredura do dispositivo, como mostra a seguinte lista:
    RC_BANDING Requer Faixa suporte.
    RC_BITBLT Capaz de transferir bitmaps.
    RC_BITMAP64 Capaz de suportar bitmaps maior que 64 k.
    RC_DI_BITMAP Capaz de suportar dispositivo bitmaps independentes.
    RC_DIBTODEV Sem suporte.
    RC_GDI20_OUTPUT Capaz de suportar recursos de 16-bit 2.0 Windows.
    RC_PALETTE Especifica um dispositivo palette-Based.
    RC_SCALING Capaz de dimensionamento.
    RC_STRETCHBLT Sem suporte.
    RC_STRETCHDIB Sem suporte.
    SHADEBLENDCAPS

    Valor que indica o sombreamento e misturando capacidades do dispositivo. Consulte " Comentários " para obter mais comentários.

    SB_CONST_ALPHA

    Controla o SourceConstantAlpha membro das BLENDFUNCTION estrutura, que é relacionado pela blendFunction parâmetro da AlphaBlend função.

    SB_GRAD_RECT

    Capaz de manipulação GradientFill retângulos.

    SB_GRAD_TRI

    Capaz de manipulação GradientFill Triângulos.

    0 Dispositivo não tem suporte qualquer desses recursos.
    SB_PIXEL_ALPHA Capaz de manipulação por-alfa pixel na AlphaBlend.
    SB_PREMULT_ALPHA Capaz de manipulação alfa premultiplied in AlphaBlend.
    SIZEPALETTE Número de entradas na paleta de sistema.

    Este índice é válido somente se o driver de dispositivo define o bit RC_PALETTE no índice de RASTERCAPS e está disponível somente se o driver for compatível com 16-bit Windows.

    Tecnologia

    Tecnologia de dispositivo. Ele pode ser qualquer uma do seguinte valores.

    DT_PLOTTER Vetor plotadora
    DT_RASDISPLAY Exibir de varredura
    DT_RASPRINTER Impressora de varredura
    DT_RASCAMERA Câmera de varredura
    DT_CHARSTREAM Transmitir caractere
    DT_DISPFILE Arquivo de Vídeo
    TEXTCAPS Valor que indica os recursos de texto do dispositivo, como mostra a seguinte lista:
    TC_CP_STROKE Dispositivo é capaz de traço juntar precisão.
    TC_CR_90 Dispositivo é capaz de rotação caractere 90-degree.
    TC_CR_ANY Dispositivo é capaz de rotação qualquer caractere.
    TC_EA_DOUBLE Dispositivo pode desenhar caracteres duplos peso.
    TC_IA_ABLE Dispositivo pode colocar em itálico.
    TC_OP_CHARACTER Dispositivo é capaz de caractere saída precisão.
    TC_OP_STROKE Dispositivo é capaz de traço saída precisão.
    TC_RA_ABLE Dispositivo pode desenhar as fontes de varredura.
    TC_RESERVED Reservado; Deve ser zero.
    TC_SA_CONTIN Dispositivo usa qualquer múltiplos para dimensionamento caractere exato.
    TC_SA_DOUBLE Dispositivo é capaz de caractere doubled para dimensionamento.
    TC_SA_INTEGER Dispositivo usa inteiro múltiplos somente para o dimensionamento caractere.
    TC_SCROLLBLT Dispositivo Não é possível rolar usando um bit-transferir bloco.

    Este significado pode ser o oposto do que você esperava.

    TC_SF_X_YINDEP Dispositivo pode escalabilidade de forma independente na x-and y-Directions.
    TC_SO_ABLE Dispositivo pode desenhar strikeouts.
    TC_UA_ABLE Dispositivo pode sublinhar.
    TC_VA_ABLE Dispositivo pode desenhar vetor fontes.
    VERTRES Altura, em linhas de varredura, da Tela.
    VERTSIZE Altura, em milímetros, do físico Tela.

Return Value

Retorna o valor do item desejado.

Remarks

A seguinte tabela mostra os índices seis que GetDeviceCaps Fornece no local da impressora escapa.

O índice Escape de impressora substituído

PHYSICALWIDTH

GETPHYSPAGESIZE

PHYSICALHEIGHT

GETPHYSPAGESIZE

PHYSICALOFFSETX

GETPRINTINGOFFSET

PHYSICALOFFSETY

GETPHYSICALOFFSET

Windows CE 1.0 e 1.01 não suporte esses índices.

Requirements

Header windows.h
Library coredll.lib
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

GetObjectType
StretchBlt
GDI Functions