Compartilhar via


Função SystemParametersInfoA (winuser.h)

Importante

Algumas informações estão relacionadas a um produto de pré-lançamento que pode ser substancialmente modificado antes de ser lançado comercialmente. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Recupera ou define o valor de um dos parâmetros de todo o sistema. Essa função também pode atualizar o perfil do usuário ao definir um parâmetro.

Sintaxe

BOOL SystemParametersInfoA(
  [in]      UINT  uiAction,
  [in]      UINT  uiParam,
  [in, out] PVOID pvParam,
  [in]      UINT  fWinIni
);

Parâmetros

[in] uiAction

Tipo: UINT

O parâmetro de todo o sistema a ser recuperado ou definido. Os valores possíveis são organizados nas seguintes tabelas de parâmetros relacionados:

  • Parâmetros de acessibilidade
  • Parâmetros da área de trabalho
  • Parâmetros de ícone
  • Parâmetros de entrada
  • Parâmetros de menu
  • Parâmetros de energia
  • Parâmetros de salvamento de tela
  • Parâmetros de tempo limite
  • Parâmetros de efeito de interface do usuário
  • Parâmetros de janela

Veja a seguir os parâmetros de acessibilidade.

Parâmetro de acessibilidade Significado
SPI_GETACCESSTIMEOUT
0x003C
Recupera informações sobre o período de tempo limite associado aos recursos de acessibilidade. O parâmetro pvParam deve apontar para uma estrutura ACCESSTIMEOUT que receba as informações. Defina o membro cbSize dessa estrutura e o parâmetro uiParam como sizeof(ACCESSTIMEOUT).
SPI_GETAUDIODESCRIPTION
0x0074
Determina se as descrições de áudio estão habilitadas ou desabilitadas. O parâmetro pvParam é um ponteiro para uma estrutura AUDIODESCRIPTION . Defina o membro cbSize dessa estrutura e o parâmetro uiParam como sizeof(AUDIODESCRIPTION).

Embora seja possível que os usuários que têm deficiências visuais ouçam o áudio no conteúdo do vídeo, há muita ação no vídeo que não tem áudio correspondente. A descrição de áudio específica do que está acontecendo em um vídeo ajuda esses usuários a entender melhor o conteúdo. Esse sinalizador permite determinar se as descrições de áudio foram habilitadas e em qual idioma.

Windows Server 2003 e Windows XP/2000: Não há suporte para esse parâmetro.

SPI_GETCLIENTAREAANIMATION
0x1042
Determina se as animações estão habilitadas ou desabilitadas. O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE se as animações estiverem habilitadas ou FALSE caso contrário.

Exibir recursos como piscar, piscar, cintilar e mover conteúdo pode causar convulsões em usuários com epilepsia sensível a fotos. Esse sinalizador permite determinar se essas animações foram desabilitadas na área do cliente.

Windows Server 2003 e Windows XP/2000: Não há suporte para esse parâmetro.

SPI_GETDISABLEOVERLAPPEDCONTENT
0x1040
Determina se o conteúdo sobreposto está habilitado ou desabilitado. O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE se habilitado ou FALSE caso contrário.

Recursos de exibição, como imagens de plano de fundo, planos de fundo texturizados, marcas d'água em documentos, mesclagem alfa e transparência podem reduzir o contraste entre o primeiro plano e a tela de fundo, tornando mais difícil para os usuários com baixa visão ver objetos na tela. Esse sinalizador permite determinar se esse conteúdo sobreposto foi desabilitado.

Windows Server 2003 e Windows XP/2000: Não há suporte para esse parâmetro.

SPI_GETFILTERKEYS
0x0032
Recupera informações sobre o recurso de acessibilidade FilterKeys. O parâmetro pvParam deve apontar para uma estrutura FILTERKEYS que receba as informações. Defina o membro cbSize dessa estrutura e o parâmetro uiParam como sizeof(FILTERKEYS).
SPI_GETFOCUSBORDERHEIGHT
0x2010
Recupera a altura, em pixels, das bordas superior e inferior do retângulo de foco desenhado com DrawFocusRect. O parâmetro pvParam deve apontar para um valor UINT .

Windows 2000: Não há suporte para esse parâmetro.

SPI_GETFOCUSBORDERWIDTH
0x200E
Recupera a largura, em pixels, das bordas esquerda e direita do retângulo de foco desenhado com DrawFocusRect. O parâmetro pvParam deve apontar para um UINT.

Windows 2000: Não há suporte para esse parâmetro.

SPI_GETHIGHCONTRAST
0x0042
Recupera informações sobre o recurso de acessibilidade HighContrast. O parâmetro pvParam deve apontar para uma estrutura HIGHCONTRAST que recebe as informações. Defina o membro cbSize dessa estrutura e o parâmetro uiParam como sizeof(HIGHCONTRAST).

Para obter uma discussão geral, consulte Comentários.

SPI_GETLOGICALDPIOVERRIDE
0x009E
Recupera um valor que determina se o Windows 8 está exibindo aplicativos usando o planalto de dimensionamento padrão para o hardware ou indo para o próximo planalto superior. Esse valor se baseia na configuração atual "Tornar tudo na tela maior", encontrada na seção Facilidade de Acesso das configurações do computador: 1 está ativado, 0 está desativado.

Os aplicativos podem fornecer recursos de texto e imagem para cada um dos vários planaltos de dimensionamento: 100%, 140% e 180%. Fornecer recursos separados otimizados para uma escala específica evita distorção devido ao redimensionamento. O Windows 8 determina o planalto de dimensionamento apropriado com base em vários fatores, incluindo o tamanho da tela e a densidade de pixels. Quando "Tornar tudo na tela maior" é selecionado (SPI_GETLOGICALDPIOVERRIDE retorna um valor de 1), o Windows usa recursos do próximo planalto superior. Por exemplo, no caso de hardware que o Windows determina que deve usar uma escala de SCALE_100_PERCENT, essa substituição faz com que o Windows use o valor de escala SCALE_140_PERCENT , supondo que ele não viole outras restrições.

Nota Você não deve usar esse valor. Ele pode estar alterado ou indisponível em versões subsequentes do Windows. Em vez disso, use a função GetScaleFactorForDevice ou a classe DisplayProperties para recuperar o fator de dimensionamento preferencial. Os aplicativos da área de trabalho devem usar o DPI lógico da área de trabalho em vez do fator de escala. A DPI lógica da área de trabalho pode ser recuperada por meio da função GetDeviceCaps .
 
SPI_GETMESSAGEDURATION
0x2016
Recupera o tempo em que os pop-ups de notificação devem ser exibidos, em segundos. O parâmetro pvParam deve apontar para um ULONG que recebe a duração da mensagem.

Os usuários com deficiências visuais ou condições cognitivas, como TDAH e dislexia, podem precisar de mais tempo para ler o texto nas mensagens de notificação. Esse sinalizador permite que você recupere a duração da mensagem.

Windows Server 2003 e Windows XP/2000: Não há suporte para esse parâmetro.

SPI_GETMOUSECLICKLOCK
0x101E
Recupera o estado do recurso ClickLock do Mouse. O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE se habilitada ou FALSE caso contrário. Para obter mais informações, consulte Visão geral da entrada do mouse.

Windows 2000: Não há suporte para esse parâmetro.

SPI_GETMOUSECLICKLOCKTIME
0x2008
Recupera o atraso de tempo antes que o botão principal do mouse seja bloqueado. O parâmetro pvParam deve apontar para DWORD que recebe o atraso de tempo, em milissegundos. Isso só será habilitado se SPI_SETMOUSECLICKLOCK estiver definido como TRUE. Para obter mais informações, consulte Visão geral da entrada do mouse.

Windows 2000: Não há suporte para esse parâmetro.

SPI_GETMOUSEKEYS
0x0036
Recupera informações sobre o recurso de acessibilidade MouseKeys. O parâmetro pvParam deve apontar para uma estrutura MOUSEKEYS que receba as informações. Defina o membro cbSize dessa estrutura e o parâmetro uiParam como sizeof(MOUSEKEYS).
SPI_GETMOUSESONAR
0x101C
Recupera o estado do recurso Sonar do Mouse. O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE se habilitada ou FALSE caso contrário. Para obter mais informações, consulte Visão geral da entrada do mouse.

Windows 2000: Não há suporte para esse parâmetro.

SPI_GETMOUSEVANISH
0x1020
Recupera o estado do recurso Desapareça do Mouse. O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE se habilitada ou FALSE caso contrário. Para obter mais informações, consulte Visão geral da entrada do mouse.

Windows 2000: Não há suporte para esse parâmetro.

SPI_GETSCREENREADER
0x0046
Determina se um utilitário de revisor de tela está em execução. Um utilitário de revisor de tela direciona informações textuais para um dispositivo de saída, como um sintetizador de fala ou uma tela em Braille. Quando esse sinalizador é definido, um aplicativo deve fornecer informações textuais em situações em que, de outra forma, apresentaria as informações graficamente.

O parâmetro pvParam é um ponteiro para uma variável BOOL que recebe TRUE se um utilitário de revisor de tela estiver em execução ou FALSE caso contrário.

Nota O Narrador, o leitor de tela incluído no Windows, não define os sinalizadores de SPI_SETSCREENREADER ou SPI_GETSCREENREADER .
 
SPI_GETSERIALKEYS
0x003E
Não há suporte para esse parâmetro.

Windows Server 2003 e Windows XP/2000: O usuário deve controlar essa configuração por meio do Painel de Controle.

SPI_GETSHOWSOUNDS
0x0038
Determina se o sinalizador de acessibilidade Mostrar Sons está ativado ou desativado. Se estiver ativado, o usuário exigirá que um aplicativo apresente informações visualmente em situações em que, de outra forma, ele apresentaria as informações apenas de forma audível. O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE se o recurso estiver ativado ou FALSE se estiver desativado.

Usar esse valor é equivalente a chamar GetSystemMetrics com SM_SHOWSOUNDS. Essa é a chamada recomendada.

SPI_GETSOUNDSENTRY
0x0040
Recupera informações sobre o recurso de acessibilidade SoundSentry. O parâmetro pvParam deve apontar para uma estrutura SOUNDSENTRY que recebe as informações. Defina o membro cbSize dessa estrutura e o parâmetro uiParam como sizeof(SOUNDSENTRY).
SPI_GETSTICKYKEYS
0x003A
Recupera informações sobre o recurso de acessibilidade StickyKeys. O parâmetro pvParam deve apontar para uma estrutura STICKYKEYS que recebe as informações. Defina o membro cbSize dessa estrutura e o parâmetro uiParam como sizeof(STICKYKEYS).
SPI_GETTOGGLEKEYS
0x0034
Recupera informações sobre o recurso de acessibilidade ToggleKeys. O parâmetro pvParam deve apontar para uma estrutura TOGGLEKEYS que recebe as informações. Defina o membro cbSize dessa estrutura e o parâmetro uiParam como sizeof(TOGGLEKEYS).
SPI_SETACCESSTIMEOUT
0x003D
Define o período de tempo limite associado aos recursos de acessibilidade. O parâmetro pvParam deve apontar para uma estrutura ACCESSTIMEOUT que contenha os novos parâmetros. Defina o membro cbSize dessa estrutura e o parâmetro uiParam como sizeof(ACCESSTIMEOUT).
SPI_SETAUDIODESCRIPTION
0x0075
Ativa ou desativa o recurso de descrições de áudio. O parâmetro pvParam é um ponteiro para uma estrutura AUDIODESCRIPTION .

