Z cyklu boso przez Śródziemie: biblioteka GDI+ oraz jak sprawdzić, czy kursor zawiera się w figurze geometrycznej.

Dziś wykorzystam bibliotekę graficzną GDI+ i pokażę jak przetestować czy kursor zawiera się w jakiejś figurze geometrycznej. Napiszę aplikację, która będzie wyświetlała nazwę wskazanej na mapie krainy.

W tym celu biorę kostkę rosołową Knorr, odpalam Visual Sudio 2008 i tworzę nowy projekt WinForms. Do utworzonej domyślnie formy dodaję kontrolkę PictureBox, nazywam ją mapkaPictureBox i wstawiam do niej gotowy obrazek (właściwość Image w oknie Properties). Obrazkiem będzie wyszukana w  googlach mapka tolkienowskiego Śródziemia na licencji GNU.  Zmieniam właściwość SizeMode na StretchImage, co spowoduje dopasowanie obrazka do rozmiarów kontrolki. Do formy dodaję jeszcze labelki, które nazywam xyLabel i krainaLabel. Gotuję na małym ogniu przez  3min. ciągle mieszając 🙂

Następnie tworzę metodę obsługująca zdarzenie MouseMove, która ułatwi mi dalszą pracę. (W Form1.cs[Design] klikam obrazek, następnie w oknie Properties wybieram grupę Events i podwójnie klikam na MouseMove – zostanie wygenerowany szkic metody w Form1.cs, oraz potrzebny kod w pliku Form1.Designer.cs . Środek metody wypełniamy sami.)

//ta metoda ma pomóc w określeniu współrzędnych punktów,
//które będą wierzchołkami wielkąta ograniczającego Gondor
private void mapkaPictureBox_MouseMove(object sender, MouseEventArgs e)
{
  xyLabel.Text = String.Format("Współrzędne: x={0}, y={1}", e.X, e.Y);
}

Od tej pory w labelce xyLabel będę widział aktualne położenie myszki na obrazku.

Następnie przystępuje do napisania metody, która obsłuży zdarzenie MouseDown dla mapkaPictureBox. Wygląda ona następująco:

private void mapkaPictureBox_MouseDown(object sender, MouseEventArgs e)
{
//tworzymy obiekt klasy Graphics, który będzie potrzebyny do narysowania ramek
Graphics g = mapkaPictureBox.CreateGraphics();

//tworzymy prosokąt ograniczający Mordor
Rectangle rMordor = new Rectangle(530, 270, 190, 100);

//tworzymy wielkoąt, który będzie reprezentował granice Gondoru
Point p1 = new Point(340, 280);
Point p2 = new Point(310, 320);
Point p3 = new Point(390, 320);
Point p4 = new Point(400, 350);
Point p5 = new Point(445, 300);
Point [] pTab = new Point[] {p1,p2,p3,p4,p5};
GraphicsPath gpGondor = new GraphicsPath();
gpGondor.AddPolygon(pTab);

//rysujemy na mapie prostokąt reprezentujący Mordor,
//oraz wielkoąt reprezentujący Gondor
//Możemy pominąć rysowanie, aby mapka ładniej wyglądała
g.DrawRectangle(new Pen(Color.Red, 3), rMordor);
g.DrawPath(new Pen(Color.Blue,3),gpGondor);

//sprawdzamy czy kursor w czasie klkinięcia był w obrębie Mordoru lub Gondoru
if (rMordor.Contains(e.X, e.Y))
    krainaLabel.Text = "Wybrałeś Mordor";
else if (gpGondor.IsVisible(e.X, e.Y))
    krainaLabel.Text = "Wybrałeś Gondor";
else
    krainaLabel.Text = "Wybierz Mordor lub Gondor";
}

Uwaga: klasa GraphicPath znajduje się w przestrzeni nazw System.Drawing.Drawing2D, która nie jest domyślnie dołączana w projekach Windows Forms.

Kluczowe są tu linijki 26 i 28. To tutaj sprawdzam metodą Contains (należącą do klasy Rectangle), czy kursor w czasie kliknięcia jest wewnątrz prostokąta rMordor , oraz metodą IsVisible (należącą do klasy GraphicPath) , czy jest wewnątrz wielokątu gpGondor.

Gotowy program wygląda tak:

Voilà!

Zachęcam do podzielenia się opinią na temat prezentowanego programu, a także całego wpisu. Z chęcią wyjaśnię niejasności. Głos uzasadnionej i wyrozumiałej krytyki będzie również mile widziany.