Difference between revisions of "Cursor"

From Free Pascal wiki
Jump to navigationJump to search
(Cursor - property of the TCursor Object.)
 
(8 intermediate revisions by 7 users not shown)
Line 1: Line 1:
−
Cursor - property of the TCursor Object.
+
{{Cursor}}
  
 +
Cursor - [[Property|property]] of the TCursor Object.
  
−
'''Cursor Constants'''
+
==List of cursor constants==
  
−
* crAppStart <= Arrow with small hour glass in the lower right corner.<br>
+
{| class="wikitable"
−
* crArrow <= Arrow<br>
+
|-
−
* crCross <= Cross<br>
+
! Constant || Integer value ||Shape
−
* crDefault <= Same as Arrow.<br>
+
|-
−
* crDrag <= Arrow with a dotted box going through the bottom part of the Arrow.<br>
+
| crDefault || 0  || [[Image:crArrow.png]]
−
* crHandPoint <= Hand with pointing index finger (same as you would see when hovering over a link in a browser).<br>
+
|-
−
* crHelp <= Arrow with a question mark to the right of it.<br>
+
| crNone  || -1  || Invisible mouse pointer
−
* crHourGlass <= Hour Glass<br>
+
|-
−
* crHSplit <= Horizontal Split (A left arrow, two pipes in the center, and a right arrow.)<br>
+
| crArrow || -2 || [[Image:crArrow.png]]
−
* crIBeam <= IBeam<br>
+
|-
−
* crMultiDrag <= Same as crDrag but there are two boxes going through the bottom part of the Arrow.<br>
+
| crCross || -3 || [[Image:crCross.png]]
−
* crNo <= A black circle with a slash through it.<br>
+
|-
−
* crNoDrop <= A white circle with a slash through it.<br>
+
| crIBeam || -4 || [[Image:crIBeam.png]]
−
* crNone <= No cursor. The mouse pointer is invisible.<br>
+
|-
−
* crSizeAll <= A cross with arrows on the tips.<br>
+
| crSize || -22 || [[Image:crSize.png]]
−
* crSizeNESW <= An animated, double arrow cursor that is joined, pointing from North East to South West. <br>
+
|-
−
* crSizeNS <= An animated, double arrow cursor that is joined, pointing from North to South.<br>
+
| crSizeNESW || -6 || [[Image:crSizeNESW.png]]
−
* crSizeNWSE <= An animated, double arrow cursor that is joined, pointing from North West to South West.<br>
+
|-
−
* crSizeWE <= An animated, double arrow cursor that is joined, pointing from West to East.<br>
+
| crSizeNS || -7 || [[Image:crSizeNS.png]]
−
* crSQLWait <= An hour glass with the letters SQL beneath it.<br>
+
|-
−
* crUpArrow <= A black arrow pointing up.<br>
+
|crSizeNWSE || -8 || [[Image:crSizeNWSE.png]]
−
* crVSplit <= Vertical Split (A left arrow, two pipes in the center, and a right arrow.)
+
|-
 +
|crSizeWE || -9 || [[Image:crSizeWE.png]]
 +
|-
 +
|crUpArrow || -10 || |[[Image:crUpArrow.png]]
 +
|-
 +
|crHourGlass || -11 || [[Image:crHourGlass.png]]
 +
|-
 +
|crDrag || -12 || [[Image:crDrag.png]]
 +
|-
 +
|crNoDrop || -13 || |[[Image:crNoDrop.png]]
 +
|-
 +
|crHSplit || -14 || [[Image:crHSplit.png]]
 +
|-
 +
|crVSplit || -15 || |[[Image:crVSplit.png]]
 +
|-
 +
|crMultiDrag || -16 || [[Image:crMultiDrag.png]]
 +
|-
 +
|crSQLWait || -17 || [[Image:crSQLWait.png]]
 +
|-
 +
|crNo || -18 || [[Image:CrNo.png]]
 +
|-
 +
|crAppStart || -19 || [[Image:crAppStart.png]]
 +
|-
 +
|crHelp || -20 || [[Image:crHelp.png]]
 +
|-
 +
|crHandPoint || -21 || [[Image:crHandPoint.png]]
 +
|}
  
 +
== Examples ==
 +
===Example 1: To View All The Cursor Types===
  
−
<hr>
+
(1) On [[TForm|Form1]], drag a [[TComboBox|ComboBox]] control onto the Form.
  
 +
(2) Set the ComboBox1, Items (TStrings) to the following:
  
−
'''EXAMPLE 1: To View All The Cursor Types'''
+
<syntaxhighlight lang="pascal">
 +
crAppStart
 +
crArrow
 +
crCross
 +
crDefault
 +
crDrag
 +
crHandPoint
 +
crHelp
 +
crHourGlass
 +
crHSplit
 +
crIBeam
 +
crMultiDrag
 +
crNo
 +
crNoDrop
 +
crNone
 +
crSizeAll
 +
crSizeNESW
 +
crSizeNS
 +
crSizeNWSE
 +
crSizeWE
 +
crSQLWait
 +
crUpArrow
 +
