Exportar (0) Imprimir
Expandir todo

Cursors (Clase)

Actualización: noviembre 2007

Proporciona una colección de objetos Cursor que va a utilizar una aplicación de formularios Windows Forms.

Espacio de nombres:  System.Windows.Forms
Ensamblado:  System.Windows.Forms (en System.Windows.Forms.dll)

public sealed class Cursors
public final class Cursors
public final class Cursors

Algunos de los objetos Cursor de esta clase pueden adoptar una apariencia diferente de las descritas. El usuario puede cambiar la apariencia del cursor mediante el ajuste de los valores del puntero del mouse (ratón) en el sistema operativo. Los cursores de movilidad y de inmovilidad son estáticos y el sistema operativo no puede cambiarlos.

Los cursores de movilidad y de inmovilidad se utilizan durante el funcionamiento de la rueda del mouse. Dependiendo de la dirección en que puedan realizarse desplazamientos por la pantalla, el cursor cambia al cursor de inmovilidad correspondiente cuando se hace clic en la rueda del mouse. Después, el cursor cambia al cursor de movilidad correspondiente cuando se desplaza el mouse.

En el siguiente ejemplo se muestra la forma de modificar el cursor del mouse utilizando la propiedad Control.Cursor, la clase Cursor y la clase Cursors. En el ejemplo se crea un formulario que contiene un control ComboBox, un control Panel y un control ListView. El control ComboBox contiene todos los cursores que proporciona la clase Cursors. Cuando el usuario selecciona un cursor del mouse en ComboBox, la propiedad Control.Cursor se establece en el cursor seleccionado, que actualiza el cursor para el control Panel. El control ListView se actualiza cada vez que se produce el evento Control.CursorChanged.

using System;
using System.Drawing;
using System.Windows.Forms;

namespace MCursor
{
    public class Form1 : System.Windows.Forms.Form
    {
        private System.Windows.Forms.ComboBox cursorSelectionComboBox;

        private System.Windows.Forms.Panel testPanel;
        private System.Windows.Forms.Label label1;
        private System.Windows.Forms.Label label2;
        private System.Windows.Forms.ListView cursorEventViewer;
        private System.Windows.Forms.Label label3;

        [STAThread]
        static void Main() 
        {
            Application.Run(new Form1());
        }

        public Form1()
        {
            this.cursorSelectionComboBox = new System.Windows.Forms.ComboBox();
            this.testPanel = new System.Windows.Forms.Panel();
            this.label1 = new System.Windows.Forms.Label();
            this.label2 = new System.Windows.Forms.Label();
            this.cursorEventViewer = new System.Windows.Forms.ListView();
            this.label3 = new System.Windows.Forms.Label();

            // Select Cursor Label
            this.label2.Location = new System.Drawing.Point(24, 16);
            this.label2.Size = new System.Drawing.Size(80, 16);
            this.label2.Text = "Select cursor:";

            // Cursor Testing Panel Label
            this.label1.Location = new System.Drawing.Point(24, 80);
            this.label1.Size = new System.Drawing.Size(144, 23);
            this.label1.Text = "Cursor testing panel:";

            // Cursor Changed Events Label
            this.label3.Location = new System.Drawing.Point(184, 16);
            this.label3.Size = new System.Drawing.Size(128, 16);
            this.label3.Text = "Cursor changed events:";

            // Cursor Selection ComboBox
            this.cursorSelectionComboBox.Location = new System.Drawing.Point(24, 40);
            this.cursorSelectionComboBox.Size = new System.Drawing.Size(152, 21);
            this.cursorSelectionComboBox.TabIndex = 0;
            this.cursorSelectionComboBox.SelectedIndexChanged += 
                 new System.EventHandler(this.cursorSelectionComboBox_SelectedIndexChanged);

            // Cursor Test Panel
            this.testPanel.BackColor = System.Drawing.SystemColors.ControlDark;
            this.testPanel.Location = new System.Drawing.Point(24, 104);
            this.testPanel.Size = new System.Drawing.Size(152, 160);
            this.testPanel.CursorChanged += new System.EventHandler(this.testPanel_CursorChanged);

            // Cursor Event ListView
            this.cursorEventViewer.Location = new System.Drawing.Point(184, 40);
            this.cursorEventViewer.Size = new System.Drawing.Size(256, 224);
            this.cursorEventViewer.TabIndex = 4;
            this.cursorEventViewer.View = System.Windows.Forms.View.List;

            // Set up how the form should be displayed and add the controls to the form.
            this.ClientSize = new System.Drawing.Size(456, 286);
            this.Controls.AddRange(new System.Windows.Forms.Control[] {
                                        this.label3, this.cursorEventViewer,
                                        this.label2, this.label1,
                                        this.testPanel, this.cursorSelectionComboBox});

            this.Text = "Cursors Example";

            // Add all the cursor types to the combobox.
            foreach (Cursor cursor in CursorList())
            {
                cursorSelectionComboBox.Items.Add(cursor);
            }

        }

