Tipos de interação e atalhos de teclado no módulo de ferramentas de desenho

Este artigo descreve todas as maneiras de desenhar e editar formas usando um mouse, tela sensível ao toque ou atalhos de teclado.

O gerenciador de desenho dá suporte a três maneiras diferentes de interagir com o mapa, para desenhar formas.

• click - As coordenadas são adicionadas ao clicar no mouse ou tela sensível ao toque.
• freehand – as coordenadas são adicionadas ao arrastar no mouse ou tela sensível ao toque.
• hybrid - As coordenadas são adicionadas ao clicar ou arrastar no mouse ou tela sensível ao toque.

Como desenhar formas

Antes que qualquer forma possa ser desenhada, defina a drawingMode opção do gerenciador de desenho com uma configuração de desenho com suporte. Essa configuração pode ser programada ou invocada pressionando um dos botões de desenho na barra de ferramentas. O modo de desenho permanece habilitado, mesmo após o desenho de uma forma, facilitando o desenho de mais formas do mesmo tipo. Defina de forma programática o modo de desenho para um estado ocioso. Ou alterne para um estado ocioso selecionando o botão modos de desenho atual na barra de ferramentas.

As próximas seções descrevem todas as maneiras pelas quais as formas podem ser desenhadas no mapa.

Como desenhar um ponto

Quando o gerenciador de desenho está no modo de desenho draw-point, as ações a seguir podem ser realizadas para desenhar pontos no mapa. Esses métodos funcionam com todos os modos de interação.

Iniciar desenho

• Selecione o botão esquerdo do mouse ou toque no mapa para adicionar um ponto ao mapa.
• Se o mouse estiver sobre o mapa, pressione a tecla F e um ponto será adicionado na coordenada do ponteiro do mouse. Esse método fornece maior precisão para adicionar um ponto ao mapa. Há menos movimentos no mouse devido ao movimento pressionado do botão esquerdo do mouse.
• Continue clicando, tocando ou pressionando F para adicionar mais pontos ao mapa.

Concluir desenho

• Selecione qualquer botão na barra de ferramentas de desenho.
• Defina de forma programática o modo de desenho.
• Pressione a chave C.

Cancelar desenho

• Pressione a chave Escape.

Como desenhar uma linha

Quando o gerenciador de desenho está no modo draw-line, as ações a seguir podem ser realizadas para desenhar pontos no mapa, dependendo do modo de interação.

Iniciar desenho

• Modo de clique
  • Selecione o botão esquerdo do mouse ou toque no mapa para adicionar cada ponto de uma linha no mapa. Uma coordenada é adicionada à linha para cada clique ou toque.
  • Se o mouse estiver sobre o mapa, pressione a tecla F e um ponto será adicionado na coordenada do ponteiro do mouse. Esse método fornece maior precisão para adicionar um ponto ao mapa. Há menos movimentos no mouse devido ao movimento pressionado do botão esquerdo do mouse.
  • Continue clicando até que todos os pontos desejados tenham sido adicionados à linha.
• Modo de desenho à mão livre
  • Pressione o botão esquerdo do mouse ou toque e segure no mapa e arraste o mouse ou o ponto de toque. As coordenadas são adicionadas à linha à medida que o mouse ou o ponto de toque se move em torno do mapa. Assim que o evento de mouse ou de toque é disparado, o desenho é concluído. A opção freehandInterval do gerenciador de desenhos define a frequência na qual as coordenadas são adicionadas.
• Modo híbrido
  • Alternar entre os métodos clicar e à mão livre, conforme desejado, ao desenhar uma única linha. Por exemplo, clique em alguns pontos, mantenha pressionado e arraste o mouse para adicionar vários pontos e clique em mais alguns.

Concluir desenho

• Modo híbrido/clique
  • Clique duas vezes no mapa no último ponto.
  • Clique em qualquer botão na barra de ferramentas de desenho.
  • Defina de forma programática o modo de desenho.
• Modo de desenho à mão livre
  • Solte o botão do mouse ou o ponto de toque.
• Pressione a chave C.

Cancelar desenho

• Pressione a chave Escape.

Como desenhar um polígono