crVSplit
 +
</syntaxhighlight>
  
−
(1) On Form1, drag a ComboBox control onto the Form.
 
−
 
−
(2) Set the ComboBox1, Items (TStrings) to the following:
 
−
 
−
crAppStart<br>
 
−
crArrow<br>
 
−
crCross<br>
 
−
crDefault<br>
 
−
crDrag<br>
 
−
crHandPoint<br>
 
−
crHelp<br>
 
−
crHourGlass<br>
 
−
crHSplit<br>
 
−
crIBeam<br>
 
−
crMultiDrag<br>
 
−
crNo<br>
 
−
crNoDrop<br>
 
−
crNone<br>
 
−
crSizeAll<br>
 
−
crSizeNESW<br>
 
−
crSizeNS<br>
 
−
crSizeNWSE<br>
 
−
crSizeWE<br>
 
−
crSQLWait<br>
 
−
crUpArrow<br>
 
−
crVSplit<br><br>
 
  
 
(3) On the ComboBox1Change procedure add this code:
 
(3) On the ComboBox1Change procedure add this code:
  
−
<delphi>
+
<syntaxhighlight lang="pascal">
 
procedure TForm1.ComboBox1Change(Sender: TObject);
 
procedure TForm1.ComboBox1Change(Sender: TObject);
 
begin
 
begin
−
     Form1.Cursor := StringToCursor(ComboBox1.Text);
+
     Cursor := StringToCursor(ComboBox1.Text);
 
end;
 
end;
−
</delphi>
+
</syntaxhighlight>
  
 
This will allow you to select the cursor type from the ComboBox and see it when you move the mouse over the Form. Only when you hover over the ComboBox will the cursor return to the default (crDefault).
 
This will allow you to select the cursor type from the ComboBox and see it when you move the mouse over the Form. Only when you hover over the ComboBox will the cursor return to the default (crDefault).
  
 +
===Example 2: Change An Objects Cursor===
  
−
<hr>
+
<syntaxhighlight lang="pascal">
−
 
 
−
 
 
−
'''EXAMPLE 2: Change An Objects Cursor'''
 
−
 
 
−
<delphi>
 
 
procedure TForm1.FormCreate(Sender: TObject);
 
procedure TForm1.FormCreate(Sender: TObject);
 
begin
 
begin
−
     Form1.Cursor := crHourGlass;
+
     Cursor := crHourGlass;
 
     // Changes the Form1 cursor to an hour glass.
 
     // Changes the Form1 cursor to an hour glass.
  
Line 89: Line 112:
 
     // Changes the Memo1 cursor to an hour glass.
 
     // Changes the Memo1 cursor to an hour glass.
 
end;  
 
end;  
−
</delphi>
+
</syntaxhighlight>
−
 
 
−
 
 
−
<hr>
 
−
 
 
  
−
'''EXAMPLE 3: Change All Controls To An Hour Glass, Except TBitBtn Controls'''
+
===Example 3: Change All Controls To An Hour Glass, Except TBitBtn Controls===
  
−
<delphi>
+
<syntaxhighlight lang="pascal">
 
procedure TForm1.FormCreate(Sender: TObject);
 
procedure TForm1.FormCreate(Sender: TObject);
 
var
 
var
 
   I: Integer;
 
   I: Integer;
 
begin
 
begin
−
     Form1.Cursor := crHourGlass;
+
     Cursor := crHourGlass;
−
     for I := 0 to Form1.ControlCount - 1 do
+
     for I := 0 to ControlCount - 1 do
 
     begin
 
     begin
−
           if (Form1.Controls[I].ClassType <> TBitBtn) then
+
           if (Controls[I].ClassType <> TBitBtn) then
−
             Form1.Controls[I].Cursor := crHourGlass;
+
             Controls[I].Cursor := crHourGlass;
 
     end;
 
     end;
 
end;  
 
end;  
−
</delphi>
+
</syntaxhighlight>
  
 
However, if you had a GroupBox, you would have to address the controls within it separately.
 
However, if you had a GroupBox, you would have to address the controls within it separately.
  
−
<delphi>
+
<syntaxhighlight lang="pascal">
 
procedure TForm1.FormCreate(Sender: TObject);
 
procedure TForm1.FormCreate(Sender: TObject);
 
var
 
var
 
   I: Integer;
 
   I: Integer;
 
begin
 
begin
−
     Form1.Cursor := crHourGlass;
+
     Cursor := crHourGlass;
−
     for I := 0 to Form1.ControlCount - 1 do
+
     for I := 0 to ControlCount - 1 do
 
     begin
 
     begin
−
           if (Form1.Controls[I].ClassType <> TBitBtn) then
+
           if (Controls[I].ClassType <> TBitBtn) then
−
             Form1.Controls[I].Cursor := crHourGlass;
+
             Controls[I].Cursor := crHourGlass;
 
     end;
 
     end;
−
     for I := 0 to Form1.GroupBox1.ControlCount - 1 do
+
     for I := 0 to GroupBox1.ControlCount - 1 do
 
     begin
 
     begin
