MQL5 ReferansıÇizelge İşlemleriChartSetString

ChartSetString

Belirlenen çizelgenin karşılık gelen özelliği için değer ayarlar. Çizelge özelliği sring tipinde olmalıdır. Komut, çizelge mesajları kuyruğuna eklendi ve önceki komutların işlenmesinin hemen ardından uygulanacak.

bool  ChartSetString(
   long                         chart_id,     // Çizelge tanımlayıcı
   ENUM_CHART_PROPERTY_STRING   prop_id,      // Özellik tanımlayıcı
   string                       str_value     // Değer
   );

Parametreler

chart_id

[in] Çizelge tanımlayıcısı. 0, mevcut çizelge anlamına gelir.

prop_id

[in] Çizelge özelliğinin tanımlayıcısı. Değeri, ENUM_CHART_PROPERTY_STRING değerlerinden biri olabilir (sadece-okunur olanlar hariç).

str_value

[in] Özellik değeri dizgisi. Dizgi uzunluğu 2045 karakteri geçemez (fazla karakterler budanacaktır).

Dönüş değeri

Komutun çizelge mesajları kuyruğuna eklenmesi durumunda 'true', aksi durumda 'false' dönüşü yapar. Hata hakkında bilgi almak için, GetLastError() fonksiyonunu çağırın.

Not

ChartSetString, çizelge üstündeki yorum çıktıları için, Comment fonksiyonunun yerine kullanılabilir.

İşlev eşzamansızdır; bu, işlevin, belirtilen grafik sırasına başarıyla eklenmiş olan komutun yürütülmesini beklemediği anlamına gelir. Bunun yerine, kontrolü hemen geri döndürür. Özellik yalnızca, uygun komutun grafik sırasından kaldırılmasından sonra değişecektir. Grafik sırasından komutları hemen yürütmek için ChartRedraw işlevini çağırın.

Bir kerede birkaç grafik özelliğini hemen değiştirmek isterseniz, o zaman ilgili işlevler (ChartSetString, ChartSetDouble, ChartSetString) bir kod bloğunda çalıştırılmalı, sonra aramanız gerekir ChartRedraw bir kere.

Komut yürütme sonucunu kontrol etmek için, belirtilen grafik özelliğini isteyen bir işlev kullanabilirsiniz. (ChartGetInteger, ChartGetDouble, ChartSetString). Ancak, bu işlevlerin senkron olduğunu ve yürütme sonuçlarını beklediğini unutmayın.

Örnek:

void OnTick()
  {
//---
   double Ask,Bid;
   int Spread;
   Ask=SymbolInfoDouble(Symbol(),SYMBOL_ASK);
   Bid=SymbolInfoDouble(Symbol(),SYMBOL_BID);
   Spread=SymbolInfoInteger(Symbol(),SYMBOL_SPREAD);
   string comment=StringFormat("Выводим цены:\nAsk = %G\nBid = %G\nSpread = %d",
                               Ask,Bid,Spread);
   ChartSetString(0,CHART_COMMENT,comment);
  }

Ayrıca Bakınız

Comment, ChartGetString

ChartSetInteger

ChartGetDouble