Embora seja possível que os usuários com deficiência visual ouçam o áudio no conteúdo do vídeo, há muita ação em vídeo que não tem áudio correspondente. Uma descrição de áudio específica do que está acontecendo em um vídeo ajuda esses usuários a entender melhor o conteúdo. Esse sinalizador permite habilitar ou desabilitar descrições de áudio nos idiomas em que elas são fornecidas.

Windows Server 2003 e Windows XP/2000: Não há suporte para esse parâmetro.

SPI_SETCLIENTAREAANIMATION
0x1043
Ativa ou desativa animações da área do cliente. O parâmetro pvParam é uma variável BOOL . Defina pvParam como TRUE para habilitar animações e outros efeitos transitórios na área do cliente ou FALSE para desabilitá-las.

Recursos de exibição como piscar, piscar, cintilar e mover conteúdo podem causar convulsões em usuários com epilepsia sensível à foto. Esse sinalizador permite habilitar ou desabilitar todas essas animações.

Windows Server 2003 e Windows XP/2000: Não há suporte para esse parâmetro.

SPI_SETDISABLEOVERLAPPEDCONTENT
0x1041
Ativa ou desativa o conteúdo sobreposto (como imagens de plano de fundo e marcas d'água). O parâmetro pvParam é uma variável BOOL . Defina pvParam como TRUE para desabilitar o conteúdo sobreposto ou FALSE para habilitar o conteúdo sobreposto.

Recursos de exibição como imagens de plano de fundo, planos de fundo texturizados, marcas d'água em documentos, mesclagem alfa e transparência podem reduzir o contraste entre o primeiro plano e a tela de fundo, tornando mais difícil para os usuários com baixa visão ver objetos na tela. Esse sinalizador permite habilitar ou desabilitar todo esse conteúdo sobreposto.

Windows Server 2003 e Windows XP/2000: Não há suporte para esse parâmetro.

SPI_SETFILTERKEYS
0x0033
Define os parâmetros do recurso de acessibilidade FilterKeys. O parâmetro pvParam deve apontar para uma estrutura FILTERKEYS que contenha os novos parâmetros. Defina o membro cbSize dessa estrutura e o parâmetro uiParam como sizeof(FILTERKEYS).
SPI_SETFOCUSBORDERHEIGHT
0x2011
Define a altura das bordas superior e inferior do retângulo de foco desenhado com DrawFocusRect como o valor do parâmetro pvParam .

Windows 2000: Não há suporte para esse parâmetro.

SPI_SETFOCUSBORDERWIDTH
0x200F
Define a altura das bordas esquerda e direita do retângulo de foco desenhado com DrawFocusRect como o valor do parâmetro pvParam .

Windows 2000: Não há suporte para esse parâmetro.

SPI_SETHIGHCONTRAST
0x0043
Define os parâmetros do recurso de acessibilidade HighContrast. O parâmetro pvParam deve apontar para uma estrutura HIGHCONTRAST que contenha os novos parâmetros. Defina o membro cbSize dessa estrutura e o parâmetro uiParam como sizeof(HIGHCONTRAST).
SPI_SETLOGICALDPIOVERRIDE
0x009F
Não use.
SPI_SETMESSAGEDURATION
0x2017
Define a hora em que os pop-ups de notificação devem ser exibidos, em segundos. O parâmetro pvParam especifica a duração da mensagem.

Os usuários com deficiências visuais ou condições cognitivas, como TDAH e dislexia, podem precisar de mais tempo para ler o texto em mensagens de notificação. Esse sinalizador permite definir a duração da mensagem.

Windows Server 2003 e Windows XP/2000: Não há suporte para esse parâmetro.

SPI_SETMOUSECLICKLOCK
0x101F
Ativa ou desativa o recurso de acessibilidade ClickLock do Mouse. Esse recurso bloqueia temporariamente o botão principal do mouse quando esse botão é clicado e mantido pressionado pelo tempo especificado por SPI_SETMOUSECLICKLOCKTIME. O parâmetro pvParam especifica TRUE para ativado ou FALSE para desativado. O padrão é off. Para obter mais informações, consulte Comentários e AboutMouse Input.

Windows 2000: Não há suporte para esse parâmetro.

SPI_SETMOUSECLICKLOCKTIME
0x2009
Ajusta o atraso de tempo antes que o botão principal do mouse seja bloqueado. O parâmetro uiParam deve ser definido como 0. O parâmetro pvParam aponta para um DWORD que especifica o atraso de tempo em milissegundos. Por exemplo, especifique 1000 para um atraso de 1 segundo. O padrão é 1200. Para obter mais informações, consulte Visão geral da entrada do mouse.

Windows 2000: Não há suporte para esse parâmetro.

SPI_SETMOUSEKEYS
0x0037
Define os parâmetros do recurso de acessibilidade MouseKeys. O parâmetro pvParam deve apontar para uma estrutura MOUSEKEYS que contenha os novos parâmetros. Defina o membro cbSize dessa estrutura e o parâmetro uiParam como sizeof(MOUSEKEYS).
SPI_SETMOUSESONAR
0x101D
Ativa ou desativa o recurso de acessibilidade do Sonar. Esse recurso mostra brevemente vários círculos concêntricos ao redor do ponteiro do mouse quando o usuário pressiona e libera a tecla CTRL. O parâmetro pvParam especifica TRUE para ativado e FALSE para desativado. O padrão é off. Para obter mais informações, consulte Visão geral da entrada do mouse.

Windows 2000: Não há suporte para esse parâmetro.

SPI_SETMOUSEVANISH
0x1021
Ativa ou desativa o recurso Desaparecer. Esse recurso oculta o ponteiro do mouse quando o usuário digita; o ponteiro reaparece quando o usuário move o mouse. O parâmetro pvParam especifica TRUE para ativado e FALSE para desativado. O padrão é off. Para obter mais informações, consulte Visão geral da entrada do mouse.

Windows 2000: Não há suporte para esse parâmetro.

SPI_SETSCREENREADER
0x0047
Determina se um utilitário de revisão de tela está em execução. O parâmetro uiParam especifica TRUE para ativado ou FALSE para desativado.
Nota O Narrador, o leitor de tela incluído no Windows, não define os sinalizadores de SPI_SETSCREENREADER ou SPI_GETSCREENREADER .
 
SPI_SETSERIALKEYS
0x003F
Não há suporte para esse parâmetro.

Windows Server 2003 e Windows XP/2000: O usuário deve controlar essa configuração por meio do Painel de Controle.

SPI_SETSHOWSOUNDS
0x0039
Ativa ou desativa o recurso de acessibilidade ShowSounds. O parâmetro uiParam especifica TRUE para ativado ou FALSE para desativado.
SPI_SETSOUNDSENTRY
0x0041
Define os parâmetros do recurso de acessibilidade SoundSentry . O parâmetro pvParam deve apontar para uma estrutura SOUNDSENTRY que contém os novos parâmetros. Defina o membro cbSize dessa estrutura e o parâmetro uiParam como sizeof(SOUNDSENTRY).
SPI_SETSTICKYKEYS
0x003B
Define os parâmetros do recurso de acessibilidade StickyKeys. O parâmetro pvParam deve apontar para uma estrutura STICKYKEYS que contenha os novos parâmetros. Defina o membro cbSize dessa estrutura e o parâmetro uiParam como sizeof(STICKYKEYS).
SPI_SETTOGGLEKEYS
0x0035
Define os parâmetros do recurso de acessibilidade ToggleKeys. O parâmetro pvParam deve apontar para uma estrutura TOGGLEKEYS que contenha os novos parâmetros. Defina o membro cbSize dessa estrutura e o parâmetro uiParam como sizeof(TOGGLEKEYS).
 

Veja a seguir os parâmetros da área de trabalho.

Parâmetro da área de trabalho Significado
SPI_GETCLEARTYPE
0x1048
Determina se ClearType está habilitado. O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE se ClearType estiver habilitado ou FALSE caso contrário.

ClearType é uma tecnologia de software que melhora a legibilidade do texto em monitores de tela de cristal líquido (LCD).

Windows Server 2003 e Windows XP/2000: Não há suporte para esse parâmetro.

SPI_GETDESKWALLPAPER
0x0073
Recupera o caminho completo do arquivo bitmap para o papel de parede da área de trabalho. O parâmetro pvParam deve apontar para um buffer para receber a cadeia de caracteres de caminho terminada em nulo. Defina o parâmetro uiParam como o tamanho, em caracteres, do buffer pvParam . A cadeia de caracteres retornada não excederá MAX_PATH caracteres. Se não houver papel de parede da área de trabalho, a cadeia de caracteres retornada estará vazia.
SPI_GETDROPSHADOW
0x1024
Determina se o efeito de sombra de soltar está habilitado. O parâmetro pvParam deve apontar para uma variável BOOL que retorna TRUE se habilitada ou FALSE se desabilitada.

Windows 2000: Não há suporte para esse parâmetro.

SPI_GETFLATMENU
0x1022
Determina se os menus nativos do Usuário têm aparência de menu simples. O parâmetro pvParam deve apontar para uma variável BOOL que retorna TRUE se a aparência do menu simples estiver definida ou FALSE caso contrário.

Windows 2000: Não há suporte para esse parâmetro.

SPI_GETFONTSMOOTHING
0x004A
Determina se o recurso de suavização de fonte está habilitado. Esse recurso usa a suavização de fonte para fazer as curvas de fonte parecerem mais suaves pintando pixels em diferentes níveis cinzas.

O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE se o recurso estiver habilitado ou FALSE se não estiver.

SPI_GETFONTSMOOTHINGCONTRAST
0x200C
Recupera um valor de contraste usado na suavização ClearType . O parâmetro pvParam deve apontar para um UINT que receba as informações. Os valores de contraste válidos são de 1000 a 2200. O valor padrão é 1400.

Windows 2000: Não há suporte para esse parâmetro.

SPI_GETFONTSMOOTHINGORIENTATION
0x2012
Recupera a orientação de suavização de fonte. O parâmetro pvParam deve apontar para um UINT que receba as informações. Os valores possíveis são FE_FONTSMOOTHINGORIENTATIONBGR (azul-verde-vermelho) e FE_FONTSMOOTHINGORIENTATIONRGB (vermelho-verde-azul).

Windows XP/2000: Esse parâmetro não tem suporte até o Windows XP com SP2.

SPI_GETFONTSMOOTHINGTYPE
0x200A
Recupera o tipo de suavização de fonte. O parâmetro pvParam deve apontar para um UINT que receba as informações. Os valores possíveis são FE_FONTSMOOTHINGSTANDARD e FE_FONTSMOOTHINGCLEARTYPE.

Windows 2000: Não há suporte para esse parâmetro.

SPI_GETWORKAREA
0x0030
Recupera o tamanho da área de trabalho no monitor de exibição primário. A área de trabalho é a parte da tela não obscurecida pela barra de tarefas do sistema ou pelas barras de ferramentas da área de trabalho do aplicativo. O parâmetro pvParam deve apontar para uma estrutura RECT que recebe as coordenadas da área de trabalho, expressas em tamanho de pixel físico. Qualquer modo de virtualização de DPI do chamador não tem efeito nessa saída.

Para obter a área de trabalho de um monitor diferente do monitor de exibição primário, chame a função GetMonitorInfo .

SPI_SETCLEARTYPE
0x1049
Ativa ou desativa o ClearType. O parâmetro pvParam é uma variável BOOL . Defina pvParam como TRUE para habilitar ClearType ou FALSE para desabilitá-lo.

ClearType é uma tecnologia de software que melhora a legibilidade do texto em monitores LCD.

Windows Server 2003 e Windows XP/2000: Não há suporte para esse parâmetro.

SPI_SETCURSORS
0x0057
Recarrega os cursores do sistema. Defina o parâmetro uiParam como zero e o parâmetro pvParam como NULL.
SPI_SETDESKPATTERN
0x0015
Define o padrão da área de trabalho atual fazendo com que o Windows leia a configuração Pattern= do arquivo WIN.INI.
SPI_SETDESKWALLPAPER
0x0014
Nota Quando o sinalizador SPI_SETDESKWALLPAPER é usado, SystemParametersInfo retorna TRUE , a menos que haja um erro (como quando o arquivo especificado não existe).
 
SPI_SETDROPSHADOW
0x1025
Habilita ou desabilita o efeito de sombra de soltar. Defina pvParam como TRUE para habilitar o efeito de sombra de soltar ou FALSE para desabilitá-lo. Você também deve ter CS_DROPSHADOW no estilo de classe de janela.

Windows 2000: Não há suporte para esse parâmetro.

SPI_SETFLATMENU
0x1023
Habilita ou desabilita a aparência do menu simples para menus nativos do Usuário. Defina pvParam como TRUE para habilitar a aparência do menu simples ou FALSE para desabilitá-lo.

Quando habilitada, a barra de menus usa COLOR_MENUBAR para a tela de fundo da barra de menus, COLOR_MENU para a tela de fundo do menu pop-up, COLOR_MENUHILIGHT para o preenchimento da seleção de menu atual e COLOR_HILIGHT para a estrutura de tópicos da seleção de menu atual. Se desabilitado, os menus serão desenhados usando as mesmas métricas e cores que no Windows 2000.

Windows 2000: Não há suporte para esse parâmetro.

SPI_SETFONTSMOOTHING
0x004B
Habilita ou desabilita o recurso de suavização de fonte, que usa a suavização de fonte para fazer as curvas de fonte parecerem mais suaves pintando pixels em diferentes níveis cinzas.

Para habilitar o recurso, defina o parâmetro uiParam como TRUE. Para desabilitar o recurso, defina uiParam como FALSE.

SPI_SETFONTSMOOTHINGCONTRAST
0x200D
Define o valor de contraste usado na suavização ClearType . O parâmetro pvParam é o valor de contraste. Os valores de contraste válidos são de 1000 a 2200. O valor padrão é 1400.

SPI_SETFONTSMOOTHINGTYPE também deve ser definido como FE_FONTSMOOTHINGCLEARTYPE.

Windows 2000: Não há suporte para esse parâmetro.

SPI_SETFONTSMOOTHINGORIENTATION
0x2013
Define a orientação de suavização de fonte. O parâmetro pvParam é FE_FONTSMOOTHINGORIENTATIONBGR (azul-verde-vermelho) ou FE_FONTSMOOTHINGORIENTATIONRGB (vermelho-verde-azul).

Windows XP/2000: Esse parâmetro não tem suporte até o Windows XP com SP2.

SPI_SETFONTSMOOTHINGTYPE
0x200B
Define o tipo de suavização de fonte. O parâmetro pvParam será FE_FONTSMOOTHINGSTANDARD, se o anti-aliasing padrão for usado ou FE_FONTSMOOTHINGCLEARTYPE, se ClearType for usado. O padrão é FE_FONTSMOOTHINGSTANDARD.

SPI_SETFONTSMOOTHING também deve ser definido.

Windows 2000: Não há suporte para esse parâmetro.

SPI_SETWORKAREA
0x002F
Define o tamanho da área de trabalho. A área de trabalho é a parte da tela não obscurecida pela barra de tarefas do sistema ou pelas barras de ferramentas da área de trabalho do aplicativo. O parâmetro pvParam é um ponteiro para uma estrutura RECT que especifica o novo retângulo da área de trabalho, expresso em coordenadas de tela virtual. Em um sistema com vários monitores de exibição, a função define a área de trabalho do monitor que contém o retângulo especificado.
 

Veja a seguir os parâmetros de ícone.

Parâmetro de ícone Significado
SPI_GETICONMETRICS
0x002D
Recupera as métricas associadas aos ícones. O parâmetro pvParam deve apontar para uma estrutura ICONMETRICS que recebe as informações. Defina o membro cbSize dessa estrutura e o parâmetro uiParam como sizeof(ICONMETRICS).
SPI_GETICONTITLELOGFONT
0x001F
Recupera as informações de fonte lógica para a fonte de título de ícone atual. O parâmetro uiParam especifica o tamanho de uma estrutura LOGFONT e o parâmetro pvParam deve apontar para a estrutura LOGFONT a ser preenchida.
SPI_GETICONTITLEWRAP
0x0019
Determina se a disposição icon-title está habilitada. O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE se habilitado ou FALSE caso contrário.
SPI_ICONHORIZONTALSPACING
0x000D
Define ou recupera a largura, em pixels, de uma célula de ícone. O sistema usa esse retângulo para organizar ícones na exibição de ícones grandes.

Para definir esse valor, defina uiParam como o novo valor e defina pvParam como NULL. Não é possível definir esse valor como menor que SM_CXICON.

Para recuperar esse valor, pvParam deve apontar para um inteiro que recebe o valor atual.

SPI_ICONVERTICALSPACING
0x0018
Define ou recupera a altura, em pixels, de uma célula de ícone.

Para definir esse valor, defina uiParam como o novo valor e defina pvParam como NULL. Você não pode definir esse valor como menor que SM_CYICON.

Para recuperar esse valor, pvParam deve apontar para um inteiro que recebe o valor atual.

SPI_SETICONMETRICS
0x002E
Define as métricas associadas aos ícones. O parâmetro pvParam deve apontar para uma estrutura ICONMETRICS que contenha os novos parâmetros. Defina o membro cbSize dessa estrutura e o parâmetro uiParam como sizeof(ICONMETRICS).
SPI_SETICONS
0x0058
Recarrega os ícones do sistema. Defina o parâmetro uiParam como zero e o parâmetro pvParam como NULL.
SPI_SETICONTITLELOGFONT
0x0022
Define a fonte usada para títulos de ícone. O parâmetro uiParam especifica o tamanho de uma estrutura LOGFONT e o parâmetro pvParam deve apontar para uma estrutura LOGFONT .
SPI_SETICONTITLEWRAP
0x001A
Ativa ou desativa o encapsulamento ícone-título. O parâmetro uiParam especifica TRUE para ativado ou FALSE para desativado.
 

Veja a seguir os parâmetros de entrada. Eles incluem parâmetros relacionados ao teclado, mouse, touchpad, caneta, idioma de entrada e o aviso mais profundo.

Parâmetro de entrada Significado
SPI_GETBEEP
0x0001
Determina se o aviso está ativado.

O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE se o beeper estiver ativado ou FALSE se estiver desativado.

SPI_GETBLOCKSENDINPUTRESETS
0x1026
Recupera um BOOL que indica se um aplicativo pode redefinir o temporizador do protetor de tela chamando a função SendInput para simular a entrada do teclado ou do mouse. O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE se a entrada simulada for bloqueada ou FALSE caso contrário.
SPI_GETCONTACTVISUALIZATION
0x2018
Recupera a configuração de visualização de contato atual. O parâmetro pvParam deve apontar para uma variável ULONG que recebe a configuração. Para obter mais informações, consulte Visualização de Contato.
SPI_GETDEFAULTINPUTLANG
0x0059
Recupera o identificador de localidade de entrada para o idioma de entrada padrão do sistema. O parâmetro pvParam deve apontar para uma variável HKL que recebe esse valor. Para obter mais informações, consulte Idiomas, localidades e layouts de teclado.
SPI_GETGESTUREVISUALIZATION
0x201A
Recupera a configuração de visualização de gesto atual. O parâmetro pvParam deve apontar para uma variável ULONG que recebe a configuração. Para obter mais informações, consulte Visualização de Gestos.
SPI_GETKEYBOARDCUES
0x100A
Determina se as chaves de acesso ao menu são sempre sublinhadas. O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE se as teclas de acesso do menu estiverem sempre sublinhadas e FALSE se elas forem sublinhadas somente quando o menu for ativado pelo teclado.
SPI_GETKEYBOARDDELAY
0x0016
Recupera a configuração de atraso de repetição do teclado, que é um valor no intervalo de 0 (aproximadamente 250 ms de atraso) até 3 (atraso de aproximadamente 1 segundo). O atraso real associado a cada valor pode variar dependendo do hardware. O parâmetro pvParam deve apontar para uma variável de inteiro que recebe a configuração.
SPI_GETKEYBOARDPREF
0x0044
Determina se o usuário depende do teclado em vez do mouse e deseja que os aplicativos exibam interfaces de teclado que, de outra forma, estariam ocultas. O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE se o usuário depende do teclado; ou FALSE caso contrário.
SPI_GETKEYBOARDSPEED
0x000A
Recupera a configuração de velocidade de repetição do teclado, que é um valor no intervalo de 0 (aproximadamente 2,5 repetições por segundo) a 31 (aproximadamente 30 repetições por segundo). As taxas reais de repetição são dependentes de hardware e podem variar de uma escala linear em até 20%. O parâmetro pvParam deve apontar para uma variável DWORD que recebe a configuração.
SPI_GETMOUSE
0x0003
Recupera os dois valores de limite do mouse e a aceleração do mouse. O parâmetro pvParam deve apontar para uma matriz de três inteiros que recebe esses valores. Consulte mouse_event para obter mais informações.
SPI_GETMOUSEHOVERHEIGHT
0x0064
Recupera a altura, em pixels, do retângulo no qual o ponteiro do mouse precisa permanecer para TrackMouseEvent gerar uma mensagem WM_MOUSEHOVER . O parâmetro pvParam deve apontar para uma variável UINT que recebe a altura.
SPI_GETMOUSEHOVERTIME
0x0066
Recupera o tempo, em milissegundos, que o ponteiro do mouse precisa permanecer no retângulo de foco para TrackMouseEvent para gerar uma mensagem WM_MOUSEHOVER . O parâmetro pvParam deve apontar para uma variável UINT que recebe a hora.
SPI_GETMOUSEHOVERWIDTH
0x0062
Recupera a largura, em pixels, do retângulo no qual o ponteiro do mouse precisa permanecer para TrackMouseEvent gerar uma mensagem WM_MOUSEHOVER . O parâmetro pvParam deve apontar para uma variável UINT que recebe a largura.
SPI_GETMOUSESPEED
0x0070
Recupera a velocidade atual do mouse. A velocidade do mouse determina até que ponto o ponteiro se moverá com base na distância que o mouse move. O parâmetro pvParam deve apontar para um inteiro que recebe um valor que varia entre 1 (mais lento) e 20 (mais rápido). Um valor de 10 é o padrão. O valor pode ser definido por um usuário final usando o aplicativo do painel de controle do mouse ou por um aplicativo usando SPI_SETMOUSESPEED.
SPI_GETMOUSETRAILS
0x005E
Determina se o recurso Trilhas do Mouse está habilitado. Esse recurso melhora a visibilidade dos movimentos do cursor do mouse mostrando brevemente uma trilha de cursores e apagando-os rapidamente.

O parâmetro pvParam deve apontar para uma variável de inteiro que recebe um valor. se o valor for zero ou 1, o recurso será desabilitado. Se o valor for maior que 1, o recurso será habilitado e o valor indicará o número de cursores desenhados na trilha. O parâmetro uiParam não é usado.

Windows 2000: Não há suporte para esse parâmetro.

SPI_GETMOUSEWHEELROUTING
0x201C
Recupera a configuração de roteamento para entrada da roda do mouse. A configuração de roteamento determina se a entrada da roda do mouse é enviada para o aplicativo com foco (primeiro plano) ou o aplicativo sob o cursor do mouse.

O parâmetro pvParam deve apontar para uma variável DWORD que recebe a opção de roteamento. O parâmetro uiParam não é usado.

Se o valor for zero (MOUSEWHEEL_ROUTING_FOCUS), a entrada da roda do mouse será entregue ao aplicativo com foco. Se o valor for 1 (MOUSEWHEEL_ROUTING_HYBRID), a entrada da roda do mouse será entregue ao aplicativo com foco (aplicativos da área de trabalho) ou o aplicativo sob o ponteiro do mouse (aplicativos da Windows Store).

A partir do Windows 10: Se o valor for 2 (MOUSEWHEEL_ROUTING_MOUSE_POS), a entrada da roda do mouse será entregue ao aplicativo sob o ponteiro do mouse. Esse é o novo padrão e MOUSEWHEEL_ROUTING_HYBRID não está mais disponível em Configurações.

SPI_GETPENVISUALIZATION
0x201E
Recupera a configuração de visualização de gesto de caneta atual. O parâmetro pvParam deve apontar para uma variável ULONG que recebe a configuração. Para obter mais informações, consulte Visualização de caneta.
SPI_GETSNAPTODEFBUTTON
0x005F
Determina se o recurso snap-to-default-button está habilitado. Se habilitado, o cursor do mouse será movido automaticamente para o botão padrão, como OK ou Aplicar, de uma caixa de diálogo. O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE se o recurso estiver ativado ou FALSE se ele estiver desativado.
SPI_GETSYSTEMLANGUAGEBAR
0x1050
A partir do Windows 8: Determina se a barra de idiomas do sistema está habilitada ou desabilitada. O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE se a barra de idiomas estiver habilitada ou FALSE caso contrário.
SPI_GETTHREADLOCALINPUTSETTINGS
0x104E
A partir do Windows 8: Determina se as configurações de entrada ativas têm escopo Local (por thread, TRUE) ou Global (sessão, FALSE). O parâmetro pvParam deve apontar para uma variável BOOL .
SPI_GETTOUCHPADPARAMETERS
0x00AE
A partir do Windows 11, versão 24H2: Recupera detalhes sobre o Touchpad de Precisão, incluindo as configurações do usuário e as informações do sistema relacionadas ao touchpad.

O parâmetro pvParam deve apontar para uma estrutura de TOUCHPAD_PARAMETERS .

O parâmetro uiParam deve especificar o tamanho da estrutura.

O valor do campo versionNumber na estrutura TOUCHPAD_PARAMETERS deve ser definido como o valor apropriado para a versão da estrutura que está sendo usada.

SPI_GETWHEELSCROLLCHARS
0x006C
Recupera o número de caracteres a serem rolados quando a roda horizontal do mouse é movida. O parâmetro pvParam deve apontar para uma variável UINT que recebe o número de linhas. O valor padrão é 3.
SPI_GETWHEELSCROLLLINES
0x0068
Recupera o número de linhas a serem roladas quando a roda vertical do mouse é movida. O parâmetro pvParam deve apontar para uma variável UINT que recebe o número de linhas. O valor padrão é 3.
SPI_SETBEEP
0x0002
Ativa ou desativa o aviso. O parâmetro uiParam especifica TRUE para ativado ou FALSE para desativado.
SPI_SETBLOCKSENDINPUTRESETS
0x1027
Determina se um aplicativo pode redefinir o temporizador do protetor de tela chamando a função SendInput para simular a entrada de teclado ou mouse. O parâmetro uiParam especifica TRUE se o protetor de tela não for desativado por entrada simulada ou FALSE se o protetor de tela for desativado por entrada simulada.
SPI_SETCONTACTVISUALIZATION
0x2019
Define a configuração de visualização de contato atual. O parâmetro pvParam deve apontar para uma variável ULONG que identifique a configuração. Para obter mais informações, consulte Visualização de Contato.
Nota Se as visualizações de contato estiverem desabilitadas, as visualizações de gesto não poderão ser habilitadas.
 
SPI_SETDEFAULTINPUTLANG
0x005A
Define o idioma de entrada padrão para o shell do sistema e os aplicativos. O idioma especificado deve ser exibido usando o conjunto de caracteres do sistema atual. O parâmetro pvParam deve apontar para uma variável HKL que contenha o identificador de localidade de entrada para o idioma padrão. Para obter mais informações, consulte Idiomas, localidades e layouts de teclado.
SPI_SETDOUBLECLICKTIME
0x0020
Define o tempo de clique duplo para o mouse como o valor do parâmetro uiParam . Se o valor uiParam for maior que 5000 milissegundos, o sistema definirá o tempo de clique duplo como 5000 milissegundos.

O tempo de clique duplo é o número máximo de milissegundos que podem ocorrer entre o primeiro e o segundo cliques de um clique duplo. Você também pode chamar a função SetDoubleClickTime para definir o tempo de clique duplo. Para obter o tempo de clique duplo atual, chame a função GetDoubleClickTime .

SPI_SETDOUBLECLKHEIGHT
0x001E
Define a altura do retângulo de clique duplo como o valor do parâmetro uiParam .

O retângulo de clique duplo é o retângulo no qual o segundo clique de um clique duplo deve cair para que ele seja registrado como um clique duplo.

Para recuperar a altura do retângulo de clique duplo, chame GetSystemMetrics com o sinalizador SM_CYDOUBLECLK .

SPI_SETDOUBLECLKWIDTH
0x001D
Define a largura do retângulo de clique duplo para o valor do parâmetro uiParam .

O retângulo de clique duplo é o retângulo no qual o segundo clique de um clique duplo deve cair para que ele seja registrado como um clique duplo.

Para recuperar a largura do retângulo de clique duplo, chame GetSystemMetrics com o sinalizador SM_CXDOUBLECLK .

SPI_SETGESTUREVISUALIZATION
0x201B
Define a configuração de visualização de gesto atual. O parâmetro pvParam deve apontar para uma variável ULONG que identifique a configuração. Para obter mais informações, consulte Visualização de gestos.
Nota Se as visualizações de contato estiverem desabilitadas, as visualizações de gesto não poderão ser habilitadas.
 
SPI_SETKEYBOARDCUES
0x100B
Define o sublinhado das letras-chave de acesso do menu. O parâmetro pvParam é uma variável BOOL . Defina pvParam como TRUE para sempre sublinhar as teclas de acesso do menu ou FALSE para sublinhar as teclas de acesso do menu somente quando o menu for ativado do teclado.
SPI_SETKEYBOARDDELAY
0x0017
Define a configuração de atraso de repetição do teclado. O parâmetro uiParam deve especificar 0, 1, 2 ou 3, em que zero define o atraso mais curto de aproximadamente 250 ms) e 3 define o atraso mais longo (aproximadamente 1 segundo). O atraso real associado a cada valor pode variar dependendo do hardware.
SPI_SETKEYBOARDPREF
0x0045
Define a preferência do teclado. O parâmetro uiParam especifica TRUE se o usuário depende do teclado em vez do mouse e deseja que os aplicativos exibam interfaces de teclado que, de outra forma, estariam ocultas; UiParam será FALSE caso contrário.
SPI_SETKEYBOARDSPEED
0x000B
Define a configuração de velocidade de repetição do teclado. O parâmetro uiParam deve especificar um valor no intervalo de 0 (aproximadamente 2,5 repetições por segundo) a 31 (aproximadamente 30 repetições por segundo). As taxas reais de repetição são dependentes de hardware e podem variar de uma escala linear em até 20%. Se uiParam for maior que 31, o parâmetro será definido como 31.
SPI_SETLANGTOGGLE
0x005B
Define o conjunto de teclas de acesso para alternar entre idiomas de entrada. Os parâmetros uiParam e pvParam não são usados. O valor define as teclas de atalho nas folhas de propriedades do teclado lendo o registro novamente. O registro deve ser definido antes que esse sinalizador seja usado. o caminho no registro é HKEY_CURRENT_USER\Layout do Teclado\Alternância

