PropertyValueUIItem(Image, PropertyValueUIItemInvokeHandler, String) Construtor

Definição

Namespace:

System.Drawing.Design

Assembly:

System.Windows.Forms.dll

Inicializa uma nova instância da classe PropertyValueUIItem.

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)

Parâmetros

uiItemImage

Image

O ícone para exibir. A imagem deve ser de 8x8 pixels.

handler

PropertyValueUIItemInvokeHandler

O manipulador a ser invocado quando a imagem é clicada duas vezes.

tooltip

String

O ToolTip a exibir para a propriedade à qual esse PropertyValueUIItem está associado.

Exceções

ArgumentNullException

uiItemImage ou handler é null.

Exemplos

O exemplo de código a seguir fornece um PropertyValueUIItem objeto para qualquer propriedade do componente chamado HorizontalMargin ou VerticalMargin. O PropertyValueUIItem para essas propriedades fornece uma imagem, uma Dica de Ferramenta e um manipulador de eventos que exibe uma caixa de mensagem quando a imagem da propriedade é clicada. Este exemplo de código faz parte de um exemplo maior fornecido para a IPropertyValueUIService interface .

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

Confira também

• IPropertyValueUIService
• PropertyValueUIItemInvokeHandler