/**
* Static Helper Method to Create using PK arguments
* You must pass in the PK arguments on an object to load, or leave it blank to create a new one.
* If you want to load via QueryString or PathInfo, use the CreateFromQueryString or CreateFromPathInfo
* static helper methods. Finally, specify a CreateType to define whether or not we are only allowed to
* edit, or if we are also allowed to create a new one, etc.
*
* @param mixed $objParentObject QForm or QPanel which will be using this SentLogMetaControl
* @param integer $intWordSentLogId primary key value
* @param QMetaControlCreateType $intCreateType rules governing SentLog object creation - defaults to CreateOrEdit
* @return SentLogMetaControl
*/
public static function Create($objParentObject, $intWordSentLogId = null, $intCreateType = QMetaControlCreateType::CreateOrEdit)
{
// Attempt to Load from PK Arguments
if (strlen($intWordSentLogId)) {
$objSentLog = SentLog::Load($intWordSentLogId);
// SentLog was found -- return it!
if ($objSentLog) {
return new SentLogMetaControl($objParentObject, $objSentLog);
} else {
if ($intCreateType != QMetaControlCreateType::CreateOnRecordNotFound) {
throw new QCallerException('Could not find a SentLog object with PK arguments: ' . $intWordSentLogId);
}
}
// If EditOnly is specified, throw an exception
} else {
if ($intCreateType == QMetaControlCreateType::EditOnly) {
throw new QCallerException('No PK arguments specified');
}
}
// If we are here, then we need to create a new record
return new SentLogMetaControl($objParentObject, new SentLog());
}
/**
* Reload this SentLog from the database.
* @return void
*/
public function Reload()
{
// Make sure we are actually Restored from the database
if (!$this->__blnRestored) {
throw new QCallerException('Cannot call Reload() on a new, unsaved SentLog object.');
}
// Reload the Object
$objReloaded = SentLog::Load($this->intWordSentLogId);
// Update $this's local variables to match
$this->strIpAddress = $objReloaded->strIpAddress;
$this->strUserAgent = $objReloaded->strUserAgent;
$this->dttDateSent = $objReloaded->dttDateSent;
$this->WordId = $objReloaded->WordId;
}
