Udostępnij za pośrednictwem

strony właściwości

  • Artykuł

Użytkownicy mogą wyświetlać i zmieniać właściwości zależne od konfiguracji projektu i -independent przy użyciu stron właściwości. Przycisk Strony właściwości jest włączony w oknie Właściwości lub na pasku narzędzi Eksplorator rozwiązań dla obiektów, które zapewniają widok strony właściwości wybranego obiektu. Strony właściwości są tworzone przez środowisko i są dostępne dla rozwiązań i projektów. Można je jednak również udostępnić dla elementów projektu, które korzystają z właściwości zależnych od konfiguracji. Ta funkcja może być używana, gdy pliki w projekcie wymagają różnych ustawień przełącznika kompilatora w celu poprawnej kompilacji.

Używanie stron właściwości

Jeśli strona właściwości jest już wyświetlana i wybór zmieni się (na przykład z rozwiązania do projektu), informacje wyświetlane na stronach zmienią się, aby wyświetlić właściwości nowego wyboru. Jeśli w obiekcie obsługującym strony właściwości nie ma żadnych właściwości, strona właściwości jest pusta.

Jeśli wybrano wiele obiektów, na stronie właściwości zostanie wyświetlona część częściowa właściwości dla wszystkich zaznaczonych elementów. Jeśli wybrany element nie zawiera właściwości zależnych od konfiguracji, a przycisk Strony właściwości na pasku narzędzi Eksplorator rozwiązań zostanie kliknięty, fokus zmieni się na okno Właściwości. Aby uzyskać więcej informacji dotyczących okno Właściwości i zaznaczenia, zobacz Rozszerzanie właściwości.

Jeśli właściwości są wyświetlane dla wielu obiektów i zmieniasz wartość na stronie właściwości, wszystkie wartości obiektów są ustawione na nową wartość, nawet jeśli początkowo były różne, a strona była pusta, gdy właściwości poszczególnych obiektów były wyświetlane.

W programie Visual Studio są dostępne dwa ogólne typy okien dialogowych ProjectProperty Pages . W pierwszym przypadku projektów języka Visual Basic strony właściwości są wyświetlane przy użyciu formatu pola, jak pokazano na poniższym zrzucie ekranu. W drugiej części przedstawionej w dalszej części tej sekcji strona właściwości hostuje siatkę właściwości podobną do tej, która znajduje się w oknie Właściwości.

Strony właściwości Języka Visual Basic

Okno dialogowe Strony właściwości projektu z formatem pola i strukturą drzewa

Struktura drzewa w oknie dialogowym Strony właściwości nie jest kompilowana przy użyciu polecenia IVsHierarchy. Środowisko na podstawie nazwy poziomu przekazanej do niego przez ISpecifyPropertyPages interfejsy i IVsPropertyPage tworzy je.