Quando o gerenciador de desenho está no modo draw-polygon, as ações a seguir podem ser realizadas para desenhar pontos no mapa, dependendo do modo de interação.

Iniciar desenho

• Modo de clique
  • Selecione o botão esquerdo do mouse ou toque no mapa para adicionar cada ponto de um polígono no mapa. Uma coordenada é adicionada ao polígono para cada clique ou toque.
  • Se o mouse estiver sobre o mapa, pressione a tecla F e um ponto será adicionado na coordenada do ponteiro do mouse. Esse método fornece maior precisão para adicionar um ponto ao mapa. Há menos movimentos no mouse devido ao movimento pressionado do botão esquerdo do mouse.
  • Continue clicando até que todos os pontos desejados tenham sido adicionados ao polígono.
• Modo de desenho à mão livre
  • Pressione o botão esquerdo do mouse ou toque e segure no mapa e arraste o mouse ou o ponto de toque. As coordenadas são adicionadas ao polígono à medida que o mouse ou o ponto de toque se move em torno do mapa. Assim que o evento de mouse ou de toque é disparado, o desenho é concluído. A opção freehandInterval do gerenciador de desenhos define a frequência na qual as coordenadas são adicionadas.
• Modo híbrido
  • Alternar entre os métodos clicar e à mão livre, conforme desejado, ao desenhar um único polígono. Por exemplo, clique em alguns pontos, mantenha pressionado e arraste o mouse para adicionar vários pontos e clique em mais alguns.

Concluir desenho

• Modo híbrido/clique
  • Clique duas vezes no mapa no último ponto.
  • Clique no primeiro ponto no polígono.
  • Clique em qualquer botão na barra de ferramentas de desenho.
  • Defina de forma programática o modo de desenho.
• Modo de desenho à mão livre
  • Solte o botão do mouse ou o ponto de toque.
• Pressione a chave C.

Cancelar desenho

• Pressione a chave Escape.

Como desenhar um retângulo

Quando o gerenciador de desenho está no modo draw-rectangle, as ações a seguir podem ser realizadas para desenhar pontos no mapa, dependendo do modo de interação. A forma gerada segue a especificação GeoJSON estendida para retângulos.

Iniciar desenho

• Pressione o botão esquerdo do mouse ou toque e segure no mapa para adicionar o primeiro canto do retângulo e arraste para criar o retângulo.

Concluir desenho

• Solte o botão do mouse ou o ponto de toque.
• Defina de forma programática o modo de desenho.
• Pressione a chave C.

Cancelar desenho

• Pressione a chave Escape.

Como desenhar um círculo

Quando o gerenciador de desenho está no modo draw-circle, as ações a seguir podem ser realizadas para desenhar pontos no mapa, dependendo do modo de interação. A forma gerada segue a especificação GeoJSON estendida para círculos.

Iniciar desenho

• Pressione o botão esquerdo do mouse ou toque e segure no mapa para adicionar o centro do círculo e arraste para dar um raio aos círculos.

Concluir desenho

• Solte o botão do mouse ou o ponto de toque.
• Defina de forma programática o modo de desenho.
• Pressione a chave C.

Cancelar desenho

• Pressione a chave Escape.

Atalhos de teclado

As ferramentas de desenho dão suporte a atalhos de teclado. Esses atalhos de teclado são funcionais quando o mapa está em foco.

Chave	Ação
C	Conclui um desenho em andamento e define o modo de desenho como ocioso. O foco se move para o elemento do mapa de nível superior.
Escape	Cancela um desenho em andamento e define o modo de desenho como ocioso. O foco se move para o elemento do mapa de nível superior.
F	Adiciona uma coordenada a um ponto, linha ou polígono se o mouse estiver sobre o mapa. Ação equivalente de clicar no mapa quando estiver no modo de clique ou híbrido. Esse atalho permite desenhos mais precisos e rápidos. Você pode usar uma mão para posicionar o mouse e outra para pressionar o botão sem mover o mouse da posição de pressão.
Delete ou Backspace	Se as formas forem selecionadas durante o modo de edição, exclua-as.

Próximas etapas

Saiba mais sobre as classes no módulo ferramentas de desenho:

Gerenciador de desenho

Barra de ferramentas de desenho