. Os valores válidos são "1" = ALT+SHIFT, "2" = CTRL+SHIFT e "3" = nenhum.
SPI_SETMOUSE
0x0004
Define os dois valores de limite do mouse e a aceleração do mouse. O parâmetro pvParam deve apontar para uma matriz de três inteiros que especifica esses valores. Consulte mouse_event para obter mais informações.
SPI_SETMOUSEBUTTONSWAP
0x0021
Troca ou restaura o significado dos botões esquerdo e direito do mouse. O parâmetro uiParam especifica TRUE para trocar os significados dos botões ou FALSE para restaurar seus significados originais.

Para recuperar a configuração atual, chame GetSystemMetrics com o sinalizador SM_SWAPBUTTON .

SPI_SETMOUSEHOVERHEIGHT
0x0065
Define a altura, em pixels, do retângulo no qual o ponteiro do mouse deve permanecer para TrackMouseEvent gerar uma mensagem WM_MOUSEHOVER . Defina o parâmetro uiParam como a nova altura.
SPI_SETMOUSEHOVERTIME
0x0067
Define o tempo, em milissegundos, em que o ponteiro do mouse deve permanecer no retângulo de foco para TrackMouseEvent gerar uma mensagem WM_MOUSEHOVER . Isso será usado somente se você passar HOVER_DEFAULT no parâmetro dwHoverTime na chamada para TrackMouseEvent. Defina o parâmetro uiParam como a nova hora.

