Botões da janela Propriedades
Dependendo da linguagem de desenvolvimento e do tipo de produto, determinados botões são exibidos por padrão na barra de ferramentas da janela Propriedades . Em todos os casos, os botões Categorizado, Alfabético, Propriedades e Páginas de propriedades são exibidos. No Visual C# e Visual Basic, o botão Eventos também é exibido. Em determinados projetos do Visual C++, as mensagens VC++ e os botões VC substitui são exibidos. Botões adicionais podem ser exibidos para outros tipos de projeto. Para obter mais informações sobre botões na janela Propriedades , consulte Janela Propriedades.
Implementação de botões da janela Propriedades
Quando você clica no botão Categorizado, o Visual Studio chama a ICategorizeProperties interface no objeto que tem foco para classificar suas propriedades por categoria. ICategorizeProperties é implementado no IDispatch objeto que é apresentado à janela Propriedades .
Existem 11 categorias de propriedades predefinidas, que têm valores negativos. Você pode definir categorias personalizadas, mas recomendamos atribuir-lhes valores positivos para distingui-las das categorias predefinidas.
O MapPropertyToCategory método retorna o valor de categoria de propriedade apropriado para a propriedade especificada. O GetCategoryName método retorna uma cadeia de caracteres que contém o nome da categoria. Você só precisa fornecer suporte para valores de categoria personalizados porque o Visual Studio conhece os valores de categoria de propriedade padrão.
Quando você clica no botão Alfabético , as propriedades são exibidas em ordem alfabética por nome. Os nomes são recuperados de acordo com um algoritmo de IDispatch classificação localizado.
Quando a janela Propriedades é aberta, o botão Propriedades é mostrado automaticamente como selecionado. Em outras partes do ambiente, o mesmo botão é exibido e você pode clicar nele para mostrar a janela Propriedades .
O botão Páginas de propriedades não estará disponível se ISpecifyPropertyPages não for implementado para o objeto selecionado. As páginas de propriedades exibem propriedades dependentes da configuração que normalmente estão associadas a soluções e projetos, mas também podem ser associadas a itens de projeto (por exemplo, no Visual C++).
Observação
Não é possível adicionar botões da barra de ferramentas à janela Propriedades usando código não gerenciado. Para adicionar um botão da barra de ferramentas, você deve criar um objeto gerenciado derivado do PropertyTab.