ChangeCaptionSettings

Синтаксис

bool ChangeCaptionSettings(ChartCaptionId mon, ChangeCaptionSettingsArgs arg)

Параметры

mon. Моникёр заголовка диаграммы.

arg. Настройки заголовка, которые необходимо задать.

Описание

Операция ChangeCaptionSettings изменяет положение и текст заголовка диаграммы в регламентном отчёте.

Комментарии

Операция позволяет изменить основной заголовок или заголовки осей у диаграммы. Для выполнения операции укажите в поле mon моникёр заголовка в одном из следующих форматов:

В поле arg укажите новое расположение или текст заголовка.

Результатом выполнения операции будет логическое значение true, если изменение расположения/текста заголовка завершилось успешно.

Пример

Ниже приведён пример изменения расположения основного заголовка у диаграммы в регламентном отчёте. В запросе передаётся моникёр заголовка и относительные координаты и размеры заголовка. В ответе возвращается признак успешного изменения расположения.

SOAP-запрос:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<ChangeCaptionSettings xmlns="http://www.fsight.ru/PP.SOM.Som">
<mon xmlns="">
  <id>FFNAKJOANICIGOAEKMPEFIIGMCAGPNOEKKDDNNJJIPOMJKBK!M!S!PJPBDGOOANICIGOAEIDNFIKEJLMICGKJEFLDIBGCCPKLCPBPM!Sheets!1!Objects!PrxChart1!Caption</id>
  </mon>
<arg xmlns="">
<r>
  <left>0.25</left>
  <top>0.25</top>
  <width>0.7</width>
  <height>0.05</height>
  </r>
  </arg>
  </ChangeCaptionSettings>
  </s:Body>
  </s:Envelope>

SOAP-ответ:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
  <ChangeCaptionSettingsResult xmlns="http://www.fsight.ru/PP.SOM.Som" xmlns:q1="http://www.fsight.ru/PP.SOM.Som" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">1</ChangeCaptionSettingsResult>
  </soapenv:Body>
  </soapenv:Envelope>

JSON-запрос:

{
 "ChangeCaptionSettings" : 
  {
   "mon" : 
    {
     "id" : "FFNAKJOANICIGOAEKMPEFIIGMCAGPNOEKKDDNNJJIPOMJKBK!M!S!PJPBDGOOANICIGOAEIDNFIKEJLMICGKJEFLDIBGCCPKLCPBPM!Sheets!1!Objects!PrxChart1!Caption"
    },
   "arg" : 
    {
     "r" : 
      {
       "left" : "0.25",
       "top" : "0.25",
       "width" : "0.7",
       "height" : "0.05"
      }
    }
  }
}

JSON-ответ:

{
 "ChangeCaptionSettingsResult" : "1"
}
public static bool ChangeCaptionSettings(string moniker, uint sheetKey, string chartId)
{
    var somClient = new SomPortTypeClient(); // Прокси-объект для выполнения операций
    // Параметры выполнения операции
    var tChange = new ChangeCaptionSettings()
    {
        arg = new ChangeCaptionSettingsArgs()
        {
            r = new RectF()
            {
                left = 0.25,
                top = 0.25,
                height = 0.05,
                width = 0.7
            }
        },
        mon = new ChartCaptionId() { id = moniker + "!Sheets!" + sheetKey + "!Objects!" + chartId + "!Caption" }
    };
    // Изменение расположения заголовка диаграммы
    var result = somClient.ChangeCaptionSettings(tChange);
    return result;
}

См. также:

Работа с регламентными отчётами