Coordenadas do Windows Forms

O sistema de coordenadas para um Windows Form é baseado em coordenadas de dispositivo, e a unidade básica de medida ao desenhar no Windows Forms é a unidade de dispositivo (normalmente, o pixel). Os pontos na tela são descritos por pares de coordenadas x e y, com as coordenadas x aumentando para a direita e as coordenadas y aumentando de cima para baixo. A localização da origem, em relação à tela, irá variar dependendo se você está especificando as coordenadas da tela ou do cliente.

Coordenadas da tela

Um aplicativo do Windows Forms especifica a posição de uma janela na tela em coordenadas de tela. Para as coordenadas da tela, a origem é o canto superior esquerdo da tela. A posição completa de uma janela é frequentemente descrita por uma estrutura Rectangle contendo as coordenadas da tela de dois pontos que definem os cantos superior esquerdo e inferior direito da janela.

Coordenadas do Cliente

Um aplicativo Windows Forms especifica a posição de pontos em um formulário ou controle usando coordenadas de cliente. A origem das coordenadas do cliente é o canto superior esquerdo da área do cliente do controle ou formulário. As coordenadas do cliente garantem que um aplicativo possa usar valores de coordenadas consistentes ao desenhar em um formulário ou controle, independentemente da posição do formulário ou controle na tela.

As dimensões da área do cliente também são descritas por uma estrutura Rectangle que contém coordenadas do cliente para a área. Em todos os casos, a coordenada superior esquerda do retângulo é incluída na área do cliente, enquanto a coordenada inferior direita é excluída. As operações gráficas não incluem as bordas direita e inferior de uma área do cliente. Por exemplo, o método FillRectangle preencherá até a borda direita e inferior do retângulo especificado, mas não incluirá essas bordas.

Mapeamento de um tipo de coordenada para outro

Ocasionalmente, você pode precisar mapear as coordenadas da tela para as coordenadas do cliente. Você pode facilmente fazer isso usando os métodos PointToClient e PointToScreen disponíveis na classe Control. Por exemplo, a propriedade MousePosition de Control é relatada em coordenadas de tela, mas talvez você queira convertê-las em coordenadas de cliente.

Ver também

  • Last updated on