Udostępnij za pośrednictwem


CToolBarCtrl::AddButtons

Dodaje jeden lub więcej przycisków do formantu toolbar.

BOOL AddButtons(
   int nNumButtons,
   LPTBBUTTON lpButtons 
);

Parametry

  • nNumButtons
    Liczba przycisków, aby dodać.

  • lpButtons
    Adres tablicy TBBUTTON struktur, które zawiera informacje dotyczące przycisków, aby dodać.Musi być taka sama liczba elementów w tablicy jako przyciski określonej przez nNumButtons.

Wartość zwracana

Niezerowa, jeśli kończy się pomyślnie; zero w inny sposób.

Uwagi

lpButtons Punkty wskaźnik do tablicy TBBUTTON struktury.Każdy TBBUTTON struktury kojarzy przycisk dodawany styl przycisku, stan obrazu lub ciąg Identyfikatora polecenia i zdefiniowane przez użytkownika danych:

typedef struct _TBBUTTON {

int iBitmap;// zero-based index of button image

int idCommand; // command to be sent when button pressed

BYTE fsState; // button state--see below

BYTE fsStyle; // button style--see below

DWORD dwData; // application-defined value

int iString;// zero-based index of button label string

} TBBUTTON;

Członkowie są następujące:

  • iBitmap
    Wyświetlanego obrazu na przycisku, -1, jeśli brak obrazu dla tego przycisku.

  • idCommand
    Identyfikator polecenia skojarzony z przyciskiem.Ten identyfikator jest wysyłany w WM_COMMAND wiadomości, gdy wybrany jest przycisk.Jeśli fsStyle członek ma TBSTYLE_SEP wartości, członek ten musi mieć wartość zero.

  • fsState
    Flagi stanu przycisku.Mogą to być kombinacją wartości wymienionych poniżej:

    • TBSTATE_CHECKEDPrzycisk ma TBSTYLE_CHECKED styl i jest jest wciśnięty.

    • TBSTATE_ENABLEDPrzycisk akceptuje danych wejściowych użytkownika.Przycisk, który nie ma tego Państwa nie akceptuje danych wejściowych użytkownika i jest wyszarzone.

    • TBSTATE_HIDDENPrzycisk nie jest widoczny i nie mogą odbierać danych wejściowych użytkownika.

    • TBSTATE_INDETERMINATEPrzycisk jest wyszarzony.

    • TBSTATE_PRESSEDPrzycisk jest naciśnięty.

    • TBSTATE_WRAPPodział wiersza poniżej przycisku.Przycisk musi mieć również TBSTATE_ENABLED Państwo.

  • fsStyle
    Styl przycisku.Mogą to być kombinacją wartości wymienionych poniżej:

    • TBSTYLE_BUTTONTworzy standardowego przycisku polecenia.

    • TBSTYLE_CHECKTworzy przycisk, który przełącza pomiędzy Państwami wciśnięty i eknaprzyciskach przy każdym kliknięciu go.Przycisk ma inny kolor tła, gdy jest on w stanie wciśnięty.

    • TBSTYLE_CHECKGROUPTworzy przycisk wyboru, która pozostaje wciśnięty do momentu naciśnięcia innego przycisku w grupie.

    • TBSTYLE_GROUPTworzy przycisk, który pozostaje wciśnięty do momentu naciśnięcia innego przycisku w grupie.

    • TBSTYLE_SEPTworzy separatora, zapewniając mały odstęp pomiędzy grupami przycisków.Przycisk ten styl nie odbiera danych wejściowych użytkownika.

  • dwData
    Dane zdefiniowane przez użytkownika.

  • iString
    Ciąg używany jako przycisk wyświetlanego etykiety, -1, jeśli nie ma żadnego ciągu znaków dla tego przycisku.

Obraz lub ciąg znaków, w której podasz indeksu musi uprzednio zostały dodane do formantu toolbar listy za pomocą AddBitmap, Addstring(), lub AddStrings.

Wymagania

Nagłówek: afxcmn.h

Zobacz też

Informacje

Klasa CToolBarCtrl

Wykres hierarchii

CToolBarCtrl::InsertButton

CToolBarCtrl::DeleteButton

CToolBarCtrl::AddBitmap

CToolBarCtrl::AddString

CToolBarCtrl::AddStrings