Na stronach właściwości programu Visual Studio są dostępne tylko dwie kategorie najwyższego poziomu:

  • Typowe właściwości, które wyświetla informacje niezależne od konfiguracji dla wybranego obiektu lub obiektów. W związku z tym po wybraniu jednej z podkategorii Wspólnych właściwości opcje Konfiguracja, Platforma i Program Configuration Manager w górnej części okna dialogowego nie są dostępne.

  • Właściwości konfiguracji, które zawierają informacje zależne od konfiguracji dotyczące parametrów debugowania, optymalizacji i kompilacji dla rozwiązania lub projektu.

    Nie można utworzyć żadnych dodatkowych kategorii najwyższego poziomu, ale możesz nie wyświetlać jednej lub drugiej w implementacji programu IVsPropertyPage. Jeśli na przykład nie masz żadnych właściwości niezależnych od konfiguracji do wyświetlenia dla obiektu, możesz nie wyświetlać kategorii Właściwości wspólne. Wyświetlane są wspólne właściwości, jeśli ISpecifyPropertyPages są implementowane z obiektu przeglądania elementu i właściwości konfiguracji podczas implementowania ISpecifyPropertyPages w obiekcie konfiguracji (obiekt implementuje IVsCfginterfejsy , IVsProjectCfgi powiązane).

    Każda kategoria wyświetlana w kategorii najwyższego poziomu reprezentuje oddzielną stronę właściwości. Wpisy kategorii i podkategorii dostępne w oknie dialogowym są określane przez implementację elementów ISpecifyPropertyPages i IVsPropertyPage.

    IDispatch obiekty dla elementów w kontenerze wyboru, które mają właściwości, które mają być wyświetlane na stronach właściwości implementują ISpecifyPropertyPages wyliczenie listy identyfikatorów klas. Identyfikatory klas są przekazywane jako zmienne do ISpecifyPropertyPages i są używane do tworzenia wystąpień stron właściwości. Lista identyfikatorów klas jest również przekazywana w celu IVsPropertyPage utworzenia struktury drzewa po lewej stronie okna dialogowego. Strony właściwości następnie przekazują informacje z powrotem do IDispatch obiektu, który implementuje ISpecifyPropertyPages i wypełnia informacje dla każdej strony.

    Właściwości obiektu przeglądania są pobierane przy użyciu IDispatch dla każdego obiektu w kontenerze wyboru.

    Implementacja Help::DisplayTopicFromF1Keyword w programie VSPackage udostępnia funkcje przycisku Pomoc.

    Aby uzyskać więcej informacji, zobacz IDispatch i ISpecifyPropertyPages w bibliotece MSDN.

    Drugi typ stron właściwości wyświetlanych w przykładach hostuje formę siatki właściwości, jak pokazano na poniższym zrzucie ekranu.

    Strony właściwości VC

    Okno dialogowe Strony właściwości z siatką właściwości

    Interfejsy IVSMDPropertyBrowser i IVSMDPropertyGrid (zadeklarowane w vsmanaged.h) służą do tworzenia i wypełniania siatki właściwości w oknie dialogowym lub oknie.

    Architektura projektów znacznie zmieniła się z poprzednich wersji programu Visual Studio. W szczególności pojęcie aktywnego projektu uległo zmianie. W programie Visual Studio nie ma pojęcia aktywnego projektu. W poprzednich środowiskach deweloperskich aktywny projekt był projektem, który kompiluje i wdraża polecenia domyślnie niezależnie od kontekstu. Teraz rozwiązanie kontroluje i arbitra, które kompilują i wdrażają polecenia, mają zastosowanie do których projektów.

    To, co wcześniej było aktywnym projektem, jest teraz przechwytywane na jeden z trzech różnych sposobów:

  • Projekt startowy

    Projekt lub projekty można określić na stronie właściwości rozwiązania, która zostanie uruchomiona po naciśnięciu F5 przez użytkownika lub wybraniu pozycji Uruchom z menu Kompilacja. Działa to w sposób podobny do starego aktywnego projektu w sensie, że jego nazwa jest wyświetlana w Eksplorator rozwiązań z pogrubioną czcionką.

    Projekt startowy można pobrać jako właściwość w modelu automatyzacji, wywołując polecenie DTE.Solution.SolutionBuild.StartupProjects. W programie VSPackage wywołasz get_StartupProject metody lub get_StartupProject . IVsSolutionBuildManager usługa jest dostępna jako usługa w QueryService SID_SVsSolutionBuildManager. Aby uzyskać więcej informacji, zobacz Project Configuration Object and Solution Configuration (Konfiguracja obiektu i rozwiązania projektu).

  • Konfiguracja kompilacji aktywnego rozwiązania

    Program Visual Studio ma aktywną konfigurację rozwiązania dostępną w modelu automatyzacji przez zaimplementowanie elementu DTE.Solution.SolutionBuild.ActiveConfiguration. Konfiguracja rozwiązania to kolekcja zawierająca jedną konfigurację projektu dla każdego projektu w rozwiązaniu (każdy projekt może mieć wiele konfiguracji na wielu platformach z różnych nazw). Aby uzyskać więcej informacji dotyczących stron właściwości rozwiązania, zobacz Konfiguracja rozwiązania.

  • Aktualnie wybrany projekt

    Zaimplementuj metodę GetCurrentSelection , aby pobrać hierarchię projektu i wybrany element lub elementy projektu. Z DTE należy użyć SelectedItems.SelectedItem.Project metod i SelectedItems.SelectedItem.ProjectItem . Przykładowy kod znajduje się pod tymi nagłówkami w podstawowych dokumentach programu Visual Studio.

Zobacz też