createDiaryRecord

From Bohemia Interactive Community
Revision as of 10:01, 11 June 2021 by Lou Montana (talk | contribs) (Text replacement - "</dd> <dt><dt>" to "</dd> <dt><dt>")
Jump to navigation Jump to search
Hover & click on the images for description

Description

Description:

Creates a diary entry. Supported tags and their parameters:

Tag Options Example
img
  • image: String - path to image. When present, any element with it will be displayed as image.
  • width: Number - image width in pixels.
  • height: Number - image height in pixels.
<img image="picture.paa" width="128" height="64" />
font
<font color="#FF00FF" size="16" face="LucidaConsoleB">Hello there</font>
br N/A
Line 1<br/>Line 2
marker
<marker name="respawn_west">Respawn point</marker>
execute
  • expression: String - executed code
<execute expression="player setDamage 1">Die!</execute>
executeClose
  • expression: String - executed code, diary is closed afterwards
<executeClose expression="player setDamage 1">Die and close</executeClose>
log
<log subject="Hello">Get to the Hello subject</log>
<log record="ABCD">Get to the ABC record</log>
gear
<gear unit="123456">Open unit 123456's gear</gear>
teamSwitch
<teamSwitch unit="123456">Switch to unit 123456</teamSwitch>
kick
<kick unit="123456">Kick player unit 123456</kick>
ban
<ban unit="123456">ban player unit 123456</ban>
mute
<mute unit="123456">mute player unit 123456</mute>
currentTask
<currentTask id="my_task">get to my_task task</currentTask>
↑ Back to spoiler's top

If the createDiaryRecord command fails, it returns a null record. Before Arma 3 v2.00, isNull did not work with the diary record type and diaryRecordNull did not exist. In order to verify a null record, it is possible to create a variable and compare against it:
private _recordNull = objNull createDiaryRecord []; private _createdRecord = player createDiaryRecord ["Diary", ["Title", "Description"]];
if (_createdRecord isEqualTo _recordNull) then { hint "Failed"; };
Groups:
Briefing

Syntax

Syntax:
player createDiaryRecord [subject, text, task, taskState, showTitle]
Parameters:
player: Object
subject: String
text: String
task: (Optional, default taskNull) - Task
taskState: String (Optional, default ?) - Changes the state of the given task. Can be "NONE", "CREATED", "ASSIGNED", "SUCCEEDED", "FAILED", "CANCELED"
showTitle: Boolean (Optional, default true) - Whether or not to show title in the description section as well Template:Since
Return Value:
Diary Record

Alternative Syntax

Syntax:
player createDiaryRecord [subject, [title, text], task, taskState, showTitle]
Parameters:
player : Object
subject: String
title: String
text: String
task: (Optional, default taskNull) - Task
taskState: String (Optional, default ?) - Changes the state of the given task. Can be "NONE", "CREATED", "ASSIGNED", "SUCCEEDED", "FAILED", "CANCELED"
showTitle: Boolean (Optional, default true) - Whether or not to show title in the description section as well Template:Since
Return Value:
Diary Record

Examples

Example 1:
player createDiaryRecord ["Diary", ["Intel", "Enemy base is on grid <marker name='enemyBase'>161170</marker>"]]
Example 2:
player createDiaryRecord ["Diary", "Information gathered.<br /><img image='wellDone_ca.paa' />"]
Example 3:
player createDiaryRecord ["Diary", ["No Title", "description"], taskNull, "", false];
Example 4:
player createDiaryRecord ["Diary", ["Font tag","<font color='#7FFF00' size='30' face='TahomaB'>This will changed text size, colour and font</font>"], taskNull, "",false];
Example 5:
player createDiaryRecord ["Diary", ["Image", "<img image='\A3\Ui_F_Curator\Data\Logos\arma3_curator_artwork.jpg' width='500' height='800'/>"], taskNull, "", false];
Example 6:
player createDiaryRecord ["Diary", ["Linebreak","Line1<br></br>Line2<br></br><br></br>Line4"], taskNull, "", false];
Example 7:
player createDiaryRecord ["Diary", ["Execute","<execute expression='hint ""Some code"";'>Some text</execute>"], taskNull, "", false];
Example 8:
player createDiaryRecord ["Diary", ["ExecuteClose", "<executeClose expression=""hint 'Diary closed';"">Close Diary</executeClose>"], taskNull, "", false];

Additional Information

See also:
processDiaryLink createDiaryLink createDiarySubject diarySubjectExists setDiaryRecordText removeDiaryRecord

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note
Posted on March 24, 2017 - 20:11 (UTC)
Tankbuster
When adding multiple diary records, be aware that they appear in reverse order. ie the first one you add will appear last and the last one you add will be first.
Posted on June 22, 2019 - 16:28 (UTC)
R3vo
It seems that the task parameter has no effect in Arma 3 because the task entry in the briefing menu is created when the task itself was created.