SftDirectoryFolder.SetSubFolderCheckBoxes Method
Updates the subfolders' checkboxes.
Syntax
object
A SftDirectoryFolder object.
Value
Defines the new checkbox status.
| Value | Value | Description |
|---|
| checkboxSftDirectoryNone | 0 | None - The checkbox is removed. |
| checkboxSftDirectoryNo | 1 | Not selected - The checkbox option is enabled and not selected. |
| checkboxSftDirectoryYes | 2 | Selected - The checkbox option is enabled and selected. |
| checkboxSftDirectoryUnknown | 3 | Unknown - The checkbox option is enabled and unknown. |
| checkboxSftDirectoryNoDisabled | 4 | Not selected, disabled - The checkbox option is disabled and not selected. |
| checkboxSftDirectoryYesDisabled | 5 | Selected, disabled - The checkbox option is disabled and selected. |
| checkboxSftDirectoryUnknownDisabled | 6 | Unknown, disabled - The checkbox option is disabled and unknown. |
Depth
Defines the depth of subfolders to be updated.
| Depth | Description |
|---|
| True | All subfolders (and their subfolders) are updated recursively with the new checkbox status Value. |
| False | Only immediate folders owned by the current folder are updated with the new checkbox status Value. |
Comments
The SetSubFolderCheckBoxes method updates the subfolders' checkboxes.
The EvaluateSubFolderCheckBoxes method can be used to update a folder's checkbox based on all subfolders' checkboxes.
Examples
VB.NET
AxSftDirectoryDL_Combo.Headers.Style = style
End Sub
Private Sub AxSftDirectoryTV_CheckBoxClicked(ByVal sender As Object, ByVal e As AxSftDirectoryLib30._ISftDirectoryEvents_CheckBoxClickedEvent) Handles AxSftDirectoryTV.CheckBoxClicked
If e.newValue <> SftDirectoryCheckBoxValueConstants.checkboxSftDirectoryNo And _
e.newValue <> SftDirectoryCheckBoxValueConstants.checkboxSftDirectoryYes Then
e.newValue = SftDirectoryCheckBoxValueConstants.checkboxSftDirectoryYes
End If
AxSftDirectoryTV.CurrentFolder.SetSubFolderCheckBoxes(e.newValue, True)
AxSftDirectoryTV.CurrentFolder.CheckBox = e.newValue
AxSftDirectoryTV.RootFolder.EvaluateSubFolderCheckBoxes(True)
End Sub
Private Sub AxSftDirectoryTV_Combo_CheckBoxClicked(ByVal sender As Object, ByVal e As AxSftDirectoryLib30._ISftDirectoryEvents_CheckBoxClickedEvent) Handles AxSftDirectoryTV_Combo.CheckBoxClicked
If e.newValue <> SftDirectoryCheckBoxValueConstants.checkboxSftDirectoryNo And _
e.newValue <> SftDirectoryCheckBoxValueConstants.checkboxSftDirectoryYes Then View Entire Sample Code
VB6
SftDirectoryTV_Combo.Headers.Style = Style
SftDirectoryDL_Combo.Headers.Style = Style
End Sub
Private Sub SftDirectoryTV_CheckBoxClicked(ByVal Folder As SftDirectoryLib30.ISftDirectoryFolder, ByVal OldValue As SftDirectoryLib30.SftDirectoryCheckBoxValueConstants, NewValue As SftDirectoryLib30.SftDirectoryCheckBoxValueConstants)
If NewValue <> checkboxSftDirectoryNo And NewValue <> checkboxSftDirectoryYes Then
NewValue = checkboxSftDirectoryYes
End If
SftDirectoryTV.CurrentFolder.SetSubFolderCheckBoxes NewValue, True
SftDirectoryTV.CurrentFolder.CheckBox = NewValue
SftDirectoryTV.RootFolder.EvaluateSubFolderCheckBoxes True
End Sub
Private Sub SftDirectoryTV_Combo_CheckBoxClicked(ByVal Folder As SftDirectoryLib30.ISftDirectoryFolder, ByVal OldValue As SftDirectoryLib30.SftDirectoryCheckBoxValueConstants, NewValue As SftDirectoryLib30.SftDirectoryCheckBoxValueConstants)
If NewValue <> checkboxSftDirectoryNo And NewValue <> checkboxSftDirectoryYes Then
NewValue = checkboxSftDirectoryYes View Entire Sample Code
C#
axSftDirectoryDL_Combo.Headers.Style = style;
}
private void axSftDirectoryTV_CheckBoxClicked(object sender, AxSftDirectoryLib30._ISftDirectoryEvents_CheckBoxClickedEvent e) {
if (e.newValue != SftDirectoryCheckBoxValueConstants.checkboxSftDirectoryNo &&
e.newValue != SftDirectoryCheckBoxValueConstants.checkboxSftDirectoryYes) {
e.newValue = SftDirectoryCheckBoxValueConstants.checkboxSftDirectoryYes;
}
axSftDirectoryTV.CurrentFolder.SetSubFolderCheckBoxes(e.newValue, true);
axSftDirectoryTV.CurrentFolder.CheckBox = e.newValue;
axSftDirectoryTV.RootFolder.EvaluateSubFolderCheckBoxes(true);
}
private void axSftDirectoryTV_Combo_CheckBoxClicked(object sender, AxSftDirectoryLib30._ISftDirectoryEvents_CheckBoxClickedEvent e) {
if (e.newValue != SftDirectoryCheckBoxValueConstants.checkboxSftDirectoryNo &&
e.newValue != SftDirectoryCheckBoxValueConstants.checkboxSftDirectoryYes) { View Entire Sample Code
C++
vDirDL_Combo->Headers->Style = style;
}
void CControlStylesDlg::OnCheckBoxClickedSftDirectoryTV(LPDISPATCH Folder, long OldValue, long FAR* NewValue)
{
if (*NewValue != checkboxSftDirectoryNo && *NewValue != checkboxSftDirectoryYes)
*NewValue = checkboxSftDirectoryYes;
ISftDirectoryPtr vDirTV = m_SftDirectoryTV.GetControlUnknown();
vDirTV->CurrentFolder->SetSubFolderCheckBoxes((SftDirectoryCheckBoxValueConstants) *NewValue, VARIANT_TRUE);
vDirTV->CurrentFolder->CheckBox = (SftDirectoryCheckBoxValueConstants) *NewValue;
vDirTV->RootFolder->EvaluateSubFolderCheckBoxes(VARIANT_TRUE);
}
void CControlStylesDlg::OnCheckBoxClickedSftDirectoryTVCombo(LPDISPATCH Folder, long OldValue, long FAR* NewValue)
{
if (*NewValue != checkboxSftDirectoryNo && *NewValue != checkboxSftDirectoryYes) View Entire Sample Code
See Also SftDirectoryFolder Object | Object Hierarchy
On
Off