[WPF] WPF ComboBox에서 특정 Enum 항목에만 툴팁 보여주기

WPF에서 ComboBox를 사용할 때, Enum 값을 바인딩하여 항목을 보여주는 경우는 매우 흔합니다.

이번 글에서는 네트워크 설정 화면을 예시로 들어, ComboBox의 아이템 중 특정 항목에만 툴팁을 표시하는 방법을 소개합니다.

---

시나리오

• 사용자는 LAN, WiFi, VPN 중 하나의 네트워크 연결 방식을 선택할 수 있습니다.
• 이 중 VPN은 보안 연결이 필요하므로, 툴팁을 통해 이를 사용자에게 안내해야 합니다.
• 다른 항목에는 툴팁을 표시하지 않습니다. VPN 항목에 마우스가 올라갔을 때만 툴팁을 표시해야 합니다.

---

1. Enum 정의

먼저 연결 방식에 대한 Enum을 정의합니다.

public enum ConnectionType
{
    LAN,
    WiFi,
    VPN
}

---

2. 툴팁 컨버터 구현

툴팁을 조건부로 반환하는 IValueConverter를 구현합니다.
VPN일 경우에만 문자열을 반환하고, 그 외의 경우에는 null을 반환하여 툴팁이 나타나지 않도록 합니다.

public class ConnectionTooltipConverter : MarkupExtension, IValueConverter
{
    public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
    {
        if (value is ConnectionType type)
        {
            return type == ConnectionType.VPN ? "보안 연결 필요" : null;
        }

        return null;
    }

    public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
        => throw new NotImplementedException();

    public override object ProvideValue(IServiceProvider serviceProvider)
        => this;
}

이 컨버터는 XAML에서도 바로 사용할 수 있도록 MarkupExtension을 상속받아 구현되어 있습니다.

---

3. XAML에서 ComboBox 구성

ComboBox에 Enum을 바인딩하고, 각 항목마다 툴팁을 설정할 수 있도록 ItemContainerStyle을 사용합니다.

<ComboBox Height="20" Width="100" ItemsSource="{Binding ConnectionTypes, ElementName=wTest}" SelectedIndex="0">
    <ComboBox.ItemContainerStyle>
        <Style TargetType="{x:Type ComboBoxItem}">
            <Setter Property="ToolTip" Value="{Binding Path=Content, RelativeSource={RelativeSource Self}, Converter={local:ConnectionTooltipConverter}}"/>
        </Style>
    </ComboBox.ItemContainerStyle>
</ComboBox>

여기서 ConnectionTypes는 ConnectionType Enum의 값들을 바인딩한 컬렉션입니다.
저는 예시 코드로 보여주는 것이라 DependencyProperty로 윈도우 내부에 선언하였지만,
본인 상황에 따라 ObjectDataProvider를 사용하거나 뷰모델에서 직접 제공하는 방식으로 구현하시면 됩니다.

public IEnumerable<ConnectionType> ConnectionTypes
{
    get { return (IEnumerable<ConnectionType>)GetValue(ConnectionTypeProperty); }
    set { SetValue(ConnectionTypeProperty, value); }
}
public static readonly DependencyProperty ConnectionTypeProperty =
    DependencyProperty.Register(nameof(ConnectionTypes), typeof(IEnumerable<ConnectionType>), typeof(TestDialog), new PropertyMetadata(null));

public TestDialog(WindowPosition windowPosition)
{
    windowPosition.Apply(this);

    InitializeComponent();

    ConnectionTypes = Enum.GetValues(typeof(ConnectionType)).Cast<ConnectionType>();
}

또한, DevExpress를 사용하는 경우에는 dxe:EnumItemsSource를 활용하여 Enum을 바로 바인딩할 수 있습니다.

---

4. 정리

• ItemContainerStyle을 사용하면 ComboBox의 항목마다 개별적인 스타일을 지정할 수 있습니다.
• ValueConverter를 통해 특정 항목에만 조건부로 툴팁을 표시할 수 있습니다.
• 이 방식을 확장해서 Tooltip 뿐만 아니라 다양한 스타일을 적용할 수 있습니다.