O tempo especificado deve estar entre USER_TIMER_MAXIMUM e USER_TIMER_MINIMUM. Se uiParam for menor que USER_TIMER_MINIMUM, a função usará USER_TIMER_MINIMUM. Se uiParam for maior que USER_TIMER_MAXIMUM, a função será USER_TIMER_MAXIMUM.

Windows Server 2003 e Windows XP: O sistema operacional não impõe o uso de USER_TIMER_MAXIMUM e USER_TIMER_MINIMUM até o Windows Server 2003 com SP1 e Windows XP com SP2.

SPI_SETMOUSEHOVERWIDTH
0x0063
Define a largura, em pixels, do retângulo no qual o ponteiro do mouse deve permanecer para TrackMouseEvent gerar uma mensagem WM_MOUSEHOVER . Defina o parâmetro uiParam como a nova largura.
SPI_SETMOUSESPEED
0x0071
Define a velocidade atual do mouse. O parâmetro pvParam é um inteiro entre 1 (mais lento) e 20 (mais rápido). Um valor de 10 é o padrão. Esse valor normalmente é definido usando o aplicativo do painel de controle do mouse.
SPI_SETMOUSETRAILS
0x005D
Habilita ou desabilita o recurso Trilhas do Mouse, o que melhora a visibilidade dos movimentos do cursor do mouse mostrando brevemente uma trilha de cursores e apagando-os rapidamente.

