Om förloppsindikatorkontroller
En förloppsindikator är ett fönster som ett program kan använda för att ange förloppet för en lång åtgärd.
Den består av en rektangel som animeras när en operation fortskrider.
Följande bild visar ett förloppsfält som inte använder visuella stilar.
Följande illustration visar ett förloppsfält med hjälp av visuella stilar. Kontrollens utseende varierar beroende på operativsystemet och det valda temat. Mer information finns i Visual Styles.
Mer information finns under följande rubriker.
Så här använder du förloppsstaplar
Du kan skapa en förloppsindikator med hjälp av funktionen CreateWindowEx och ange PROGRESS_CLASS-fönsterklassen. Den här fönsterklassen registreras när den vanliga DLL-filen för kontroller läses in. Mer information finns i Om vanliga kontroller.
Kontrollen är också tillgänglig i Microsoft Visual Studio Toolbox, där den kallas Förloppskontroll.
Intervall och aktuell position
Förloppsindikatorns intervall representerar hela varaktigheten för åtgärden, och den aktuella positionen representerar förloppet som programmet har gjort för att slutföra åtgärden. I fönsterproceduren används intervallet och den aktuella positionen för att fastställa hur stor procentandel av förloppsindikatorn som ska fyllas med markeringsfärgen.
Om du inte anger intervallvärdena anger systemet minimivärdet till 0 och det maximala värdet till 100. Du kan justera intervallet till praktiska heltal med hjälp av meddelandet PBM_SETRANGE.
En förloppsindikator innehåller flera meddelanden som du kan använda för att ange den aktuella positionen. Meddelandet PBM_SETPOS anger positionen till ett angivet värde. Meddelandet PBM_DELTAPOS flyttar fram positionen genom att lägga till ett angivet värde i den aktuella positionen.
Med meddelandet PBM_SETSTEP kan du ange en stegökning för ett förloppsfält. Därefter, när du skickar PBM_STEPIT meddelandet till progressbaren, ökar den aktuella positionen med det angivna inkrementet. Som standardinställning är stegincrementet inställt på 10.
Förval för meddelandebearbetning i förloppsindikatorn
I det här avsnittet beskrivs de meddelanden som hanteras av fönsterproceduren för klassen PROGRESS_CLASS.
| Meddelande | Bearbetningen har utförts |
|---|---|
| WM_CREATE | Allokerar och initierar en inledande struktur. |
| WM_DESTROY | Frigör alla resurser som är associerade med förloppsindikatorn. |
| WM_ERASEBKGND | Ritar förloppsindikatorns bakgrund och kantlinjer. |
| WM_GETFONT | Returnerar handtaget till det aktuella teckensnittet. Förloppsindikatorn ritar för närvarande inte text, så att skicka det här meddelandet har ingen effekt på kontrollen. |
| WM_PAINT | Ritar förloppsindikatorn. Om parametern wParam inte ärNULL-förutsätter kontrollen att värdet är en HDC och målar med den enhetskontexten. |
| WM_SETFONT | Sparar handtaget till det nya teckensnittet och returnerar handtaget till föregående teckensnitt. Förloppsindikatorn ritar för närvarande inte text, så att skicka det här meddelandet har ingen effekt på kontrollen. |
Marquee-stil
Genom att skapa förloppsindikatorkontrollen med PBS_MARQUEE formatmall kan du animera den på ett sätt som visar aktivitet, men anger inte vilken andel av aktiviteten som är slutförd. Den markerade delen av förloppsindikatorn flyttas upprepade gånger längs längden på fältet. Du kan starta och stoppa animeringen och kontrollera dess hastighet genom att skicka meddelandet PBM_SETMARQUEE. Förloppsstaplar för markeringsramen har inte något intervall eller en position.
Följande bild visar ett förloppsfält i markeringsramsläge. Den markerade delen flyttas över fältet.
