Cursor.Clip Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém ou define os limites que representam o retângulo de corte para o cursor.

public:
 static property System::Drawing::Rectangle Clip { System::Drawing::Rectangle get(); void set(System::Drawing::Rectangle value); };

public static System.Drawing.Rectangle Clip { get; set; }

member this.Clip : System.Drawing.Rectangle with get, set

Public Shared Property Clip As Rectangle

Valor da propriedade

Rectangle

O Rectangle que representa o retângulo de corte para o Cursor, em coordenadas de tela.

Exemplos

O exemplo de código a seguir cria um cursor do Current cursor Handle, altera sua posição e retângulo de recorte. O resultado é que o cursor se moverá para cima e para a esquerda 50 pixels de onde ele está quando o código é executado. Além disso, o retângulo de recorte do cursor é alterado para os limites do formulário (por padrão, é a tela inteira do usuário). Este exemplo requer que você tenha um Form e um Button para chamar esse código quando ele for clicado.

void MoveCursor()
{
   // Set the Current cursor, move the cursor's Position,
   // and set its clipping rectangle to the form.

   this->Cursor = gcnew System::Windows::Forms::Cursor( ::Cursor::Current->Handle );
   ::Cursor::Position = Point(::Cursor::Position.X - 50,::Cursor::Position.Y - 50);
   ::Cursor::Clip = Rectangle(this->Location,this->Size);

}

private void MoveCursor()
{
   // Set the Current cursor, move the cursor's Position,
   // and set its clipping rectangle to the form. 

   this.Cursor = new Cursor(Cursor.Current.Handle);
   Cursor.Position = new Point(Cursor.Position.X - 50, Cursor.Position.Y - 50);
   Cursor.Clip = new Rectangle(this.Location, this.Size);
}

Private Sub MoveCursor()
   ' Set the Current cursor, move the cursor's Position,
   ' and set its clipping rectangle to the form. 

   Me.Cursor = New Cursor(Cursor.Current.Handle)
   Cursor.Position = New Point(Cursor.Position.X - 50, Cursor.Position.Y - 50)
   Cursor.Clip = New Rectangle(Me.Location, Me.Size)
End Sub

Comentários

Um cursor recortado tem permissão para se mover somente dentro de seu retângulo de recorte. Geralmente, o sistema permite isso somente se o mouse for capturado no momento. Se o cursor não estiver recortado no momento, o retângulo resultante conterá as dimensões de toda a tela.