Para desabilitar o recurso, defina o parâmetro uiParam como zero ou 1. Para habilitar o recurso, defina uiParam como um valor maior que 1 para indicar o número de cursores desenhados na trilha.

Windows 2000: Não há suporte para esse parâmetro.

SPI_SETMOUSEWHEELROUTING
0x201D
Define a configuração de roteamento para entrada da roda do mouse. A configuração de roteamento determina se a entrada da roda do mouse é enviada para o aplicativo com foco (primeiro plano) ou o aplicativo sob o cursor do mouse.

O parâmetro pvParam deve apontar para uma variável DWORD que recebe a opção de roteamento. Defina o parâmetro uiParam como zero.

Se o valor for zero (MOUSEWHEEL_ROUTING_FOCUS), a entrada da roda do mouse será entregue ao aplicativo com foco. Se o valor for 1 (MOUSEWHEEL_ROUTING_HYBRID), a entrada da roda do mouse será entregue ao aplicativo com foco (aplicativos da área de trabalho) ou o aplicativo sob o ponteiro do mouse (aplicativos da Windows Store).

A partir do Windows 10: Se o valor for 2 (MOUSEWHEEL_ROUTING_MOUSE_POS), a entrada da roda do mouse será entregue ao aplicativo sob o ponteiro do mouse. Esse é o novo padrão e MOUSEWHEEL_ROUTING_HYBRID não está mais disponível em Configurações.

SPI_SETPENVISUALIZATION
0x201F
Define a configuração de visualização de gesto de caneta atual. O parâmetro pvParam deve apontar para uma variável ULONG que identifique a configuração. Para obter mais informações, consulte Visualização de caneta.
SPI_SETSNAPTODEFBUTTON
0x0060
Habilita ou desabilita o recurso snap-to-default-button. Se habilitado, o cursor do mouse se move automaticamente para o botão padrão, como OK ou Aplicar, de uma caixa de diálogo. Defina o parâmetro uiParam como TRUE para habilitar o recurso ou FALSE para desabilitá-lo. Os aplicativos devem usar a função ShowWindow ao exibir uma caixa de diálogo para que o gerenciador de diálogo possa posicionar o cursor do mouse.
SPI_SETSYSTEMLANGUAGEBAR
0x1051
A partir do Windows 8: Ativa ou desativa o recurso de barra de idioma herdado. O parâmetro pvParam é um ponteiro para uma variável BOOL . Defina pvParam como TRUE para habilitar a barra de idiomas herdada ou FALSE para desabilitá-la. O sinalizador tem suporte no Windows 8, onde a barra de idiomas herdada é substituída pelo Comutador de Entrada e, portanto, desativada por padrão. Ativar a barra de idiomas herdada é fornecido por motivos de compatibilidade e não tem efeito no Comutador de Entrada.
SPI_SETTHREADLOCALINPUTSETTINGS
0x104F
A partir do Windows 8: Determina se as configurações de entrada ativas têm escopo Local (por thread, TRUE) ou Global (sessão, FALSE). O parâmetro pvParam deve ser uma variável BOOL , convertida por PVOID.
SPI_SETTOUCHPADPARAMETERS
0x00AF
A partir do Windows 11, versão 24H2: Define detalhes sobre o Precision Touchpad, incluindo as configurações do usuário e as informações do sistema relacionadas ao touchpad.

O parâmetro pvParam deve apontar para uma estrutura de TOUCHPAD_PARAMETERS .

O parâmetro uiParam deve especificar o tamanho da estrutura.

O valor do campo versionNumber na estrutura TOUCHPAD_PARAMETERS deve ser definido como o valor apropriado para a versão da estrutura que está sendo usada.

SPI_SETWHEELSCROLLCHARS
0x006D
Define o número de caracteres a rolar quando a roda horizontal do mouse é movida. O número de caracteres é definido do parâmetro uiParam .
SPI_SETWHEELSCROLLLINES
0x0069
Define o número de linhas a rolar quando a roda vertical do mouse é movida. O número de linhas é definido do parâmetro uiParam .

