HasKeyword - Form

Member of: Form Script

Checks to see if the specified keyword is attached to this form.

SyntaxEdit

bool Function HasKeyword(Keyword akKeyword) native

ParametersEdit

  • akKeyword: The Keyword to query for.

Return ValueEdit

Whether this form has the specified keyword or not. If the form doesn't support keywords, it will always return false.

ExamplesEdit

ScriptName ExampleScript Extends ObjectReference

Keyword Property DoomKeywordProperty Auto

Event OnItemAdded(Form akBaseItem, Int aiItemCount, ObjectReference akFormReference, ObjectReference akSourceContainer)
	If akBaseItem.HasKeyword(DoomKeywordProperty) ; Does the added object have a doom keyword?
		Debug.Trace("The added sword is a doom sword")
	EndIf
EndEvent

;Check if the current location has a keyword.

Keyword property LocTypeHouse auto

Bool Function CurrentLocationHasKeyword(ObjectReference akRef, Keyword akKeyword)
        Location kCurrentLoc = akRef.GetCurrentLocation()
        if (kCurrentLoc == none)
                return false
        endif

        if kCurrentLoc.HasKeyword(akKeyword)
                return true
        else
                return false
        endif
EndFunction

debug.trace("Is this location a house?: " +CurrentLocationHasKeyword(Game.GetPlayer(), LocTypeHouse))

NotesEdit

  • If run on a Spell, this function checks all attached magic effects, and returns true if at least one magic effect has a specified keyword.
  • If run on an Ingredient or a Potion, this function does not checks attached magic effects, only the record itself.

See AlsoEdit