−
           if (Form1.GroupBox1.Controls[I].ClassType <> TBitBtn) then
+
           if (GroupBox1.Controls[I].ClassType <> TBitBtn) then
−
             Form1.GroupBox1.Controls[I].Cursor := crHourGlass;
+
             GroupBox1.Controls[I].Cursor := crHourGlass;
 
     end;
 
     end;
 
end;   
 
end;   
−
</delphi>
+
</syntaxhighlight>
  
−
With the above example, in which you had Form1, as well as other controls on the form such as Memo1, Edit1, Image1, BitBtn, etc., this would change all but the BitBtn controls to the Hour Glass.  There are controls such as the TGroupBox, TPanel, that act as individual containers for controls, and these items must be addresses separately from the main Form in order to change their internal control set to a different cursor at runtime.
+
With the above example, in which you had Form1, as well as other controls on the form such as [[TMemo|Memo]], [[TEdit|Edit]], [[TImage|Image]], [[TBitBtn|BitBtn]], etc., this would change all but the BitBtn controls to the Hour Glass.  There are controls such as the [[TGroupBox]], [[TPanel]], that act as individual containers for controls, and these items must be addresses separately from the main Form in order to change their internal control set to a different cursor at [[runtime]].

Latest revision as of 21:35, 12 November 2020

│ Deutsch (de) │ English (en) │ suomi (fi) │

Cursor - property of the TCursor Object.

List of cursor constants

Constant Integer value Shape
crDefault 0 crArrow.png
crNone -1 Invisible mouse pointer
crArrow -2 crArrow.png
crCross -3 crCross.png
crIBeam -4 crIBeam.png
crSize -22 crSize.png
crSizeNESW -6 crSizeNESW.png
crSizeNS -7 crSizeNS.png
crSizeNWSE -8 crSizeNWSE.png
crSizeWE -9 crSizeWE.png
crUpArrow -10 crUpArrow.png
crHourGlass -11 crHourGlass.png
crDrag -12 crDrag.png
crNoDrop -13 crNoDrop.png
crHSplit -14 crHSplit.png
crVSplit -15 crVSplit.png
crMultiDrag -16 crMultiDrag.png
crSQLWait -17 crSQLWait.png
crNo -18 CrNo.png
crAppStart -19 crAppStart.png
crHelp -20 crHelp.png
crHandPoint -21 crHandPoint.png

Examples

Example 1: To View All The Cursor Types

(1) On Form1, drag a ComboBox control onto the Form.

(2) Set the ComboBox1, Items (TStrings) to the following: 

crAppStart
crArrow
crCross
crDefault
crDrag
crHandPoint
crHelp
crHourGlass
crHSplit
crIBeam
crMultiDrag
crNo
crNoDrop
crNone
crSizeAll
crSizeNESW
crSizeNS
crSizeNWSE
crSizeWE
crSQLWait
crUpArrow
crVSplit


(3) On the ComboBox1Change procedure add this code: 

procedure TForm1.ComboBox1Change(Sender: TObject);
begin
     Cursor := StringToCursor(ComboBox1.Text);
end;

This will allow you to select the cursor type from the ComboBox and see it when you move the mouse over the Form. Only when you hover over the ComboBox will the cursor return to the default (crDefault).

Example 2: Change An Objects Cursor

procedure TForm1.FormCreate(Sender: TObject);
begin
     Cursor := crHourGlass;
     // Changes the Form1 cursor to an hour glass.

     Button1.Cursor := crHourGlass;
     // Changes the Button1 cursor to an hour glass.

     Memo1.Cursor := crHourGlass;
     // Changes the Memo1 cursor to an hour glass.
end;

Example 3: Change All Controls To An Hour Glass, Except TBitBtn Controls

procedure TForm1.FormCreate(Sender: TObject);
var
   I: Integer;
begin
     Cursor := crHourGlass;
     for I := 0 to ControlCount - 1 do
     begin
          if (Controls[I].ClassType <> TBitBtn) then
             Controls[I].Cursor := crHourGlass;
     end;
end;

However, if you had a GroupBox, you would have to address the controls within it separately. 

procedure TForm1.FormCreate(Sender: TObject);
var
   I: Integer;
begin
     Cursor := crHourGlass;
     for I := 0 to ControlCount - 1 do
     begin
          if (Controls[I].ClassType <> TBitBtn) then
             Controls[I].Cursor := crHourGlass;
     end;
     for I := 0 to GroupBox1.ControlCount - 1 do
     begin
          if (GroupBox1.Controls[I].ClassType <> TBitBtn) then
             GroupBox1.Controls[I].Cursor := crHourGlass;
     end;
end;

With the above example, in which you had Form1, as well as other controls on the form such as Memo, Edit, Image, BitBtn, etc., this would change all but the BitBtn controls to the Hour Glass. There are controls such as the TGroupBox, TPanel, that act as individual containers for controls, and these items must be addresses separately from the main Form in order to change their internal control set to a different cursor at runtime.

Retrieved from "http://wiki.freepascal.org/index.php?title=Cursor&oldid=141019"