Udostępnij za pośrednictwem

Metoda IVsStatusbar.Progress — (UInt32, Int32, String, UInt32, UInt32)

  • Artykuł

 

Pokazuje postęp operacji, które określony czas trwania.

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

Składnia

int Progress(
    ref uint pdwCookie,
    int fInProgress,
    string pwszLabel,
    uint nComplete,
    uint nTotal
)

int Progress(
    unsigned int% pdwCookie,
    int fInProgress,
    String^ pwszLabel,
    unsigned int nComplete,
    unsigned int nTotal
)

abstract Progress : 
        pdwCookie:uint32 byref *
        fInProgress:int *
        pwszLabel:string *
        nComplete:uint32 *
        nTotal:uint32 -> int

Function Progress (
    ByRef pdwCookie As UInteger,
    fInProgress As Integer,
    pwszLabel As String,
    nComplete As UInteger,
    nTotal As UInteger
) As Integer

Parametry

  • pdwCookie
    Type: System.UInt32

    [out w] Identyfikator bieżącego użytkownika, aby zapobiec wielu używa paska postępu w tym samym czasie.

  • fInProgress
    Type: System.Int32

    [in] true gdy pasek postępu jest używany; wartość false, po zakończeniu.

  • pwszLabel
    Type: System.String

    [in] Tekst do wyświetlenia w polu Stan, gdy pasek postępu jest w użyciu.

  • nComplete
    Type: System.UInt32

    [in] Liczba jednostek obecnie skonfigurowanie pasek postępu.

  • nTotal
    Type: System.UInt32

    [in] Całkowita liczba jednostek dla operacji paska postępu.

Wartość zwracana

Type: System.Int32

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

Uwagi

Podpis COM

Z vsshell.idl:

HRESULT IVsStatusbar::Progress(
   [in,out]VSCOOKIE *pdwCookie,
   [in]BOOL fInProgress,
   [in]LPCOLESTR pwszLabel,
   [in]ULONG nComplete,
   [in]ULONG nTotal
);

Postęp jest wyświetlany jako rosnące niebieski pasek w obszarze paska postępu na pasku stanu. Ta metoda wywołuje użytkownika paska stanu po raz pierwszy pdwCookie musi mieć wartość zero. Wartość zwracany w pdwCookie jest unikatowy identyfikator, że użytkownik paska stanu musi używać w przyszłości wywołania tej metody.

Ta metoda jest wywoływana, aby wyświetlić postęp podczas operacji. W efekcie nTotal musi być znane przed wywołaniem tej metody. Jeśli nTotal nie może być ustalona wcześniej i operacji może zająć więcej niż kilka sekund, wywołanie Animation Metoda zamiast tego.

Zobacz też

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

Powrót do początku