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 |
|---|---|
|
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).
|
|
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. |
|
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. |
|
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. |
|
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).
|
|
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. |
|
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. |
|
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. |
|
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 .
|
|
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. |
|
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. |
|
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. |
|
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).
|
|
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. |
|
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. |
|
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 .
|
|
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. |
|
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. |
|
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).
|
|
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).
|
|
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).
|
|
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).
|
|
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. |
|
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. |
|
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. |
|
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).
|
|
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. |
|
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. |
|
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).
|
|
Não use. |
|
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. |
|
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. |
|
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. |
|
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).
|
|
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. |
|
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. |
|
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 .
|
|
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. |
|
Ativa ou desativa o recurso de acessibilidade ShowSounds. O parâmetro uiParam especifica TRUE para ativado ou FALSE para desativado. |
|
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).
|
|
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).
|
|
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 |
|---|---|
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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 . |
|
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. |
|
Recarrega os cursores do sistema. Defina o parâmetro uiParam como zero e o parâmetro pvParam como NULL. |
|
Define o padrão da área de trabalho atual fazendo com que o Windows leia a configuração Pattern= do arquivo WIN.INI. |
|
Nota Quando o sinalizador SPI_SETDESKWALLPAPER é usado, SystemParametersInfo retorna TRUE , a menos que haja um erro (como quando o arquivo especificado não existe).
|
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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 |
|---|---|
|
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).
|
|
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. |
|
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. |
|
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. |
|
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. |
|
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).
|
|
Recarrega os ícones do sistema. Defina o parâmetro uiParam como zero e o parâmetro pvParam como NULL. |
|
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 . |
|
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 |
|---|---|
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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 . |
|
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. |
|
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. |
|
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. |
|
Ativa ou desativa o aviso. O parâmetro uiParam especifica TRUE para ativado ou FALSE para desativado. |
|
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. |
|
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.
|
|
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. |
|
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 . |
|
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 . |
|
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 . |
|
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.
|
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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 . |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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 . |
|
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 |
|---|---|
|
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. |
|
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. |
|
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. |
|
Define o valor de alinhamento dos menus pop-up. O parâmetro uiParam especifica TRUE para alinhamento à direita ou FALSE para alinhamento esquerdo. |
|
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. |
|
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.
Veja a seguir os parâmetros de proteção de tela.
Veja a seguir os parâmetros de tempo limite para aplicativos e serviços.
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 |
|---|---|
|
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. |
|
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. |
|
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 . |
|
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. |
|
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. |
|
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. |
|
O mesmo que SPI_GETKEYBOARDCUES. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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 . |
|
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. |
|
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. |
|
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. |
|
O mesmo que SPI_SETKEYBOARDCUES. |
|
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. |
|
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. |
|
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 . |
|
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 |
|---|---|
|
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. |
|
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. |
|
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. |
|
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).
|
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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).
|
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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:
|
|
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. |
|
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. |
|
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. |
|
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).
|
|
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. |
|
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. |
|
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. |
|
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. |
|
Define o arrasto de janelas completas ativadas ou desativadas. O parâmetro uiParam especifica TRUE para ativado ou FALSE para desativado. |
|
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 . |
|
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 . |
|
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. |
|
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á. |
|
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).
|
|
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. |
|
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. |
|
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. |
|
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.
|
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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:
|
[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 |
|---|---|
|
Grava a nova configuração de parâmetro em todo o sistema no perfil do usuário. |
|
Transmite a mensagem WM_SETTINGCHANGE depois de atualizar o perfil do usuário. |
|
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) |