O número de linhas é o número sugerido de linhas a rolar quando a roda do mouse é rolada sem usar teclas modificadoras. Se o número for 0, nenhuma rolagem deverá ocorrer. Se o número de linhas a serem roladas for maior que o número de linhas que podem ser visualizadas e, em particular, se for WHEEL_PAGESCROLL (#defined como UINT_MAX), a operação de rolagem deverá ser interpretada como clicando uma vez na página para baixo ou nas regiões de página para cima da barra de rolagem.

 

A seguir estão os parâmetros de menu.

Parâmetro de menu Significado
SPI_GETMENUDROPALIGNMENT
0x001B
Determina se os menus pop-up são alinhados à esquerda ou alinhados à direita, em relação ao item de barra de menus correspondente. O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE se alinhado à direita ou FALSE caso contrário.
SPI_GETMENUFADE
0x1012
Determina se a animação de fade do menu está habilitada. O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE quando a animação fade está habilitada e FALSE quando está desabilitada. Se a animação fade estiver desabilitada, os menus usarão animação de slide. Esse sinalizador é ignorado, a menos que a animação de menu esteja habilitada, o que você pode fazer usando o sinalizador SPI_SETMENUANIMATION . Para obter mais informações, consulte AnimateWindow.
SPI_GETMENUSHOWDELAY
0x006A
Recupera o tempo, em milissegundos, que o sistema espera antes de exibir um menu de atalho quando o cursor do mouse está sobre um item de submenu. O parâmetro pvParam deve apontar para uma variável DWORD que recebe o tempo do atraso.
SPI_SETMENUDROPALIGNMENT
0x001C
Define o valor de alinhamento dos menus pop-up. O parâmetro uiParam especifica TRUE para alinhamento à direita ou FALSE para alinhamento esquerdo.
SPI_SETMENUFADE
0x1013
Habilita ou desabilita a animação de fade do menu. Defina pvParam como TRUE para habilitar o efeito fade do menu ou FALSE para desabilitá-lo. Se a animação fade estiver desabilitada, os menus usarão animação de slide. he O efeito de fade do menu só será possível se o sistema tiver uma profundidade de cor de mais de 256 cores. Esse sinalizador é ignorado, a menos que SPI_MENUANIMATION também esteja definido. Para obter mais informações, consulte AnimateWindow.
SPI_SETMENUSHOWDELAY
0x006B
Define uiParam como a hora, em milissegundos, que o sistema aguarda antes de exibir um menu de atalho quando o cursor do mouse está sobre um item de submenu.
 

Veja a seguir os parâmetros de energia.

A partir do Windows Server 2008 e do Windows Vista, não há suporte para esses parâmetros de energia. Em vez disso, para determinar o estado de energia de exibição atual, um aplicativo deve se registrar para notificações de GUID_MONITOR_POWER_STATE . Para determinar o tempo limite de desligamento de exibição atual, um aplicativo deve se registrar para notificação de alterações na configuração de energia GUID_VIDEO_POWERDOWN_TIMEOUT . Para obter mais informações, consulte Registrando-se para eventos de energia.

Windows Server 2003 e Windows XP/2000: Para determinar o estado de energia de exibição atual, use os seguintes parâmetros de energia.

Parâmetro power Significado
SPI_GETLOWPOWERACTIVE
0x0053
Não há suporte para esse parâmetro.

Windows Server 2003 e Windows XP/2000: Determina se a fase de baixa potência do salvamento de tela está habilitada. O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE se habilitada ou FALSE se desabilitada. Esse sinalizador tem suporte apenas para aplicativos de 32 bits.

SPI_GETLOWPOWERTIMEOUT
0x004F
Não há suporte para esse parâmetro.

Windows Server 2003 e Windows XP/2000: Recupera o valor de tempo limite para a fase de baixa potência de economia de tela. O parâmetro pvParam deve apontar para uma variável inteiro que recebe o valor. Esse sinalizador tem suporte apenas para aplicativos de 32 bits.

SPI_GETPOWEROFFACTIVE
0x0054
Não há suporte para esse parâmetro. Quando a fase de desligar o salvamento de tela está habilitada, a configuração de energia GUID_VIDEO_POWERDOWN_TIMEOUT é maior que zero.

Windows Server 2003 e Windows XP/2000: Determina se a fase de desligar o salvamento de tela está habilitada. O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE se habilitada ou FALSE se desabilitada. Esse sinalizador tem suporte apenas para aplicativos de 32 bits.

SPI_GETPOWEROFFTIMEOUT
0x0050
Não há suporte para esse parâmetro. Em vez disso, verifique a configuração de energia GUID_VIDEO_POWERDOWN_TIMEOUT .

Windows Server 2003 e Windows XP/2000: Recupera o valor de tempo limite para a fase de desligar do salvamento de tela. O parâmetro pvParam deve apontar para uma variável inteiro que recebe o valor. Esse sinalizador tem suporte apenas para aplicativos de 32 bits.

SPI_SETLOWPOWERACTIVE
0x0055
Não há suporte para esse parâmetro.

Windows Server 2003 e Windows XP/2000: Ativa ou desativa a fase de baixa potência do salvamento de tela. Defina uiParam como 1 para ativar ou zero para desativar. O parâmetro pvParam deve ser NULL. Esse sinalizador tem suporte apenas para aplicativos de 32 bits.

SPI_SETLOWPOWERTIMEOUT
0x0051
Não há suporte para esse parâmetro.

Windows Server 2003 e Windows XP/2000: Define o valor de tempo limite, em segundos, para a fase de baixa potência do salvamento de tela. O parâmetro uiParam especifica o novo valor. O parâmetro pvParam deve ser NULL. Esse sinalizador tem suporte apenas para aplicativos de 32 bits.

SPI_SETPOWEROFFACTIVE
0x0056
Não há suporte para esse parâmetro. Em vez disso, defina a configuração de energia GUID_VIDEO_POWERDOWN_TIMEOUT .

Windows Server 2003 e Windows XP/2000: Ativa ou desativa a fase de desligar do salvamento de tela. Defina uiParam como 1 para ativar ou zero para desativar. O parâmetro pvParam deve ser NULL. Esse sinalizador tem suporte apenas para aplicativos de 32 bits.

SPI_SETPOWEROFFTIMEOUT
0x0052
Não há suporte para esse parâmetro. Em vez disso, defina a configuração de energia GUID_VIDEO_POWERDOWN_TIMEOUT como um valor de tempo limite.

Windows Server 2003 e Windows XP/2000: Define o valor de tempo limite, em segundos, para a fase de desligar do salvamento de tela. O parâmetro uiParam especifica o novo valor. O parâmetro pvParam deve ser NULL. Esse sinalizador tem suporte apenas para aplicativos de 32 bits.

 

Veja a seguir os parâmetros de proteção de tela.

Parâmetro de proteção de tela Significado
SPI_GETSCREENSAVEACTIVE
0x0010
Determina se o salvamento de tela está habilitado. O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE se o salvamento de tela estiver habilitado ou FALSE caso contrário.

Windows 7, Windows Server 2008 R2 e Windows 2000: A função retorna TRUE mesmo quando o salvamento de tela não está habilitado.

SPI_GETSCREENSAVERRUNNING
0x0072
Determina se um protetor de tela está em execução na estação de janela do processo de chamada. O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE se um protetor de tela estiver em execução no momento ou FALSE caso contrário. Observe que apenas a estação de janela interativa, WinSta0, pode ter um protetor de tela em execução.
SPI_GETSCREENSAVESECURE
0x0076
Determina se o protetor de tela requer uma senha para exibir a área de trabalho do Windows. O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE se o protetor de tela exigir uma senha ou FALSE caso contrário. O parâmetro uiParam é ignorado.

Windows Server 2003 e Windows XP/2000: Não há suporte para esse parâmetro.

SPI_GETSCREENSAVETIMEOUT
0x000E
Recupera o valor de tempo limite da economia de tela, em segundos. O parâmetro pvParam deve apontar para uma variável de inteiro que recebe o valor.
SPI_SETSCREENSAVEACTIVE
0x0011
Define o estado da proteção de tela. O parâmetro uiParam especifica TRUE para ativar o salvamento de tela ou FALSE para desativá-lo.

Se o computador tiver entrado no modo de economia de energia ou no estado de bloqueio do sistema, ocorrerá uma exceção ERROR_OPERATION_IN_PROGRESS.

SPI_SETSCREENSAVESECURE
0x0077
Define se o protetor de tela exige que o usuário insira uma senha para exibir a área de trabalho do Windows. O parâmetro uiParam é uma variável BOOL . O parâmetro pvParam é ignorado. Defina uiParam como TRUE para exigir uma senha ou FALSE para não exigir uma senha.

Se o computador tiver entrado no modo de economia de energia ou no estado de bloqueio do sistema, ocorrerá uma exceção ERROR_OPERATION_IN_PROGRESS.

Windows Server 2003 e Windows XP/2000: Não há suporte para esse parâmetro.

SPI_SETSCREENSAVETIMEOUT
0x000F
Define o valor de tempo limite de economia de tela como o valor do parâmetro uiParam . Esse valor é a quantidade de tempo, em segundos, que o sistema deve estar ocioso antes que o protetor de tela seja ativado.

Se o computador tiver entrado no modo de economia de energia ou no estado de bloqueio do sistema, ocorrerá uma exceção ERROR_OPERATION_IN_PROGRESS.

 

Veja a seguir os parâmetros de tempo limite para aplicativos e serviços.

Parâmetro de tempo limite Significado
SPI_GETHUNGAPPTIMEOUT
0x0078
Recupera o número de milissegundos que um thread pode passar sem expedir uma mensagem antes que o sistema a considere sem resposta. O parâmetro pvParam deve apontar para uma variável de inteiro que recebe o valor.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Não há suporte para esse parâmetro.

SPI_GETWAITTOKILLTIMEOUT
0x007A
Recupera o número de milissegundos que o sistema aguarda antes de encerrar um aplicativo que não responde a uma solicitação de desligamento. O parâmetro pvParam deve apontar para uma variável de inteiro que recebe o valor.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Não há suporte para esse parâmetro.

SPI_GETWAITTOKILLSERVICETIMEOUT
0x007C
Recupera o número de milissegundos que o gerenciador de controle de serviço aguarda antes de encerrar um serviço que não responde a uma solicitação de desligamento. O parâmetro pvParam deve apontar para uma variável de inteiro que recebe o valor.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Não há suporte para esse parâmetro.

SPI_SETHUNGAPPTIMEOUT
0x0079
Define o tempo limite do aplicativo suspenso como o valor do parâmetro uiParam . Esse valor é o número de milissegundos que um thread pode passar sem expedir uma mensagem antes que o sistema a considere sem resposta.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Não há suporte para esse parâmetro.

SPI_SETWAITTOKILLTIMEOUT
0x007B
Define o tempo limite da solicitação de desligamento do aplicativo para o valor do parâmetro uiParam . Esse valor é o número de milissegundos que o sistema aguarda antes de encerrar um aplicativo que não responde a uma solicitação de desligamento.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Não há suporte para esse parâmetro.

SPI_SETWAITTOKILLSERVICETIMEOUT
0x007D
Define o tempo limite da solicitação de desligamento do serviço como o valor do parâmetro uiParam . Esse valor é o número de milissegundos que o sistema aguarda antes de encerrar um serviço que não responde a uma solicitação de desligamento.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Não há suporte para esse parâmetro.

 

Veja a seguir os efeitos da interface do usuário. O valor SPI_SETUIEFFECTS é usado para habilitar ou desabilitar todos os efeitos da interface do usuário de uma só vez. Esta tabela contém a lista completa de valores de efeito de interface do usuário.

Parâmetro de efeitos de interface do usuário Significado
SPI_GETCOMBOBOXANIMATION
0x1004
Determina se o efeito de abertura de slide para caixas de combinação está habilitado. O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE para habilitado ou FALSE para desabilitado.
SPI_GETCURSORSHADOW
0x101A
Determina se o cursor tem uma sombra ao seu redor. O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE se a sombra estiver habilitada, FALSE se estiver desabilitada. Esse efeito será exibido somente se o sistema tiver uma profundidade de cor de mais de 256 cores.
SPI_GETGRADIENTCAPTIONS
0x1008
Determina se o efeito de gradiente para barras de título da janela está habilitado. O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE para habilitado ou FALSE para desabilitado. Para obter mais informações sobre o efeito de gradiente, consulte a função GetSysColor .
SPI_GETHOTTRACKING
0x100E
Determina se o acompanhamento frequente de elementos da interface do usuário, como nomes de menu nas barras de menus, está habilitado. O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE para habilitado ou FALSE para desabilitado.

O acompanhamento frequente significa que, quando o cursor se move sobre um item, ele é realçado, mas não selecionado. Você pode consultar esse valor para decidir se deseja usar o acompanhamento frequente na interface do usuário do seu aplicativo.

SPI_GETLISTBOXSMOOTHSCROLLING
0x1006
Determina se o efeito de rolagem suave para caixas de listagem está habilitado. O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE para habilitado ou FALSE para desabilitado.
SPI_GETMENUANIMATION
0x1002
Determina se o recurso de animação de menu está habilitado. Essa opção mestra deve estar ativada para habilitar efeitos de animação de menu. O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE se a animação estiver habilitada e FALSE se estiver desabilitada.

Se a animação estiver habilitada, SPI_GETMENUFADE indica se os menus usam esmaecimento ou animação de slide.

SPI_GETMENUUNDERLINES
0x100A
O mesmo que SPI_GETKEYBOARDCUES.
SPI_GETSELECTIONFADE
0x1014
Determina se o efeito de esmaecimento de seleção está habilitado. O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE se habilitada ou FALSE se desabilitada.

O efeito de esmaecimento de seleção faz com que o item de menu selecionado pelo usuário permaneça na tela brevemente enquanto desaparece após o menu ser ignorado.

SPI_GETTOOLTIPANIMATION
0x1016
Determina se a animação tooltip está habilitada. O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE se habilitada ou FALSE se desabilitada. Se a animação tooltip estiver habilitada, SPI_GETTOOLTIPFADE indica se as Dicas de Ferramenta usam fade ou animação de slide.
SPI_GETTOOLTIPFADE
0x1018
Se SPI_SETTOOLTIPANIMATION estiver habilitado, SPI_GETTOOLTIPFADE indicará se a animação tooltip usa um efeito fade ou um efeito de slide. O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE para animação de fade ou FALSE para animação de slide. Para obter mais informações sobre efeitos de slide e fade, consulte AnimateWindow.
SPI_GETUIEFFECTS
0x103E
Determina se os efeitos da interface do usuário estão habilitados ou desabilitados. O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE se todos os efeitos de interface do usuário estiverem habilitados ou FALSE se estiverem desabilitados.
SPI_SETCOMBOBOXANIMATION
0x1005
Habilita ou desabilita o efeito de abertura de slides para caixas de combinação. Defina o parâmetro pvParam como TRUE para habilitar o efeito de gradiente ou FALSE para desabilitá-lo.
SPI_SETCURSORSHADOW
0x101B
Habilita ou desabilita uma sombra ao redor do cursor. O parâmetro pvParam é uma variável BOOL . Defina pvParam como TRUE para habilitar a sombra ou FALSE para desabilitar a sombra. Esse efeito será exibido somente se o sistema tiver uma profundidade de cor de mais de 256 cores.
SPI_SETGRADIENTCAPTIONS
0x1009
Habilita ou desabilita o efeito de gradiente para barras de título da janela. Defina o parâmetro pvParam como TRUE para habilitá-lo ou FALSE para desabilitá-lo. O efeito de gradiente só será possível se o sistema tiver uma profundidade de cor de mais de 256 cores. Para obter mais informações sobre o efeito de gradiente, consulte a função GetSysColor .
SPI_SETHOTTRACKING
0x100F
Habilita ou desabilita o acompanhamento frequente de elementos da interface do usuário, como nomes de menu nas barras de menus. Defina o parâmetro pvParam como TRUE para habilitá-lo ou FALSE para desabilitá-lo.

O acompanhamento frequente significa que, quando o cursor se move sobre um item, ele é realçado, mas não selecionado.

SPI_SETLISTBOXSMOOTHSCROLLING
0x1007
Habilita ou desabilita o efeito de rolagem suave para caixas de listagem. Defina o parâmetro pvParam como TRUE para habilitar o efeito de rolagem suave ou FALSE para desabilitá-lo.
SPI_SETMENUANIMATION
0x1003
Habilita ou desabilita a animação do menu. Essa opção mestra deve estar ativada para que qualquer animação de menu ocorra. O parâmetro pvParam é uma variável BOOL ; defina pvParam como TRUE para habilitar a animação e FALSE para desabilitar a animação.

Se a animação estiver habilitada, SPI_GETMENUFADE indica se os menus usam esmaecimento ou animação de slide.

SPI_SETMENUUNDERLINES
0x100B
O mesmo que SPI_SETKEYBOARDCUES.
SPI_SETSELECTIONFADE
0x1015
Defina pvParam como TRUE para habilitar o efeito de fade da seleção ou FALSE para desabilitá-lo.

O efeito de esmaecimento de seleção faz com que o item de menu selecionado pelo usuário permaneça na tela brevemente enquanto desaparece após o menu ser ignorado. O efeito de esmaecimento de seleção só será possível se o sistema tiver uma profundidade de cor de mais de 256 cores.

SPI_SETTOOLTIPANIMATION
0x1017
Defina pvParam como TRUE para habilitar a animação tooltip ou FALSE para desabilitá-la. Se habilitado, você pode usar SPI_SETTOOLTIPFADE para especificar a animação de fade ou slide.
SPI_SETTOOLTIPFADE
0x1019
Se o sinalizador SPI_SETTOOLTIPANIMATION estiver habilitado, use SPI_SETTOOLTIPFADE para indicar se a animação tooltip usa um efeito fade ou um efeito de slide. Defina pvParam como TRUE para animação de fade ou FALSE para animação de slide. O efeito de fade da dica de ferramenta só será possível se o sistema tiver uma profundidade de cor de mais de 256 cores. Para obter mais informações sobre os efeitos de esmaecimento e slide, consulte a função AnimateWindow .
SPI_SETUIEFFECTS
0x103F
Habilita ou desabilita os efeitos da interface do usuário. Defina o parâmetro pvParam como TRUE para habilitar todos os efeitos da interface do usuário ou FALSE para desabilitar todos os efeitos da interface do usuário.
 

Veja a seguir os parâmetros de janela.

Parâmetro window Significado
SPI_GETACTIVEWINDOWTRACKING
0x1000
Determina se o rastreamento de janela ativo (ativando a janela em que o mouse está ativado) está ativado ou desativado. O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE para ativado ou FALSE para desativado.
SPI_GETACTIVEWNDTRKZORDER
0x100C
Determina se as janelas ativadas por meio do rastreamento de janela ativo serão levadas para a parte superior. O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE para ativado ou FALSE para desativado.
SPI_GETACTIVEWNDTRKTIMEOUT
0x2002
Recupera o atraso de rastreamento de janela ativa, em milissegundos. O parâmetro pvParam deve apontar para uma variável DWORD que recebe a hora.
SPI_GETANIMATION
0x0048
Recupera os efeitos de animação associados às ações do usuário. O parâmetro pvParam deve apontar para uma estrutura ANIMATIONINFO que recebe as informações. Defina o membro cbSize dessa estrutura e o parâmetro uiParam como sizeof(ANIMATIONINFO).
SPI_GETBORDER
0x0005
Recupera o fator multiplicador de borda que determina a largura da borda de dimensionamento de uma janela. O parâmetro pvParam deve apontar para uma variável de inteiro que recebe esse valor.
SPI_GETCARETWIDTH
0x2006
Recupera a largura do cursor em controles de edição, em pixels. O parâmetro pvParam deve apontar para uma variável DWORD que recebe esse valor.
SPI_GETDOCKMOVING
0x0090
Determina se uma janela é encaixada quando ela é movida para as bordas superior, esquerda ou direita de uma matriz de monitor ou monitor. O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE se habilitada ou FALSE caso contrário.

Use SPI_GETWINARRANGING para determinar se esse comportamento está habilitado.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Não há suporte para esse parâmetro.

SPI_GETDRAGFROMMAXIMIZE
0x008C
Determina se uma janela maximizada é restaurada quando sua barra de legenda é arrastada. O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE se habilitada ou FALSE caso contrário.

Use SPI_GETWINARRANGING para determinar se esse comportamento está habilitado.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Não há suporte para esse parâmetro.

SPI_GETDRAGFULLWINDOWS
0x0026
Determina se a arrastar janelas completas está habilitada. O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE se habilitada ou FALSE caso contrário.
SPI_GETFOREGROUNDFLASHCOUNT
0x2004
Recupera o número de vezes que SetForegroundWindow piscará o botão da barra de tarefas ao rejeitar uma solicitação de comutador em primeiro plano. O parâmetro pvParam deve apontar para uma variável DWORD que recebe o valor.
SPI_GETFOREGROUNDLOCKTIMEOUT
0x2000
Recupera a quantidade de tempo após a entrada do usuário, em milissegundos, durante o qual o sistema não permitirá que os aplicativos se forcem em primeiro plano. O parâmetro pvParam deve apontar para uma variável DWORD que recebe a hora.
SPI_GETMINIMIZEDMETRICS
0x002B
Recupera as métricas associadas a janelas minimizadas. O parâmetro pvParam deve apontar para uma estrutura MINIMIZEDMETRICS que recebe as informações. Defina o membro cbSize dessa estrutura e o parâmetro uiParam como sizeof(MINIMIZEDMETRICS).
SPI_GETMOUSEDOCKTHRESHOLD
0x007E
Recupera o limite em pixels em que o comportamento de encaixe é disparado usando um mouse para arrastar uma janela para a borda de uma matriz de monitor ou monitor. O limite padrão é 1. O parâmetro pvParam deve apontar para uma variável DWORD que recebe o valor.

Use SPI_GETWINARRANGING para determinar se esse comportamento está habilitado.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Não há suporte para esse parâmetro.

SPI_GETMOUSEDRAGOUTTHRESHOLD
0x0084
Recupera o limite em pixels em que o comportamento de desencaixe é disparado usando um mouse para arrastar uma janela da borda de um monitor ou uma matriz de monitor em direção ao centro. O limite padrão é 20.

Use SPI_GETWINARRANGING para determinar se esse comportamento está habilitado.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Não há suporte para esse parâmetro.

SPI_GETMOUSESIDEMOVETHRESHOLD
0x0088
Recupera o limite em pixels da parte superior de um monitor ou de uma matriz de monitores em que uma janela maximizada verticalmente é restaurada quando arrastada com o mouse. O limite padrão é 50.

Use SPI_GETWINARRANGING para determinar se esse comportamento está habilitado.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Não há suporte para esse parâmetro.

SPI_GETNONCLIENTMETRICS
0x0029
Recupera as métricas associadas à área não cliente de janelas não minimizadas. O parâmetro pvParam deve apontar para uma estrutura NONCLIENTMETRICS que recebe as informações. Defina o membro cbSize dessa estrutura e o parâmetro uiParam como sizeof(NONCLIENTMETRICS).

Windows Server 2003 e Windows XP/2000: Consulte Comentários para NONCLIENTMETRICS.

SPI_GETPENDOCKTHRESHOLD
0x0080
Recupera o limite em pixels em que o comportamento de encaixe é disparado usando uma caneta para arrastar uma janela para a borda de uma matriz de monitor ou monitor. O padrão é 30.

Use SPI_GETWINARRANGING para determinar se esse comportamento está habilitado.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Não há suporte para esse parâmetro.

SPI_GETPENDRAGOUTTHRESHOLD
0x0086
Recupera o limite em pixels em que o comportamento de desencaixe é disparado usando uma caneta para arrastar uma janela da borda de um monitor ou monitorar matriz em direção ao centro. O limite padrão é 30.

Use SPI_GETWINARRANGING para determinar se esse comportamento está habilitado.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Não há suporte para esse parâmetro.

SPI_GETPENSIDEMOVETHRESHOLD
0x008A
Recupera o limite em pixels da parte superior de uma matriz de monitores ou monitores em que uma janela maximizada verticalmente é restaurada quando arrastada com o mouse. O limite padrão é 50.

Use SPI_GETWINARRANGING para determinar se esse comportamento está habilitado.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Não há suporte para esse parâmetro.

SPI_GETSHOWIMEUI
0x006E
Determina se a janela de status do IME está visível (por usuário). O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE se a janela de status estiver visível ou FALSE se não estiver.
SPI_GETSNAPSIZING
0x008E
Determina se uma janela é maximizada verticalmente quando é dimensionada para a parte superior ou inferior de uma matriz de monitor ou monitor. O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE se habilitado ou FALSE caso contrário.

Use SPI_GETWINARRANGING para determinar se esse comportamento está habilitado.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Não há suporte para esse parâmetro.

SPI_GETWINARRANGING
0x0082
Determina se a disposição da janela está habilitada. O parâmetro pvParam deve apontar para uma variável BOOL que recebe TRUE se habilitado ou FALSE caso contrário.

A disposição da janela reduz o número de interações de mouse, caneta ou toque necessárias para mover e dimensionar janelas de nível superior simplificando o comportamento padrão de uma janela quando ela é arrastada ou dimensionada.

Os seguintes parâmetros recuperam as configurações de arranjo de janela individuais:

SPI_GETDOCKMOVING
SPI_GETMOUSEDOCKTHRESHOLD
SPI_GETMOUSEDRAGOUTTHRESHOLD
SPI_GETMOUSESIDEMOVETHRESHOLD
SPI_GETPENDOCKTHRESHOLD
SPI_GETPENDRAGOUTTHRESHOLD
SPI_GETPENSIDEMOVETHRESHOLD
SPI_GETSNAPSIZING
Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Não há suporte para esse parâmetro.
SPI_SETACTIVEWINDOWTRACKING
0x1001
Define o acompanhamento ativo da janela (ativando a janela em que o mouse está ativado) ativado ou desativado. Defina pvParam como TRUE para ativado ou FALSE para desativado.
SPI_SETACTIVEWNDTRKZORDER
0x100D
Determina se as janelas ativadas por meio do rastreamento de janela ativo devem ser ou não levadas para a parte superior. Defina pvParam como TRUE para ativado ou FALSE para desativado.
SPI_SETACTIVEWNDTRKTIMEOUT
0x2003
Define o atraso de acompanhamento de janela ativo. Defina pvParam como o número de milissegundos para atrasar antes de ativar a janela sob o ponteiro do mouse.
SPI_SETANIMATION
0x0049
Define os efeitos de animação associados às ações do usuário. O parâmetro pvParam deve apontar para uma estrutura ANIMATIONINFO que contenha os novos parâmetros. Defina o membro cbSize dessa estrutura e o parâmetro uiParam como sizeof(ANIMATIONINFO).
SPI_SETBORDER
0x0006
Define o fator multiplicador de borda que determina a largura da borda de dimensionamento de uma janela. O parâmetro uiParam especifica o novo valor.
SPI_SETCARETWIDTH
0x2007
Define a largura do cursor em controles de edição. Defina pvParam para a largura desejada, em pixels. O valor padrão e mínimo é 1.
SPI_SETDOCKMOVING
0x0091
Define se uma janela é encaixada quando é movida para os destinos de encaixe superior, esquerdo ou direito em uma matriz de monitor ou monitor. Defina pvParam como TRUE para ativado ou FALSE para desativado.

SPI_GETWINARRANGING deve ser TRUE para habilitar esse comportamento.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Não há suporte para esse parâmetro.

SPI_SETDRAGFROMMAXIMIZE
0x008D
Define se uma janela maximizada é restaurada quando sua barra de legenda é arrastada. Defina pvParam como TRUE para ativado ou FALSE para desativado.

SPI_GETWINARRANGING deve ser TRUE para habilitar esse comportamento.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Não há suporte para esse parâmetro.

SPI_SETDRAGFULLWINDOWS
0x0025
Define o arrasto de janelas completas ativadas ou desativadas. O parâmetro uiParam especifica TRUE para ativado ou FALSE para desativado.
SPI_SETDRAGHEIGHT
0x004D
Define a altura, em pixels, do retângulo usado para detectar o início de uma operação de arrastar. Defina uiParam como o novo valor. Para recuperar a altura de arrastar, chame GetSystemMetrics com o sinalizador SM_CYDRAG .
SPI_SETDRAGWIDTH
0x004C
Define a largura, em pixels, do retângulo usado para detectar o início de uma operação de arrastar. Defina uiParam como o novo valor. Para recuperar a largura de arrastar, chame GetSystemMetrics com o sinalizador SM_CXDRAG .
SPI_SETFOREGROUNDFLASHCOUNT
0x2005
Define o número de vezes que SetForegroundWindow piscará o botão da barra de tarefas ao rejeitar uma solicitação de comutador em primeiro plano. Defina pvParam como o número de vezes a piscar.
SPI_SETFOREGROUNDLOCKTIMEOUT
0x2001
Define a quantidade de tempo após a entrada do usuário, em milissegundos, durante o qual o sistema não permite que os aplicativos se forcem em primeiro plano. Defina pvParam como o novo valor de tempo limite.

O thread de chamada deve ser capaz de alterar a janela em primeiro plano, caso contrário, a chamada falhará.

SPI_SETMINIMIZEDMETRICS
0x002C
Define as métricas associadas a janelas minimizadas. O parâmetro pvParam deve apontar para uma estrutura MINIMIZEDMETRICS que contenha os novos parâmetros. Defina o membro cbSize dessa estrutura e o parâmetro uiParam como sizeof(MINIMIZEDMETRICS).
SPI_SETMOUSEDOCKTHRESHOLD
0x007F
Define o limite em pixels em que o comportamento de encaixe é disparado usando um mouse para arrastar uma janela para a borda de uma matriz de monitor ou monitor. O limite padrão é 1. O parâmetro pvParam deve apontar para uma variável DWORD que contenha o novo valor.

SPI_GETWINARRANGING deve ser TRUE para habilitar esse comportamento.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Não há suporte para esse parâmetro.

SPI_SETMOUSEDRAGOUTTHRESHOLD
0x0085
Define o limite em pixels em que o comportamento de desencaixe é disparado usando um mouse para arrastar uma janela da borda de uma matriz de monitor ou monitor para seu centro. O limite padrão é 20. O parâmetro pvParam deve apontar para uma variável DWORD que contenha o novo valor.

SPI_GETWINARRANGING deve ser TRUE para habilitar esse comportamento.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Não há suporte para esse parâmetro.

SPI_SETMOUSESIDEMOVETHRESHOLD
0x0089
Define o limite em pixels da parte superior do monitor em que uma janela maximizada verticalmente é restaurada quando arrastada com o mouse. O limite padrão é 50. O parâmetro pvParam deve apontar para uma variável DWORD que contenha o novo valor.

SPI_GETWINARRANGING deve ser TRUE para habilitar esse comportamento.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Não há suporte para esse parâmetro.

SPI_SETNONCLIENTMETRICS
0x002A
Define as métricas associadas à área não cliente de janelas não minimizadas. O parâmetro pvParam deve apontar para uma estrutura NONCLIENTMETRICS que contenha os novos parâmetros. Defina o membro cbSize dessa estrutura e o parâmetro uiParam como sizeof(NONCLIENTMETRICS). Além disso, o membro lfHeight da estrutura LOGFONT deve ser um valor negativo.
SPI_SETPENDOCKTHRESHOLD
0x0081
Define o limite em pixels em que o comportamento de encaixe é disparado usando uma caneta para arrastar uma janela para a borda de uma matriz monitor ou monitor. O limite padrão é 30. O parâmetro pvParam deve apontar para uma variável DWORD que contenha o novo valor.

SPI_GETWINARRANGING deve ser TRUE para habilitar esse comportamento.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Não há suporte para esse parâmetro.

SPI_SETPENDRAGOUTTHRESHOLD
0x0087
Define o limite em pixels em que o comportamento de desencaixe é disparado usando uma caneta para arrastar uma janela da borda de uma matriz de monitor ou monitor para seu centro. O limite padrão é 30. O parâmetro pvParam deve apontar para uma variável DWORD que contenha o novo valor.

SPI_GETWINARRANGING deve ser TRUE para habilitar esse comportamento.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Não há suporte para esse parâmetro.

SPI_SETPENSIDEMOVETHRESHOLD
0x008B
Define o limite em pixels da parte superior do monitor em que uma janela maximizada verticalmente é restaurada quando arrastada com uma caneta. O limite padrão é 50. O parâmetro pvParam deve apontar para uma variável DWORD que contenha o novo valor.

SPI_GETWINARRANGING deve ser TRUE para habilitar esse comportamento.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Não há suporte para esse parâmetro.

SPI_SETSHOWIMEUI
0x006F
Define se a janela de status do IME está visível ou não por usuário. O parâmetro uiParam especifica TRUE para ativado ou FALSE para desativado.
SPI_SETSNAPSIZING
0x008F
Define se uma janela é maximizada verticalmente quando é dimensionada para a parte superior ou inferior do monitor. Defina pvParam como TRUE para ativado ou FALSE para desativado.

SPI_GETWINARRANGING deve ser TRUE para habilitar esse comportamento.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Não há suporte para esse parâmetro.

SPI_SETWINARRANGING
0x0083
Define se a disposição da janela está habilitada. Defina pvParam como TRUE para ativado ou FALSE para desativado.

A disposição da janela reduz o número de interações de mouse, caneta ou toque necessárias para mover e dimensionar janelas de nível superior simplificando o comportamento padrão de uma janela quando ela é arrastada ou dimensionada.

Os seguintes parâmetros definem as configurações de arranjo de janela individuais:

SPI_SETDOCKMOVING
SPI_SETMOUSEDOCKTHRESHOLD
SPI_SETMOUSEDRAGOUTTHRESHOLD
SPI_SETMOUSESIDEMOVETHRESHOLD
SPI_SETPENDOCKTHRESHOLD
SPI_SETPENDRAGOUTTHRESHOLD
SPI_SETPENSIDEMOVETHRESHOLD
SPI_SETSNAPSIZING
Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Não há suporte para esse parâmetro.

[in] uiParam

Tipo: UINT

Um parâmetro cujo uso e formato dependem do parâmetro do sistema que está sendo consultado ou definido. Para obter mais informações sobre parâmetros de todo o sistema, consulte o parâmetro uiAction . Se não for indicado de outra forma, você deverá especificar zero para esse parâmetro.

[in, out] pvParam

Tipo: PVOID

Um parâmetro cujo uso e formato dependem do parâmetro do sistema que está sendo consultado ou definido. Para obter mais informações sobre parâmetros de todo o sistema, consulte o parâmetro uiAction . Se não for indicado de outra forma, você deverá especificar NULL para esse parâmetro. Para obter informações sobre o tipo de dados PVOID , consulte Tipos de dados do Windows.

[in] fWinIni

Tipo: UINT

Se um parâmetro do sistema estiver sendo definido, especifica se o perfil de usuário deve ser atualizado e, nesse caso, se a mensagem WM_SETTINGCHANGE deve ser transmitida para todas as janelas de nível superior para notificá-los sobre a alteração.

Esse parâmetro poderá ser zero se você não quiser atualizar o perfil do usuário ou transmitir a mensagem WM_SETTINGCHANGE ou pode ser um ou mais dos valores a seguir.

Valor Significado
SPIF_UPDATEINIFILE
Grava a nova configuração de parâmetro em todo o sistema no perfil do usuário.
SPIF_SENDCHANGE
Transmite a mensagem WM_SETTINGCHANGE depois de atualizar o perfil do usuário.
SPIF_SENDWININICHANGE
O mesmo que SPIF_SENDCHANGE.

Retornar valor

Tipo: BOOL

Se a função for bem-sucedida, o valor retornado será um valor diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Essa função destina-se ao uso com aplicativos que permitem ao usuário personalizar o ambiente.

Um nome de layout de teclado deve ser derivado do valor hexadecimal do identificador de idioma correspondente ao layout. Por exemplo, o inglês dos EUA tem um identificador de idioma de 0x0409, portanto, o layout principal em inglês dos EUA é chamado de "00000409". Variantes do layout em inglês dos EUA, como o layout Dvorak, são chamadas de "00010409", "00020409" e assim por diante. Para obter uma lista dos identificadores de idioma primários e identificadores de sublanguage que compõem um identificador de idioma, consulte a macro MAKELANGID .

Há uma diferença entre o esquema de cores de Alto Contraste e o Modo de Alto Contraste. O esquema de cores de Alto Contraste altera as cores do sistema para cores que têm contraste óbvio; você alterna para esse esquema de cores usando as Opções de Exibição no painel de controle. O Modo de Alto Contraste, que usa SPI_GETHIGHCONTRAST e SPI_SETHIGHCONTRAST, aconselha os aplicativos a modificar sua aparência para usuários com deficiência visual. Ele envolve coisas como aviso audível para os usuários e esquema de cores personalizado (usando as Opções de Acessibilidade no painel de controle). Para obter mais informações, consulte HIGHCONTRAST. Para obter mais informações sobre recursos gerais de acessibilidade, consulte Acessibilidade.

Durante o tempo em que o botão primário é mantido pressionado para ativar o recurso ClickLock do Mouse, o usuário pode mover o mouse. Depois que o botão primário é bloqueado, liberar o botão primário não resulta em uma mensagem de WM_LBUTTONUP . Portanto, será exibido para um aplicativo que o botão primário ainda está inativo. Qualquer mensagem de botão subsequente libera o botão primário, enviando uma mensagem WM_LBUTTONUP para o aplicativo, portanto, o botão pode ser desbloqueado programaticamente ou por meio do usuário clicando em qualquer botão.

Essa API não tem reconhecimento de DPI e não deve ser usada se o thread de chamada estiver ciente do DPI por monitor. Para obter a versão com reconhecimento de DPI dessa API, consulte SystemParametersInfoForDPI. Para obter mais informações sobre o reconhecimento de DPI, consulte a documentação do Windows High DPI.

Exemplos

O exemplo a seguir usa SystemParametersInfo para dobrar a velocidade do mouse.


#include <windows.h>
#include <stdio.h>
#pragma comment(lib, "user32.lib")    

void main()  
{     
    BOOL fResult;
    int aMouseInfo[3];    // Array for mouse information
    
    // Get the current mouse speed.         
    fResult = SystemParametersInfo(SPI_GETMOUSE,   // Get mouse information
                                   0,              // Not used
                                   &aMouseInfo,    // Holds mouse information
                                   0);             // Not used           
                                   
    // Double it.         
    if( fResult )     
    {
        aMouseInfo[2] = 2 * aMouseInfo[2];
        
        // Change the mouse speed to the new value.
        SystemParametersInfo(SPI_SETMOUSE,      // Set mouse information
                             0,                 // Not used
                             aMouseInfo,        // Mouse information
                             SPIF_SENDCHANGE);  // Update Win.ini
    }  
}

Observação

O cabeçalho winuser.h define SystemParametersInfo como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winuser.h (inclua Windows.h)
Biblioteca User32.lib
DLL User32.dll
Conjunto de APIs ext-ms-win-ntuser-sysparams-ext-l1-1-0 (introduzido no Windows 8)

Confira também

ACCESSTIMEOUT

ANIMATIONINFO

AUDIODESCRIPTION

FILTERKEYS

HIGHCONTRAST

ICONMETRICS

LOGFONT

MAKELANGID

MINIMIZEDMETRICS

MOUSEKEYS

NONCLIENTMETRICS

RECT

SERIALKEYS

SOUNDSENTRY

STICKYKEYS

SystemParametersInfoForDPI

TOGGLEKEYS

WM_SETTINGCHANGE

Tipos de dados do Windows