Элемент управления CheckBox (для пользователей Visual Basic 6.0)

Статья
11/05/2008

Обновлен: Ноябрь 2007

В этом разделе сравнивается элемент управления CheckBox , использовавшийся в Visual Basic 6.0, с его эквивалентом в Visual Basic 2008.

Элемент управления CheckBox в Visual Basic 6.0 заменяется элементом управления CheckBox Windows Forms в Visual Basic 2008. Имена некоторых свойств, методов, событий и констант различаются, а в некоторых случаях имеются различия и в их поведении.

Концептуальные различия

Событие Click

В Visual Basic 6.0 событие Click возникает при программном изменении состояния элемента управления CheckBox. В Visual Studio 2005 можно использовать событие CheckStateChanged, а событие Click использовать нельзя.

Дополнительные различия

Дополнительно имеется большое число концептуальных различий, которые применяются ко всем элементам управления, включая различия в привязке данных, обработке шрифтов, функции перетаскивания, поддержке справки и т. д. Дополнительные сведения см. в разделах Общие сведения о Windows Forms и Дополнения к Windows Forms для .NET Framework 2.0.

Изменения кода для элемента управления CheckBox

Следующие примеры иллюстрируют различия в методах кодирования между Visual Basic 6.0 и Visual Basic 2008.

Изменения кода для реагирования на события Clicks элемента управления CheckBox

В следующем примере кода показано изменение текста элемента управления CheckBox при установке и снятии флажка этого элемента управления. Используемое в Visual Basic 6.0 свойство Value заменено свойством Visual Basic 2008Checked, а свойство Caption заменено свойством Text. Обратите внимание, что в примере Visual Basic 2008 используется событие CheckStateChanged для дублирования поведения события Visual Basic 6.0 Click.

' Visual Basic 6.0
Private Sub Check1_Click()
    If Check1.Value = 1 Then
        Check1.Caption = "Checked"
    Else
        Check1.Caption = "Unchecked"
    End If
End Sub

