parameters: (self, param, params)
return_statement: return entry
docstring: Make a validity entry for a handle's parent object.
  
          Creates 'parent' VUID.
docstring_summary: Make a validity entry for a handle's parent object.
docstring_tokens: Make a validity entry for a handle s parent object .
function: def makeHandleValidityParent(self, param, params):
          """Make a validity entry for a handle's parent object.
  
          Creates 'parent' VUID.
          """
          param_name = getElemName(param)
          paramtype = getElemType(param)
  
          # Deal with handle parents
          handleparent = self.getHandleParent(paramtype)
          if handleparent is None:
              return None
  
          otherparam = findTypedElem(params, handleparent)
          if otherparam is None:
              return None
  
          parent_name = getElemName(otherparam)
          entry = ValidityEntry(anchor=(param_name, 'parent'))
  
          is_optional = self.isHandleOptional(param, params)
  
          if self.paramIsArray(param):
              template = 'Each element of {}'
              if is_optional:
                  template += ' that is a valid handle'
          elif is_optional:
              template = 'If {} is a valid handle, it'
          else:
              # not optional, not an array. Just say the parameter name.
              template = '{}'
  
          entry += template.format(self.makeParameterName(param_name))
  
          entry += ' must: have been created, allocated, or retrieved from {}'.format(
              self.makeParameterName(parent_name))
  
          return entry
function_tokens: def makeHandleValidityParent ( self , param , params ) : param_name = getElemName ( param ) paramtype = getElemType ( param ) # Deal with handle parents handleparent = self . getHandleParent ( paramtype ) if handleparent is None : return None otherparam = findTypedElem ( params , handleparent ) if otherparam is None : return None parent_name = getElemName ( otherparam ) entry = ValidityEntry ( anchor = ( param_name , 'parent' ) ) is_optional = self . isHandleOptional ( param , params ) if self . paramIsArray ( param ) : template = 'Each element of {}' if is_optional : template += ' that is a valid handle' elif is_optional : template = 'If {} is a valid handle, it' else : # not optional, not an array. Just say the parameter name. template = '{}' entry += template . format ( self . makeParameterName ( param_name ) ) entry += ' must: have been created, allocated, or retrieved from {}' . format ( self . makeParameterName ( parent_name ) ) return entry