        private Cursor [] CursorList()
        {

            // Make an array of all the types of cursors in Windows Forms.
            return new Cursor [] {
                                     Cursors.AppStarting, Cursors.Arrow, Cursors.Cross,
                                     Cursors.Default, Cursors.Hand, Cursors.Help,
                                     Cursors.HSplit, Cursors.IBeam, Cursors.No,
                                     Cursors.NoMove2D, Cursors.NoMoveHoriz, Cursors.NoMoveVert,
                                     Cursors.PanEast, Cursors.PanNE, Cursors.PanNorth,
                                     Cursors.PanNW, Cursors.PanSE, Cursors.PanSouth,
                                     Cursors.PanSW, Cursors.PanWest, Cursors.SizeAll,
                                     Cursors.SizeNESW, Cursors.SizeNS, Cursors.SizeNWSE,
                                     Cursors.SizeWE, Cursors.UpArrow, Cursors.VSplit, Cursors.WaitCursor};

        }

        private void cursorSelectionComboBox_SelectedIndexChanged(object sender, System.EventArgs e)
        {
            // Set the cursor in the test panel to be the selected cursor style.
            testPanel.Cursor = (Cursor)cursorSelectionComboBox.SelectedItem;
        }

        private void testPanel_CursorChanged(object sender, System.EventArgs e)
        {
            // Build up a string containing the type of object sending the event, and the event.
            string cursorEvent = string.Format("[{0}]: {1}", sender.GetType().ToString(), "Cursor changed");                

            // Record this event in the list view.
            this.cursorEventViewer.Items.Add(cursorEvent);
        }
    }
}


package MCursor;

import System.*;
import System.Drawing.*;
import System.Windows.Forms.*;
import System.Collections.*;

public class Form1 extends System.Windows.Forms.Form
{
    private System.Windows.Forms.ComboBox cursorSelectionComboBox;
    private System.Windows.Forms.Panel testPanel;
    private System.Windows.Forms.Label label1;
    private System.Windows.Forms.Label label2;
    private System.Windows.Forms.ListView cursorEventViewer;
    private System.Windows.Forms.Label label3;

    /** @attribute STAThread()
     */
    public static void main(String[] args)
    {
        Application.Run(new Form1());
    } //main

    public Form1()
    {
        this.cursorSelectionComboBox = new System.Windows.Forms.ComboBox();
        this.testPanel = new System.Windows.Forms.Panel();
        this.label1 = new System.Windows.Forms.Label();
        this.label2 = new System.Windows.Forms.Label();
        this.cursorEventViewer = new System.Windows.Forms.ListView();
        this.label3 = new System.Windows.Forms.Label();
        // Select Cursor Label
        this.label2.set_Location(new System.Drawing.Point(24, 16));
        this.label2.set_Size(new System.Drawing.Size(80, 16));
        this.label2.set_Text("Select cursor:");
        // Cursor Testing Panel Label
        this.label1.set_Location(new System.Drawing.Point(24, 80));
        this.label1.set_Size(new System.Drawing.Size(144, 23));
        this.label1.set_Text("Cursor testing panel:");
        // Cursor Changed Events Label
        this.label3.set_Location(new System.Drawing.Point(184, 16));
        this.label3.set_Size(new System.Drawing.Size(128, 16));
        this.label3.set_Text("Cursor changed events:");
        // Cursor Selection ComboBox
        this.cursorSelectionComboBox.set_Location(
            new System.Drawing.Point(24, 40));
        this.cursorSelectionComboBox.set_Size(
            new System.Drawing.Size(152, 21));
        this.cursorSelectionComboBox.set_TabIndex(0);
        this.cursorSelectionComboBox.add_SelectedIndexChanged(
            new System.EventHandler(
            this.cursorSelectionComboBox_SelectedIndexChanged));
        // Cursor Test Panel
        this.testPanel.set_BackColor(
            System.Drawing.SystemColors.get_ControlDark());
        this.testPanel.set_Location(new System.Drawing.Point(24, 104));
        this.testPanel.set_Size(new System.Drawing.Size(152, 160));
        this.testPanel.add_CursorChanged(new System.EventHandler(
            this.testPanel_CursorChanged));
        // Cursor Event ListView
        this.cursorEventViewer.set_Location(new System.Drawing.Point(184, 40));
        this.cursorEventViewer.set_Size(new System.Drawing.Size(256, 224));
        this.cursorEventViewer.set_TabIndex(4);
        this.cursorEventViewer.set_View(System.Windows.Forms.View.List);
        // Set up how the form should be displayed and add the controls to the 
        // form.
        this.set_ClientSize(new System.Drawing.Size(456, 286));
        this.get_Controls().AddRange(new System.Windows.Forms.Control[] { 
            this.label3, this.cursorEventViewer, this.label2, this.label1,
            this.testPanel, this.cursorSelectionComboBox });

        this.set_Text("Cursors Example");

        IEnumerator myEnum = CursorList().GetEnumerator();
        // Add all the cursor types to the combobox.
        while (myEnum.MoveNext()) {
            Cursor cursor = ( Cursor)myEnum.get_Current();
            cursorSelectionComboBox.get_Items().Add(cursor);
        }
    } //Form1

