Dodawanie zmiennej składowej

Możesz dodać zmienną składową do klasy przy użyciu widoku klas. Zmienne składowe mogą być przeznaczone do wymiany danych i sprawdzania poprawności danych lub mogą być ogólne. Kreator zmiennych składowych danych jest przeznaczony do podejmowania odpowiednich informacji i używania ich do wstawiania elementów w plikach źródłowych w odpowiednich lokalizacjach. Możesz dodać zmienną składową z edytora okna dialogowego w widoku zasobów lub z widoku klasy.

Uwaga

Podczas projektowania i implementowania okna dialogowego można użyć edytora okien dialogowych w celu dodania kontrolek okna dialogowego, a następnie zaimplementowania zmiennych składowych kontrolek kontrolek.

Aby dodać zmienną składową dla kontrolki okna dialogowego w widoku zasobu przy użyciu Kreatora dodawania zmiennej składowej:

1. W widoku zasobu rozwiń węzeł projektu i węzeł Okno dialogowe, aby wyświetlić listę okien dialogowych projektu.

2. Kliknij dwukrotnie okno dialogowe, do którego chcesz dodać zmienną składową, aby otworzyć ją w edytorze okien dialogowych.

3. W oknie dialogowym wyświetlanym w edytorze okien dialogowych kliknij prawym przyciskiem myszy kontrolkę, do której chcesz dodać zmienną składową.

4. W menu skrótów wybierz pozycję Dodaj zmienną , aby wyświetlić kreatora Dodawanie zmiennej składowej.

   Uwaga

   Wartość domyślna jest już podana w obszarze Identyfikator kontrolki.

5. Podaj informacje w odpowiednich polach kreatora. Aby uzyskać więcej informacji, zobacz kontrolki okna dialogowego i typy zmiennych.

6. Wybierz przycisk Zakończ , aby dodać definicję i kod implementacji do projektu i zamknąć kreatora.

Aby dodać zmienną składową z widoku klasy przy użyciu Kreatora dodawania zmiennej składowej:

1. W widoku klasy rozwiń węzeł projektu, aby wyświetlić klasy w projekcie.

2. Kliknij prawym przyciskiem myszy klasę, do której chcesz dodać zmienną.

3. W menu skrótów wybierz pozycję Dodaj, a następnie wybierz pozycję Dodaj zmienną, aby wyświetlić Kreatora dodawania zmiennej składowej.

4. Podaj informacje w odpowiednich polach kreatora. Aby uzyskać więcej informacji, zobacz Dodawanie kreatora zmiennej składowej.

5. Wybierz przycisk Zakończ , aby dodać definicję i kod implementacji do projektu i zamknąć kreatora.

W tym obszarze

• Kreator dodawania zmiennej składowej
• Kontrolki okna dialogowego i typy zmiennych

Kreator dodawania zmiennej składowej

Ten kreator dodaje deklarację zmiennej składowej do pliku nagłówka. W zależności od opcji może on dodać kod do pliku .cpp. Po dodaniu zmiennej składowej przy użyciu kreatora możesz edytować kod w środowisku deweloperów.

• Uzyskaj dostęp

  Ustawia dostęp do zmiennej składowej. Modyfikatory dostępu to słowa kluczowe określające dostęp do innych klas, które muszą być zmiennej składowej. Aby uzyskać więcej informacji na temat określania dostępu, zobacz Kontrola dostępu do składowych. Poziom dostępu zmiennej składowej jest domyślnie ustawiony na public wartość .

  • public
  • protected
  • private

• Typ zmiennej

  Ustawia typ zwracany dla dodawanej zmiennej składowej.

  • Jeśli dodasz zmienną składową, która nie jest kontrolką okna dialogowego, wybierz z listy dostępnych typów.

    Aby uzyskać informacje o typach, zobacz podstawowe typy.

    • char
    • double
    • float
    • int
    • long
    • short
    • unsigned char
    • unsigned int
    • unsigned long

  • Jeśli dodasz zmienną składową dla kontrolki okna dialogowego, to pole jest wypełnione typem obiektu zwracanego dla kontrolki lub wartości. Jeśli wybierzesz pozycję Kontrolka, typ zmiennej określa klasę bazową kontrolki wybranej w polu Identyfikator kontrolki. Jeśli kontrolka okna dialogowego może przechowywać wartość, a jeśli wybierzesz wartość, typ zmiennej określa odpowiedni typ dla wartości, którą kontrolka może przechowywać. Aby uzyskać więcej informacji, zobacz kontrolki okna dialogowego i typy zmiennych.

    Ta wartość zależy od wyboru w polu Identyfikator kontrolki i nie można jej zmienić.

• Nazwa zmiennej

  Ustawia nazwę dodawanej zmiennej składowej. Zmienne składowe zwykle zaczynają się od ciągu m_identyfikującego , który jest udostępniany domyślnie.

• Zmienna sterowa

  Wskazuje, że zmienna składowa zarządza kontrolką w oknie dialogowym z obsługą wymiany danych i walidacji danych. Aby uzyskać więcej informacji, zobacz DoDataExchange. Ta opcja jest dostępna tylko dla zmiennych składowych dodanych do klas pochodnych z CDialog. Zaznacz to pole, aby aktywować opcje Identyfikator kontrolki i Typ kontrolki.