' Visual Basic
Private Sub CheckBox1_CheckStateChanged(ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles CheckBox1.CheckStateChanged
    If CheckBox1.Checked = True Then
        CheckBox1.Text = "Checked"
    Else
        CheckBox1.Text = "Unchecked"
    End If
End Sub

Изменения в коде для определения состояния элемента управления CheckBox

В следующем примере показано выполнение проверки состояния элемента управления CheckBox во время выполнения.

' Visual Basic 6.0
Select Case Check1.Value
    Case vbUnchecked
        Check1.Caption = "Unchecked"
    Case vbChecked
        Check1.Caption = "Checked"
    Case vbGrayed
        Check1.Caption = "Disabled"
End Select

' Visual Basic
Select Case CheckBox1.CheckState
    Case CheckState.Unchecked
        CheckBox1.Text = "Unchecked"
    Case CheckState.Checked
        CheckBox1.Text = "Checked"
    Case CheckState.Indeterminate
        CheckBox1.Text = "Disabled"
End Select

Эквиваленты свойств, методов и событий элемента управления CheckBox

В следующей таблице приведен список свойств, методов и событий Visual Basic 6.0 с их эквивалентами в Visual Basic 2008. Свойства, методы и события, имена и поведение которых остались без изменения, не указываются. Константы, если используются, расположены под свойством или методом с отступом. Если не указано иное, все перечисления Visual Basic 2008 сопоставлены пространству имен System.Windows.Forms.

Где это необходимо, даны ссылки на разделы, описывающие различия в поведении. Если нет прямого эквивалента в Visual Basic 2008, приводятся ссылки на разделы, содержащие альтернативные решения.

Свойства

Свойство в Visual Basic 6.0	Эквивалент в Visual Basic 2008
Alignment 0 (по левому краю) 1 (по правому краю)	CheckAlign Значение перечисления MiddleLeft Значение перечисления MiddleRight
Appearance 0 (плоский) 1 (3-мерный)	Перечисление FlatStyle Значение перечисления Flat Значение перечисления Standard
BackColor	BackColor Примечание. Список констант цвета см. в разделе Обработка цветов для пользователей Visual Basic 6.0. Примечание. Обработка цветов в Visual Basic 2008 выполняется иначе. Дополнительные сведения см. в разделе Действие цветов (для пользователей Visual Basic 6.0).
Caption	Text
Container	Parent
DataChanged DataField DataFormat DataMember DataSource	Новая реализация. Дополнительные сведения см. в разделе Доступ к данным для пользователей Visual Basic 6.0.
DisabledPicture DownPicture	Новая реализация. Дополнительные сведения см. в разделе Практическое руководство. Эмуляция элемента управления Visual Basic 6.0 с тремя состояниями в обновляемом приложении.
DragIcon DragMode	Новая реализация. Дополнительные сведения см. в разделе Действие перетаскивания для пользователей Visual Basic 6.0.
Font FontBold FontItalic FontName FontSize FontStrikethrough FontUnderline	Font Примечание. Обработка шрифтов в Visual Basic 2008 выполняется иначе. Дополнительные сведения см. в разделе Обработка шрифтов для пользователей Visual Basic 6.0.
ForeColor	ForeColor Примечание. Список констант цвета см. в разделе Обработка цветов для пользователей Visual Basic 6.0. Примечание. Обработка цветов в Visual Basic 2008 выполняется иначе. Дополнительные сведения см. в разделе Действие цветов (для пользователей Visual Basic 6.0).
Height	Height, Size Примечание. Обработка координат в Visual Basic 2008 выполняется иначе. Дополнительные сведения см. в разделе Система координат (для пользователей Visual Basic 6.0).
HelpContextID	Новая реализация. Дополнительные сведения см. в разделе Поддержка справки (для пользователей Visual Basic 6.0).
HWnd	Handle
Index	Новая реализация. Дополнительные сведения см. в разделе Массивы элементов управления для пользователей Visual Basic 6.0.
Left	Left Примечание. Обработка координат в Visual Basic 2008 выполняется иначе. Дополнительные сведения см. в разделе Система координат (для пользователей Visual Basic 6.0).
MaskColor	Новая реализация. Дополнительные сведения см. в разделе Свойство MaskColor (для пользователей Visual Basic 6.0).
MouseIcon	Новая реализация. Дополнительные сведения см. в разделе Невозможно задать настраиваемый указатель мыши MousePointer.
MousePointer	Cursor Список констант см. в разделе Свойство MousePointer (для пользователей Visual Basic 6.0).
OLEDropMode	Новая реализация. Дополнительные сведения см. в разделе Действие перетаскивания для пользователей Visual Basic 6.0.
Parent	Метод FindForm
Picture	Image
RightToLeft True	RightToLeft Значение перечисления Yes Значение перечисления No
Style 0 (стандартный) 1 (графический)	Appearance Значение перечисления Normal Значение перечисления Button Примечание. Существуют различия в работе со стилем Graphical в Visual Basic 2008. Дополнительные сведения см. в разделе Практическое руководство. Эмуляция элемента управления Visual Basic 6.0 с тремя состояниями в обновляемом приложении.
Tag	Tag
ToolTipText	Компонент ToolTip Дополнительные сведения см. в разделе Поддержка подсказок (для пользователей Visual Basic 6.0).
Top	Top Примечание. Обработка координат отличается в Visual Basic 2008. Дополнительные сведения см. в разделе Система координат (для пользователей Visual Basic 6.0).
UseMaskColor	Новая реализация. Дополнительные сведения см. в разделе Свойство MaskColor (для пользователей Visual Basic 6.0).
Value 0 (vbUnchecked) 1 (vbChecked) 2 (vbGrayed)	CheckState Значение перечисления Unchecked Значение перечисления Checked Значение перечисления Indeterminate
WhatsThisHelpID	Новая реализация. Дополнительные сведения см. в разделе Поддержка справки (для пользователей Visual Basic 6.0).
Width	Width, Size Примечание. Обработка координат в Visual Basic 2008 выполняется иначе. Дополнительные сведения см. в разделе Система координат (для пользователей Visual Basic 6.0).

Методы

Метод в Visual Basic 6.0	Эквивалент в Visual Basic 2008
Drag	Новая реализация. Дополнительные сведения см. в разделе Действие перетаскивания для пользователей Visual Basic 6.0.
Move	SetBounds Примечание. Обработка координат в Visual Basic 2008 выполняется иначе. Дополнительные сведения см. в разделе Система координат (для пользователей Visual Basic 6.0).
OLEDrag	Новая реализация. Дополнительные сведения см. в разделе Действие перетаскивания для пользователей Visual Basic 6.0.
SetFocus	Focus
ShowWhatsThis	Новая реализация. Дополнительные сведения см. в разделе Поддержка справки (для пользователей Visual Basic 6.0).
ZOrder 0 (vbBringToFront) 1 (vbSendToBack)	BringToFront, SendToBack

События

Событие в Visual Basic 6.0	Эквивалент в Visual Basic 2008
Click	CheckStateChanged Примечание. В Visual Basic 6.0 событие Click возникает при программном изменении состояния элемента управления CheckBox. В Visual Basic 2008 событие Click не происходит; поэтому следует использовать событие CheckStateChanged.
DragDrop DragOver	Новая реализация. Дополнительные сведения см. в разделе Действие перетаскивания для пользователей Visual Basic 6.0.
GotFocus	Enter
LostFocus	Leave
OLECompleteDrag OLEDragDrop OLEDragOver OLEGiveFeedback OLESetData OLEStartDrag	Новая реализация. Дополнительные сведения см. в разделе Действие перетаскивания для пользователей Visual Basic 6.0.
Validate	Validating

Замечания по обновлению

При обновлении приложения Visual Basic 6.0 с помощью Мастера обновления элементы управления CheckBox обновляются до элементов управления Windows Forms CheckBox, а код обновляется для использования эквивалентных свойств, методов и событий. При отсутствии эквивалентов или при наличии потенциальных отличий в поведении в код вставляются комментарии со ссылками на соответствующие разделы справки.

См. также