Udostępnij za pośrednictwem


Porady: dostarczanie mapy bitowej przybornika dla formantu

Jeśli chcesz mieć specjalną ikonę kontrolki wyświetlaną w przyborniku programu Visual Studio, możesz określić konkretny obraz przy użyciu elementu ToolboxBitmapAttribute. Ta klasa jest atrybutem, specjalnym rodzajem klasy, którą można dołączyć do innych klas. Aby uzyskać więcej informacji na temat atrybutów, zobacz Omówienie atrybutów (Visual Basic) dla języka Visual Basic lub Atrybuty (C#) dla języka C#.

ToolboxBitmapAttributeZa pomocą elementu można określić ciąg, który wskazuje ścieżkę i nazwę pliku dla mapy bitowej o rozmiarze 16 o 16 pikseli. Ta mapa bitowa pojawi się następnie obok kontrolki po dodaniu do przybornika. Można również określić obiekt , w którym przypadku mapa bitowa skojarzona z tym typem Typejest ładowana. Jeśli określisz zarówno ciąg, jak Type i, kontrolka wyszukuje zasób obrazu o nazwie określonej przez parametr ciągu w zestawie zawierającym typ określony przez Type parametr .

Aby określić mapę bitową przybornika dla kontrolki

  1. Dodaj element ToolboxBitmapAttribute do deklaracji klasy kontrolki przed Class słowem kluczowym visual Basic i powyżej deklaracji klasy dla języka Visual C#.

    ' Specifies the bitmap associated with the Button type.
    <ToolboxBitmap(GetType(Button))> Class MyControl1
    ' Specifies a bitmap file.
    End Class
    <ToolboxBitmap("C:\Documents and Settings\Joe\MyPics\myImage.bmp")> _
       Class MyControl2
    End Class
    ' Specifies a type that indicates the assembly to search, and the name
    ' of an image resource to look for.
    <ToolboxBitmap(GetType(MyControl), "MyControlBitmap")> Class MyControl
    End Class
    
    // Specifies the bitmap associated with the Button type.
    [ToolboxBitmap(typeof(Button))]
    class MyControl1 : UserControl
    {
    }
    // Specifies a bitmap file.
    [ToolboxBitmap(@"C:\Documents and Settings\Joe\MyPics\myImage.bmp")]
    class MyControl2 : UserControl
    {
    }
    // Specifies a type that indicates the assembly to search, and the name
    // of an image resource to look for.
    [ToolboxBitmap(typeof(MyControl), "MyControlBitmap")]
    class MyControl : UserControl
    {
    }
    
  2. Ponownie skompiluj projekt.

    Uwaga

    Mapa bitowa nie jest wyświetlana w przyborniku dla automatycznie wygenerowanych kontrolek i składników. Aby wyświetlić mapę bitową, załaduj ponownie kontrolkę przy użyciu okna dialogowego Wybieranie elementów przybornika. Aby uzyskać więcej informacji, zobacz Przewodnik: automatyczne wypełnianie przybornika za pomocą składników niestandardowych.

Zobacz też