SHSipPreference

9/9/2008

Essa função solicita uma alteração de posição para a entrada painel.

Syntax

BOOL SHSipPreference(
  HWND hwnd,
  SIPSTATE st
);

Parameters

• hwnd
  [no] Identificador para a janela solicitando a entrada desejada posição painel.

• ST
  [no] Especifica a posição solicitada para a entrada painel. A seguinte tabela mostra os valores permitidos para este parâmetro.

  Valor	Descrição
  SIP_UP	Uma solicitação para exibir a entrada painel. Qualquer pendente SIP_DOWN solicitações são ignoradas.
  SIP_DOWN	Uma solicitação para ocultar a entrada painel. Quando esse valor é usado, um timer é conjunto e a entrada painel é reduzido apenas depois que a mensagem timer for recebida. Essa abordagem evita a entrada SIP_UP solicitações painel do piscando quando um controle solicita SIP_DOWN e outro controle imediatamente.
  SIP_FORCEDOWN	Força a entrada painel para ficar ocultos imediatamente, sem configuração um timer. Use esse valor se você desejar a entrada painel ocultos e são não se deverá haver nenhuma SIP_UP solicitações. Isso seria apropriado se, de exemplo, seu aplicativo é um total-jogo Tela.
  SIP_UNCHANGED	Informa o sistema para ignorar quaisquer pendente para baixo solicitações. Se SHSipPreference é chamado com o sinalizador SIP_DOWN, o sistema define um timer e depois o timer é acionado, a entrada painel é rebaixado. No entanto, se você chamar SIP_UNCHANGED antes o acionado timer e, em seguida, a entrada painel permanecerá na sua atual localidade.

Return Value

Essa função retorna TRUE se ele for bem-sucedido e FALSE se ele falhar.

Remarks

Essa função geralmente é usada pelos controles a posição de entrada painel quando altera o foco. Qualquer controle que solicita SIP_UP deve, em alguns apontar, solicitação SIP_DOWN. Isso geralmente ocorre geralmente quando o foco é perdido.

O seguinte exemplo de código mostra como usar o SHSipPreference função no codificar que pode fazer parte de um controle personalizado.

case WM_SETFOCUS:
  SHSipPreference(hwnd, SIP_UP);
  break;
case WM_KILLFOCUS:
  SHSipPreference(hwnd, SIP_DOWN);
  break;

Requirements

Header	aygshell.h
Library	aygshell.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Pocket PC 2000 and later