{"id":18057,"date":"2026-08-21T09:58:02","date_gmt":"2026-08-21T12:58:02","guid":{"rendered":"https:\/\/kb.elipse.com.br\/?p=18057"},"modified":"2026-08-21T10:00:35","modified_gmt":"2026-08-21T13:00:35","slug":"habilitando-o-menu-de-zoom-eo-zoom-de-area-nas-telas-do-e3","status":"publish","type":"post","link":"https:\/\/kb.elipse.com.br\/en\/habilitando-o-menu-de-zoom-eo-zoom-de-area-nas-telas-do-e3\/","title":{"rendered":"Habilitando o menu de Zoom e o Zoom de \u00c1rea nas telas do E3."},"content":{"rendered":"
\n
\n

Quando o operador precisa ampliar uma regi\u00e3o da tela em tempo de execu\u00e7\u00e3o, o menu de Zoom (bot\u00e3o direito) e o Zoom de \u00c1rea resolvem \u2014 desde que Viewer e Telas estejam configurados.<\/p>\n<\/div>\n<\/div>\n

\n
\n

1.<\/span> O que \u00e9 o menu de Zoom (e o Zoom de \u00c1rea)<\/h2>\n

O menu de Zoom<\/strong> permite ampliar uma regi\u00e3o espec\u00edfica da tela em tempo de execu\u00e7\u00e3o. \u00c9 um menu de contexto acionado com o bot\u00e3o direito do mouse<\/strong> sobre a tela em execu\u00e7\u00e3o e re\u00fane as op\u00e7\u00f5es de amplia\u00e7\u00e3o e redu\u00e7\u00e3o, incluindo o Zoom de \u00c1rea<\/strong> \u2014 o modo em que o usu\u00e1rio desenha um ret\u00e2ngulo com o mouse e a tela \u00e9 ampliada para enquadrar exatamente aquela regi\u00e3o. Este artigo mostra quais propriedades configurar \u2014 no Viewer, nas Telas e no comando OpenScreen<\/code> \u2014 para habilitar esse menu.<\/p>\n

Para que esse recurso funcione, tr\u00eas comportamentos precisam estar habilitados:<\/p>\n

    \n
  • Exibir o menu de contexto<\/strong> de Zoom ao clicar com o bot\u00e3o direito (AllowContextMenu<\/code>);<\/li>\n
  • Permitir a altera\u00e7\u00e3o do zoom<\/strong> em tempo de execu\u00e7\u00e3o (AllowZoomChange<\/code>);<\/li>\n
  • Centralizar a tela<\/strong> para que a regi\u00e3o ampliada seja posicionada e naveg\u00e1vel de forma previs\u00edvel (ScreenAlignment<\/code>).<\/li>\n<\/ul>\n

    Essas propriedades existem tanto no Viewer<\/strong> (valem como padr\u00e3o para toda a aplica\u00e7\u00e3o e para a Tela Inicial) quanto em cada Tela<\/strong> (podem herdar do Viewer ou ser definidas individualmente).<\/p>\n<\/section>\n

    \n

    2.<\/span> Propriedades envolvidas<\/h2>\n
    \n\n\n\n\n\n\n\n
    Propriedade<\/th>\nNo Viewer<\/th>\nNas Telas<\/th>\nFun\u00e7\u00e3o<\/th>\n<\/tr>\n<\/thead>\n
    AllowContextMenu<\/code><\/td>\nTrue<\/code> ou False<\/code><\/td>\n0 (ppDefault)<\/code>, 1 (ppAllow)<\/code> ou 2 (ppBlock)<\/code><\/td>\nExibe o menu de Zoom ao clicar com o bot\u00e3o direito<\/td>\n<\/tr>\n
    AllowZoomChange<\/code><\/td>\nTrue<\/code> ou False<\/code><\/td>\n0 (ppDefault)<\/code>, 1 (ppAllow)<\/code> ou 2 (ppBlock)<\/code><\/td>\nPermite alterar o zoom em tempo de execu\u00e7\u00e3o<\/td>\n<\/tr>\n
    ScreenAlignment<\/code><\/td>\n1 (paTopLeft)<\/code> ou 2 (paCenter)<\/code><\/td>\n0 (paDefault)<\/code>, 1 (paTopLeft)<\/code> ou 2 (paCenter)<\/code><\/td>\nAlinhamento da tela dentro do Viewer<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n

    Nas Telas, os valores Default<\/em> fazem a Tela herdar<\/strong> as configura\u00e7\u00f5es do Viewer destas propriedades; qualquer outra op\u00e7\u00e3o for\u00e7a explicitamente o recurso naquela Tela. Como o padr\u00e3o de f\u00e1brica da propriedade ScreenAlignment<\/code> do Viewer \u00e9 paTopLeft<\/code>, para exibir o Zoom de \u00c1rea \u00e9 preciso alter\u00e1-la para paCenter<\/code> no Viewer, ou diretamente na Tela desejada, ou for\u00e7ar o par\u00e2metro de alinhamento do comando que abre a Tela.<\/p>\n

    \n

    Hierarquia de configura\u00e7\u00e3o<\/p>\n

    O alinhamento, o zoom e a barra de rolagem seguem uma ordem de preced\u00eancia: a configura\u00e7\u00e3o do Viewer<\/strong> \u00e9 a base; a configura\u00e7\u00e3o de cada Tela<\/strong> prevalece sobre a do Viewer (quando n\u00e3o est\u00e1 em default); e os par\u00e2metros do OpenScreen<\/code><\/strong> prevalecem sobre todos. Assim, se o OpenScreen<\/code> n\u00e3o informar par\u00e2metros (apenas o nome da Tela), vale a configura\u00e7\u00e3o da Tela; se, al\u00e9m disso, a Tela estiver toda em default, vale a configura\u00e7\u00e3o do Viewer.<\/p>\n<\/div>\n

    \n

    Por que a centraliza\u00e7\u00e3o importa?<\/p>\n

    Com a tela centralizada (paCenter<\/code>), a regi\u00e3o ampliada pelo Zoom de \u00c1rea \u00e9 posicionada de forma consistente e a barra de rolagem permite navegar por todo o conte\u00fado \u2014 inclusive liberando o deslocamento (pan) da tela mesmo quando ela cabe na \u00e1rea vis\u00edvel. Com paTopLeft<\/code>, a tela permanece “colada” no canto superior esquerdo ao ampliar.<\/p>\n<\/div>\n<\/section>\n

    \n

    3.<\/span> Como habilitar<\/h2>\n

    Pelo E3 Studio \u2014 no Viewer<\/h3>\n

    Na lista de propriedades do objeto Viewer<\/code>, no grupo Comportamento<\/strong>, ajuste:<\/p>\n

      \n
    • AllowContextMenu = True<\/code><\/li>\n
    • AllowZoomChange = True<\/code><\/li>\n
    • ScreenAlignment = 2 - paCenter<\/code><\/li>\n<\/ul>\n
      \"Lista
      Lista de propriedades do Viewer, no grupo Comportamento.<\/figcaption><\/figure>\n

      A aba Visualizador<\/strong> da janela de propriedades do Viewer traz, al\u00e9m disso, ajustes espec\u00edficos da Tela Inicial<\/strong>:<\/p>\n

        \n
      • Alinhamento da Tela:<\/strong> For\u00e7ar Centralizado<\/em> \u2014 centraliza a abertura da Tela Inicial<\/strong>;<\/li>\n
      • marque Habilitar barra de rolagem na Tela Inicial<\/strong> para permitir navegar pela regi\u00e3o ampliada;<\/li>\n
      • marque Exibir o menu do Zoom ao clicar com o bot\u00e3o direito do mouse<\/strong> (propriedade AllowContextMenu<\/code>) \u2014 obrigat\u00f3rio para o menu de Zoom aparecer.<\/li>\n<\/ul>\n
        \"Aba
        Aba Visualizador da janela de propriedades do Viewer.<\/figcaption><\/figure>\n
        \n

        Aten\u00e7\u00e3o \u2014 h\u00e1 dois “Alinhamento da Tela” diferentes<\/p>\n

        O campo Alinhamento da Tela<\/em> desta aba n\u00e3o<\/strong> altera a propriedade ScreenAlignment<\/code> do Viewer: ele define o alinhamento apenas da abertura da Tela Inicial<\/strong>. O alinhamento das demais Telas<\/strong> \u00e9 governado pela propriedade ScreenAlignment<\/code> (na lista de propriedades) e por cada Tela. Portanto, ajuste sempre a propriedade ScreenAlignment<\/code> na lista de propriedades \u2014 n\u00e3o apenas o combo desta aba.<\/p>\n<\/div>\n

        Pelo E3 Studio \u2014 nas Telas<\/h3>\n

        A configura\u00e7\u00e3o do Viewer atende \u00e0 Tela Inicial. As demais Telas<\/strong> devem atender individualmente \u00e0s propriedades. Na lista de propriedades de cada Tela, no grupo Comportamento<\/strong>, ajuste:<\/p>\n

          \n
        • AllowContextMenu = 1 - ppAllow<\/code> (ou 0 - ppDefault<\/code> para herdar do Viewer)<\/li>\n
        • AllowZoomChange = 1 - ppAllow<\/code> (ou 0 - ppDefault<\/code> para herdar do Viewer)<\/li>\n
        • ScreenAlignment = 2 - paCenter<\/code> (ou 0 - paDefault<\/code> para herdar do Viewer)<\/li>\n<\/ul>\n
          \"Lista
          Lista de propriedades de uma Tela, no grupo Comportamento.<\/figcaption><\/figure>\n

          Por script (comando OpenScreen)<\/h3>\n

          Ao abrir uma tela por script com OpenScreen<\/code>, \u00e9 poss\u00edvel passar os par\u00e2metros de zoom<\/strong>, barra de rolagem<\/strong> e alinhamento<\/strong> diretamente na string da tela, no formato Tela?Zoom?Scroll?Align<\/code>:<\/p>\n

          \n
          <\/i><\/i><\/i> VBScript<\/div>\n
          ' Abre a Tela2 em 100%, com barra de rolagem quando necess\u00e1ria e centralizada<\/span>\r\nApplication.GetFrame(\"\"<\/span>).OpenScreen \"Tela2?100?1?2\"<\/span>, 0<\/pre>\n<\/div>\n
          Onde:<\/p>\n
          \n\n\n\n\n\n\n\n
          Componente<\/th>\nValor no exemplo<\/th>\nSignificado<\/th>\n<\/tr>\n<\/thead>\n
          Zoom<\/code><\/td>\n100<\/code><\/td>\nEscala de 100% (tamanho nativo \u2014 ideal para o Zoom de \u00c1rea)<\/td>\n<\/tr>\n
          Scroll<\/code><\/td>\n1<\/code><\/td>\nBarra de rolagem exibida quando necess\u00e1rio (0<\/code> = nunca, 2<\/code> = sempre)<\/td>\n<\/tr>\n
          Align<\/code><\/td>\n2<\/code><\/td>\nTela centralizada no frame<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
          \n
          Tamb\u00e9m vale para o DoModal<\/p>\n
          Os mesmos par\u00e2metros de zoom, barra de rolagem e alinhamento, junto ao nome da tela e separados por ?<\/code>, aplicam-se ao abrir uma tela como janela modal com DoModal<\/code> \u2014 por exemplo, Application.DoModal(Application.GetScreen(\"Tela2?100?1?2\"), \"T\u00edtulo\", 100, 100, 400, 300, \"\")<\/code>.<\/p>\n<\/div>\n<\/section>\n
          \n
          4.<\/span> Resultado<\/h2>\n
          Com as propriedades habilitadas, ao clicar com o bot\u00e3o direito sobre a tela em execu\u00e7\u00e3o o operador passa a ver o menu de contexto<\/strong>. A partir dele \u00e9 poss\u00edvel acionar diferentes n\u00edveis de zoom \u2014 modos como Toda Tela<\/em> e Preencher<\/em>, percentuais fixos (de 10% a 10000%) e o Zoom de \u00c1rea<\/strong>, que permite arrastar um ret\u00e2ngulo sobre a regi\u00e3o de interesse para ampli\u00e1-la. A barra de rolagem permite ent\u00e3o navegar por todo o conte\u00fado da tela ampliada. O menu tamb\u00e9m oferece op\u00e7\u00f5es de Alinhamento<\/em>, Qualidade<\/em>, Enquadrar<\/em> e Mover<\/em>.<\/p>\n
          \"Menu
          Menu de contexto com as op\u00e7\u00f5es de zoom, alinhamento e o Zoom de \u00c1rea.<\/figcaption><\/figure>\n<\/section>\n
          \n
          5.<\/span> Observa\u00e7\u00f5es e boas pr\u00e1ticas<\/h2>\n
            \n
          • Escala fixa favorece o Zoom de \u00c1rea.<\/strong> Para ampliar uma regi\u00e3o \u00e9 preciso que exista detalhe a ser ampliado. Abrir a tela em uma escala fixa (ex.: 100%<\/code>) mant\u00e9m o conte\u00fado em tamanho nativo. O modo Preencher<\/em> estica a tela para ocupar todo o Viewer, o que reduz o proveito da amplia\u00e7\u00e3o por \u00e1rea.<\/li>\n
          • Habilite a barra de rolagem.<\/strong> Sem ela, as op\u00e7\u00f5es Zoom de \u00c1rea<\/em>, Enquadrar<\/em> e Mover<\/em> n\u00e3o ficam dispon\u00edveis no menu, e o usu\u00e1rio n\u00e3o consegue navegar pelas demais partes da tela ampliada.<\/li>\n
          • Heran\u00e7a pelo ppDefault<\/code>.<\/strong> Definir as propriedades no Viewer e deixar as Telas em ppDefault<\/code> centraliza a configura\u00e7\u00e3o em um \u00fanico ponto \u2014 \u00fatil em aplica\u00e7\u00f5es com muitas telas.<\/li>\n
          • Vale para toda Tela que deve permitir zoom.<\/strong> As op\u00e7\u00f5es de zoom, alinhamento e barra de rolagem definidas na aba Visualizador da janela de propriedades do Viewer cobrem apenas a Tela Inicial. Para as demais Telas, valem as propriedades do Viewer e de cada Tela \u2014 por heran\u00e7a ou definidas explicitamente.<\/li>\n
          • Alinhamento pelo pr\u00f3prio menu.<\/strong> O menu de contexto tamb\u00e9m traz Alinhamento (Esta Tela)<\/em> e Alinhamento (Todas as Telas)<\/em>, permitindo ao operador for\u00e7ar o alinhamento em tempo de execu\u00e7\u00e3o \u2014 \u00fatil para reposicionar a tela ap\u00f3s uma amplia\u00e7\u00e3o. Esse ajuste tem preced\u00eancia sobre o definido nas propriedades.<\/li>\n<\/ul>\n<\/section>\n
            <\/section>\n