Transable.Sdk.Wpf 0.1.0-preview.2

Transable.Sdk.Wpf

One line of code makes your WPF app multilingual — automatic UI translation backed by the Transable API.

⚠️ Preview. This is an early preview (0.1.0-preview.x). The public API may change between preview releases without notice. Not recommended for production yet — we'd love your feedback at https://transable.to/support.

Quick start

// App.xaml.cs — that's the whole integration:
protected override void OnStartup(StartupEventArgs e)
{
    TransableWpf.Init("tk_live_YOUR_KEY");
    base.OnStartup(e);
}

Get an API key: create an App project at https://transable.to/dashboard — the setup wizard shows a live "connected" check for your first run.

On startup the SDK detects the user's OS language, scans the logical tree of every open window and translates static UI text: TextBlock.Text, Content / Header values that are strings (buttons, menu items, group boxes, tab headers), Window.Title, ToolTip strings. _File-style access keys are preserved. Translations are cached on disk, so the second launch is instant and works offline.

Control markup

xmlns:tr="https://transable.to/sdk/wpf"

<TextBlock Text="BuildID: 2026.07.1" tr:Transable.Ignore="True" />  
<TextBlock Text="OK"                 tr:Transable.Force="True" />   
<tr:TransableLanguageSelector />                                    

Programmatic: Transable.Sdk.Transable.SetLanguage("de"), CurrentLanguage, LanguageChanged.

What is NOT translated (by design)

• User input: TextBox.Text is never read or sent anywhere — not even with Transable.Force (WPF has no built-in watermark, so input controls have nothing to translate).
• Data-bound properties: values driven by your ViewModels are skipped, so bound user data (names, e-mails, documents) never leaves the machine. Magic mode translates the static "chrome" of an MVVM app; translate dynamic content explicitly via Transable.Sdk.Transable.T("key", "Fallback text").
• Style/template/trigger values: only plain local values (XAML literals or direct SetValue calls) are ever rewritten.
• ItemsSource-generated items: rows of lists, grids and combo boxes are data, not chrome.
• Safe mode additionally filters e-mails, URLs, paths, GUIDs, versions, log-like lines and code identifiers before the network layer.

Failure philosophy

Wrong key, no network, quota exceeded — the app keeps working in its source language, with one warning through TransableOptions.Logger. The SDK never throws from public entry points, never blocks the UI thread, and is inert in the XAML designer.