Dodawanie zmiennej składowej

Możesz dodać zmienną składową do klasy przy użyciu widoku klasy. Zmienne składowe mogą być przeznaczone do wymiany danych i walidacji 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 okien dialogowych w widoku zasobów lub z widoku klasy.

Uwaga

Podczas projektowania i implementowania okna dialogowego może okazać się bardziej wydajne, aby użyć edytora okien dialogowych do dodania kontrolek okna dialogowego, a następnie zaimplementować zmienne składowe kontrolek.

Aby dodać zmienną składową 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 okna dialogowego 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 identyfikatorze kontrolki.

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

6. Wybierz pozycję Zakończ , aby dodać kod definicji i 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 Kreator dodawania zmiennej składowej.

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

W tej sekcji

• 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żna dodać kod do pliku cpp. Po dodaniu zmiennej składowej przy użyciu kreatora możesz edytować kod w środowisku deweloperów.

• Dostęp

  Ustawia dostęp do zmiennej składowej. Modyfikatory dostępu są słowami kluczowymi określającymi dostęp do innych klas do zmiennej składowej. Aby uzyskać więcej informacji na temat określania dostępu, zobacz Kontrola dostępu do elementów członkowskich. Domyślnie ustawiono public poziom dostępu zmiennej składowej.

  • public
  • protected
  • Prywatny

• 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 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 obszarze Identyfikator kontrolki i nie można jej zmienić.

• Nazwa zmiennej

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

• Zmienna kontrolna

  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 narzędzia CDialog. Wybierz 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 wtedy, gdy pole Zmienna sterowania jest zaznaczone i jest ograniczone do identyfikatorów kontrolek już dodanych do okna dialogowego. Na przykład w przypadku standardowego przycisku OK identyfikator kontrolki to IDOK.

  Opcja	Opis
  Kontrola	Ta opcja jest domyślnie ustawiana dla typu kontrolki. Zarządza samą kontrolką, a nie stanem ani zawartością kontrolki (ponieważ 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 pokazywać stan, na przykład 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.

• Wartość minimalna

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

• Wartość maksymalna

  Dostępny tylko wtedy, gdy typ zmiennej to BOOL, , DWORDfloatlongUINTintBYTEshortdouble, COLECurrencylub .CTime Wskazuje najwyższą wartość akceptowalną dla zakresu skalowania lub daty.

• 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

Kreator dodawania zmiennej składowej umożliwia dodanie zmiennej składowej 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 obsługiwane w MFC i edytorze okien dialogowych. Wyświetla także 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	Brak; tylko kontrolka	Nie dotyczy
Przycisk	PRZYCISK	Cbutton	Brak; tylko kontrolka	Nie dotyczy
Pole wyboru	SPRAWDZIĆ	Cbutton	BOOL	Minimalna wartość/Wartość maksymalna
Pole kombi	COMBOBOX	Ccombobox	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 klawisza dostępu	msctls_hotkey32	Chotkeyctrl	Brak; tylko kontrolka	Nie dotyczy
Pole listy	LISTBOX	Clistbox	CString	Maksymalna liczba znaków
Kontrolka listy	Widok SysListView32	Clistctrl	Brak; tylko kontrolka	Nie dotyczy
Kontrolka Kalendarz miesiąca	SysMonthCal32	Cmonthcalctrl	CTime	Minimalna wartość/wartość maksymalna
Kontrolka postępu	msctls_progress32	CProgressCtrl	Brak; 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)	SCROLLBAR	Cscrollbar	int	Minimalna wartość/wartość maksymalna
suwak	msctls_trackbar32	Csliderctrl	int	Minimalna wartość/wartość maksymalna
Sterowanie zakręcanie	msctls_updown32	CSpinButtonCtrl	Brak; tylko kontrolka	Nie dotyczy
Kontrolka karty	SysTabControl32	Ctabctrl	Brak; tylko kontrolka	Nie dotyczy
Kontrolka drzewa	SysTreeView32	Ctreectrl	Brak; tylko kontrolka	Nie dotyczy