• Identyfikator kontrolki

  Ustawia identyfikator dodawanej zmiennej sterującej. Wybierz z listy identyfikator dla typu kontrolki, dla której dodajesz zmienną składową. Lista jest aktywna tylko w przypadku wybrania pola Zmienna sterowania i jest ograniczona do identyfikatorów kontrolek już dodanych do okna dialogowego. Na przykład dla standardowego przycisku OK identyfikator kontrolki to IDOK.

  Opcja	Opis
  Formant	Ta opcja jest domyślnie ustawiana dla typu kontrolki. Zarządza samą kontrolką, a nie stanem lub zawartością kontrolki (jak można zarządzać polem listy, polem kombi lub polem edycji).
  Wartość	Ta opcja jest dostępna dla typów kontrolek, które mogą przechowywać wartość lub wyświetlać stan, takie jak pole edycji lub pole wyboru. Jest ona również dostępna dla typów kontrolek, dla których można zarządzać zakresem, zawartością lub stanem. Aby uzyskać więcej informacji, zobacz kontrolki okna dialogowego i typy zmiennych.

• Kategoria

  Określa, czy zmienna jest oparta na typie kontrolki, czy na wartości kontrolki.

• Typ kontrolki

  Ustawia typ dodawanej kontrolki. To pole nie jest dostępne do zmiany. Na przykład przycisk ma typ kontrolki BUTTON, a pole kombi ma typ kontrolki COMBOBOX. Aby uzyskać więcej informacji, zobacz kontrolki okna dialogowego i typy zmiennych.

• Maksymalna liczba znaków

  Dostępne tylko wtedy, gdy typ zmiennej jest ustawiony na CString. Wskazuje największą liczbę znaków, które może pomieścić kontrolka.

• Minimalna wartość

  Dostępny tylko wtedy, gdy typ zmiennej to BOOL, , DWORDlongfloatintBYTEUINTdoubleshortCOLECurrency lub CTime. Wskazuje najniższą wartość akceptowalną dla skali lub zakresu dat.

• Wartość maksymalna

  Dostępny tylko wtedy, gdy typ zmiennej to BOOL, , DWORDlongfloatUINTintBYTEshortdoubleCOLECurrencylub .CTime Wskazuje najwyższą wartość akceptowalną dla skali lub zakresu dat.

• Plik .h

  W przypadku kontrolek ActiveX, których zmienne składowe wymagają klasy otoki. Ustawia nazwę pliku nagłówka, aby dodać deklarację klasy.

• plik .cpp

  W przypadku kontrolek ActiveX, których zmienne składowe wymagają klasy otoki. Ustawia nazwę pliku implementacji, aby dodać definicję klasy.

• Komentarz

  Zawiera komentarz w pliku nagłówka zmiennej składowej.

Kontrolki okna dialogowego i typy zmiennych

Możesz użyć kreatora dodawania zmiennej składowej, aby dodać zmienną składową do kontrolki okna dialogowego utworzonej przy użyciu MFC. Typ kontrolki, dla której dodajesz zmienną składową, określa opcje wyświetlane w oknie dialogowym.

W poniższej tabeli opisano wszystkie typy kontrolek okna dialogowego, które są obsługiwane w MFC i edytorze okien dialogowych. Wyświetla również ich dostępne typy i wartości.

Kontrola	Typ kontrolki	Typ zmiennej sterującej	Typ zmiennej wartości	Wartości minimalne/maksymalne (tylko typ wartości)
Kontrolka animacji	SysAnimate32	CAnimateCtrl	Żaden; tylko kontrolka	Nie dotyczy
Przycisk	GUZIK	CButton	Żaden; tylko kontrolka	Nie dotyczy
Pole wyboru	SPRAWDZIĆ	CButton	BOOL	Minimalna wartość/Wartość maksymalna
Pole kombi	POLE KOMBI	CComboBox	Ciąg CString	Maksymalna liczba znaków
Kontrolka selektora daty i godziny	SysDateTimePick32	CDateTimeCtrl	CTime	Minimalna wartość/wartość maksymalna
Pole edycji	Edytuj…	CEdit	CString, int, UINT, long, DWORD, float, double, BYTE, short, BOOL, COleDateTime, lub COleCurrency	Minimalna wartość/wartość maksymalna; niektóre znaki maksymalnej obsługi
Kontrolka dostępu	msctls_hotkey32	CHotKeyCtrl	Żaden; tylko kontrolka	Nie dotyczy
Pole listy	POLE LISTY	CListBox	CString	Maksymalna liczba znaków
Kontrolka listy	SysListView32	CListCtrl	Żaden; tylko kontrolka	Nie dotyczy
Kontrolka Kalendarz miesiąca	SysMonthCal32	CMonthCalCtrl	CTime	Minimalna wartość/wartość maksymalna
Kontrolka postępu	msctls_progress32	CProgressCtrl	Żaden; tylko kontrolka	Nie dotyczy
Kontrolka Edycja wzbogacona 2	RichEdit20A	CRichEditCtrl	CString	Maksymalna liczba znaków
Kontrolka edycji wzbogaconej	RICHEDIT	CRichEditCtrl	CString	Maksymalna liczba znaków
Pasek przewijania (pionowy lub poziomy)	PASEK PRZEWIJANIA	CScrollBar	int	Minimalna wartość/wartość maksymalna
Kontrolka suwaka	msctls_trackbar32	CSliderCtrl	int	Minimalna wartość/wartość maksymalna
Sterowanie spinem	msctls_updown32	CSpinButtonCtrl	Żaden; tylko kontrolka	Nie dotyczy
Kontrolka tabulacji	SysTabControl32	CTabCtrl	Żaden; tylko kontrolka	Nie dotyczy
Kontrolka drzewa	SysTreeView32	CTreeCtrl	Żaden; tylko kontrolka	Nie dotyczy