SHFullScreen

9/9/2008

Esta função pode ser usada para assumir certas áreas da Tela. Ele é usado para modificar a barra de tarefas, O Painel de Entrada botão, ou Iniciar ícone menu.

Syntax

BOOL SHFullScreen(
  HWND hwndRequester,
  DWORD dwState
);

Parameters

• hwndRequester
  [no] Identificador para o janela de alto nível solicitando o total-estado Tela. Se você estiver usando um dos sinalizadores SHFS_HIDE *, essa janela deve ser a janela primeiro plano ou a função falhará.

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

  For All Platforms:

  Estado	Descrição
  SHFS_SHOWTASKBAR	Return a barra de tarefas para seu estado superior.
  SHFS_HIDETASKBAR	Colocar a barra de tarefas na inferior de z-ordem. Observe que um jogo ou um aplicativo que requer a Tela inteira pode usar esse sinalizador. Não deixe que o aplicativo é dimensionado para Tela completa antes de usar esse sinalizador. Caso contrário, ele será exibido como embora a função foi nada.

  Estado	Descrição
  SHFS_SHOWSIPBUTTON	Retorna o botão Input Panel ao seu estado visível. Observação Suporte para apenas em um Windows Mobile 6 Professional e Windows Mobile 6 Classic.
  SHFS_HIDESIPBUTTON	Oculta o botão painel de Entrada. Observação Suporte para apenas em um Windows Mobile 6 Professional e Windows Mobile 6 Classic.
  SHFS_SHOWSTARTICON	Return o Iniciar botão ícone para a barra de tarefas. Observação Suporte para apenas em um Windows Mobile 6 Professional e Windows Mobile 6 Classic.
  SHFS_HIDESTARTICON	Ocultar o Iniciar ícone botão sobre a barra de tarefas. Quando o Iniciar ícone estiver oculto, o shell é em um estado especial no qual clicando a barra de tarefas não irá exibir o Iniciar menu. A barra de tarefas essencialmente é desativada quando nesse estado. Enquanto neste modo, WM_LBUTTONDOWN e WM_LBUTTONUP As mensagens serão encaminhadas para hwndRequester. Isso permite que um aplicativo para ato de soltar fora neste modo, chamado essa função com o estado SHFS_SHOWSTARTICON quando o usuário clica a barra de tarefas. Observação Suporte para apenas em um Windows Mobile 6 Professional e Windows Mobile 6 Classic.

Return Value

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

Exemplo de código

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

#include <aygshell.h>
LRESULT CALLBACK SHFullScreenWndProc(HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam)
{
    static fFullScreen = FALSE;
    switch (message)
    {
        case WM_KEYDOWN:
        {
            // Toggle between full screen and normal mode when the user presses the space bar.
            if (VK_SPACE == wParam)
            {
                DWORD dwState;
                RECT rc;
                if (fFullScreen)
                {
                    // To switch to normal mode, first show all of the shell parts.
                    dwState = (SHFS_SHOWTASKBAR | SHFS_SHOWSTARTICON | SHFS_SHOWSIPBUTTON);
                    SHFullScreen(hwnd, dwState);
                    // Next resize the main window to the size of the work area.
                    SystemParametersInfo(SPI_GETWORKAREA, 0, &rc, FALSE);
                    MoveWindow(hwnd, rc.left, rc.top, rc.right-rc.left, rc.bottom-rc.top, TRUE);
                    fFullScreen = !fFullScreen;
                }
                else
                {
                    // To switch to full screen mode, first hide all of the shell parts.
                    dwState = (SHFS_HIDETASKBAR | SHFS_HIDESTARTICON | SHFS_HIDESIPBUTTON);
                    SHFullScreen(hwnd, dwState);
                    // Next resize the main window to the size of the screen.
                    SetRect(&rc, 0, 0, GetSystemMetrics(SM_CXSCREEN), GetSystemMetrics(SM_CYSCREEN));
                    MoveWindow(hwnd, rc.left, rc.top, rc.right-rc.left, rc.bottom-rc.top, TRUE);
                    fFullScreen = !fFullScreen;
                }
            }
        }
        break;
    }
    return DefWindowProc(hwnd, message, wParam, lParam);
}

Requirements

See Also

Reference

WM_LBUTTONDOWN
WM_LBUTTONUP