Ofereça suporte a layouts de encaixe para aplicativos da área de trabalho no Windows 11

Os layouts de encaixe são um novo recurso do Windows 11 para ajudar os usuários a conhecer os benefícios do encaixe de janelas. Layouts de ajuste são facilmente acessíveis ao passar o mouse sobre o botão maximizar de uma janela ou pressionar Win + Z. Depois de invocar o menu que mostra os layouts disponíveis, os usuários podem clicar em uma zona de um layout para ajustar uma janela a essa zona específica e usar o Assistente de Ajuste para concluir a criação de todo um layout de janelas. Os layouts de ajuste são personalizados de acordo com o tamanho e a orientação da tela atual, incluindo suporte para três janelas lado a lado em telas paisagem grandes e janelas empilhadas de cima para baixo em telas retrato.

Se a janela do aplicativo tiver o botão Maximizar legenda disponível, o sistema mostrará automaticamente layouts ajustáveis quando um usuário passar o mouse sobre esse botão. Os layouts de ajuste aparecerão automaticamente na maioria dos aplicativos, mas alguns aplicativos da área de trabalho podem não mostrar os layouts de ajuste. Este tópico descreve como garantir que seu aplicativo mostre o menu com layouts ajustáveis se o sistema não o mostrar automaticamente.

Por que meu aplicativo não mostra o menu Ajustar layout?

Se a janela principal do aplicativo tiver o botão Maximizar legenda disponível, mas não mostrar o menu Ajustar layout, talvez seja porque você personalizou os botões de legenda ou a barra de título de uma forma que impede isso.

Como corrigir isso?

Se você tiver uma barra de título personalizada, será possível realizar as seguintes operações:

• Use as APIs de janelas do SDK de Aplicativos do Windows (consulte Gerenciar janelas do aplicativo) e faça com que a plataforma desenhe e forneça os botões da barra de título para você.

• Para aplicativos Win32, verifique se você está respondendo adequadamente a WM_NCHITTEST (com um valor de retorno de HTMAXBUTTON para o botão maximizar/restaurar).

  LRESULT CALLBACK TestWndProc(HWND window, UINT msg, WPARAM wParam, LPARAM lParam)
  {
      switch (msg)
      {
            case WM_NCHITTEST:
          {
              // Get the point in screen coordinates.
              // GET_X_LPARAM and GET_Y_LPARAM are defined in windowsx.h
              POINT point = { GET_X_LPARAM(lParam), GET_Y_LPARAM(lParam) };
              // Map the point to client coordinates.
              ::MapWindowPoints(nullptr, window, &point, 1);
              // If the point is in your maximize button then return HTMAXBUTTON
              if (::PtInRect(&m_maximizeButtonRect, point))
              {
                  return HTMAXBUTTON;
              }
          }
          break;
      }
      return ::DefWindowProcW(window, msg, wParam, lParam);
  }
  

• Se o aplicativo usa Electron, atualize para a versão estável v13 do Electron para habilitar layouts de snap.

E se a janela do meu aplicativo exibir layouts de encaixe, mas não estiver se encaixando corretamente?

Se o aplicativo puder invocar o menu com layouts ajustáveis, mas não puder encaixar corretamente nos tamanhos de zona, é provável que o tamanho mínimo da janela do aplicativo seja muito grande para que a janela se ajuste à zona selecionada.

Seu aplicativo deve dar suporte a uma largura mínima de até 500 pixels efetivos (epx) para suportar layouts ajustáveis entre os tamanhos de tela mais comuns. No entanto, é recomendável que você dê suporte a uma largura mínima menor (330 epx ou menos), pois ela será compatível com um conjunto maior de dispositivos e layouts ajustáveis.