    private Cursor[] CursorList()
    {
        // Make an array of all the types of cursors in Windows Forms.
        return new Cursor[] { Cursors.get_AppStarting(), Cursors.get_Arrow(), 
            Cursors.get_Cross(), Cursors.get_Default(), Cursors.get_Hand(), 
            Cursors.get_Help(), Cursors.get_HSplit(), Cursors.get_IBeam(), 
            Cursors.get_No(), Cursors.get_NoMove2D(), Cursors.get_NoMoveHoriz(), 
            Cursors.get_NoMoveVert(), Cursors.get_PanEast(), 
            Cursors.get_PanNE(), Cursors.get_PanNorth(), Cursors.get_PanNW(),
            Cursors.get_PanSE(), Cursors.get_PanSouth(), Cursors.get_PanSW(),
            Cursors.get_PanWest(), Cursors.get_SizeAll(), 
            Cursors.get_SizeNESW(), Cursors.get_SizeNS(), 
            Cursors.get_SizeNWSE(), Cursors.get_SizeWE(), 
            Cursors.get_UpArrow(), Cursors.get_VSplit(), 
            Cursors.get_WaitCursor() };
    } //CursorList

    private void cursorSelectionComboBox_SelectedIndexChanged(Object sender,
        System.EventArgs e)
    {
        // Set the cursor in the test panel to be the selected cursor style.
        testPanel.set_Cursor((Cursor)(cursorSelectionComboBox.
            get_SelectedItem()));
    } //cursorSelectionComboBox_SelectedIndexChanged

    private void testPanel_CursorChanged(Object sender, System.EventArgs e)
    {
        // Build up a string containing the type of object sending the event, 
        // and the event.
        String cursorEvent = String.Format("[{0}]: {1}", 
               sender.GetType().ToString(), "Cursor changed");
        // Record this event in the list view.
        this.cursorEventViewer.get_Items().Add(cursorEvent);
    } //testPanel_CursorChanged
} //Form1


En el siguiente ejemplo, el cursor especificado se dibuja en el formulario con su tamaño normal y, en modo estirado, con el doble de su tamaño. En este ejemplo se supone que se dispone de Form y de un objeto Cursor que se va a pasar al método en el momento de la llamada.

private void DrawCursorsOnForm(Cursor cursor)
{
   // If the form's cursor is not the Hand cursor and the 
   // Current cursor is the Default, Draw the specified 
   // cursor on the form in normal size and twice normal size.
   if(this.Cursor != Cursors.Hand & 
     Cursor.Current == Cursors.Default)
   {
      // Draw the cursor stretched.
      Graphics graphics = this.CreateGraphics();
      Rectangle rectangle = new Rectangle(
        new Point(10,10), new Size(cursor.Size.Width * 2, 
        cursor.Size.Height * 2));
      cursor.DrawStretched(graphics, rectangle);
		
      // Draw the cursor in normal size.
      rectangle.Location = new Point(
      rectangle.Width + rectangle.Location.X, 
        rectangle.Height + rectangle.Location.Y);
      rectangle.Size = cursor.Size;
      cursor.Draw(graphics, rectangle);

      // Dispose of the cursor.
      cursor.Dispose();
   }
}


private void DrawCursorsOnForm(Cursor cursor)
{
    // If the form's cursor is not the Hand cursor and the 
    // Current cursor is the Default, Draw the specified 
    // cursor on the form in normal size and twice normal size.
        if (!(this.get_Cursor().Equals(Cursors.get_Hand())) 
            & get_Cursor().get_Current().Equals(Cursors.get_Default())) {
        // Draw the cursor stretched.
        Graphics graphics = this.CreateGraphics();
        Rectangle rectangle = new Rectangle(new Point(10, 10), 
            new Size(cursor.get_Size().get_Width() * 2, 
            cursor.get_Size().get_Height() * 2));
        cursor.DrawStretched(graphics, rectangle);
        // Draw the cursor in normal size.
        rectangle.set_Location(new Point(rectangle.get_Width() 
            + rectangle.get_Location().get_X(), rectangle.get_Height() 
            + rectangle.get_Location().get_Y()));
        rectangle.set_Size(cursor.get_Size());
        cursor.Draw(graphics, rectangle);
        // Dispose of the cursor.
        cursor.Dispose();
    }
} //DrawCursorsOnForm


System.Object
  System.Windows.Forms.Cursors

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile para Smartphone, Windows Mobile para Pocket PC

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Compatible con: 3.5, 2.0, 1.0

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft