Поделиться через


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

Обновлен: Ноябрь 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

kk8bb7ac.alert_note(ru-ru,VS.90).gifПримечание.
Список констант цвета см. в разделе Обработка цветов для пользователей Visual Basic 6.0.
kk8bb7ac.alert_note(ru-ru,VS.90).gifПримечание.
Обработка цветов в 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

kk8bb7ac.alert_note(ru-ru,VS.90).gifПримечание.
Обработка шрифтов в Visual Basic 2008 выполняется иначе. Дополнительные сведения см. в разделе Обработка шрифтов для пользователей Visual Basic 6.0.

ForeColor

ForeColor

kk8bb7ac.alert_note(ru-ru,VS.90).gifПримечание.
Список констант цвета см. в разделе Обработка цветов для пользователей Visual Basic 6.0.
kk8bb7ac.alert_note(ru-ru,VS.90).gifПримечание.
Обработка цветов в Visual Basic 2008 выполняется иначе. Дополнительные сведения см. в разделе Действие цветов (для пользователей Visual Basic 6.0).

Height

Height, Size

kk8bb7ac.alert_note(ru-ru,VS.90).gifПримечание.
Обработка координат в Visual Basic 2008 выполняется иначе. Дополнительные сведения см. в разделе Система координат (для пользователей Visual Basic 6.0).

HelpContextID

Новая реализация. Дополнительные сведения см. в разделе Поддержка справки (для пользователей Visual Basic 6.0).

HWnd

Handle

Index

Новая реализация. Дополнительные сведения см. в разделе Массивы элементов управления для пользователей Visual Basic 6.0.

Left

Left

kk8bb7ac.alert_note(ru-ru,VS.90).gifПримечание.
Обработка координат в 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

kk8bb7ac.alert_note(ru-ru,VS.90).gifПримечание.
Существуют различия в работе со стилем Graphical в Visual Basic 2008. Дополнительные сведения см. в разделе Практическое руководство. Эмуляция элемента управления Visual Basic 6.0 с тремя состояниями в обновляемом приложении.

Tag

Tag

ToolTipText

Компонент ToolTip

Дополнительные сведения см. в разделе Поддержка подсказок (для пользователей Visual Basic 6.0).

Top

Top

kk8bb7ac.alert_note(ru-ru,VS.90).gifПримечание.
Обработка координат отличается в 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

kk8bb7ac.alert_note(ru-ru,VS.90).gifПримечание.
Обработка координат в Visual Basic 2008 выполняется иначе. Дополнительные сведения см. в разделе Система координат (для пользователей Visual Basic 6.0).

Методы

Метод в Visual Basic 6.0

Эквивалент в Visual Basic 2008

Drag

Новая реализация. Дополнительные сведения см. в разделе Действие перетаскивания для пользователей Visual Basic 6.0.

Move

SetBounds

kk8bb7ac.alert_note(ru-ru,VS.90).gifПримечание.
Обработка координат в 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

kk8bb7ac.alert_note(ru-ru,VS.90).gifПримечание.
В 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, а код обновляется для использования эквивалентных свойств, методов и событий. При отсутствии эквивалентов или при наличии потенциальных отличий в поведении в код вставляются комментарии со ссылками на соответствующие разделы справки.

См. также

Основные понятия

Доступ к данным для пользователей Visual Basic 6.0

Свойство Style для пользователей Visual Basic 6.0

Обработка шрифтов для пользователей Visual Basic 6.0

Система координат (для пользователей Visual Basic 6.0)

Массивы элементов управления для пользователей Visual Basic 6.0

Поддержка справки (для пользователей Visual Basic 6.0)

Свойство MousePointer (для пользователей Visual Basic 6.0)

Поддержка подсказок (для пользователей Visual Basic 6.0)

Ссылки

Общие сведения об элементе управления CheckBox (Windows Forms)

Другие ресурсы

Обновление приложений, созданных в предыдущих версиях Visual Basic