Udostępnij za pośrednictwem

Metoda IVsUserSettingsQuery.NeedExport — (String, Int32)

  • Artykuł

 

Wskazuje, czy określona kategoria wymaga eksportu jej ustawienia.

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

Składnia

int NeedExport(
    string szCategoryGUID,
    out int pfNeedExport
)

int NeedExport(
    String^ szCategoryGUID,
    [OutAttribute] int% pfNeedExport
)

abstract NeedExport : 
        szCategoryGUID:string *
        pfNeedExport:int byref -> int

Function NeedExport (
    szCategoryGUID As String,
    <OutAttribute> ByRef pfNeedExport As Integer
) As Integer

Parametry

  • szCategoryGUID
    Type: System.String

    [in] Identyfikator GUID kategorii określone ustawienia (zdefiniowane przez punkt ustawienia niestandardowe) dotyczy kwerenda.

  • pfNeedExport
    Type: System.Int32

    [out] Wartość logiczna zwrócone do wskazania, jeśli IDE wywołać implementację ustawienia eksportu pakietu VSPackage.

Wartość zwracana

Type: System.Int32

Jeśli metoda zakończy się pomyślnie, zwraca S_OK. Jeśli nie, zwraca kod błędu.

Uwagi

Pojedynczy VSPackage może obsługiwać więcej niż jeden punkt ustawienia niestandardowe (kategoria ustawienia). Dlatego implementacje NeedExport musi wyboru podany punkt ustawienia niestandardowe identyfikowanie identyfikatora GUID ani ustawień argumentu kategorii ustalenie określonej grupy ustawień musi być zapisany.

Przykłady

W tym przykładzie pakietu VSPackage zawsze żąda jego stan paska poleceń jest zapisywany, że tylko żądania, że jego stan powiązania klucza można zapisać go została ustawiona flaga.

STDMETHOD(NeedExport)(WCHAR* pszCategoryGUID, BOOL *pfNeedExport)
{
    if (!pfNeedExport)
        return E_INVALIDARG;

    CLSID clsidCategory;
    HRESULT hr= S_OK;

    hr = CLSIDFromString(pszCategoryGUID, &clsidCategory);
    IfFailGo(hr);
    if (GUID_Profiles_CommandBars == clsidCategory) {
        *pfNeedExport = TRUE; //Always export Command Bar Configuration
    }else if (GUID_Profiles_KeyBindings == clsidCategory) {
        *pfNeedExport = FALSE; //By Default don't export key bindings
        if (m_fMake_Permanent)
            *pfNeedExport = TRUE; //Export if user wants current configuration saved.
    }else{
        hr = E_UNEXPECTED;
    }
 Error:
    return hr;
}

Zobacz też

IVsUserSettings
ImportSettings
Interfejs IVsUserSettingsQuery
Przestrzeń nazw Microsoft.VisualStudio.Shell.Interop
Obsługa ustawień użytkownika
Porady: umożliwia importowanie ustawień zestawy międzyoperacyjne
Working with Settings

Powrót do początku