SHDoneButton

9/9/2008

Essa função é fornecida para aplicativos que precisam para dinamicamente apresentação ou ocultar o OK botão baseia o estado do aplicativo.

Syntax

BOOL SHDoneButton(
  HWND hwndRequester,
  DWORD dwState
);

Parameters

• hwndRequester
  [no] Identificador para o janela de alto nível solicitando o Feito botão.

• dwState
  [no] Especifica o estado botão. A seguinte tabela mostra os valores estados possíveis para esse parâmetro.

  Estado	Descrição
  SHDB_SHOW	Adiciona WS_EX_CAPTIONOKBTN para hwndRequester. Próximo tempo esta janela torna-se a janela primeiro plano, o Feito botão será exibido. Observe que hwndRequester não pode ser definido para o estilo WS_CAPTION. Para obter mais informações sobre WS_EX_CAPTIONOKBTN e WS_CAPTION, consulte Estilos de área não-cliente.
  SHDB_HIDE	Remove a WS_EX_CAPTIONOKBTN de hwndRequester. O Feito botão não será exibido o próximo tempo esta janela torna-se a janela primeiro plano.
  SHDB_SHOWCANCEL	Permite que o botão ' Cancelar ' [x] para ter semântica cancelar. SHDB_SHOWCANCEL mostra o botão [x], mas torna enviar um WM_COMMAND ou IDCANCEL quando pressionado.

Return Value

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

Remarks

Para todas as plataformas

Normalmente, o Feito botão é gerenciado pelo shell e mostrando ou ocultando o OK botão acontece automaticamente. Um janela de alto nível que precisa de Feito botão apareça deve usar o estilo janela WS_EX_CAPTIONOKBTN.

Para tornar a OK botão aparecer, certifique-se de que a janela não têm estilos a WS_CAPTION ou estilo.

Sempre que as alterações janela primeiro plano, o shell verifica os bits estilo da janela para determinar se o OK botão deve aparecer na barra de tarefas. O OK botão tem prioridade sobre um barra de menus adicionado à barra de tarefas.

Para suprimir a OK botão, use o estilo WS_NONAVDONEBUTTON.

Para Mobile Windows

Normalmente, o Feito (o botão OK botão que aparece no canto superior-direito canto da Tela) é gerenciado pelo shell e mostrando ou ocultando o OK botão acontece automaticamente. Um janela de alto nível que precisa de Feito botão apareça deve usar a seguinte janela estilos:

• Deve ter WS_EX_CAPTIONOKBTN
• Não deve ter WS_CAPTION
  Estilo

Observação

WS_CAPTION é definido como (WS_BORDERWS_DLGFRAME).Para tornar a OK botão aparecer, certifique-se que a janela não possui um desses estilos.

Sempre que as alterações janela primeiro plano, o shell verifica os bits estilo da janela para determinar se o OK botão deve aparecer na navegação barra.

Para suprimir a OK botão, use o estilo WS_NONAVDONEBUTTON.

Exemplo de código

O seguinte exemplo de código demonstra como usar SHDoneButton.

Observação

Para fazer o seguinte exemplo de código mais fácil de ler, verificação de segurança e manipulação de erro não estão incluídos.Esta exemplo de código não deve ser usado em uma configuração versão a menos que ele foi modificado para incluí-las.

// Show or hide a window's Done button.
BOOL SHDoneButtonExample(HWND hWnd, BOOL fShow) 
{
    if (fShow)
    {
        // Show the Done button when the window moves to the foreground.
        return SHDoneButton(hWnd, SHDB_SHOW);
    }
    else
    {
        // Hide the Done button when the window moves from the foreground.
        return SHDoneButton(hWnd, SHDB_HIDE);
    }
}

Requirements

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

See Also

Concepts

Window and Message Box Styles