Control Properties¶

Control Properties

Inputs: 1

Outputs: 1

Kategori: trexMes service

Form üzerindeki kontrollerin görsel ve davranışsal özelliklerini çalışma zamanında ayarlar. Visible, Enabled, Text, ForeColor gibi her türlü property atamasını yapar.

Özet¶

Form Bind Controls veri bağlarken, Control Properties özellik atar. İkisi birbirini tamamlar:

"Bu textbox'a sipariş numarasını yaz" → Form Bind Controls
"Bu butonu gizle, etiketi kırmızı yap" → Control Properties

Property Tablosu¶

Alan	Tip	Varsayılan	Açıklama
`name`	string	—	Canvas üzerinde gösterilecek ad
`formname`	string	(boş)	Hedef form adı
`formainform`	boolean	`false`	Ana form (`AppForm`) mı?
`props`	array	`[]`	Özellik atama listesi

`props` Yapısı¶

Her satır 4 alan içerir:

Anahtar	Açıklama	Örnek
`p`	Kontrol adı (ControlName)	`btnSubmit`
`v`	Özellik adı (PropertyName)	`Enabled`
`d`	Değer veya path	`true`
`dt`	Değer kaynağı (dataType)	`bool`

[
  { "p": "btnSubmit", "v": "Enabled",   "d": "true",          "dt": "bool" },
  { "p": "lblTitle",  "v": "Text",      "d": "Yeni Sipariş",  "dt": "str"  },
  { "p": "txtQty",    "v": "ForeColor", "d": "Red",           "dt": "str"  },
  { "p": "btnSave",   "v": "Visible",   "d": "payload.canSave","dt": "msg" }
]

`dataType` Çeşitleri¶

dt alanı değerin nereden okunacağını belirler:

`dataType`	Anlam	Tipik Kullanım
`msg`	Mesaj nesnesinden	Dinamik değerler
`flow`	Flow context	Geçici state
`global`	Global context	Sabit ayarlar
`num`	Sabit sayı	`42`, `100`
`json`	Sabit JSON	`{"color":"red"}`
`bool`	Sabit boolean	`true`, `false`
`jsonata`	JSONata ifadesi	`$count(payload.items) > 5`
diğer	Sabit string	`"Red"`, `"Verdana"`

Çıkış Mesajı¶

{
  "operationtype": "ControlProperties",
  "receiveddata": { /* event data */ },
  "name": "OrderForm",
  "value": [
    { "ControlName": "btnSubmit", "PropertyName": "Enabled",   "Value": true   },
    { "ControlName": "lblTitle",  "PropertyName": "Text",      "Value": "Yeni" },
    { "ControlName": "txtQty",    "PropertyName": "ForeColor", "Value": "Red"  }
  ]
}

Asenkron İşlem Modeli¶

Node, tüm property atamalarını Promise.all ile paralel çözümler:

let tasks = node.props.map((item) => {
    return new Promise((resolve, reject) => {
        switch (item.dt) {
            case 'msg':    computedValue = RED.util.getMessageProperty(msg, item.d); break;
            case 'flow':   computedValue = node.context().flow.get(item.d); break;
            case 'global': computedValue = node.context().global.get(item.d); break;
            case 'jsonata':
                // Async JSONata çözümlemesi
                let expr = RED.util.prepareJSONataExpression(item.d, node);
                RED.util.evaluateJSONataExpression(expr, msg, (err, result) => {
                    err ? reject(err) : resolve({
                        ControlName: item.p,
                        PropertyName: item.v,
                        Value: result
                    });
                });
                return;
            // ...
        }
        resolve({ ControlName: item.p, PropertyName: item.v, Value: computedValue });
    });
});

Promise.all(tasks).then((bindcontrols) => { /* msg.payload.push */ });

Tipik Property İsimleri¶

WinForm kontrolleri için en sık kullanılan özellikler:

Property	Tip	Örnek Değer
`Visible`	bool	`true` / `false`
`Enabled`	bool	`true` / `false`
`Text`	string	`"Kaydet"`
`BackColor`	string	`"Red"`, `"#FF0000"`
`ForeColor`	string	`"White"`
`Font.Bold`	bool	`true`
`Width`	number	`200`
`Height`	number	`40`

Tipik Akış¶

flowchart LR
    A[Business Events] --> B[Custom Form]
    B --> C[Form Bind Controls]
    C --> D[Control Properties<br/>btnSave.Enabled=true]
    D --> E[Responser]

    style A fill:#ccffcc,color:#000
    style B fill:#ccffcc,color:#000
    style C fill:#ccffcc,color:#000
    style D fill:#ccffcc,color:#000
    style E fill:#ccffcc,color:#000

Önemli Notlar¶

Property isimleri büyük harfle başlar

WinForm property isimleri PascalCase'dir: Visible, Enabled, Text, BackColor — küçük harfle başlamazlar.

Form henüz açılmadıysa

Control Properties panele property atama gönderir; ancak form henüz açılmamışsa atama uygulanamaz. Akışta önce Custom Form olmalıdır.

Sık Karşılaşılan Hatalar¶

Property uygulanmıyor

Property adı yazımı doğru mu? (Visible ≠ visible)
Kontrol adı XML'deki ile eşleşiyor mu?
dataType seçimi tutarlı mı? bool seçtiyseniz değer "true"/"false" string olmalı.

JSONata hatası

JSONata ifadesi sentaks hatası içeriyorsa node hata fırlatır. İfadeyi önce başka bir akışta change node'unda test edin.

İpuçları¶

Toplu disable/enable

Bir formun tüm input'larını disable etmek istiyorsanız her birini tek tek listelemek yerine bir function node ile dinamik liste oluşturun ve dataType: jsonata ile döndürün.

Renkler için string formatı

Renk değerleri için WinForm Color enum isimleri (Red, LightBlue, Crimson) veya HTML hex (#FF0000) kullanılabilir.