PropertyValueUIItem(Image, PropertyValueUIItemInvokeHandler, String) Konstruktor

Definition

Namespace:

System.Drawing.Design

Assembly:

System.Windows.Forms.dll

Initialisiert eine neue Instanz der PropertyValueUIItem-Klasse.

public:
 PropertyValueUIItem(System::Drawing::Image ^ uiItemImage, System::Drawing::Design::PropertyValueUIItemInvokeHandler ^ handler, System::String ^ tooltip);

public PropertyValueUIItem (System.Drawing.Image uiItemImage, System.Drawing.Design.PropertyValueUIItemInvokeHandler handler, string? tooltip);

new System.Drawing.Design.PropertyValueUIItem : System.Drawing.Image * System.Drawing.Design.PropertyValueUIItemInvokeHandler * string -> System.Drawing.Design.PropertyValueUIItem

Public Sub New (uiItemImage As Image, handler As PropertyValueUIItemInvokeHandler, tooltip As String)

Parameter

uiItemImage

Image

Das anzuzeigende Symbol. Das Bild muss eine Größe von 8 x 8 Pixel haben.

handler

PropertyValueUIItemInvokeHandler

Der Handler, der bei einem Doppelklick auf das Bild aufgerufen werden soll.

tooltip

String

Die ToolTip-Eigenschaft, die für die Eigenschaft angezeigt werden soll, der diese PropertyValueUIItem-Klasse zugeordnet ist.

Ausnahmen

ArgumentNullException

uiItemImage oder handler ist null.

Beispiele

Das folgende Codebeispiel stellt ein PropertyValueUIItem -Objekt für alle Eigenschaften der Komponente mit dem Namen HorizontalMargin oder VerticalMarginbereit. Der PropertyValueUIItem für diese Eigenschaften stellt ein Bild, eine QuickInfo und einen Ereignishandler bereit, der ein Meldungsfeld anzeigt, wenn auf das Bild für die Eigenschaft geklickt wird. Dieses Codebeispiel ist Teil eines größeren Beispiels für die IPropertyValueUIService Schnittstelle.

// 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"));
    }
}

Weitere Informationen

• IPropertyValueUIService
• PropertyValueUIItemInvokeHandler