Udostępnij za pośrednictwem

Metoda IVsPropertyPage.CategoryTitle — (UInt32, String)

  • Artykuł

 

Zwraca kategorii, w ramach którego strony właściwości mają być wyświetlane w widoku drzewa.

Przestrzeń nazw:   Microsoft.VisualStudio.Shell.Interop
Zestaw:  Microsoft.VisualStudio.Shell.Interop (w Microsoft.VisualStudio.Shell.Interop.dll)

Składnia

int CategoryTitle(
    uint iLevel,
    out string pbstrCategory
)

int CategoryTitle(
    unsigned int iLevel,
    [OutAttribute] String^% pbstrCategory
)

abstract CategoryTitle : 
        iLevel:uint32 *
        pbstrCategory:string byref -> int

Function CategoryTitle (
    iLevel As UInteger,
    <OutAttribute> ByRef pbstrCategory As String
) As Integer

Parametry

  • iLevel
    [w] Liczba całkowita zawierająca poziom.
  • pbstrCategory
    [out, retval] Wskaźnik do kategorii (folder), pod którym ma stronę właściwości mają być wyświetlane.

Wartość zwracana

Type: System.Int32

Jeśli metoda się powiedzie, zwraca S_OK.Jeśli nie powiedzie się, zwraca kod błędu.

Uwagi

Podpis COM

Z vsshell.idl:

HRESULT IVsPropertyPage::CategoryTitle(
   [in]UINT iLevel,
   [out, retval]BSTR *pbstrCategory
);

Jeśli na stronie właściwości nie ma kategorii i wolisz, aby pokazać na najwyższym poziomie widoku drzewa, bezpośrednio do odpowiedniej kategorii najwyższego poziomu, a następnie albo wykonania IPropertyPage samodzielnie lub zwrotu E_NOTIMPL z tej metody.

  1. W przeciwnym razie środowiska najpierw wywołuje tej metody, z iLevel o wartości zero.

  2. Następnie można zwrócić nazwę kategorii, który powinien być najbliższe bezpośredniej ancestor tej strony w drzewie.

  3. Środowiska naturalnego będą następnie wywołanie z iLevel jedną wartość.

  4. Jeśli na stronie ma być wcięty o jeden poziom, zwracany jest S_FALSE.

  5. Środowisko w dalszym ciągu wywołanie tej metody, zwiększając wartość iLevel przez jednego każdego czasu, aż powrócisz coś innego niż S_OK, lub osiągnąć wewnętrzny limit środowiska go obsługuje.

Zwracanie E_NOTIMPL i S_FALSE zatrzymuje przetwarzanie bez pokazywania błąd do użytkownika.Wszystkie wartości inne niż S_OK może spowodować błąd informacje mają być widoczne dla użytkownika.

Środowisko obecnie obsługuje tylko dwa poziomy kategorii:

CatLevel1

CatLevel0

PageName

Kategorie programu Visual Studio, właściwości wspólne i właściwości konfiguracji znajdują się powyżej CatLevel1 w hierarchii.Kategorie Visual Studio nie są liczone jako część dwa poziomy.Nie powrócić, z get_CategoryTitle.

Zobacz też

Interfejs IVsPropertyPage
Przestrzeń nazw Microsoft.VisualStudio.Shell.Interop

Powrót do początku