PropertyValueUIItemInvokeHandler Délégué

Définition

Espace de noms:

System.Drawing.Design

Assembly:

System.Windows.Forms.dll

Représente la méthode qui gérera l'événement InvokeHandler d'un PropertyValueUIItem.

public delegate void PropertyValueUIItemInvokeHandler(ITypeDescriptorContext ^ context, PropertyDescriptor ^ descriptor, PropertyValueUIItem ^ invokedItem);

public delegate void PropertyValueUIItemInvokeHandler(ITypeDescriptorContext context, PropertyDescriptor descriptor, PropertyValueUIItem invokedItem);

type PropertyValueUIItemInvokeHandler = delegate of ITypeDescriptorContext * PropertyDescriptor * PropertyValueUIItem -> unit

Public Delegate Sub PropertyValueUIItemInvokeHandler(context As ITypeDescriptorContext, descriptor As PropertyDescriptor, invokedItem As PropertyValueUIItem)

Paramètres

context

ITypeDescriptorContext

ITypeDescriptorContext de la propriété associée à l'icône sur laquelle l'utilisateur a double-cliqué.

descriptor

PropertyDescriptor

Propriété associée à l'icône sur laquelle l'utilisateur a double-cliqué.

invokedItem

PropertyValueUIItem

PropertyValueUIItem associé à l'icône sur laquelle l'utilisateur a double-cliqué.

Exemples

L’exemple de code suivant fournit un PropertyValueUIItem objet pour toutes les propriétés du composant nommé HorizontalMargin ou VerticalMargin. Le PropertyValueUIItem pour ces propriétés fournit une image, une info-bulle et un gestionnaire d’événements qui affiche une boîte de message lorsque l’utilisateur clique sur l’image de la propriété. Cet exemple de code fait partie d’un exemple plus grand fourni pour l’interface IPropertyValueUIService .

// PropertyValueUIHandler delegate that provides PropertyValueUIItem
// objects to any properties named HorizontalMargin or VerticalMargin.
private void marginPropertyValueUIHandler(
    System.ComponentModel.ITypeDescriptorContext context,
    System.ComponentModel.PropertyDescriptor propDesc,
    ArrayList itemList)
{
    // A PropertyValueUIHandler added to the IPropertyValueUIService
    // is queried once for each property of a component and passed
    // a PropertyDescriptor that represents the characteristics of 
    // the property when the Properties window is set to a new 
    // component. A PropertyValueUIHandler can determine whether 
    // to add a PropertyValueUIItem for the object to its ValueUIItem 
    // list depending on the values of the PropertyDescriptor.
    if (propDesc.DisplayName.Equals("HorizontalMargin"))
    {
        Image img = Image.FromFile("SampImag.jpg");
        itemList.Add(new PropertyValueUIItem(img, new PropertyValueUIItemInvokeHandler(this.marginInvoke), "Test ToolTip"));
    }
    if (propDesc.DisplayName.Equals("VerticalMargin"))
    {
        Image img = Image.FromFile("SampImag.jpg");
        img.RotateFlip(RotateFlipType.Rotate90FlipNone);
        itemList.Add(new PropertyValueUIItem(img, new PropertyValueUIItemInvokeHandler(this.marginInvoke), "Test ToolTip"));
    }
}

Remarques

Le double-clic sur une icône dans le Fenêtre Propriétés déclenche l’événement InvokeHandler du PropertyValueUIItem auquel l’icône est associée. L’événement InvokeHandler lance généralement une interface utilisateur pour modifier la valeur de la propriété. Ajoutez un PropertyValueUIItemInvokeHandler à la InvokeHandler propriété d’un PropertyValueUIItem pour affecter un gestionnaire d’événements afin d’effectuer le comportement approprié lorsque l’icône affichée en regard du nom de la propriété fait l’objet d’un double-clic.

Lorsque vous créez un délégué PropertyValueUIItemInvokeHandler, vous identifiez la méthode qui gérera l'événement. Pour associer l'événement au gestionnaire d'événements, ajoutez une instance du délégué à l'événement. Le gestionnaire d'événements est appelé chaque fois qu'un événement se produit, sauf si vous supprimez le délégué. Pour plus d’informations sur les délégués de gestionnaire d’événements, consultez Gestion et déclenchement d’événements.

Méthodes d’extension

Voir aussi

• ITypeDescriptorContext
• PropertyValueUIItem
• IPropertyValueUIService